> ## 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، نفّذ بحث السجلات والتحقق من حالة الشركات واستخراج بياناتها في 220+ دولة. من $2.00 لكل فحص حسب الدولة والمستوى، دون عقود.

عند بدء جلسة التحقق من الشركات، يستعلم Didit من سجلات الشركات الرسمية لاسترجاع معلومات الشركة والتحقق منها. يشكّل هذا البحث الآلي الأساس لعملية التحقق من الشركات بأكملها.

## البحث في السجل

يتصل Didit بسجلات الشركات في الدول المدعومة للحصول على البيانات الرسمية. في التدفق المستضاف، يختار المستخدم دولة التأسيس ويملأ اسم الشركة أو رقم التسجيل أو كليهما، ويُشترط إدخال واحد منهما على الأقل. تُوحَّد أرقام التسجيل حيث تقتضي السجلات ذلك (على سبيل المثال، تُكمَّل أرقام شركات المملكة المتحدة بأصفار حتى تبلغ ثمانية أرقام)، وعند توفير المعرّفين معاً يجمع البحث في السجل بينهما.

### ملء البحث مسبقاً باستخدام `expected_details`

إذا كنت تعرف الشركة مسبقاً، مرِّر `expected_details` (`company_name`، `registry_country`، `registration_number`) عند [إنشاء الجلسة](https://docs.didit.me/ar/sessions-api/create-session.md). يحدد التدفق المستضاف الدولة ويقفلها مسبقاً (وكذلك الولاية في السجلات على مستوى الولايات مثل `US-CA`)، ويملأ حقول البحث المطابقة، ويشغّل البحث المُصرَّح به تلقائياً، فيصل المستخدم مباشرة إلى نتيجة شركته. يبقى الحقلان قابلين للتعديل حتى يتمكن المستخدم من تصحيح تصريح خاطئ. هذا ملء مسبق فقط، واختيار شركة مختلفة عن المُصرَّح بها لا يُنتج أي تحذير.

### أنواع البحث

تدعم عمليات البحث في السجل نمطين:

| النمط | الوصف |
| - | - |
| **دقيق** | يطابق اسم الشركة أو رقم التسجيل بدقة |
| **يحتوي على** | يطابق الشركات التي يحتوي اسمها على عبارة البحث، ويفيد عندما يكون الاسم القانوني الدقيق غير معروف |

### سير عمل البحث

يتبع البحث في السجل سير عمل غير متزامن:

**1. البحث**

يستعلم Didit السجل عن الدولة المختارة والمعرّفات المُدخلة، أي اسم الشركة أو رقم التسجيل أو كليهما معاً. يوضح حقل `searched_by` في الاستجابة كيفية مطابقة النتائج (`name` أو `registration_number` أو `registration_number_and_name`)، وتعرض الواجهة المستضافة على نتائج رقم التسجيل زر تجاوز بنقرة واحدة بعنوان "البحث باسم الشركة بدلاً من ذلك". يعمل البحث بشكل غير متزامن.

**2. استعلام النتائج**

استعلم عن حالة البحث حتى تُحسم النتائج. قد تستغرق السجلات الكبيرة بضع ثوانٍ لإعادة النتائج.

**3. اختيار الشركة**

راجع الشركات التي أعادها البحث واختر المطابقة الصحيحة. يربط Didit الشركة المختارة بفحص KYB ويملأ جميع البيانات المتاحة.

**4. التأكيد والمتابعة**

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

**5. الإرسال اليدوي**

إذا لم يُعثر على الشركة في السجل، أرسل بيانات الشركة يدوياً. تستمر الجلسة باستخدام البيانات المقدَّمة، وتُضبط قيمة `is_from_registry` على `false`.

### البيانات المُسترجعة

| الحقل | الوصف |
| - | - |
| `company_name` | الاسم القانوني كما هو مسجَّل لدى الجهة المختصة |
| `registration_number` | رقم تسجيل الشركة أو تأسيسها الرسمي |
| `country_code` | دولة التأسيس (ISO 3166-1 alpha-3) |
| `company_type` | نوع الكيان القانوني (Ltd وLLC وPLC وSA وGmbH وSL وغيرها) |
| `registry_status` | الحالة الحالية للشركة في السجل (`active` أو `dissolved` أو `struck_off` وغيرها) |
| `incorporation_date` | التاريخ الذي سُجّلت فيه الشركة لأول مرة |
| `registered_address` | عنوان المقر المسجّل الرسمي |
| `tax_number` | الرقم الضريبي عند توفره |
| `alternative_names` | الأسماء التجارية أو dbas أو الأسماء القانونية السابقة أو الأسماء باللغة الأصلية، كقيمة نصية |
| `legal_entity_identifier` | LEI، وهو للمؤسسات المالية والكيانات المدرجة |
| `nature_of_business` | وصف موجز لنشاط الشركة (بلغة السجل) |
| `registered_capital` | رأس المال المصرّح به أو المُصدر ككائن `{amount, currency}` |
| `location_of_registration` | مدينة التسجيل أو التقسيم الإداري لمكان التسجيل |
| `control_scheme` | نظام السيطرة أو الحوكمة عندما يعرضه السجل |
| `website`، `email`، `phone` | بيانات التواصل المسجلة لدى السجل |
| `addresses[]` | عناوين مسجلة أو تجارية إضافية |
| `industries[]` | رموز تصنيف الصناعات (SIC أو NACE أو ما يعادلها محلياً) |
| `accounts` | تواريخ التقديم عند الإبلاغ عنها، بما في ذلك `last_annual_return_date` و`last_agm_date`. الإقرارات السنوية والاجتماعات تختلف عن الحسابات المالية. |
| `financial_summary` | ملخص البيانات المالية حيث ينشرها السجل (الإيرادات وعدد الموظفين وحالة التقديم) |
| `confirmed_by_user_at` | الطابع الزمني عند تأكيد المستخدم النهائي لبيانات السجل أو تعديلها |
| `last_console_edit_at` | الطابع الزمني لآخر تعديل من وحدة التحكم بواسطة محلل |
| `is_editable` | `true` طالما يستطيع المستخدم النهائي تعديل البيانات المأخوذة من السجل في التدفق المستضاف |
| `is_from_registry` | `true` للشركات المأخوذة من السجل، و`false` للإدخال اليدوي |
| `fetch_status` | `pending` أو `resolved` أو `failed`، وهي حالة البحث في السجل |
| `verification_status` | `verified` أو `failed` أو `unknown` |

### حالات الشركة

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

> [!WARNING]
>
> يجوز أن تُعلَّم الشركات التي لا تكون حالتها **نشطة** تلقائياً أو تُرفض، وذلك بحسب إعدادات سير العمل لديك.

### مؤشر مصدر البيانات

يتضمن كل سجل شركة العلَم `is_from_registry`:

* **`true`**: تم استرداد البيانات من سجل شركات رسمي
* **`false`**: أُدخلت البيانات يدوياً لأن الشركة لم تُعثر عليها في السجل

يتتبع الحقل `fetch_status` ما إذا كان البحث في السجل قد اكتمل أو فشل أو ما زال قيد التنفيذ.

## مستويات البيانات والأسعار

في التدفق المستضاف، يترتب على اختيار الشركة رسوم السجل، حتى إذا غادر مقدّم الطلب قبل تأكيد التفاصيل أو إتمام التحقق.
إذا كان التقرير جاهزاً عند الاختيار، يُحتسب المستوى المسلَّم فوراً.
إذا كانت الملكية ما زالت معلّقة، يُحتسب مستوى Lite عند الاختيار، ولا يُحتسب إلا فرق السعر عند تسليم مستوى أعلى.
إذا كانت الملكية غير متاحة، فلا تُطبّق أي رسوم إضافية للملكية.
يستند الإجمالي إلى الأسعار المعروضة عند الاختيار، ولا يتجاوز أبداً عرض سعر المستوى المطلوب.
يُحتسب الاختيار وأي تعديل لاحق للملكية كفحص سجل واحد، أما قراءة التقرير المشترى أو تأكيد تفاصيله فلا تُحتسب مرة أخرى.
تُسجَّل في العقود القائمة بسعر ثابت عمليةُ فحص سجل واحدة عند الاختيار، دون وحدة عقد ثانية لتسليم الملكية لاحقاً.
لا توجد رسوم بحث منفصلة لعمليات البحث في سير العمل المستضاف.
قد تترتب على عمليات البحث المستقلة عبر API رسوم قدرها \$0.50 لكل طلب ناجح؛ انظر [فوترة البحث](https://docs.didit.me/ar/standalone-apis/kyb-registry-search.md). انظر [أسعار سجل KYB](https://docs.didit.me/ar/getting-started/kyb-registry-pricing.md) للاطلاع على الجدول الكامل لكل دولة.

| المستوى | ما تحصل عليه |
| - | - |
| **Lite** | الحقول المذكورة أعلاه: ملف الشركة والمعرّفات والحالة والعنوان المسجّل والنشاط والمسؤولون |
| **المساهمون** | مستوى Lite مع المساهمين المباشرين (أشخاص طبيعيون وكيانات اعتبارية) وفئات نسب ملكيتهم |
| **UBO** | مستوى المساهمين مع المستفيدين الحقيقيين النهائيين الذين يتم تحديدهم عبر سلسلة الملكية |

يختار سير العمل المستضاف المستوى حسب الدولة من *Workflows → KYB Registry Check → Countries*. حيثما لا يحتوي السجل على أي سجل ملكية لشركة ما، يُسلَّم طلب المساهمين أو UBO ويُحتسب بأعلى مستوى تستطيع سجلات الدولة تقديمه، وغالباً ما يكون Lite.

الشركة التي لا تُعثر عليها ويُدخلها المستخدم يدوياً (`is_from_registry: false`) تُحتسب بسعر ثابت قدره **\$0.75**، لأن البحث نُفِّذ حتى وإن لم يُرجع السجل أي بيانات.

> [accordion] مثال: استجابة مستوى Lite
>
> يُرجع Lite ملف الشركة فقط، دون مساهمين أو UBO أو بنية ملكية:
>
> ```json theme={null}
> {
>   "company_name": "ACME HOLDINGS PTY LTD",
>   "registration_number": "094447122",
>   "country_code": "AU",
>   "registry_status": "active",
>   "incorporation_date": "2000-09-12",
>   "company_type": "Proprietary Limited",
>   "registered_address": "Sydney, NSW, 2000",
>   "tax_number": null,
>   "vat_number": null,
>   "website": null,
>   "is_from_registry": true
> }
> ```
>
> يضيف مستوى المساهمين الحقل `ownership_structure` وإدخالات المساهمين، إضافة إلى المديرين والمسؤولين. ويضيف مستوى UBO علاوة على ذلك المستفيدين الحقيقيين مع نسب الملكية. انظر [الملكية](https://docs.didit.me/ar/business-verification/ownership.md) و[المسؤولون والمديرون](https://docs.didit.me/ar/business-verification/officers.md).

## البيانات المسترجعة من السجل مقابل البيانات المقدّمة من المستخدم

تحتفظ Didit بالبيانات المسترجعة من السجل والبيانات التي أكّدها المستخدم كـ**سجلات تدقيق منفصلة**، مع عرض قياسي موحّد تعتمد عليه الفحوصات اللاحقة. تحمل كل شركة ثلاث كتل مرتبطة:

| الحقل | الوصف |
| - | - |
| `registry_data` | تفاصيل السجل الموحّدة لدى Didit: نتيجة الملكية (`ownership_error` و`section_errors` و`ubo_resolution`)، والتصحيحات التي أُجريت عبر [update-data](https://docs.didit.me/ar/sessions-api/update-data.md)، والحقائق الواردة من السجل التي ليس لها حقل خاص بها. تختلف مفاتيحها باختلاف الشركة، ولا تُشكّل عقداً ثابتاً. |
| `user_provided_data` | ما أكّده المستخدم النهائي أو عدّله خلال خطوة تأكيد السجل في التدفق المستضاف. |
| حقول المستوى الأعلى القياسية (`company_name` و`registration_number` و`country_code` و`incorporation_date` وغيرها) | الحقيقة الموحّدة: بيانات المستخدم المؤكَّدة متى وُجدت، وبيانات السجل احتياطاً. تعمل الميزات اللاحقة (مطابقة OCR للمستندات، وفحص AML، وتقييم المخاطر) على العرض القياسي الموحّد. |

يحدد الطابع الزمني `confirmed_by_user_at` وقت تأكيد المستخدم النهائي للبيانات المسترجعة من السجل أو تعديلها. ما دام هذا الطابع لا يزال null و`is_editable` بقيمة `true`، يمكن للمستخدم النهائي مواصلة تعديل الحقول داخل التدفق المستضاف.

بالنسبة للشركات المُدخلة يدوياً (`is_from_registry: false`)، يكون `user_provided_data` المصدر الوحيد، وتصبح `is_editable` بقيمة `false` بعد أن يرسل المستخدم البيانات.

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

## حقول نموذج السجل القابلة للتهيئة

تتحكم في حقول بيانات الشركة التي يطلبها التدفق المستضاف للتحقق خلال خطوة تأكيد السجل. اضبطها في Business Console: افتح محرر سير العمل، واختر عقدة **KYB Registry check**، ثم انتقل إلى تبويب **الحقول**.

لكل حقل إحدى ثلاث حالات:

| الحالة | السلوك |
| - | - |
| **مخفي** | الحقل غير معروض في التدفق المستضاف ولا يتم جمعه. |
| **اختياري** | الحقل معروض، ويمكن للمستخدم تركه فارغاً. |
| **مطلوب** | الحقل معروض، ويجب ملؤه قبل أن يتمكن المستخدم من الإرسال. |

تظهر ثلاثة حقول دائماً وتكون مطلوبة دائماً، ولا يمكن تهيئتها لأنها تحدد هوية الشركة: `company_name` و`country_code` و`region` (الولاية أو المنطقة، عندما يكون السجل إقليمياً).

الحقول الـ16 القابلة للتهيئة:

`registration_number`, `incorporation_date`, `legal_address`, `vat_number`, `alternative_names`, `tax_number`, `company_type`, `legal_entity_identifier`, `location_of_registration`, `nature_of_business`, `registered_capital_amount`, `registered_capital_currency`, `website`, `email`, `phone`, `control_scheme`

افتراضياً، ولجميع سير العمل الحالية، يكون `incorporation_date` وحده **مطلوباً**، وتكون كل الحقول القابلة للتهيئة الأخرى **اختيارية**، بحيث يعمل النموذج تماماً كما كان قبل توفر هذا الإعداد.

يُفرض الإلزام من جهة الخادم: إذا أُرسل نموذج السجل وفيه حقل مطلوب فارغ، يعيد الخادم الاستجابة `400` مع رسائل خطأ لكل حقل، وتعرض الواجهة المستضافة الحقول المفعّلة فقط. في واجهة برمجة سير العمل، يُضبط هذا الإعداد عبر الكائن `kyb_registry_fields_config` في عقدة KYB Registry، راجع [إعدادات الميزات](https://docs.didit.me/ar/management-api/workflows/feature-configs.md#سجل-الشركات-kyb) لمعرفة بنية هذا الكائن.

> [!NOTE]
>
> يُفرض `vat_number` عندما يكون **مطلوباً** للشركات المُؤسَّسة في دولة ضمن دول الاتحاد الأوروبي الخاضعة لضريبة القيمة المضافة (انظر أدناه). أما بقية الدول فيُعامل فيها الحقل كحقل اختياري حتى لو كان مطلوباً، لأنه لا يوجد رقم ضريبة قيمة مضافة أوروبي لجمعه. ويظل `tax_number` يُتحقق منه عند تقديمه لتلك الشركات.

## التحقق من ضريبة القيمة المضافة والرقم الضريبي

عند إرسال خطوة السجل، يتحقق Didit من `vat_number` الخاص بالشركة لدى المصدر الرسمي في بلدها.
إذا لم تكن لدى الشركة `vat_number`، يُتحقق من `tax_number` بدلاً منه.
يمكن إرسال الرقم مع بادئة الدولة أو بدونها، ومع أي فواصل (`DE 123 456 789` و`DE123456789` و`123456789` متكافئة بالنسبة لشركة ألمانية).

**السجلات الرسمية.** في هذه الدول يُفحص الرقم مباشرةً لدى السجل الحكومي أو الرسمي للأعمال، الذي يعيد أيضاً الاسم المسجل (وفي معظم الحالات العنوان):

| الدولة | المصدر |
| - | - |
| الدول الأعضاء الـ27 في الاتحاد الأوروبي وأيرلندا الشمالية (`XI`) | المفوضية الأوروبية [VIES](https://ec.europa.eu/taxation_customs/vies/) |
| بولندا | VIES، ثم سجل المكلفين بضريبة القيمة المضافة لدى وزارة المالية (القائمة البيضاء "White List") للشركة التي لا يدرجها VIES |
| النرويج | مركز Brønnøysund للسجلات (السجل التنسيقي المركزي للكيانات القانونية) |
| سويسرا | سجل UID لدى مكتب الإحصاء الاتحادي |
| البرازيل | سجل Receita Federal CNPJ |
| كولومبيا | RUES، السجل الموحد للأعمال والمؤسسات الاجتماعية لدى غرف التجارة |
| كوستاريكا | سجل المكلفين لدى وزارة المالية (Hacienda) |
| الإكوادور | سجل المكلفين لدى مصلحة الضرائب الداخلية (SRI) |
| باراغواي | سجل RUC لدى المديرية الوطنية للضرائب (DNIT) |

إذا أُرسل رقم SIREN أو SIRET فرنسي، أو رقم RSIN هولندي، أو رقم ضريبي هنغاري كامل بوصفه رقم ضريبة القيمة المضافة، يُحوَّل إلى رقم ضريبة القيمة المضافة المقابل قبل فحصه.
تُفحص أرقام ضريبة القيمة المضافة اليونانية تلقائياً بالبادئة `EL`.

**قواعد رقم التحقق.** في هذه الدول لا يمكن الاستعلام من أي سجل، لذلك يُفحص الرقم وفق التنسيق الرسمي للدولة وقواعد رقم التحقق فيها: ألبانيا، أندورا، الأرجنتين، أستراليا، أذربيجان، بيلاروس، كندا، تشيلي، الصين، جمهورية الدومينيكان، مصر، السلفادور، غانا، غواتيمالا، آيسلندا، الهند، إندونيسيا، إسرائيل، اليابان، كينيا، ليختنشتاين، المكسيك، مولدوفا، موناكو، الجبل الأسود، المغرب، موزمبيق، نيوزيلندا، مقدونيا الشمالية، بيرو، روسيا، سان مارينو، صربيا، سنغافورة، جنوب أفريقيا، كوريا الجنوبية، تايوان، تايلاند، تونس، تركيا، أوكرانيا، المملكة المتحدة، الولايات المتحدة، أوروغواي، فنزويلا وفيتنام.
تُطبَّق هذه القواعد أيضاً داخل الاتحاد الأوروبي عندما يكون `tax_number` رقماً ضريبياً وطنياً لا يوجد له رقم ضريبة قيمة مضافة للفحص، مثل Steuernummer الألمانية.
لا يدل `tax_number` إلا على معرّف ضريبي، لا على تسجيل في ضريبة القيمة المضافة، لذلك عندما لا يدرجه VIES تعود النتيجة إلى هذه القواعد بدلاً من `invalid`.

تحصل الشركات من أي دولة أخرى على `vat_validation_status: "not_applicable"`.
وكذلك جلسات البيئة التجريبية التي لا تتصل أبداً بأي سجل ضريبي.

تُحفظ النتيجة لدى الشركة وتظهر في [payload قرار KYB](https://docs.didit.me/ar/business-verification/response-schema.md#كتلة-company):

| الحقل | الوصف |
| - | - |
| `vat_number` | رقم ضريبة القيمة المضافة كما أُرسل |
| `vat_validation_status` | `valid`، `invalid`، `format_valid`، `invalid_format`، `could_not_validate`، أو `not_applicable` |
| `vat_validated_number` | الرقم الذي جرى فحصه كما يعرفه المصدر (مثلاً رقم ضريبة القيمة المضافة المشتق من SIREN) |
| `vat_validation_source` | المصدر الذي حدّد الحالة (انظر أدناه) |
| `vat_validated_name` | الاسم المسجل لدى المصدر، عندما يفصح عنه |
| `vat_validated_address` | العنوان المسجل لدى المصدر، عندما يفصح عنه |
| `vat_checked_at` | الطابع الزمني للفحص |

| الحالة | المعنى |
| - | - |
| `valid` | أكّد السجل الرسمي أن الرقم مسجل ونشط |
| `invalid` | ليس لدى السجل الرسمي تسجيل نشط لهذا الرقم. في الاتحاد الأوروبي، يدرج VIES الشركات المسجلة للتجارة داخل الاتحاد فقط |
| `format_valid` | الرقم يجتاز قواعد التنسيق ورقم التحقق في الدولة، ولم يُستعلم من أي سجل |
| `invalid_format` | الرقم لا يجتاز قواعد التنسيق أو رقم التحقق في الدولة |
| `could_not_validate` | السجل غير متاح، لذلك تعذّر فحص الرقم. يُعاد فحصه في المرة التالية التي يعمل فيها فحص السجل |
| `not_applicable` | لم يُقدَّم رقم ضريبة قيمة مضافة أو رقم ضريبي، أو ليس للدولة سجل أو قواعد، أو الجلسة جلسة بيئة تجريبية |

القيمة في `vat_validation_source` هي إحدى القيم التالية: `eu_vies`، `pl_vat_white_list`، `no_brreg`، `ch_uid_register`، `br_receita_federal`، `co_rues`، `cr_hacienda`، `ec_sri`، `py_dnit`، أو `format_rules`.

بمجرد أن يصبح الرقم `valid` أو `invalid` أو `format_valid` أو `invalid_format`، تُحفظ النتيجة طوال الجلسة، ولا يُسأل السجل مرة أخرى ما لم يتغير الرقم.

**مقارنة الاسم.** عندما يكون الرقم `valid` ويفصح المصدر عن الاسم المسجل، تقارن Didit هذا الاسم بشكل تقريبي مع اسم الشركة المُقدَّم.
عند وجود اختلاف جوهري يُصدر تحذير `KYB_COMPANY_VAT_NAME_MISMATCH` دون تغيير حالة الجلسة، فهو إشارة غير حاسمة للمراجِعين.
يتضمن `additional_data` الحقول `registry_name` و`registry_source` و`submitted_name`، إضافة إلى `vies_name` عندما يكون المصدر VIES.
بعض الدول الأعضاء في الاتحاد الأوروبي لا تفصح عن الاسم أو العنوان؛ فتعود الحقول فارغة ولا تُجرى أي مقارنة.

**الإجراءات القابلة للتهيئة.** يتحكم إعدادان في عقدة فحص السجل KYB في ما يفعله الفحص غير الناجح بالجلسة (القيم `REVIEW` و`DECLINE` و`NO_ACTION`):

| الإعداد | يُطبَّق عندما | القيمة الافتراضية |
| - | - | - |
| `kyb_vat_invalid_action` | تكون `vat_validation_status` هي `invalid`، أو يكون `vat_number` هو `invalid_format` | `REVIEW`، وتنتقل الجلسة إلى «قيد المراجعة» |
| `kyb_vat_unverified_action` | تكون `vat_validation_status` هي `could_not_validate` | `NO_ACTION`، ولا أثر على الجلسة |

يُعرض `tax_number` الذي يكون `invalid_format` في payload دون أن يُطلق أي إجراء، لأن الحقل الضريبي الحر غالباً ما يحتوي على معرّف شركة آخر.

تُصدر كل نتيجة أيضاً التحذير المقابل (`KYB_COMPANY_VAT_INVALID`، `KYB_COMPANY_VAT_COULD_NOT_VALIDATE`) في فحص السجل، راجع [تحذيرات التحقق من الشركات (KYB)](https://docs.didit.me/ar/business-verification/warnings.md#تحذيرات-سجل-kyb).

## المقارنة المرجعية للبيانات

يقارن Didit تلقائياً البيانات المقدَّمة من المستخدم أو البيانات المعتمدة مع ما أعاده السجل، ومع بيانات OCR المستخرجة من المستندات المرفوعة:

* **اسم الشركة**: مطابقة تقريبية لاستيعاب الاختصارات واختلافات التنسيق
* **رقم التسجيل**: التحقق من التطابق التام
* **الدولة**: فحص الاتساق بين الدولة المقدَّمة ودولة السجل
* **العنوان**: الترميز الجغرافي والتطبيع لإجراء المقارنة

تُعلَّم أي تناقضات كتحذيرات في الجلسة، ويمكن للمحللين رؤيتها في الكونسول.

## الملخص المالي

حيثما تتوفر البيانات، يسترجع Didit ملخصاً للبيانات المالية من السجل:

* الإيرادات أو حجم المبيعات
* عدد الموظفين
* رموز الصناعة SIC/NACE
* تواريخ الإيداع وحالة الامتثال

## حقول السجل الإضافية

حسب نطاق التغطية في الولاية القضائية، قد تتضمن استجابة السجل أيضاً:

* `alternative_names`: الأسماء التجارية وأسماء DBA والأسماء القانونية السابقة
* `legal_entity_identifier` (LEI): للمؤسسات المالية والكيانات المدرجة
* `website`، `email`، `phone`: معلومات الاتصال المسجلة لدى السجل
* `nature_of_business`: وصف موجز (بلغة السجل)
* `registered_capital`: رأس المال المصرّح به أو المُصدَر، ككائن `{amount, currency}`

تُدرج جميع الحقول في كتلة [`business`](https://docs.didit.me/ar/business-verification/response-schema) الخاصة بقرار KYB.

## الثقة وحالة التحقق

يحمل كل استجابة من السجل حقل `verification_status`:

| القيمة | المعنى |
| - | - |
| `VERIFIED` | أعاد السجل تطابقاً واسترجعت البيانات. |
| `FAILED` | أعاد السجل تطابقاً لكن استرجاع البيانات فشل (مثلاً استجابة جزئية). |
| `UNKNOWN` | تعذّر العثور على الشركة في أي سجل. |

ادمج هذا الحقل مع `is_from_registry` لبناء منطقك الخاص لاحقاً:

| `is_from_registry` | `verification_status` | المعنى |
| - | - | - |
| true | VERIFIED | تحقق كامل مقابل السجل الرسمي |
| true | FAILED | جزئي: قد تكون بعض الحقول قديمة أو مفقودة |
| false | UNKNOWN | بيانات مقدَّمة من المستخدم فقط؛ لا يوجد تطابق في السجل |

## مخرجات المقارنة المرجعية

تعمل كل مقارنة مرجعية على كل حقل على حدة، وتُرجع إحدى القيم التالية:

* `MATCH`: تتوافق البيانات المقدَّمة مع السجل.
* `MISMATCH`: اختلاف جوهري. يُعلَّم كتحذير.
* `NO_DATA`: أحد الطرفين فارغ، ولا يمكن إجراء المقارنة.

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

## ما الذي يحدد النتيجة

تُدخل حالة الشركة، وبلد التأسيس، ونتائج AML، ومدى التطابق مع البيانات المُعلَنة إلى القرار كوسوم تحذير على فحص السجل وفحص AML. يقرر سير العمل لديك ما إذا كان كل تحذير سيؤدي إلى القبول أو المراجعة أو الرفض. انظر [تقييم المخاطر](https://docs.didit.me/ar/business-verification/risk-assessment.md) للإشارات ومفاتيح سير العمل التي تتحكم فيها.

## الدول المدعومة

تتفاوت التغطية حسب الدولة. انظر [الدول المدعومة](https://docs.didit.me/ar/business-verification/supported-countries.md) للاطلاع على تفصيل المستويات لكل منطقة.

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

> [card] [الملكية](https://docs.didit.me/ar/business-verification/ownership.md)
>
> تحديد UBO وسلاسل الملكية.

> [card] [مخطط الاستجابة](https://docs.didit.me/ar/business-verification/response-schema.md)
>
> موضع كل حقل في payload.

> [card] [الدول المدعومة](https://docs.didit.me/ar/business-verification/supported-countries.md)
>
> التغطية حسب المنطقة.


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