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

# مرجع document_subtype: القائمة الكاملة للأكواد

> توفر Didit دليلاً شاملاً لأكواد document_subtype في تقرير التحقق من الهوية، يوضح نمط التسمية وكيفية تمييز رخص القيادة التجارية.

يحدد الحقل `document_subtype` في [تقرير التحقق من الهوية](https://docs.didit.me/ar/core-technology/id-verification/report-id-verification.md) نسخة المستند المحددة التي تعرفت عليها Didit — على سبيل المثال رخصة قيادة كوينزلاند مقابل رخصة قيادة عامة، أو رخصة قيادة تجارية أمريكية (CDL) مقابل رخصة قيادة قياسية. تسرد هذه الصفحة كل قيمة يمكن أن يعيدها هذا الحقل.> [!NOTE]
>
> يقبل سير العمل الخاص بك مجموعة فرعية فقط من هذه القيم — بحسب ما حددته في خطوة إعدادات المستندات في سير العمل. يمكنك استرداد القائمة المقبولة الدقيقة لسير العمل الخاص بك عبر 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` الخاص به وبادئة المنطقة (عند وجودها)، وتجنب تماماً افتراض أن الرمز يشير إلى دولة واحدة فقط.

\<table><thead><tr><th>document_subtype</th></tr></thead>
        \<tbody /></table>

## رخص القيادة الأمريكية: القياسية مقابل التجارية (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" مؤشراً موثوقاً في تلك الولايات.> [!WARNING]
>
> **لا تمتلك ألاسكا وواشنطن العاصمة وهاواي حالياً نوعاً فرعياً مميزاً لرخص CDL.** يتم الإبلاغ عن رخصة CDL الصادرة عن إحدى هذه المناطق القضائية الثلاث تحت النوع الفرعي القياسي `_DRIVER_LICENSE_GENERIC` لتلك المنطقة — مما يجعل من المتعذر تمييزها عن الرخصة غير التجارية من خلال `document_subtype` بمفرده. إذا كنت بحاجة إلى كشف محكم لرخص CDL لهذه المناطق القضائية الثلاث تحديداً، [تواصل معنا](mailto:support@didit.me) لتسجيل أنواع المستندات المفقودة، أو طبّق إجراءً خارج النطاق (على سبيل المثال، مطالبة السائق بتقديم رقم CDL/DOT الخاص به بشكل منفصل للتحقق).

\<table><thead><tr><th>الولاية / الإقليم</th>
            \<th>النوع الفرعي لرخصة القيادة القياسية</th>
            \<th>النوع الفرعي لرخصة القيادة التجارية (CDL)</th>
            \<th>أنواع فرعية أخرى (متعلم، مؤقت، معزز، …)</th></tr></thead>
        \<tbody /></table>

### لا يُعد `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.## مواضيع ذات صلة- [تقرير التحقق من الهوية](https://docs.didit.me/ar/core-technology/id-verification/report-id-verification.md) — حقلا `document_type` و`document_subtype` في سياق الاستخدام.
- [مستندات الهوية المدعومة](https://docs.didit.me/ar/core-technology/id-verification/supported-documents-id-verification.md) — الدول وأنواع المستندات التي تدعمها Didit.
- [نماذج البيانات — التحقق من الهوية](https://docs.didit.me/ar/reference/data-models.md#التحقق-من-الهوية) — مخطط الحقول القياسي.


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