Classification
A classification API recebe um documento (PDF ou imagem) e retorna seu tipo — um dos 17 tipos de documento brasileiros ou UNKNOWN. Utilize-a quando o tipo do documento for desconhecido, ou quando for necessário verificar se a classification interna está correta.
Modos
- Sync
- Async
Retorna o resultado inline em 3-5 segundos. Ideal para UX interativa — o usuário faz upload de um arquivo e visualiza a classification imediatamente. Tamanho de arquivo limitado a 3 MB (conteúdo efetivo em base64).
Retorna 202 imediatamente. O resultado é entregue via webhook assinado. Use quando não houver necessidade de feedback em tempo real ou quando o arquivo tiver até 6 MB.
Cadeia auto-validate
Ao informar auto_validate: true, o DVS executa automaticamente o pipeline de validation assim que o tipo for conhecido. São entregues dois eventos: classification.completed e validation.completed, ambos compartilhando o mesmo correlation_id, permitindo a correlação no sistema do consumidor.
Esse é o caminho mais simples para "enviar um documento e saber se ele é válido".
O que a classification NÃO faz
- Não valida a correção do conteúdo (CID presente, dose válida, médico licenciado, etc.) — essa é a função da Validation.
- Não verifica elegibilidade junto à operadora.
- Não executa OCR para extração downstream — apenas classifica o tipo.