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

# تحذيرات التحقق من قواعد البيانات ورموز التخطي

> مرجع Didit لتحذيرات التحقق من قواعد البيانات: COULD_NOT_PERFORM_DATABASE_VALIDATION، والتطابق الجزئي أو المنعدم، وتعذر الوصول إلى السجل، والحقول المفقودة.

تتحقق ميزة [التحقق من قواعد البيانات](https://docs.didit.me/ar/core-technology/database-validation/overview.md) في Didit من بيانات الهوية مقابل السجلات المدنية الرسمية المعتمدة — RENAPER (الأرجنتين)، وReceita Federal (البرازيل)، وTribunal Electoral (بنما، بيومتري)، وJunta Central Electoral (جمهورية الدومينيكان)، وغيرها — وتتم الفوترة لكل استعلام ناجح دون حد أدنى شهري.

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

## نظرة عامة

يتم إصدار التحذيرات في كل من جلسات سير العمل وعبر API المستقل (`POST /v3/database-validation/`). يتم وسم جميع المخاطر الخمسة بالميزة `DATABASE_VALIDATION`، وتظهر في التقرير ضمن `database_validations[].warnings[]`، وتتبع بنية [كائن التحذير](https://docs.didit.me/ar/reference/data-models.md#كائن-التحذير) القياسية (`feature` و`risk` و`additional_data` و`log_type` و`short_description` و`long_description` و`node_id`).

لا توجد مشغّلات ثابتة للرفض التلقائي في التحقق من قواعد البيانات. يتم تعيين الخطرين المرتبطين بنتيجة التطابق وخطر المستند المُستبدل وخطر عدم الانطباق إلى **إجراء قابل للتكوين** (`DECLINE` أو `REVIEW` أو `NO_ACTION`)؛ بينما يُعد `COULD_NOT_PERFORM_DATABASE_VALIDATION` السلوك الثابت الوحيد — إذ يوجّه الميزة دائمًا إلى حالة **قيد المراجعة**.

## المخاطر القابلة للتكوين

| الإعداد | رمز الخطر | السلوك |
| - | - | - |
| إجراء عدم التطابق | `DATABASE_VALIDATION_NO_MATCH` | `REVIEW` (الافتراضي في سير العمل) يضبط الميزة على **قيد المراجعة**؛ `DECLINE` يرفض؛ `NO_ACTION` يسجل التحذير دون التأثير على الحالة. بينما تكون القيمة الافتراضية للمعامل `no_match_action` في API المستقل هي `DECLINE` بدلًا من ذلك. |
| إجراء التطابق الجزئي | `DATABASE_VALIDATION_PARTIAL_MATCH` | `NO_ACTION` (الافتراضي) يسجل التحذير دون التأثير على الحالة؛ `REVIEW` يضبط الميزة على **قيد المراجعة**؛ `DECLINE` يرفض. |
| إجراء عدم التطابق | `DATABASE_VALIDATION_DOCUMENT_SUPERSEDED` | يشترك في إعداد **إجراء عدم التطابق** — ولا يوجد خيار منفصل له. لقد تعارض السجل مع ما تم تقديمه، لذا فإن المؤسسة التي ترفض عند عدم التطابق ترفض أيضًا بيانات الاعتماد المتقادمة. |
| إجراء عدم الانطباق | `DATABASE_VALIDATION_NOT_APPLICABLE` | `NO_ACTION` (الافتراضي) يسجل التحذير دون التأثير على الحالة؛ `REVIEW` يضبط الميزة على **قيد المراجعة**؛ `DECLINE` يرفض. يتم تشغيله عندما يتعذر فحص المستند على الإطلاق — فهو لا يحمل المعرّف الذي تستعلم الخدمات المكوّنة باستخدامه (على سبيل المثال، جواز سفر لا يحتوي على رقم الهوية الوطنية). |

يتحكم الإجراء الذي تم تكوينه أيضًا في `log_type` الخاص بالتحذير: `DECLINE` → `error`، و`REVIEW` → `warning`، و`NO_ACTION` → `information`.

يتم تجميع نتيجة التطابق نفسها من مدخلات `validation` الخاصة بكل خدمة (أي تطابق كامل → `full_match`؛ وإلا أي تطابق جزئي → `partial_match`؛ وإلا `no_match`) — راجع [طرق المطابقة](https://docs.didit.me/ar/core-technology/database-validation/database-validation-matching-methods.md) للاطلاع على منطق اتخاذ القرار الكامل الذي يستنتج نتائج 1×1 / 2×2.

## التحذيرات الناتجة

| العلامة | الوصف القصير | الوصف |
| - | - | - |
| `COULD_NOT_PERFORM_DATABASE_VALIDATION` | تعذر إجراء التحقق من قواعد البيانات | لم تُعد أي خدمة نتيجة قابلة للاستخدام (يظل `match_type` بقيمة `null`) — يحدث هذا عادةً بسبب نقص الحقول المطلوبة أو كونها ذات تنسيق غير صالح، أو لأن السجل أعاد خطأً. يحمل `additional_data` ملخص التخطي لكل خدمة (`reason`، و`database_validation_errors`، و`missing_required_fields_by_service`، و`invalid_format_fields_by_service`، و`field_reasons_by_service`)؛ بينما تستخدم API المستقلة `{ "validation_errors": [...] }` بدلاً من ذلك. **لن يتم تحصيل رسوم منك** عند إطلاق هذا التحذير؛ وتنتقل الميزة إلى **قيد المراجعة** حتى تصحيح البيانات. |
| `DATABASE_VALIDATION_NOT_APPLICABLE` | التحقق من قواعد البيانات غير قابل للتطبيق على هذا المستند | لا يحمل المستند المقدّم المعرّف الذي تتطلبه خدمة (أو خدمات) قاعدة البيانات التي تم تكوينها (يظل `match_type` بقيمة `null`) — على سبيل المثال، لا يحمل جواز السفر البرازيلي رقم CPF، ومن ثمّ لا يمكن الاستعلام من سجل CPF. هذا أمر متوقع لهذا النوع من المستندات ولا يشير إلى وجود مشكلة في المستند. يحمل `additional_data` ملخص التخطي لكل خدمة. **لن يتم تحصيل رسوم منك** عند إطلاق هذا التحذير. الإجراء قابل للتكوين (الافتراضي هو `NO_ACTION`). |
| `DATABASE_VALIDATION_PARTIAL_MATCH` | تطابق جزئي في التحقق من قواعد البيانات | القيمة الإجمالية لـ `match_type` هي `partial_match` — تطابقت بعض الحقول المفحوصة مع السجل دون غيرها. الإجراء قابل للتكوين (الافتراضي هو `NO_ACTION`). |
| `DATABASE_VALIDATION_NO_MATCH` | عدم وجود تطابق في التحقق من قواعد البيانات | القيمة الإجمالية لـ `match_type` هي `no_match` — تعذر على السجل تأكيد الهوية المفحوصة. الإجراء قابل للتكوين (الافتراضي هو `REVIEW` في مسارات سير العمل، و`DECLINE` في API المستقلة). |
| `DATABASE_VALIDATION_DOCUMENT_SUPERSEDED` | إصدار مستند مستبدَل | أعادت إحدى الخدمات `DOCUMENT_SUPERSEDED`: أكد السجل هوية الشخص، لكن إصدار المستند المقدّم ليس هو الإصدار المسجل في الملف — إذ صدر إصدار أحدث منذ ذلك الحين. يتم إطلاقه بصرف النظر عن قيمة `match_type`، التي تظل `full_match` لأن جميع الحقول الشخصية قد تطابقت، وبخلاف ذلك كانت هذه النتيجة ستظل غير ظاهرة. يحدد `additional_data` الخدمات التي أبلغت عن ذلك. يخضع لإعداد **No Match Action**. |

> [!NOTE]
>
> يغطي `COULD_NOT_PERFORM_DATABASE_VALIDATION` حالتين مختلفتين، ويوضح `long_description` الخاص بالتحذير (وكذلك `database_validation_errors[].message` في حالة الفشل لكل خدمة) الآن أي الحالتين قد انطبقت بدلاً من عرض جملة عامة واحدة: إما أن البيانات المفحوصة كانت مفقودة أو غير صالحة قبل إمكانية الاستعلام من أي خدمة، أو تم الاستعلام من الخدمة ولم تُعد نتيجة قابلة للاستخدام. في الحالة الثانية، عندما يبلّغ السجل عن تفاصيل تشخيصية خاصة به لتلك المحاولة، يتم تضمين هذه التفاصيل في الرسالة حتى لا تضطر إلى التواصل مع الدعم لمعرفة السبب. لا يُذكر اسم الخدمة التي جرى الاستعلام منها في الاستجابة مطلقاً.

> [!NOTE]
>
> عند إطلاق `COULD_NOT_PERFORM_DATABASE_VALIDATION` أو `DATABASE_VALIDATION_NOT_APPLICABLE` في جلسة سير عمل، يُعاد تشغيل التحقق تلقائياً بمجرد إدخال البيانات المفقودة في صفحة تفاصيل الجلسة في Console — حيث يؤدي حفظ الحقل إلى إعادة تشغيل التحقق، ويُزال التحذير عند النجاح. يعمل هذا أيضاً عندما يؤدي إجراء عدم قابلية التطبيق إلى رفض الجلسة، وبذلك يمكن معالجة الجلسة المرفوضة عن طريق تصحيح البيانات. بالنسبة إلى `DATABASE_VALIDATION_NOT_APPLICABLE`، تفيد إعادة التشغيل عندما يمكن للمستند أن يحمل المعرّف ولكن لم تتم قراءته (على سبيل المثال، بطاقة إقامة لم يُستخرج منها رقم الهوية الوطنية)؛ بينما تحتفظ أنواع المستندات التي لا تحمل المعرّف مطلقاً (على سبيل المثال، جوازات السفر الخالية من رقم الهوية الوطنية) بالتحذير. **لا تُفرض رسوم** على الخدمات التي تم تخطيها؛ ولن تدفع إلا عندما تُعيد الخدمة نتيجة قابلة للفوترة.

## مثال

```json theme={null}
{
  "warnings": [
    {
      "feature": "DATABASE_VALIDATION",
      "risk": "DATABASE_VALIDATION_NO_MATCH",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Database validation no match",
      "long_description": "The system identified a no match in the database validation, requiring further investigation.",
      "node_id": "feature_db_validation_1"
    }
  ]
}
```

## أنواع التحذيرات

يتم تعيين مستوى خطورة لكل خطر بناءً على تكوين تطبيقك. تندرج مستويات الخطورة تحت ثلاث فئات:

## مواضيع ذات صلة

* [نظرة عامة على التحقق من قواعد البيانات](https://docs.didit.me/ar/core-technology/database-validation/overview.md) — كيفية عمل الميزة بالكامل من البداية إلى النهاية والسجلات المدعومة.
* [تقرير التحقق من قواعد البيانات](https://docs.didit.me/ar/core-technology/database-validation/database-validation-report.md) — شكل الاستجابة الكامل بما في ذلك `validations[]` لكل خدمة.
* [طرق المطابقة](https://docs.didit.me/ar/core-technology/database-validation/database-validation-matching-methods.md) — كيفية استنتاج نتائج 1×1 / 2×2 (`validation_type: one_by_one` / `two_by_two`) من مطابقات كل خدمة.
* [رموز النتائج](https://docs.didit.me/ar/core-technology/database-validation/database-validation-outcome-codes.md) — التصنيف الكامل لكل نتيجة مع رموز التفاصيل الخاصة بكل دولة.
* [الدول والخدمات المدعومة](https://docs.didit.me/ar/core-technology/database-validation/database-validation-supported-countries.md) — كل سجل قيد التشغيل، والحقول المطلوبة، وسعر كل استدعاء.
* [نماذج البيانات — التحقق من قواعد البيانات](https://docs.didit.me/ar/reference/data-models.md#التحقق-من-قواعد-البيانات) — المخطط القياسي لكل حقل.


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