> ## 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 코드 목록과 명명 규칙, 상업용 운전면허증 구분 방법을 확인하세요. [신분증 인증 보고서](https://docs.didit.me/ko/core-technology/id-verification/report-id-verification.md)의 `document_subtype`은 Didit이 인식한 구체적인 문서 변형을 식별합니다. 예를 들어 일반 운전면허증 대비 퀸즐랜드 운전면허증, 또는 표준 운전면허증 대비 미국 상업용 운전면허증(CDL) 등이 있습니다. 이 페이지에서는 해당 필드가 반환할 수 있는 모든 값을 나열합니다.> [!NOTE] > > 자체 워크플로에서는 워크플로의 문서 설정 단계에서 선택한 하위 집합만 허용됩니다. 아래의 모든 값이 활성화되어 있다고 가정하지 말고, Management API의 워크플로 조회 endpoint(OCR 노드의 `documents_allowed`)를 사용하여 워크플로에 허용된 정확한 목록을 확인하십시오.## 명명 패턴모든 `document_subtype` 값은 다음 두 가지 형태 중 하나입니다.- **기본 카테고리** — `{CATEGORY}` 형태로, Didit에서 지역별로 구분할 필요가 없는 문서(대부분의 여권, 대부분의 주민등록증/국가 신분증)에 사용됩니다(예: `PASSPORT_GENERIC`, `ID_CARD_GENERIC`). - **지역 접두사 포함** — `{REGION}_{CATEGORY}` 형태로, 주(state), 도/지방(province) 또는 영토(territory)에 따라 형식이나 분류가 실질적으로 다른 문서에 사용됩니다(예: 호주의 `QUEENSLAND_DRIVER_LICENSE_GENERIC` 또는 미국의 `CALIFORNIA_COMMERCIAL_DL`). 지역 접두사는 발급 주/도 이름을 대문자로 표기하고 공백을 밑줄로 대체한 형태입니다.문서는 Didit의 문서 레지스트리에 해당 지역에 대해 별도로 분류된 고유 변형이 있을 때만 지역 접두사가 붙은 하위 유형을 갖습니다. 지역 접두사가 붙은 변형이 없다고 해서 해당 지역에 해당 문서 유형이 존재하지 않는다는 의미는 아니며, Didit이 현재 이를 국가 수준의 기본 카테고리로 대신 보고한다는 의미입니다(구체적인 예는 아래의 CDL 관련 주의사항 참조).## 모든 하위 유형 값아래 표는 보고서가 반환할 수 있는 `document_subtype` 값의 전체 목록이며, `document_type` 패밀리별로 그룹화되어 있습니다. 여기에는 지역 접두사가 붙은 변형도 이미 포함되어 있습니다. 예를 들어 `DRIVER_LICENSE_GENERIC`(대부분의 국가)과 `CALIFORNIA_DRIVER_LICENSE_GENERIC`은 모두 Driver's License 아래에 별도의 행으로 표시됩니다.기본 카테고리 코드는 단일 국가에만 고유한 것이 아니며, 해당 문서의 레지스트리 항목에 지역별 변형이 없는 모든 국가에서 공유됩니다. 예를 들어 `ID_CARD_GENERIC`은 약 170개국의 국가 신분증을 포괄합니다. 코드가 단일 국가에 매핑된다고 가정하지 말고, 항상 `document_type` 그룹과 (존재하는 경우) 지역 접두사로 코드를 조회하십시오. \ \
document_subtype
## 미국 운전면허증: 표준 대 상업용(CDL)표준 운전면허증과 상업용 운전면허증(CDL) 모두 `document_type`은 `"Driver's License"`이며, 이를 구분하지 않습니다. 구별은 전적으로 `document_subtype`에서 이루어집니다.**Didit이 분류하는 51개 미국 주 및 영토 중 48개에서는 CDL에 해당 주의 `{STATE}_DRIVER_LICENSE_GENERIC`과 구분되는 고유한 `{STATE}_COMMERCIAL_DL` 하위 유형이 부여됩니다.** 해당 주에서는 `_COMMERCIAL_DL`로 끝나는 `document_subtype`을 "CDL 문서"로 취급하는 것이 신뢰할 수 있는 신호입니다.> [!WARNING] > > **알래스카, 컬럼비아 특별구(워싱턴 D.C.), 하와이에는 현재 별도의 CDL 하위 유형이 없습니다.** 이 세 관할권의 CDL은 해당 관할권의 표준 `_DRIVER_LICENSE_GENERIC` 하위 유형으로 보고되므로, `document_subtype`만으로는 비상업용 면허증과 구분할 수 없습니다. 이 세 관할권에 대해 특별히 빈틈없는 CDL 감지가 필요한 경우 [문의](mailto:support@didit.me)하여 누락된 문서 변형을 등록하거나 대역 외 통제 수단(예: 운전자가 검증을 위해 CDL/DOT 번호를 별도로 제공하도록 요구)을 적용하십시오. \ \ \ \ \
주 / 준주표준 DL 하위 유형상업용 운전면허(CDL) 하위 유형기타 하위 유형(학습자, 임시, 강화형, …)
### `extra_fields.dl_categories`는 신뢰할 수 있는 CDL 신호가 아닙니다일부 미국 면허증에서는 OCR을 통해 읽은 카드에 인쇄된 등급 문자(`A`, `B`, `C`, …) 목록인 `extra_fields.dl_categories`도 생성됩니다. **이를 CDL 신호로 사용하지 마십시오.** 현재 이 필드는 소수의 미국 운전면허증 구성에 대해서만 채워지며, 등급 문자의 의미는 주마다 다르고 상업용/비상업용 의미 체계로 표준화되어 있지 않습니다. 또한 배서 또는 제한 코드(많은 면허증에서 "상업용"이 실제로 표기되는 부분)는 현재 보고서에 전혀 노출되지 않습니다. 현재로서는 `document_subtype`만이 표준 면허와 상업용 면허를 구분할 수 있는, 구조화된 신뢰할 수 있는 유일한 신호입니다.## 최신 상태 유지하기새로운 `document_type` 패밀리는 출시될 때 월간 변경 로그를 통해 공지됩니다. 예를 들어 기존 문서 유형의 새로운 지역 변형과 같은 `document_subtype` 추가 사항은 현재 개별적으로 공지되지 않습니다. 새로운 문서 형식이 온보딩됨에 따라 Didit의 문서 레지스트리는 지속적으로 확장됩니다. 이 목록에 대해 webhook payload에 버전 번호는 제공되지 않습니다.연동 시스템에서 하위 유형 집합이 고정되어 있다고 가정하지 않고 이전에 본 적 없는 하위 유형을 감지해야 하는 경우, 코드에서 인식하지 못하는 모든 `document_subtype` 값을 오류로 처리하기보다는 "미분류, 수동 검토"로 처리하고 이 페이지나 Management API를 통해 워크플로의 허용 하위 유형 목록을 주기적으로 다시 확인하십시오.## 관련 항목- [신분증 인증 보고서](https://docs.didit.me/ko/core-technology/id-verification/report-id-verification.md) — 맥락에서의 `document_type` / `document_subtype` 필드. - [지원되는 신분증 문서](https://docs.didit.me/ko/core-technology/id-verification/supported-documents-id-verification.md) — Didit이 지원하는 국가 및 문서 유형. - [데이터 모델 — 신분증 인증](https://docs.didit.me/ko/reference/data-models.md#신분증-인증) — 표준 필드 스키마. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.