> ## 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.

# Business Profiles API: تتبّع الشركات المُتحقَّق منها

> تتبّع الشركات المُتحقَّق منها عبر الجلسات مع Didit: ملفات تُنشأ تلقائياً، وحالات، ووسوم، واستيراد وتصدير CSV. ابتداءً من $2.00 لكل فحص.

يُنشئ Didit تلقائياً ملف شركة لكل شركة تتحقق منها، ويجمع بيانات التحقق وسجل الجلسات في كيان واحد. توفر ملفات الشركات عرضاً موحداً لكل شركة عبر جميع جلسات التحقق الخاصة بها.

> [!NOTE]
>
> ملفات الشركات هي الواجهة الخاصة بـ KYB من نموذج **كيان الشركة** العام. للاطلاع على نموذج الكيان الكامل، بما في ذلك العمليات وربط الأشخاص الرئيسيين بالمستخدمين وآلية قائمة الحظر والاستيراد والتصدير، راجع [نظرة عامة على الشركات](https://docs.didit.me/ar/entities/businesses/overview.md).

## ما هو ملف الشركة

يُنشأ ملف الشركة تلقائياً عند إرسال [جلسة شركة](https://docs.didit.me/ar/business-verification/overview.md) مع معرّف `vendor_data`. إذا كان ملف يحمل هذا المعرّف موجوداً بالفعل، تُربط الجلسة الجديدة به.

| الحقل | الوصف |
| - | - |
| **بيانات المورد** | المعرّف الفريد الخاص بك لهذه الشركة (مثال: `company-123`) |
| **الاسم المعروض** | اسم العرض الظاهر في وحدة التحكم |
| **الاسم القانوني** | الاسم القانوني الرسمي من السجل أو من الإدخال اليدوي |
| **رقم التسجيل** | رقم تسجيل الشركة أو رقم تأسيسها |
| **الدولة** | دولة التأسيس (ISO 3166-1 alpha-2) |

## حالات الملف

| الحالة | الوصف |
| - | - |
| `ACTIVE` | الشركة في وضع جيد، ولم يُكتشف أي مشكلات |
| `FLAGGED` | الشركة تحتاج إلى انتباه: نتائج المراجعة أو الفحوصات المعلقة |
| `BLOCKED` | تم حظر الشركة من أي نشاط إضافي |

يمكن تغيير الحالات يدوياً من وحدة التحكم، أو بشكل جماعي، أو تلقائياً استناداً إلى نتائج التحقق.

## مقاييس الجلسات

يتتبع كل ملف مقاييس التحقق عبر جميع الجلسات المرتبطة به:

| المقياس | الوصف |
| - | - |
| **إجمالي الجلسات** | عدد جلسات التحقق لهذه الشركة |
| **مقبولة** | الجلسات التي اجتازت جميع الفحوصات |
| **مرفوضة** | الجلسات التي أخفقت في فحص حاسم واحد أو أكثر |
| **قيد المراجعة** | الجلسات بانتظار مراجعة المحلل |
| **آخر جلسة** | الطابع الزمني لأحدث عملية تحقق |
| **أول جلسة** | الطابع الزمني لأقدم عملية تحقق |
| **آخر نشاط** | الطابع الزمني لأي نشاط حديث (تغيير الحالة، تحديث الجلسة، وغير ذلك) |

## الوسوم

أضف وسوماً إلى ملفات الشركات لتصنيفها وتصفيتها. تُحدَّد الوسوم من قبل التطبيق، لذا أنشئ وسوماً مخصصة تناسب سير عملك (مثال: `high-risk`، `vip-client`، `re-verification-needed`).

## العمليات الجماعية

أدِر عدة ملفات شركات دفعة واحدة:

| العملية | الوصف |
| - | - |
| **تحديث الحالة بشكل جماعي** | تغيير حالة الملفات المحددة (أو جميع الملفات التي تطابق المرشحات الحالية) |
| **تصدير CSV** | تصدير بيانات الملفات إلى CSV مع إمكانية اختيار الأعمدة |
| **استيراد CSV** | استيراد ملفات الشركات من ملف CSV لإنشائها مسبقاً قبل التحقق |
| **حذف جماعي** | تُحذف الملفات المحددة وجميع البيانات المرتبطة بها |

### استيراد CSV

لاستيراد ملفات الشركات بشكل جماعي:

1. نزّل **قالب الاستيراد** من وحدة التحكم لمعرفة تنسيق الأعمدة المتوقع
2. املأ القالب ببيانات شركتك
3. ارفع الملف، وسينشئ Didit مهمة استيراد ويعالج الصفوف بشكل غير متزامن

بعد الاكتمال، راجع ملخص الاستيراد لأعداد الصفوف المنشأة والمحدَّثة والفاشلة. تتضمن الصفوف الفاشلة تفاصيل خطأ محددة.

## المراجعات والتعليقات

أضف ملاحظات مراجعة داخلية إلى أي ملف شركة. التعليقات مرئية لجميع أعضاء الفريق الذين لديهم صلاحية الوصول، وتشكّل جزءاً من سجل التدقيق:

* أضف ملاحظات بمحتوى نصي حر
* اذكر أعضاء الفريق بالبريد الإلكتروني لإشعارهم
* اعرض سجل التعليقات الكامل مع اسم الكاتب والطابع الزمني

## الخطوات التالية

> [card] [نظرة عامة على التحقق من الشركات](https://docs.didit.me/ar/business-verification/overview.md)
>
> كيف تعمل جلسات التحقق من الشركات من البداية إلى النهاية.

> [card] [دليل وحدة التحكم](https://docs.didit.me/ar/business-verification/console.md)
>
> إدارة ملفات الشركات والجلسات في Business Console.

> [card] [مرجع API](https://docs.didit.me/ar/management-api/businesses/list.md)
>
> نقاط نهاية API لإدارة الشركات.


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