> ## 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: Elenco completo dei codici

> Didit elenca tutti i codici document_subtype nei report di verifica dell'identità, spiegando la nomenclatura e le patenti commerciali.

`document_subtype` nel [report di verifica dell'identità](https://docs.didit.me/it/core-technology/id-verification/report-id-verification.md) identifica la variante specifica del documento riconosciuta da Didit — ad esempio una patente di guida del Queensland rispetto a una patente generica, oppure una patente commerciale statunitense (Commercial Driver's License o CDL) rispetto a una standard. Questa pagina elenca tutti i valori che il campo può restituire.> [!NOTE]
>
> Il tuo workflow accetta solo un sottoinsieme di questi valori — quelli che hai selezionato nel passaggio di impostazione dei documenti del workflow. Recupera l'elenco esatto dei documenti accettati per il tuo workflow tramite l'endpoint di recupero del workflow della Management API (`documents_allowed` sul nodo OCR), anziché presumere che tutti i valori indicati di seguito siano abilitati per te.## Schema di denominazioneOgni valore di `document_subtype` segue uno dei due seguenti formati:- **Categoria base** — `{CATEGORY}`, per i documenti che Didit non ha bisogno di distinguere per regione (la maggior parte dei passaporti e delle carte d'identità), ad esempio `PASSPORT_GENERIC`, `ID_CARD_GENERIC`.
- **Con prefisso regionale** — `{REGION}_{CATEGORY}`, per i documenti il cui formato o classificazione varia effettivamente a seconda dello stato, della provincia o del territorio, ad esempio `QUEENSLAND_DRIVER_LICENSE_GENERIC` (Australia) o `CALIFORNIA_COMMERCIAL_DL` (Stati Uniti). Il prefisso regionale è il nome dello stato/provincia di emissione in lettere maiuscole, con gli spazi sostituiti da trattini bassi.Un documento riceve un sottotipo con prefisso regionale solo se il registro dei documenti di Didit include una variante distinta e classificata separatamente per quella regione. L'assenza di una variante con prefisso regionale non significa che quel tipo di documento non esista in tale regione — significa semplicemente che al momento Didit lo segnala nella categoria base a livello nazionale (consulta l'avvertenza sulle CDL riportata sotto per un esempio concreto).## Tutti i valori dei sottotipiLa tabella seguente è l'elenco completo dei valori di `document_subtype` che il report può restituire, raggruppati per la famiglia di `document_type`. Include già le varianti con prefisso regionale — ad esempio, sia `DRIVER_LICENSE_GENERIC` (maggior parte dei paesi) sia `CALIFORNIA_DRIVER_LICENSE_GENERIC` appaiono come righe distinte sotto Patente di guida.Un codice di categoria base non è univoco per un solo paese — è condiviso da tutti i paesi la cui voce di registro per quel documento non ha una variante specifica per regione. Ad esempio, `ID_CARD_GENERIC` copre le carte d'identità nazionali di circa 170 paesi. Ricerca un codice solo in base al relativo raggruppamento `document_type` e (se presente) al suo prefisso regionale, senza mai presumere che un codice corrisponda a un singolo paese.

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

## Patenti di guida statunitensi: standard vs. commerciali (CDL)`document_type` è `"Driver's License"` sia per una patente standard sia per una Commercial Driver's License (CDL) — non le distingue mai. La distinzione è interamente presente in `document_subtype`.**In 48 dei 51 stati e territori statunitensi classificati da Didit, una CDL riceve il proprio sottotipo `{STATE}_COMMERCIAL_DL`, distinto dal `{STATE}_DRIVER_LICENSE_GENERIC` di quello stato.** Considerare un `document_subtype` che termina con `_COMMERCIAL_DL` come indicatore di "questa è una CDL" rappresenta un segnale affidabile in quegli stati.> [!WARNING]
>
> **Al momento, l'Alaska, il Distretto di Columbia e le Hawaii non dispongono di un sottotipo CDL distinto.** Una CDL rilasciata da una di queste tre giurisdizioni viene segnalata con il sottotipo standard `_DRIVER_LICENSE_GENERIC` di tale giurisdizione — risultando indistinguibile da una patente non commerciale solo tramite `document_subtype`. Se hai bisogno di un rilevamento CDL infallibile specificamente per queste tre giurisdizioni, [contattaci](mailto:support@didit.me) per registrare le varianti di documento mancanti, oppure applica un controllo fuori banda (ad esempio richiedendo al conducente di fornire separatamente il proprio numero CDL/DOT per la verifica).

\<table><thead><tr><th>Stato / territorio</th>
            \<th>Sottotipo DL standard</th>
            \<th>Sottotipo di patente commerciale (CDL)</th>
            \<th>Altri sottotipi (principiante, provvisorio, avanzato, …)</th></tr></thead>
        \<tbody /></table>

### `extra_fields.dl_categories` non è un segnale CDL affidabileAlcune patenti statunitensi producono anche `extra_fields.dl_categories` — un elenco delle lettere di classe (`A`, `B`, `C`, …) stampate sulla tessera, lette tramite OCR. **Non utilizzare questo campo come segnale per le CDL.** Attualmente questo campo viene compilato solo per una minima parte delle configurazioni di patenti di guida statunitensi; il significato delle lettere di classe varia a seconda dello stato e non è standardizzato per distinguere tra uso commerciale e non commerciale, mentre i codici di abilitazione o di restrizione (dove la dicitura "commerciale" è effettivamente indicata su molte patenti) non sono attualmente esposti nel report. Al momento `document_subtype` è l'unico segnale strutturato e affidabile per distinguere tra patente standard e commerciale.## Rimanere sincronizzatiLe nuove famiglie di `document_type` vengono annunciate nel changelog mensile al momento del rilascio. Le aggiunte di `document_subtype` — come una nuova variante regionale di un tipo di documento esistente — non vengono attualmente annunciate singolarmente; il registro dei documenti di Didit cresce costantemente man mano che vengono integrati nuovi formati di documenti. Non esiste un numero di versione nel payload del webhook per questo elenco.Se la tua integrazione deve rilevare un sottotipo mai visto prima anziché presumere che il set sia fisso, tratta qualsiasi valore di `document_subtype` che il tuo codice non riconosce come "non classificato, revisione manuale" invece di generare un errore, e ricontrolla periodicamente questa pagina o l'elenco dei sottotipi accettati dal tuo workflow tramite la Management API.## Risorse correlate- [Report di verifica dell'identità](https://docs.didit.me/it/core-technology/id-verification/report-id-verification.md) — i campi `document_type` / `document_subtype` nel contesto.
- [Documenti d'identità supportati](https://docs.didit.me/it/core-technology/id-verification/supported-documents-id-verification.md) — paesi e tipi di documenti supportati da Didit.
- [Modelli di dati — Verifica dell'identità](https://docs.didit.me/it/reference/data-models.md#verifica-dell’identità) — schema canonico dei campi.


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