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

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

نظرة عامة

يتم إصدار التحذيرات في كل من جلسات سير العمل وعبر API المستقل (POST /v3/database-validation/). يتم وسم جميع المخاطر الخمسة بالميزة DATABASE_VALIDATION، وتظهر في التقرير ضمن database_validations[].warnings[]، وتتبع بنية كائن التحذير القياسية (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) — راجع طرق المطابقة للاطلاع على منطق اتخاذ القرار الكامل الذي يستنتج نتائج 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.

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

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

مثال

{
  "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"
    }
  ]
}

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

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

المصادقة

التحقق

المراقبة

المنصة

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

نظرة عامة

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

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

مثال

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

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

​نظرة عامة

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

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

​مثال

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

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

نظرة عامة

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

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

مثال

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

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