Saltar al contingut principal
El camp document_subtype de l’informe de verificació d’identitat identifica la variant de document específica que Didit ha reconegut; per exemple, un permís de conduir de Queensland en comparació amb un permís de conduir genèric, o un permís de conduir comercial dels EUA (CDL) en comparació amb un d’estàndard. Aquesta pàgina enumera tots els valors que pot retornar el camp.
El teu propi flux de treball només admet un subconjunt d’aquests valors: el que hagis seleccionat al pas de configuració de documents del flux de treball. Recupera la llista exacta admesa per al teu flux de treball amb l’endpoint de recuperació de fluxos de treball de la Management API (documents_allowed al node d’OCR) en lloc d’assumir que tots els valors següents estan activats per a tu.

​
Patró de nomenclatura

Cada valor de document_subtype té una d’aquestes dues formes:
  • Categoria simple — {CATEGORY}, per a documents que Didit no necessita distingir per regió (la majoria de passaports, la majoria de documents d’identitat nacionals), com ara PASSPORT_GENERIC, ID_CARD_GENERIC.
  • Amb prefix de regió — {REGION}_{CATEGORY}, per a documents el format o la classificació dels quals varia realment segons l’estat, la província o el territori, com ara QUEENSLAND_DRIVER_LICENSE_GENERIC (Austràlia) o CALIFORNIA_COMMERCIAL_DL (Estats Units). El prefix de regió és el nom de l’estat emissor o de la província emissora en majúscules i amb els espais substituïts per guions baixos.
Un document només rep un subtipus amb prefix de regió quan el registre de documents de Didit inclou una variant diferenciada i classificada per separat per a aquesta regió. L’absència d’una variant amb prefix de regió no significa que el tipus de document no existeixi en aquesta regió, sinó que Didit l’informa actualment sota la categoria simple a escala de país (consulta l’advertència sobre els CDL més avall per veure un exemple concret).

​
Tots els valors de subtipus

La taula següent és l’enumeració completa dels valors de document_subtype que pot retornar l’informe, agrupats per la família de document_type. Ja inclou les variants amb prefix de regió; per exemple, tant DRIVER_LICENSE_GENERIC (la majoria de països) com CALIFORNIA_DRIVER_LICENSE_GENERIC apareixen com a files diferenciades sota Driver’s License. Un codi de categoria simple no és exclusiu d’un sol país: es comparteix entre tots els països l’entrada de registre dels quals per a aquest document no té una variant específica per regió. Per exemple, ID_CARD_GENERIC cobreix els documents d’identitat nacionals d’aproximadament 170 països. Cerca sempre un codi per la seva agrupació de document_type i (quan estigui present) el seu prefix de regió, mai assumint que un codi es correspon amb un únic país.

​
Permisos de conduir dels EUA: estàndard o comercial (CDL)

El valor de document_type és "Driver's License" tant per a un permís de conduir estàndard com per a un permís de conduir comercial (CDL): mai no els distingeix. La distinció es troba exclusivament a document_subtype. En 48 dels 51 estats i territoris dels EUA que Didit classifica, un CDL rep el seu propi subtipus {STATE}_COMMERCIAL_DL, diferenciat de {STATE}_DRIVER_LICENSE_GENERIC d’aquest estat. Considerar que un document_subtype que acaba en _COMMERCIAL_DL equival a “això és un CDL” és un senyal fiable en aquests estats.
Actualment, Alaska, el Districte de Colúmbia i Hawaii no tenen un subtipus de CDL diferenciat. Un CDL d’una d’aquestes tres jurisdiccions s’informa sota el subtipus estàndard _DRIVER_LICENSE_GENERIC d’aquesta jurisdicció, indistinguible d’un permís no comercial únicament mitjançant document_subtype. Si necessites una detecció infal·lible de CDL específicament per a aquestes tres jurisdiccions, posa’t en contacte amb nosaltres per registrar les variants de document que falten, o aplica un control fora de banda (per exemple, sol·licitant que el conductor proporcioni per separat el seu número de CDL/DOT per a la verificació).

​
extra_fields.dl_categories no és un senyal de CDL fiable

Alguns permisos dels EUA també generen extra_fields.dl_categories: una llista de les lletres de classe (A, B, C, …) impreses a la targeta i llegides mitjançant OCR. No facis servir aquest camp com a senyal de CDL. Actualment, aquest camp només s’omple per a una petita minoria de configuracions de permisos de conduir dels EUA; el significat de les lletres de classe varia segons l’estat i no està normalitzat d’acord amb una semàntica comercial/no comercial, i els codis d’autorització o restricció (que és on realment s’indica “comercial” en molts permisos) no s’exposen de cap manera a l’informe en aquests moments. Avui dia, document_subtype és l’únic senyal estructurat i fiable per distingir entre estàndard i comercial.

​
Com mantenir-se al dia

Les noves famílies de document_type s’anuncien al registre de canvis mensual quan es publiquen. Les incorporacions a document_subtype (per exemple, una nova variant regional d’un tipus de document existent) no s’anuncien individualment actualment; el registre de documents de Didit creix contínuament a mesura que s’incorporen nous formats de documents. No hi ha cap número de versió al payload del webhook per a aquesta llista. Si la teva integració necessita detectar un subtipus que mai no ha vist abans en lloc d’assumir que el conjunt és fix, tracta qualsevol valor de document_subtype que el teu codi no reconegui com a “sense classificar, revisar manualment” en lloc de generar un error, i torna a consultar periòdicament aquesta pàgina o la llista de subtipus admesos del teu flux de treball mitjançant la Management API.

​
Relacionat

Darrera modificació el 7 de novembre del 2026