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

# التحقق من مستندات الشركات (KYB): واجهة برمجة التطبيقات

> Didit: جمع مستندات الشركات واستخراج نصوصها (OCR) والتحقق من السجلات، ومنها الشهادات وعقد التأسيس والقوائم المالية. تسعير منفصل عن استرجاع السجلات.

التحقق من الشركات يتضمن جمع المستندات بشكل منظم للتحقق من معلومات الشركة بما يتجاوز ما هو متاح في سجلات الشركات.

## الأسعار

تكلّف عملية جمع مستندات KYB **\$0.20 لكل خطوة في سير العمل**، بغض النظر عن عدد المستندات المرفوعة في تلك الخطوة. إعادة رفع مستند في الخطوة نفسها لا تضيف رسومًا أخرى، أما خطوة جمع مستندات منفصلة فلها رسومها الخاصة.

## مجموعات المستندات

تنقسم المستندات إلى أربع مجموعات منظمة، تمثل كل منها فئة من الأدلة اللازمة للتحقق من الشركة، بالإضافة إلى مجموعة عامة لأي مستند لا تستطيع Didit تصنيفه.

| المجموعة (`document_group`) | الوصف | الأنواع الفرعية المعترف بها |
| - | - | - |
| **الوجود القانوني** (`LEGAL_PRESENCE`) | مستندات تثبت أن الشركة موجودة قانونيًا | `CERTIFICATE_OF_INCORPORATION`, `CERTIFICATE_OF_GOOD_STANDING`, `CERTIFICATE_OF_INCUMBENCY`, `REGISTRY_EXCERPT`, `BUSINESS_LICENSE`, `TAX_REGISTRATION` |
| **تفاصيل الشركة** (`COMPANY_DETAILS`) | مستندات تصف التفاصيل الحالية للشركة | `CONFIRMATION_STATEMENT`, `ANNUAL_RETURN`, `STATEMENT_OF_INFORMATION` |
| **هيكل الملكية** (`OWNERSHIP_STRUCTURE`) | مستندات تثبت سلسلة الملكية | `SHAREHOLDER_REGISTRY`, `MEMORANDUM_OF_ASSOCIATION`, `ARTICLES_OF_ASSOCIATION` |
| **تفويض الممثلين** (`REPRESENTATIVES_AUTHORIZATION`) | مستندات تثبت الصلاحية للتصرف نيابة عن الشركة | `DIRECTOR_REGISTRY`, `POWER_OF_ATTORNEY`, `TRUST_AGREEMENT` |
| **أخرى** (`OTHER`) | أي شيء لا تستطيع Didit تصنيفه بثقة | `UNKNOWN` |

تتابع كل مجموعة تقدمها عبر عدادات خاصة بها: `total`، و`approved`، و`pending`، و`declined`، و`in_review`، و`other`، و`missing`. وتُجمّع حالة المستندات الإجمالية لجلسة الشركة البيانات عبر جميع المجموعات.

## أنواع المستندات

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

## سير عمل المستندات

**1. الطلبات التلقائية**

بناءً على إعداد سير العمل لديك، تحدد Didit تلقائيًا المستندات المطلوبة للتحقق من الشركة. ثم تُعرض أنواع المستندات المطلوبة على الشركة لرفعها.

**2. الرفع**

تُرفع المستندات عبر تدفق التحقق المستضاف، أو من خلال Business Console، أو من واجهتك الأمامية باستخدام endpoint [رفع المستندات](https://docs.didit.me/ar/sessions-api/kyb-upload-documents.md). الصيغ المقبولة هي PDF وJPG وJPEG وPNG وTIFF وWebP، أو أرشيف ZIP يحتوي عليها. يمكن أن يصل حجم ملفات PDF إلى 50 MB، والصور إلى 6 MB قبل الضغط. بالنسبة إلى ملف PDF محمي بكلمة مرور، أرسل كلمة المرور في `document_passwords` عند الرفع عبر API.

**3. استخراج البيانات عبر OCR**

تستخرج Didit البيانات المنظمة من المستندات المرفوعة باستخدام OCR:

* اسم الشركة ورقم التسجيل من الشهادات
* بيانات العنوان من فواتير الخدمات
* الأرقام المالية من الكشوفات
* الأسماء والأدوار من سجلات المساهمين

**4. المقارنة المتقاطعة**

تُقارن البيانات المستخرجة مع:

* بيانات السجل من البحث عن الشركة
* المعلومات المقدمة عند إنشاء الجلسة
* البيانات من المستندات الأخرى المرفوعة

تُوضع علامة على التناقضات لمراجعتها من قبل المحلل.

**5. المراجعة**

يراجع المحللون المستندات المرفوعة في Business Console، ويتحققون من صحتها، ويقبلون أو يرفضون كل مستند على حدة.

## طلبات المستندات من المحللين

أثناء عملية المراجعة، يمكن للمحللين طلب مستندات إضافية:

1. انتقل إلى جلسة الشركة في Business Console
2. انقر على **طلب مستند** وحدد نوع المستند والوصف
3. تُخطَر الشركة ويمكنها رفع المستند المطلوب
4. يظهر المستند في الجلسة بحالة **مطلوب** حتى يتم رفعه

يتيح ذلك للمحللين جمع أدلة إضافية دون رفض جلسة الشركة بالكامل.

## حالات المستندات

يستخدم كل مستند والتحقق الإجمالي `document_verifications[]` مجموعة الحالات القياسية لميزات KYB:

| الحالة | الوصف |
| - | - |
| `"Not Finished"` | المستند ما زال قيد المعالجة (رفع قيد التنفيذ، أو تشغيل OCR، أو المقارنة المتقاطعة قيد الانتظار). |
| `"Approved"` | تمت مراجعة المستند وقبوله. |
| `"Declined"` | تمت مراجعة المستند ورفضه. |
| `"In Review"` | يتطلب المستند مراجعة يدوية من المحلل. |
| `"Resub Requested"` | طلب المحلل إعادة تقديم المستند، ويجب على الشركة إعادة رفعه قبل أن تتمكن الجلسة من المضي قدمًا. |

## نتائج المطابقة المتقاطعة

عند معالجة مستند، يقارن Didit البيانات المستخرجة عبر OCR مع **البيانات التي قدمها المستخدم** المُرسلة في مسار الأشخاص الرئيسيين (وأي بيانات مؤكدة أثناء مراجعة السجل)، إضافةً إلى المستندات الأخرى المرفوعة. تُنتج المطابقة نتائج منظمة:

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

تُعرض نتائج المطابقة المتقاطعة في [Business Console](https://docs.didit.me/ar/business-verification/console.md) إلى جانب معاينة المستند، فتمنح المحللين صورة واضحة عمّا يتطابق وما يحتاج إلى انتباه.

## استرجاع المستندات عبر API

تُرفق المستندات بجلسة التحقق من الشركات (KYB). استرجعها من قرار الجلسة:

```bash theme={null}
curl https://verification.didit.me/v3/session/{session_id}/decision/ \
  -H "x-api-key: YOUR_API_KEY"
```

تتضمن الاستجابة مصفوفة `document_verifications[]`. يحتوي كل عنصر فيها على `status` و`node_id` و`items[]` (ويحتوي كل منها على `file_url` موقّع و`document_group` و`document_subtype` وبيانات مستخرجة عبر OCR)، إضافةً إلى `groups` و`required_groups`. راجع [مخطط الاستجابة](https://docs.didit.me/ar/business-verification/response-schema.md#document_verifications) للاطلاع على البنية الكاملة.

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

> [card] [مخطط الاستجابة](https://docs.didit.me/ar/business-verification/response-schema.md)
>
> مكان ظهور المستندات في payload.

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


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