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

# Referência de document_subtype: lista de códigos

> Todos os códigos document_subtype do relatório de verificação de identidade da Didit, o padrão de nomes e como identificar CNH profissional.

O campo `document_subtype` do [relatório de verificação de identidade](https://docs.didit.me/pt-br/core-technology/id-verification/report-id-verification.md) 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.> [!NOTE]
>
> 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 nomenclaturaTodo 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 subtipoA 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.

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

## 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.> [!WARNING]
>
> **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](mailto:support@didit.me) 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).

\<table><thead><tr><th>Estado / território</th>
            \<th>Subtipo padrão de carteira de motorista</th>
            \<th>Subtipo de carteira de motorista comercial (CDL)</th>
            \<th>Outros subtipos (aprendiz, provisória, avançada, …)</th></tr></thead>
        \<tbody /></table>

### `extra_fields.dl_categories` não é um sinal confiável de CDLAlgumas 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 atualizadoNovas 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- [Relatório de verificação de identidade](https://docs.didit.me/pt-br/core-technology/id-verification/report-id-verification.md): os campos `document_type` / `document_subtype` no contexto.
- [Documentos de identidade compatíveis](https://docs.didit.me/pt-br/core-technology/id-verification/supported-documents-id-verification.md): países e tipos de documento aceitos pela Didit.
- [Modelos de dados: verificação de identidade](https://docs.didit.me/pt-br/reference/data-models.md#verificação-de-identidade): esquema canônico dos campos.


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