الانتقال إلى المحتوى الرئيسي
يحدد الحقل document_subtype في تقرير التحقق من الهوية نسخة المستند المحددة التي تعرفت عليها Didit — على سبيل المثال رخصة قيادة كوينزلاند مقابل رخصة قيادة عامة، أو رخصة قيادة تجارية أمريكية (CDL) مقابل رخصة قيادة قياسية. تسرد هذه الصفحة كل قيمة يمكن أن يعيدها هذا الحقل.
يقبل سير العمل الخاص بك مجموعة فرعية فقط من هذه القيم — بحسب ما حددته في خطوة إعدادات المستندات في سير العمل. يمكنك استرداد القائمة المقبولة الدقيقة لسير العمل الخاص بك عبر endpoint استرداد سير العمل workflow-retrieve في Management API (الحقل documents_allowed في عقدة OCR) بدلاً من افتراض تفعيل جميع القيم الموضحة أدناه لديك.

​
نمط التسمية

تأتي كل قيمة في document_subtype بأحد شكلين:
  • فئة مجردة — {CATEGORY}، للمستندات التي لا تحتاج Didit إلى تمييزها حسب المنطقة (معظم جوازات السفر، ومعظم بطاقات الهوية الوطنية)، على سبيل المثال PASSPORT_GENERIC وID_CARD_GENERIC.
  • مسبوقة بالمنطقة — {REGION}_{CATEGORY}، للمستندات التي يختلف تنسيقها أو تصنيفها فعلياً حسب الولاية أو المقاطعة أو الإقليم، على سبيل المثال QUEENSLAND_DRIVER_LICENSE_GENERIC (أستراليا) أو CALIFORNIA_COMMERCIAL_DL (الولايات المتحدة). بادئة المنطقة هي اسم الولاية/المقاطعة المصدرة بأحرف كبيرة مع استبدال المسافات بشرطات سفلية.
لا يحصل المستند على نوع فرعي مسبوق بالمنطقة إلا عندما يتضمن سجل مستندات Didit نوعاً مميزاً ومصنفاً بشكل منفصل لتلك المنطقة. ولا يعني غياب نوع مسبوق بالمنطقة أن نوع المستند غير موجود في تلك المنطقة — بل يعني أن Didit تبلّغ عنه حالياً ضمن الفئة المجردة على مستوى الدولة بدلاً من ذلك (راجع التنبيه الخاص برخص القيادة التجارية CDL أدناه للاطلاع على مثال ملموس).

​
جميع قيم الأنواع الفرعية

الجدول أدناه هو الحصر الكامل لقيم document_subtype التي يمكن للتقرير إعادتها، مجمعة حسب عائلة document_type. يتضمن الجدول بالفعل الأنواع المسبوقة بالمنطقة — على سبيل المثال، يظهر كل من DRIVER_LICENSE_GENERIC (معظم الدول) وCALIFORNIA_DRIVER_LICENSE_GENERIC كصفوف متميزة تحت رخصة القيادة. الرمز الخاص بالفئة المجردة ليس فريداً لدولة واحدة — بل تتشاركه جميع الدول التي لا تحتوي مدخلات سجلها لهذا المستند على نوع خاص بالمنطقة. على سبيل المثال، يغطي ID_CARD_GENERIC بطاقات الهوية الوطنية لنحو 170 دولة. ابحث عن الرمز فقط من خلال تجميع document_type الخاص به وبادئة المنطقة (عند وجودها)، وتجنب تماماً افتراض أن الرمز يشير إلى دولة واحدة فقط.

​
رخص القيادة الأمريكية: القياسية مقابل التجارية (CDL)

تكون قيمة document_type هي "Driver's License" لكل من رخصة القيادة القياسية ورخصة القيادة التجارية (CDL) — ولا تفرّق بينهما على الإطلاق. يكمن التمييز بالكامل في document_subtype. في 48 من أصل 51 ولاية وإقليماً أمريكياً تصنفها Didit، تحصل رخصة CDL على نوع فرعي خاص بها بصيغة {STATE}_COMMERCIAL_DL، وهو مميز عن {STATE}_DRIVER_LICENSE_GENERIC لتلك الولاية. ويُعد التعامل مع document_subtype المنتهي بـ _COMMERCIAL_DL على أنه “هذه رخصة CDL” مؤشراً موثوقاً في تلك الولايات.
لا تمتلك ألاسكا وواشنطن العاصمة وهاواي حالياً نوعاً فرعياً مميزاً لرخص CDL. يتم الإبلاغ عن رخصة CDL الصادرة عن إحدى هذه المناطق القضائية الثلاث تحت النوع الفرعي القياسي _DRIVER_LICENSE_GENERIC لتلك المنطقة — مما يجعل من المتعذر تمييزها عن الرخصة غير التجارية من خلال document_subtype بمفرده. إذا كنت بحاجة إلى كشف محكم لرخص CDL لهذه المناطق القضائية الثلاث تحديداً، تواصل معنا لتسجيل أنواع المستندات المفقودة، أو طبّق إجراءً خارج النطاق (على سبيل المثال، مطالبة السائق بتقديم رقم CDL/DOT الخاص به بشكل منفصل للتحقق).

​
لا يُعد extra_fields.dl_categories مؤشراً موثوقاً لرخص CDL

تُنتج بعض الرخص الأمريكية أيضاً الحقل extra_fields.dl_categories — وهو قائمة بأحرف الفئات (A، B، C، …) المطبوعة على البطاقة، والمقروءة عبر OCR. لا تستخدم هذا الحقل كمؤشر لرخص CDL. حالياً، تتم تعبئة هذا الحقل لنسبة ضئيلة فقط من تهيئات رخص القيادة الأمريكية، وتختلف معاني أحرف الفئات باختلاف الولاية ولا يتم توحيدها وفق دلالات تجارية/غير تجارية، كما أن رموز التأييد أو التقييد (وهي الرموز التي يُشار فيها فعلياً إلى كون الرخصة “تجارية” في العديد من الرخص) لا تظهر في التقرير على الإطلاق في الوقت الحالي. ويظل document_subtype هو المؤشر المهيكل والموثوق الوحيد للتمييز بين الرخصة القياسية والتجارية اليوم.

​
البقاء على اطلاع بالتحديثات

يتم الإعلان عن عائلات document_type الجديدة في سجل التغييرات الشهري عند إطلاقها. أما إضافات document_subtype — مثل نوع فرعي إقليمي جديد لنوع مستند حالي — فلا يتم الإعلان عنها بشكل فردي في الوقت الحالي؛ حيث ينمو سجل مستندات Didit باستمرار مع إضافة تنسيقات مستندات جديدة. ولا يوجد رقم إصدار في payload الخاص بـ webhook لهذه القائمة. إذا كان التكامل الخاص بك بحاجة إلى كشف نوع فرعي لم يسبق له التعامل معه بدلاً من افتراض ثبات المجموعة، فتعامل مع أي قيمة document_subtype لا يتعرف عليها الكود البرمجي لديك كـ “غير مصنفة، تتطلب مراجعة يدوية” بدلاً من إرجاع خطأ، وأعد فحص هذه الصفحة دورياً أو فحص قائمة الأنواع الفرعية المقبولة لسير العمل الخاص بك عبر Management API.

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

آخر تعديل في ٧ نوفمبر ٢٠٢٦