Saltar al contenido principal
document_subtype en el informe de verificación de identidad identifica la variante concreta de documento que Didit reconoció: por ejemplo, una licencia de conducir de Queensland frente a una licencia de conducir genérica, o una Commercial Driver’s License de EE. UU. frente a una estándar. En esta página se enumeran todos los valores que puede devolver este campo.
Tu flujo de verificación (workflow) solo acepta un subconjunto de estos valores: los que seleccionaste en el paso de configuración de documentos del flujo. Obtén la lista exacta de valores aceptados por tu flujo con el endpoint de obtención de flujos de la Management API (documents_allowed en el nodo de OCR), en lugar de suponer que tienes habilitados todos los valores que aparecen a continuación.

​
Patrón de nomenclatura

Cada valor de document_subtype tiene una de estas dos formas:
  • Categoría simple: {CATEGORY}, para documentos que Didit no necesita distinguir por región (la mayoría de los pasaportes y de los documentos nacionales de identidad), por ejemplo PASSPORT_GENERIC, ID_CARD_GENERIC.
  • Con prefijo de región: {REGION}_{CATEGORY}, para documentos cuyo formato o clasificación realmente varía según el estado, la provincia o el territorio, por ejemplo QUEENSLAND_DRIVER_LICENSE_GENERIC (Australia) o CALIFORNIA_COMMERCIAL_DL (Estados Unidos). El prefijo de región es el nombre del estado o la provincia emisora, en mayúsculas y con los espacios sustituidos por guiones bajos.
Un documento solo recibe un subtipo con prefijo de región cuando el registro de documentos de Didit incluye una variante distinta, clasificada por separado, para esa región. Que no exista una variante con prefijo de región no significa que ese tipo de documento no exista en esa región: significa que Didit lo clasifica actualmente en la categoría simple a nivel de país (consulta la aclaración sobre las CDL más abajo para ver un ejemplo concreto).

​
Todos los valores de subtipo

La siguiente tabla es la enumeración completa de los valores de document_subtype que puede devolver el informe, agrupados por familia de document_type. Ya incluye las variantes con prefijo de región: por ejemplo, tanto DRIVER_LICENSE_GENERIC (la mayoría de los países) como CALIFORNIA_DRIVER_LICENSE_GENERIC aparecen como filas distintas en Driver’s License. Un código de categoría sin prefijo de región no es exclusivo de un país: lo comparten todos los países cuya entrada en el registro para ese documento no tiene una variante específica por región. ID_CARD_GENERIC, por ejemplo, abarca los documentos nacionales de identidad de unos 170 países. Busca un código únicamente por su agrupación de document_type y (si lo tiene) por su prefijo de región, y nunca supongas que un código corresponde a un solo país.

​
Licencias de conducir de EE. UU.: estándar frente a comerciales (CDL)

document_type es "Driver's License" tanto para una licencia de conducir estándar como para una Commercial Driver’s License (CDL): nunca las distingue. La distinción reside por completo en document_subtype. En 48 de los 51 estados y territorios de EE. UU. que Didit clasifica, una CDL tiene su propio subtipo {STATE}_COMMERCIAL_DL, distinto del {STATE}_DRIVER_LICENSE_GENERIC de ese estado. En esos estados, tratar un document_subtype que termina en _COMMERCIAL_DL como “esto es una CDL” es una señal fiable.
Alaska, el Distrito de Columbia y Hawái no tienen actualmente un subtipo de CDL distinto. Una CDL de cualquiera de estas tres jurisdicciones se informa con el subtipo estándar _DRIVER_LICENSE_GENERIC de esa jurisdicción, por lo que no se puede distinguir de una licencia no comercial solo con document_subtype. Si necesitas una detección de CDL infalible específicamente para estas tres jurisdicciones, contáctanos para registrar las variantes de documento que faltan, o aplica un control externo (por ejemplo, exigir al conductor que aporte por separado su número de CDL/DOT para verificarlo).

​
extra_fields.dl_categories no es una señal fiable de CDL

Algunas licencias de EE. UU. también generan extra_fields.dl_categories: una lista de las letras de clase (A, B, C, …) impresas en la tarjeta, leídas mediante OCR. No uses este campo como señal de CDL. Actualmente este campo solo se rellena en una pequeña minoría de configuraciones de licencias de conducir de EE. UU., el significado de las letras de clase varía según el estado y no está normalizado según criterios comerciales o no comerciales, y los códigos de endoso o restricción (que es donde realmente se indica el carácter “comercial” en muchas licencias) no se exponen actualmente en el informe en absoluto. Hoy, document_subtype es la única señal estructurada y fiable para distinguir entre licencias estándar y comerciales.

​
Mantenerse al día

Las nuevas familias de document_type se anuncian en el registro de cambios mensual cuando se publican. Las incorporaciones a document_subtype (por ejemplo, una nueva variante regional de un tipo de documento existente) no se anuncian actualmente de forma individual; el registro de documentos de Didit crece de forma continua a medida que se incorporan nuevos formatos de documento. El payload del webhook no incluye ningún número de versión para esta lista. Si tu integración necesita detectar un subtipo que nunca ha visto en lugar de suponer que el conjunto es fijo, trata cualquier valor de document_subtype que tu código no reconozca como “sin clasificar, revisar manualmente” en lugar de generar un error, y vuelve a consultar periódicamente esta página o la lista de subtipos aceptados por tu flujo a través de la Management API.

​
Relacionado

Última modificación el 1 de noviembre de 2026