Vai al contenuto principale
document_subtype nel report di verifica dell’identità 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.
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 denominazione

Ogni 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 sottotipi

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

​
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.
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 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).

​
extra_fields.dl_categories non è un segnale CDL affidabile

Alcune 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 sincronizzati

Le 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

Ultima modifica il 7 novembre 2026