> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# استيراد الشركات وتصديرها: CSV بالجملة

> استيراد كيانات شركات Didit (KYB) بالجملة من ملفات CSV وتصدير جدول الشركات كاملاً. متاح من وحدة تحكم Didit Business. فوترة لكل استدعاء.



طلب وكيل الاستيراد والتصدير الجماعي للشركات
        نسخ الموجّه إلى الحافظة



      
      

\<pre>

\````# Goal — bulk-load (or extract) Didit Business entities programmatically

CSV import / export is console-only. For programmatic bulk operations, loop `POST /v3/businesses/create/` for imports and paginate `GET /v3/businesses/` for exports.

\## Bulk import — loop the create endpoint

\```bash
\# businesses.json — array of records
\# [{"vendor_data":"biz-acme","display_name":"Acme Corp","country_code":"GBR"}, ...]

jq -c '.[]' businesses.json | while read biz; do
curl -X POST https://verification.didit.me/v3/businesses/create/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d "$biz"
sleep 0.1   # respect rate limits — see /integration/rate-limiting
done
\```

Record shape (matches `POST /v3/businesses/create/`):

\```json
\{
"vendor_data": "biz-acme",         // required, unique per app
"display_name": "Acme Corp",       // optional
"country_code": "GBR",             // ISO 3166-1 alpha-3, optional
"metadata": {"partner": "Acme Holdings"},
"tags": ["b2b-tier-1"]
}
\```

\`create` is **not** idempotent. Upsert pattern:

\```bash
if curl -s -o /dev/null -w "%{http_code}" \
 https://verification.didit.me/v3/businesses/$VD/ \
 -H "x-api-key: $DIDIT_API_KEY" | grep -q 200; then
curl -X PATCH https://verification.didit.me/v3/businesses/$VD/ \
-H "x-api-key: $DIDIT_API_KEY" -H "Content-Type: application/json" \
-d "$BODY"
else
curl -X POST https://verification.didit.me/v3/businesses/create/ \
-H "x-api-key: $DIDIT_API_KEY" -H "Content-Type: application/json" \
-d "$BODY"
fi
\```

\## Bulk export — paginate the list endpoint

\```bash
PAGE=1
while :; do
RESP=$(curl -sG https://verification.didit.me/v3/businesses/ \
-H "x-api-key: $DIDIT_API_KEY" \
\--data-urlencode "page=$PAGE" \
\--data-urlencode "page_size=100")
echo "$RESP" | jq -c '.results[]' >> businesses.ndjson
HAS_NEXT=$(echo "$RESP" | jq -r '.next // empty')
\[ -z "$HAS_NEXT" ] && break
PAGE=$((PAGE+1))
done
\```

Filter with `status`, `country_code`, `search`, date ranges (see /management-api/businesses/list).

\## What survives on update vs what stays

\| Field | Behaviour |
\|---|---|
\| `display_name`, `metadata`, `tags` | Overwritten by PATCH |
\| `legal_name`, `registration_number`, `country_code` | Read-only after a verified KYB session (overrides logged in audit log) |
\| Aggregate counters, `features` map | Computed by Didit — never accept writes |

\## Failure modes

\- `409` on create — `vendor_data` exists; use PATCH.
\- `429` — rate limit; back off using `Retry-After`. Insert 100ms+ between calls for large batches.
\- `400` — bad country code or bad JSON. Log and continue.

\## Console fallback

The Business Console (Businesses → Import / Export) handles up to 100K rows for imports and 1M rows for exports with chunked async processing and an emailed signed download link.

\## Sources of truth

\- /management-api/businesses/create — POST /v3/businesses/create/ schema
\- /management-api/businesses/list — GET /v3/businesses/ pagination
\- /entities/businesses/data-model — mutable vs read-only fields
\- /integration/rate-limiting — rate limits
\- /integration/integration-prompt — canonical end-to-end prompt````

\</pre>



      
      

الصق في

تدعم Business Console الاستيراد والتصدير الجماعي لكيانات الشركات، وهو التدفق نفسه المتاح للمستخدمين، مع تكييفه لحقول الشركات.> [!NOTE]
>
> الاستيراد والتصدير الجماعي هنا ينشئ ملفات تعريف الشركات أو يحدّثها فقط. ولا يعيد إنشاء جلسات KYB السابقة، أو تقارير السجل، أو المسؤولين، أو المستفيدين الحقيقيين، أو قرارات المزوّدين. للترحيل الكامل لبيانات KYB من مزوّد آخر أو من تصدير سجل، راجع [استيراد البيانات من مزوّد آخر](https://docs.didit.me/ar/sessions-api/import-verifications.md).## استيراد الشركات من ملف CSV### متى تستخدمه- **الترحيل** من مزوّد KYB آخر.
- **تسجيل الشركاء**: تحميل قائمة عملاء شريك.
- **تعبئة البيانات الوصفية**: تحديث الوسوم أو المستوى أو الحقول المخصصة لعدد كبير من الشركات.### أعمدة القالبنزّل القالب من *Businesses → Import → Download template*:| العمود | مطلوب | الوصف |
| - | - | - |
| `vendor_data` | نعم | معرّفك للشركة. فريد لكل تطبيق. |
| `display_name` | لا | اسم سهل القراءة. |
| `legal_name` | لا | الاسم القانوني للشركة. سيتم استبداله ببيانات السجل المتحقق منها. |
| `registration_number` | لا | رقم تسجيل الشركة. سيتم استبداله ببيانات السجل المتحقق منها. |
| `country_code` | لا | رمز ISO 3166-1 alpha-3. يُفعّل فحص الدول الخطرة. |
| `status` | لا | `ACTIVE` أو `FLAGGED` أو `BLOCKED`. القيمة الافتراضية هي `ACTIVE`. |
| `tags` | لا | وسوم مفصولة بفواصل. |
| `metadata_json` | لا | JSON مُسلسل كنص للبيانات الوصفية المخصصة. |### تشغيل الاستيراد**1. رفع ملف CSV***Businesses → Import → Upload CSV*.**2. مراجعة المعاينة**تُبرز الصفوف غير الصالحة. وتُعلَّم التكرارات (`vendor_data` موجود مسبقاً) على أنها تحديثات.**3. بدء الاستيراد**تعالج Didit الصفوف بشكل غير متزامن، ويمكن متابعة التقدم في *Businesses → Import history*.**4. مراجعة النتائج**نزّل تقرير الأخطاء لأي صفوف تم تخطيها.### التحديث مقابل الإنشاء- `vendor_data` جديد ← ينشئ شركة جديدة.
- `vendor_data` موجود ← يحدّث الحقول القابلة للتعديل والبيانات الوصفية للشركة.
- لا تتم الكتابة فوق الحقول المستمدة من السجل (`legal_name` و`registration_number` و`country_code`) بعد أن تملأها جلسة التحقق من الشركات (KYB) بالبيانات.## تصدير الشركات إلى ملف CSV### متى تستخدمه- **عمليات التدقيق للامتثال** وطلبات الجهات التنظيمية.
- **مزامنة مستودع البيانات** لأدوات ذكاء الأعمال.
- **تقارير الشركاء**: عروض مصفّاة للشركات حسب الدولة أو المستوى أو الوسم.### تشغيل التصدير1) انتقل إلى *Businesses → Export*.
2) طبّق عوامل التصفية (الحالة، الدولة، نطاق التاريخ، البحث، الوسوم).
3) اختر الأعمدة.
4) أرسل الطلب: تنشئ Didit التصدير بشكل غير متزامن وترسل رابط تنزيل موقّعاً إلى بريدك الإلكتروني.تنطبق قيود الأدوار؛ راجع [الأدوار والصلاحيات](https://docs.didit.me/ar/console/roles-permissions.md).## مسار التدقيقتُسجَّل جميع عمليات الاستيراد والتصدير مع المشغّل وأعداد الصفوف والطوابع الزمنية. راجع [سجلات التدقيق](https://docs.didit.me/ar/console/audit-logs.md).## الخطوات التالية> [card] [واجهة برمجة إنشاء الشركات](https://docs.didit.me/ar/management-api/businesses/create.md)
>
> الإنشاء الجماعي برمجياً.> [card] [الاحتفاظ بالبيانات](https://docs.didit.me/ar/console/data-retention.md)
>
> المدة التي تبقى فيها البيانات المستوردة.> [card] [سجلات التدقيق](https://docs.didit.me/ar/console/audit-logs.md)
>
> مراجعة سجل الاستيراد والتصدير.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.