> ## 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 حسب الميزة: سجل الشركات، مستندات KYB، الأشخاص الرئيسيون، AML، الهاتف، البريد، الاستبيانات، والجهاز وIP.

تعرض ميزة التحقق من الشركات التحذيرات على عنصر الميزة الذي أنتجها. يحمل كل تحذير البنية المنظمة القياسية المستخدمة في المنصة كلها، وهي `feature` و`risk` و`log_type` و`short_description` و`long_description` وحقل `additional_data` الاختياري و`node_id`، حتى تتمكن من توجيه مهام المراجعة إلى الفريق التشغيلي المناسب.

## نظرة عامة

تصدر جلسات KYB تحذيرات تحت ثلاثة وسوم أساسية للميزات، تقابل مصفوفات الميزات المخصصة في استجابة القرار من الإصدار V3:

| وسم الميزة | مفتاح استجابة القرار | ما الذي يغطيه |
| - | - | - |
| `KYB_REGISTRY` | `registry_checks[].warnings[]` | عمليات البحث في سجلات الشركات الرسمية: حالة النشاط، وقيود الدول، والملكية القابلة للاستنتاج، وسجلات المسؤولين أو المستفيدين الحقيقيين (UBO) المفقودة. |
| `KYB_DOCUMENTS` | `document_verifications[].warnings[]` | مستندات التأسيس والملكية والعنوان والمساهمين التي يرفعها المستخدم. الاتساق بين المستندات، وOCR، والبيانات الوصفية، والتلاعب، والعمر، وقواعد النوع الفرعي. |
| `KYB_KEY_PEOPLE` | `key_people_checks[].warnings[]` | إشارات على مستوى الأفراد تخص المديرين والمسؤولين والمستفيدين الحقيقيين (UBO) أو الأطراف التي يقدمها المستخدم، ويشمل ذلك نتائج PEP والعقوبات التي تنتقل من AML، وإعادة استخدام حالات الرفض السابقة. |

يمكن أن تتضمن سير العمل نفسه الميزات المشتركة أدناه أيضًا، وهي تصدر تحذيرات في مصفوفاتها الخاصة:

| وسم الميزة | مفتاح استجابة القرار |
| - | - |
| `AML` | `aml_screenings[].warnings[]` |
| `PHONE` | `phone_verifications[].warnings[]` |
| `EMAIL` | `email_verifications[].warnings[]` |
| `QUESTIONNAIRE` | `questionnaire_responses` (توجد التحذيرات في سجل الجلسة) |
| `LOCATION` | `ip_analyses[].warnings[]` |

## تحذيرات سجل KYB

تستخدم تحذيرات السجل القيمة `feature: "KYB_REGISTRY"` وتظهر في `registry_checks[].warnings[]`.

| الوسم | الوصف |
| - | - |
| `KYB_COUNTRY_RESTRICTED` | دولة الشركة خارج الدول المسموح بها والمُهيَّأة لسير العمل. |
| `KYB_OFFICERS_DATA_NOT_FOUND` | بيانات المسؤولين غير متاحة من السجل. |
| `KYB_OWNERSHIP_DATA_NOT_FOUND` | بيانات الملكية غير متاحة من السجل. |
| `KYB_BENEFICIAL_OWNERSHIP_NOT_DERIVABLE` | تعذر تحديد الملكية النهائية للمستفيد الحقيقي من بيانات السجل. |
| `KYB_COMPANY_NOT_ACTIVE` | الشركة غير نشطة وفقًا للسجل. |
| `KYB_COMPANY_NOT_FROM_REGISTRY` | أُدخلت الشركة يدويًا، وتعذر التحقق منها مقابل سجل شركات رسمي. |
| `KYB_REGISTRY_DATA_MISMATCH_WITH_EXPECTED` | رقم تسجيل الشركة الذي عُثر عليه في السجل لا يطابق `expected_details.registration_number` الذي أرسلته عند إنشاء الجلسة. |
| `KYB_REGISTRY_DATA_PARTIAL_MATCH_WITH_EXPECTED` | رقم التسجيل الذي عُثر عليه في السجل يتداخل جزئيًا فقط مع الرقم المتوقع، مثل لاحقة فرع أو شركة تابعة. |
| `KYB_COMPANY_VAT_INVALID` | لا يوجد لدى السجل الضريبي الرسمي تسجيل نشط لرقم ضريبة القيمة المضافة أو الرقم الضريبي للشركة، أو أن رقم ضريبة القيمة المضافة لا يجتاز قواعد التنسيق ورقم التحقق الخاصة بدولته. يُطبَّق الإجراء المُهيَّأ `kyb_vat_invalid_action` (الافتراضي: قيد المراجعة). |
| `KYB_COMPANY_VAT_COULD_NOT_VALIDATE` | تعذر التحقق من رقم ضريبة القيمة المضافة أو الرقم الضريبي لأن السجل الضريبي الرسمي غير متاح مؤقتًا. يُطبَّق الإجراء المُهيَّأ `kyb_vat_unverified_action` (الافتراضي: بلا أثر). |
| `KYB_COMPANY_VAT_NAME_MISMATCH` | الاسم المسجل لدى السجل الرسمي لهذا الرقم يختلف عن اسم الشركة المُقدَّم. تحذير معلوماتي - يتضمن `registry_name` و`registry_source` و`submitted_name` في `additional_data`، بالإضافة إلى `vies_name` عندما يكون السجل هو VIES. |

تنطبق تحذيرات ضريبة القيمة المضافة حيثما أمكن التحقق من رقم ضريبة القيمة المضافة أو الرقم الضريبي للشركة. راجع [التحقق من رقم ضريبة القيمة المضافة والرقم الضريبي](https://docs.didit.me/ar/business-verification/company-data.md#التحقق-من-ضريبة-القيمة-المضافة-والرقم-الضريبي) للاطلاع على الدول والمصادر.

## تحذيرات مستندات KYB

تستخدم تحذيرات المستندات `feature: "KYB_DOCUMENTS"` وتظهر في `document_verifications[].warnings[]`.

| الوسم | الوصف |
| - | - |
| `KYB_DOCUMENT_MISSING_REQUIRED_FIELD` | لم يُعثر في المستند على حقل شركة مطلوب، مثل اسم الشركة أو رقم التسجيل. |
| `KYB_DOCUMENT_NAME_MISMATCH` | اسم الشركة في المستند لا يطابق سجل الشركات. |
| `KYB_DOCUMENT_REG_NUMBER_MISMATCH` | رقم التسجيل في المستند لا يطابق سجل الشركات. |
| `KYB_DOCUMENT_INCORPORATION_DATE_MISMATCH` | تاريخ التأسيس في المستند لا يطابق سجل الشركات. |
| `KYB_DOCUMENT_ADDRESS_MISMATCH` | العنوان المسجل في المستند لا يطابق سجل الشركات. |
| `KYB_CROSS_DOCUMENT_MISMATCH` | بيانات الشركة تختلف بين مستندات الشركة المرفوعة. |
| `KYB_DOCUMENT_METADATA_MISMATCH` | توقيع المستند أو بياناته الوصفية أو بنية ملفه تشير إلى مشكلة محتملة. |
| `KYB_ASSOCIATED_PARTY_MISMATCH` | المديرون أو المساهمون في المستند لا يطابقون سجل الشركات. |
| `KYB_DOCUMENT_GRAPHIC_EDITOR` | يبدو أن المستند عُولج ببرنامج تحرير رسومي. |
| `KYB_DOCUMENT_SUSPECTED_MANIPULATION` | رصد النظام مؤشرات على احتمال التلاعب بمستند الشركة. |
| `KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT` | مُسح حقل نصي في مستند الشركة وأُعيد كتابته بخط آخر، ولا يحتوي الملف على دليل يثبت ما إذا تغيّر محتواه. ويُرفع هذا التحذير أيضاً عندما لا يمكن فحص الملف كاملاً، مع ضبط `additional_data.detection_method` على `analysis_incomplete`، لأن الجزء غير المفحوص قد يحتوي على حقل من هذا النوع. ويتحكم فيه `kyb_document_unproven_text_replacement_action` (القيمة الافتراضية مراجعة)، وفي سير العمل الذي لا يتضمن مراجعة يُستخدم `kyb_document_tampering_action` الخاص به إذا كانت قيمته رفض، وإلا فالقيمة بدون إجراء. |
| `KYB_ADDITIONAL_DATA_NOT_FOUND` | تعذّر التحقق من حقل في المستند لأن بيانات السجل المقابلة غير متاحة. |
| `KYB_DOCUMENT_EXPIRED` | يتجاوز مستند الشركة الحد الأقصى المهيأ لعمره. |
| `KYB_DOCUMENT_UNSUPPORTED_SUBTYPE` | النوع الفرعي للمستند المرفوع معطّل لسير العمل. |
| `KYB_DOCUMENT_MAX_ATTEMPTS_EXCEEDED` | تم تجاوز الحد الأقصى لمحاولات رفع مستندات الشركة. |

بالنسبة إلى التلاعب بالنص المتراكب في ملفات PDF، يمكن أن يتضمن `KYB_DOCUMENT_SUSPECTED_MANIPULATION` الحقل `additional_data.manipulated_regions`. يُرفع `KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT` عند مسح حقل نصي وإعادة كتابته بخط مختلف، وبالبنية نفسها للحقل `manipulated_regions`، ولا يُرفع `KYB_DOCUMENT_SUSPECTED_MANIPULATION` وحده أبداً، إذ إن محررات الإنترنت تعيد كتابة نص لم يتغير أيضاً، لذا لا يدل هذا التحذير على أن المحتوى تغيّر. وإذا رفعت إشارة أخرى `KYB_DOCUMENT_SUSPECTED_MANIPULATION` على المستند نفسه، فإن الإجراء الأشد صرامة بين الإجراءين هو الذي يحسم الأمر. هذه مستطيلات بإحداثيات الصفحة تحدد المناطق المشتبه في تعديلها، وهي تطابق المستطيلات المُعادة في `document_verifications[].items[].document_metadata.overlay_manipulation.manipulated_regions`.

## تحذيرات الأشخاص الرئيسيين في KYB

تستخدم تحذيرات الأشخاص الرئيسيين `feature: "KYB_KEY_PEOPLE"` وتظهر في `key_people_checks[].warnings[]`. تكشف هذه التحذيرات مشكلات على مستوى الأفراد لدى المديرين والمسؤولين والمستفيدين الحقيقيين (UBO) والأطراف التي يقدمها المستخدم.

| العلامة | الوصف |
| - | - |
| `KYB_PREVIOUSLY_DECLINED_INDIVIDUAL` | تم رفض شخص مرتبط بالشركة سابقاً في عملية تحقق أخرى من الشركات ضمن الطلب نفسه. |
| `KYB_KEY_PEOPLE_MISMATCH_WITH_DOCUMENTS` | المديرون أو المساهمون المصرَّح بهم في شاشة الأشخاص الرئيسيين لا يطابقون الأشخاص المذكورين في مستندات الشركة المرفوعة: شخص ورد في المستندات لم يُصرَّح به أبداً، أو اسم يكاد يطابق آخر، أو مساهم وارد في المستندات صُرِّح به دون دور ملكية، أو نسبة ملكية مصرَّح بها تناقض المستندات. يُطبَّق الإجراء المهيأ `kyb_key_people_document_mismatch_action` (الافتراضي: قيد المراجعة). |

> [!NOTE]
>
> **تُبلَّغ المطابقات مع الأشخاص المعرضين سياسياً (PEP) أو قوائم العقوبات لدى الأشخاص الرئيسيين** كنتائج AML قياسية على العنصر المطابق في `aml_screenings[]`، وليس كتحذير للأشخاص الرئيسيين في KYB. يطبّق فحص الأشخاص الرئيسيين الحالة الناتجة `Declined` أو `In Review` على كل طرف متأثر، بحيث يعكس الحكم العام للأشخاص الرئيسيين نتيجة فحص AML.

## تحذيرات الميزات المشتركة

يمكن أن تعمل الميزات أدناه داخل سير عمل KYB. وهي تستخدم كتالوج التحذيرات نفسه الذي تستخدمه التحقق من المستخدمين، والمرجع الكامل موجود في صفحة التحذيرات الخاصة بكل ميزة.

### AML

`feature: "AML"` على `aml_screenings[].warnings[]`.

| الوسم | الوصف |
| - | - |
| `POSSIBLE_MATCH_FOUND` | عثر فحص AML على تطابق محتمل يتطلب المراجعة. |
| `COULD_NOT_PERFORM_AML_SCREENING` | تعذّر على Didit إجراء فحص AML لأن بيانات الفحص المطلوبة مفقودة أو غير متاحة. |

### الهاتف

`feature: "PHONE"` على `phone_verifications[].warnings[]`.

| الوسم | الوصف |
| - | - |
| `DISPOSABLE_NUMBER_DETECTED` | رقم الهاتف مؤقت. |
| `VERIFICATION_CODE_ATTEMPTS_EXCEEDED` | تم تجاوز الحد الأقصى لمحاولات إدخال رمز التحقق. |
| `VOIP_NUMBER_DETECTED` | رقم الهاتف هو رقم VoIP. |
| `DUPLICATED_PHONE_NUMBER` | استُخدم رقم الهاتف في عملية تحقق أخرى. |
| `HIGH_RISK_PHONE_NUMBER` | رقم الهاتف عالي المخاطر. |
| `PHONE_NUMBER_IN_BLOCKLIST` | يطابق رقم الهاتف أحد الإدخالات في قائمة الحظر لديك. |

### البريد الإلكتروني

`feature: "EMAIL"` على `email_verifications[].warnings[]`.

| الوسم | الوصف |
| - | - |
| `BREACHED_EMAIL_DETECTED` | يظهر عنوان البريد الإلكتروني في تسريبات بيانات معروفة. |
| `DISPOSABLE_EMAIL_DETECTED` | عنوان البريد الإلكتروني مؤقت. |
| `UNDELIVERABLE_EMAIL_DETECTED` | عنوان البريد الإلكتروني غير قابل للتسليم. |
| `DUPLICATED_EMAIL` | استُخدم عنوان البريد الإلكتروني في عملية تحقق أخرى. |
| `EMAIL_IN_BLOCKLIST` | يطابق عنوان البريد الإلكتروني أحد الإدخالات في قائمة الحظر لديك. |
| `EMAIL_CODE_ATTEMPTS_EXCEEDED` | تم تجاوز الحد الأقصى لمحاولات إدخال رمز التحقق من البريد الإلكتروني. |

### الاستبيانات

`feature: "QUESTIONNAIRE"`.

| الوسم | الوصف |
| - | - |
| `CUSTOM_STATUS_RULE_TRIGGERED` | قامت قاعدة حالة في سير العمل بتقييم إجابة في الاستبيان وغيّرت حالة الميزة. |

### تحليل الجهاز وعنوان IP

`feature: "LOCATION"` على `ip_analyses[].warnings[]`.

| الوسم | الوصف |
| - | - |
| `COUNTRY_FROM_DOCUMENT_DOES_NOT_MATCH_COUNTRY_FROM_IP` | لا تتطابق دولة المستند مع دولة عنوان IP. |
| `PRIVATE_NETWORK_DETECTED` | تم رصد إشارة من شبكة خاصة أو VPN أو وكيل (proxy) أو Tor. |
| `EXPECTED_IP_ADDRESS_MISMATCH` | لا يتطابق عنوان IP مع عنوان IP المتوقع المقدَّم للجلسة. |
| `IP_ADDRESS_IN_BLOCKLIST` | يطابق عنوان IP أحد الإدخالات في قائمة الحظر لديك. |
| `DEVICE_FINGERPRINT_IN_BLOCKLIST` | تطابق بصمة الجهاز أحد الإدخالات في قائمة الحظر لديك. |
| `DUPLICATED_IP_ADDRESS` | استُخدم عنوان IP نفسه في عملية تحقق أخرى بقيمة `vendor_data` مختلفة. |
| `DUPLICATED_DEVICE_FINGERPRINT` | استُخدمت بصمة الجهاز نفسها في عملية تحقق أخرى بقيمة `vendor_data` مختلفة. |

## أمثلة

### السجل: الشركة غير نشطة

```json theme={null}
{
  "registry_checks": [
    {
      "node_id": "feature_kyb_registry",
      "status": "Declined",
      "warnings": [
        {
          "feature": "KYB_REGISTRY",
          "risk": "KYB_COMPANY_NOT_ACTIVE",
          "log_type": "error",
          "short_description": "Company is not active",
          "long_description": "The company is not active according to the registry.",
          "additional_data": null,
          "node_id": "feature_kyb_registry"
        }
      ]
    }
  ]
}
```

### المستندات: الاشتباه في التلاعب بالتراكب

```json theme={null}
{
  "document_verifications": [
    {
      "node_id": "feature_kyb_documents",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_DOCUMENTS",
          "risk": "KYB_DOCUMENT_SUSPECTED_MANIPULATION",
          "log_type": "warning",
          "short_description": "Possible document manipulation",
          "long_description": "The system detected signs of possible corporate-document manipulation.",
          "additional_data": {
            "manipulated_regions": [
              { "page": 1, "x": 120, "y": 240, "width": 180, "height": 22, "page_width": 612, "page_height": 792 }
            ]
          },
          "node_id": "feature_kyb_documents"
        }
      ]
    }
  ]
}
```

### الأشخاص الرئيسيون: فرد سبق رفضه

```json theme={null}
{
  "key_people_checks": [
    {
      "node_id": "feature_kyb_key_people",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_KEY_PEOPLE",
          "risk": "KYB_PREVIOUSLY_DECLINED_INDIVIDUAL",
          "log_type": "warning",
          "short_description": "Previously declined individual",
          "long_description": "A person associated with the company was previously declined in another business verification for the same application.",
          "additional_data": null,
          "node_id": "feature_kyb_key_people"
        }
      ]
    }
  ]
}
```

## ذات صلة

> [card] [مخطط الاستجابة](https://docs.didit.me/ar/business-verification/response-schema.md)
>
> اطّلع على المكان الذي تظهر فيه التحذيرات في مصفوفة كل ميزة من ميزات KYB.

> [card] [الحالات](https://docs.didit.me/ar/business-verification/statuses.md)
>
> اطّلع على كيفية تحويل شدة التحذير إلى حالة التحقق.

> [card] [المستندات](https://docs.didit.me/ar/business-verification/documents.md)
>
> راجع مجموعات المستندات وسلوك OCR والمطابقة المتقاطعة.

> [card] [الأشخاص الرئيسيون](https://docs.didit.me/ar/business-verification/key-people.md)
>
> تدفق التحقق من المسؤول وUBO والطرف المقدَّم.

> [card] [تقرير AML](https://docs.didit.me/ar/core-technology/aml-screening/report-aml-screening.md)
>
> البنية على مستوى المطابقات لفحوصات AML للشركات والأشخاص.

> [card] [نماذج البيانات المرجعية](https://docs.didit.me/ar/reference/data-models.md)
>
> الأشكال القياسية لتحذيرات ومصفوفات الميزات.


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