Pular para o conteúdo principal
O campo document_subtype do relatório de verificação de identidade identifica a variante específica de documento que a Didit reconheceu, por exemplo uma carteira de motorista de Queensland em vez de uma carteira de motorista genérica, ou uma carteira de motorista comercial dos EUA em vez de uma carteira de motorista padrão. Esta página lista todos os valores que o campo pode retornar.
O seu fluxo de verificação (workflow) aceita apenas um subconjunto desses valores: aqueles que você selecionou na etapa de configurações de documentos do fluxo. Consulte a lista exata de valores aceitos pelo seu fluxo com o endpoint workflow-retrieve da Management API (documents_allowed no nó de OCR), em vez de supor que todos os valores abaixo estão habilitados para seu fluxo.

​
Padrão de nomenclatura

Todo valor de document_subtype tem um destes dois formatos:
  • Categoria simples: {CATEGORY}, para documentos que a Didit não precisa distinguir por região (a maioria dos passaportes e das carteiras de identidade nacionais), por exemplo PASSPORT_GENERIC, ID_CARD_GENERIC.
  • Com prefixo de região: {REGION}_{CATEGORY}, para documentos cujo formato ou classificação realmente varia por estado, província ou território, por exemplo QUEENSLAND_DRIVER_LICENSE_GENERIC (Austrália) ou CALIFORNIA_COMMERCIAL_DL (Estados Unidos). O prefixo de região é o nome do estado ou da província emissora, em maiúsculas e com os espaços substituídos por sublinhados.
Um documento só recebe um subtipo com prefixo de região quando o registro de documentos da Didit contém uma variante distinta, classificada separadamente, para aquela região. A ausência de uma variante com prefixo de região não significa que o tipo de documento não exista naquela região: significa que, atualmente, a Didit o classifica na categoria simples em nível de país (veja a ressalva sobre CDL abaixo para um exemplo concreto).

​
Todos os valores de subtipo

A tabela abaixo é a lista completa de valores de document_subtype que o relatório pode retornar, agrupados pela família de document_type. Ela já inclui as variantes com prefixo de região: por exemplo, tanto DRIVER_LICENSE_GENERIC (a maioria dos países) quanto CALIFORNIA_DRIVER_LICENSE_GENERIC aparecem como linhas distintas em Driver’s License. Um código de categoria sem prefixo regional não é exclusivo de um país: ele é compartilhado por todos os países cujo registro para aquele documento não tem uma variante específica por região. ID_CARD_GENERIC, por exemplo, abrange carteiras de identidade nacionais de cerca de 170 países. Procure um código apenas pelo seu agrupamento de document_type e (quando houver) pelo seu prefixo de região, nunca supondo que um código corresponde a um único país.

​
Carteiras de motorista dos EUA: comum vs. comercial (CDL)

O document_type é "Driver's License" tanto para uma carteira de motorista comum quanto para uma Commercial Driver’s License (CDL): ele nunca as distingue. A distinção está inteiramente no document_subtype. Em 48 dos 51 estados e territórios dos EUA que a Didit classifica, uma CDL tem seu próprio subtipo {STATE}_COMMERCIAL_DL, distinto do {STATE}_DRIVER_LICENSE_GENERIC daquele estado. Nesses estados, considerar que um document_subtype terminado em _COMMERCIAL_DL significa “isto é uma CDL” é um sinal confiável.
Alasca, Distrito de Colúmbia e Havaí não têm, atualmente, um subtipo distinto para CDL. Uma CDL de uma dessas três jurisdições é informada com o subtipo comum _DRIVER_LICENSE_GENERIC da jurisdição, impossível de distinguir de uma carteira não comercial apenas pelo document_subtype. Se você precisa de uma detecção de CDL infalível especificamente para essas três jurisdições, entre em contato conosco para registrar as variantes de documento que faltam, ou aplique um controle externo (por exemplo, exigir que o motorista informe separadamente o número da CDL/DOT para verificação).

​
extra_fields.dl_categories não é um sinal confiável de CDL

Algumas carteiras dos EUA também geram extra_fields.dl_categories: uma lista das letras de categoria (A, B, C, …) impressas no cartão, lidas por OCR. Não use este campo como seu sinal de CDL. Hoje, ele é preenchido apenas para uma pequena minoria das configurações de carteira de motorista dos EUA, o significado das letras de categoria varia por estado e não é normalizado em relação a uma semântica comercial/não comercial, e os códigos de endosso ou restrição (que é onde “comercial” de fato aparece em muitas carteiras) atualmente não são expostos no relatório de forma alguma. Hoje, o document_subtype é o único sinal estruturado e confiável para distinguir uma carteira comum de uma comercial.

​
Como se manter atualizado

Novas famílias de document_type são anunciadas no changelog mensal quando são lançadas. Adições de document_subtype (uma nova variante regional de um tipo de documento existente, por exemplo) atualmente não são anunciadas individualmente: o registro de documentos da Didit cresce continuamente à medida que novos formatos de documento são incorporados. O payload do webhook desta lista não tem número de versão. Se a sua integração precisa detectar um subtipo que nunca viu antes, em vez de supor que o conjunto é fixo, trate qualquer valor de document_subtype que o seu código não reconheça como “não classificado, revisar manualmente” em vez de gerar um erro, e consulte periodicamente esta página ou a lista de subtipos aceitos pelo seu fluxo por meio da Management API.

​
Relacionados

Última modificação em 1 de novembro de 2026