> ## 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のID認証レポートが返す全document_subtypeコードの一覧です。命名パターンの仕組みと、商用運転免許証を見分ける方法も解説します。

[本人確認レポート](https://docs.didit.me/ja/core-technology/id-verification/report-id-verification.md)の`document_subtype`は、Didit が認識した書類の具体的な種類を示します。たとえば、一般的な運転免許証ではなくクイーンズランド州の運転免許証であること、あるいは標準の運転免許証ではなく米国の商用運転免許証 (Commercial Driver's License) であることを識別します。このページでは、このフィールドが返す可能性のあるすべての値を列挙します。> [!NOTE]
>
> お使いのワークフローで受け付けるのは、これらのうちワークフローの書類設定ステップで選択したものだけです。以下のすべての値が有効になっていると想定せず、Management APIのワークフロー取得エンドポイント (OCRノードの`documents_allowed`) を使って、ワークフローで受け付ける正確なリストを取得してください。## 命名パターン`document_subtype`の値は、次の2つの形式のいずれかです。- **カテゴリのみ**: `{CATEGORY}`。Didit が地域ごとに区別する必要のない書類 (ほとんどのパスポート、ほとんどの国民IDカード) に使われます。例: `PASSPORT_GENERIC`、`ID_CARD_GENERIC`。
- **地域プレフィックス付き**: `{REGION}_{CATEGORY}`。州、省、準州によって書式や分類が実際に異なる書類に使われます。例: `QUEENSLAND_DRIVER_LICENSE_GENERIC` (オーストラリア)、`CALIFORNIA_COMMERCIAL_DL` (米国)。地域プレフィックスは発行元の州または省の名称を大文字にし、スペースをアンダースコアに置き換えたものです。書類に地域プレフィックス付きのサブタイプが割り当てられるのは、Didit の書類レジストリにその地域専用の、個別に分類されたバリアントが登録されている場合だけです。地域プレフィックス付きのバリアントがないことは、その地域にその書類タイプが存在しないことを意味しません。現時点では Didit が国レベルのカテゴリのみの値で報告していることを意味します (具体例は後述のCDLに関する注意点を参照してください)。## すべてのサブタイプの値以下の表は、レポートが返す可能性のある`document_subtype`の値をすべて列挙したもので、`document_type`のファミリーごとにグループ化しています。地域プレフィックス付きのバリアントもすでに含まれています。たとえば、Driver's Licenseの下には`DRIVER_LICENSE_GENERIC` (ほとんどの国) と`CALIFORNIA_DRIVER_LICENSE_GENERIC`の両方が別々の行として表示されます。カテゴリのみのコードは1つの国に固有のものではありません。その書類のレジストリエントリに地域固有のバリアントがないすべての国で共有されます。たとえば`ID_CARD_GENERIC`は、約170か国の国民IDカードを対象としています。コードは必ず`document_type`のグループと (ある場合は) 地域プレフィックスで照合し、1つのコードが1つの国に対応すると決して想定しないでください。

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

## 米国の運転免許証 標準免許と商用免許 (CDL)`document_type`は、標準の運転免許証と商用運転免許証 (CDL) のどちらでも`"Driver's License"`となり、両者を区別することはありません。区別は`document_subtype`だけで行われます。**Didit が分類する米国の51の州および地域のうち48では、CDLにその州の`{STATE}_DRIVER_LICENSE_GENERIC`とは別の`{STATE}_COMMERCIAL_DL`サブタイプが割り当てられます。** これらの州では、`document_subtype`が`_COMMERCIAL_DL`で終わることを「CDLである」と判断する信頼できるシグナルとして扱えます。> [!WARNING]
>
> **アラスカ州、コロンビア特別区、ハワイ州には、現時点でCDL専用のサブタイプがありません。** これら3つの管轄区域で発行されたCDLは、その管轄区域の標準の`_DRIVER_LICENSE_GENERIC`サブタイプで報告されるため、`document_subtype`だけでは商用ではない免許証と区別できません。これら3つの管轄区域について確実な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 の書類レジストリは、新しい書類形式が追加されるにつれて継続的に拡大しています。このリストについて、Webhookペイロードにバージョン番号はありません。連携でこれまでに見たことのないサブタイプを検出する必要がある場合は、値のセットが固定されていると想定せず、コードが認識しない`document_subtype`の値をエラーにするのではなく「未分類、手動でレビュー」として扱ってください。また、このページ、またはManagement APIを使用してワークフローで受け付けるサブタイプのリストを定期的に確認してください。## 関連情報- [本人確認レポート](https://docs.didit.me/ja/core-technology/id-verification/report-id-verification.md): `document_type`/`document_subtype`フィールドの使われ方。
- [対応している本人確認書類](https://docs.didit.me/ja/core-technology/id-verification/supported-documents-id-verification.md): Didit が対応している国と書類タイプ。
- [データモデル: 本人確認](https://docs.didit.me/ja/reference/data-models.md#本人確認): 標準フィールドスキーマ。


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