> ## 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: полный справочник

> Все коды document_subtype в отчёте верификации личности Didit, структура названий и определение коммерческих водительских прав.

Поле `document_subtype` в [отчёте о верификации личности](https://docs.didit.me/ru/core-technology/id-verification/report-id-verification.md) определяет конкретный вариант документа, распознанный Didit, — например, водительское удостоверение Квинсленда в отличие от общего водительского удостоверения, или коммерческое водительское удостоверение США (CDL) в отличие от стандартного. На этой странице перечислены все значения, которые может возвращать это поле.> [!NOTE]
>
> Ваш сценарий принимает только часть из них — то, что вы выбрали на шаге настройки документов в сценарии. Чтобы получить точный список разрешённых документов для вашего сценария, используйте endpoint получения сценария в 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/ru/core-technology/id-verification/report-id-verification.md) — поля `document_type` и `document_subtype` в контексте отчёта.
- [Поддерживаемые удостоверения личности](https://docs.didit.me/ru/core-technology/id-verification/supported-documents-id-verification.md) — страны и типы документов, поддерживаемые Didit.
- [Модели данных — верификация личности](https://docs.didit.me/ru/reference/data-models.md#верификация-личности) — каноническая схема полей.


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