Conheça a nossa nova rota MEDICAL RECEIPT para validação automatizada de recibos do Receita Saúde!
CNH_EVALUATION recebe as imagens da CNH e uma selfie do titular e executa todas as etapas da validação:📌 Nesta versão, o flow está disponível somente na rota síncrona /connect. Por executar extração, descriptografia e duas comparações biométricas na mesma requisição, o tempo de resposta pode levar alguns segundos. Recomendamos implementar política de retry no consumo.
cnhFiles aceita de 1 a 3 arquivos, em uma das composições abaixo:| Composição | Arquivos em cnhFiles |
|---|---|
| CNH digital | 1 arquivo PDF da CNH digital |
| Frente e verso | Imagens da parte frontal e do verso com o QR Code |
| Três partes | Parte frontal superior, parte frontal inferior e verso com o QR Code |
cnhFiles deve conter fileBase64 ou fileUrl. Envie apenas um dos dois por item.data:image/...;base64,.faceFileBase64 ou faceFileUrl, seguindo as mesmas orientações.VALIDA), todos os critérios abaixo devem ser atendidos:| # | Critério | Descrição |
|---|---|---|
| 1 | Presença da fotografia | O documento deve conter a fotografia do titular (região frontal superior identificada na extração). |
| 2 | Presença do QR Code | O verso deve conter o QR Code, necessário para o consumo dos dados do VIO. |
| 3 | Validação biométrica | As duas comparações faciais devem ser aprovadas. |
| 4 | Correspondência dos dados | Os campos comparados devem corresponder aos dados do VIO, conforme os critérios abaixo. |
| 5 | Validade do documento | A CNH não pode estar vencida. O resultado dessa verificação é informado em cnhStatus. |
| Campo | name em fields | Critério |
|---|---|---|
| Nome | nome | Similaridade igual ou superior a 0.90 |
| CPF | cpf | Correspondência exata |
| Categoria de habilitação | cat_hab | Correspondência exata |
| Código de segurança | codigo_seguranca | Correspondência exata |
| Data de nascimento | data_nascimento | Correspondência exata |
| Data de emissão | data_emissao | Correspondência exata |
| Data de validade | data_validade | Correspondência exata |
| Registro | registro | Correspondência exata |
| RENACH | renach | Correspondência exata |
doc, data_primeira_habilitacao, local_uf e observacoes) não participam da validação. Eles são retornados com os valores da extração e do VIO, mas com score e status iguais a null.| Comparação | Parâmetro | Padrão | Descrição |
|---|---|---|---|
| Foto da CNH × foto do VIO | thresholds.faceMatch.cnhVio | 0.45 | Verifica se a foto impressa corresponde à foto armazenada no QR Code. |
| Foto da CNH × selfie | thresholds.faceMatch.cnhFace | 0.45 | Verifica se a pessoa da selfie é o titular da CNH. |
valid: true) quando a similaridade é igual ou superior ao threshold aplicado. O parâmetro thresholds é opcional; quando não informado, é aplicado o valor padrão de 0,45 em ambas as comparações.result.status)| Status | Descrição | statusDescription |
|---|---|---|
| VALIDA | Todos os critérios de validação foram atendidos. | CNH validada com sucesso. |
| VENCIDA | A CNH está fora da validade e os demais critérios foram atendidos. | A CNH apresentada está vencida. |
| VENCIDA | A CNH consta como vencida nos dados descriptografados do VIO. | |
| VENCIDA | A CNH consta como vencida nos dados capturados no documento. | |
| INVALIDA | A comparação de dados ou a comparação facial identificou divergências. | Foram identificadas divergências entre os dados extraídos da CNH e as informações do VIO. |
| INVALIDA | Foram identificadas incompatibilidades entre a face da CNH e a imagem facial armazenada na base VIO. | |
| INVALIDA | Foram identificadas incompatibilidades entre a face enviada e a fotografia da CNH. | |
| INVALIDA | Foram identificadas incompatibilidades tanto entre a face da CNH e a imagem facial armazenada na base VIO quanto entre a face enviada e a fotografia da CNH. | |
| INVALIDA | A CNH apresentada está vencida e foram identificadas incompatibilidades nas comparações faciais realizadas. | |
| INCONCLUSIVA | Não foi possível concluir a validação com os arquivos enviados. | Documento não reconhecido como CNH. |
| INCONCLUSIVA | Não foi possível descriptografar o QR Code enviado. Isso pode ocorrer devido à baixa qualidade da imagem ou à utilização de um formato incompatível com o padrão VIO. | |
| INCONCLUSIVA | A imagem da CNH enviada não contém o QR Code. Repita o processo enviando imagens completas do documento, incluindo toda a parte frontal (superior e inferior) e o verso, onde está localizado o QR Code. | |
| INCONCLUSIVA | A imagem enviada não contém a fotografia da CNH. Repita o processo enviando imagens completas do documento, incluindo toda a parte frontal (superior e inferior) e o verso, onde está localizado o QR Code. | |
| INCONCLUSIVA | Não foi possível concluir a validação porque um ou mais campos obrigatórios para comparação entre os dados extraídos da CNH e os dados do VIO não foram identificados no documento enviado. | |
| INCONCLUSIVA | Selfie não identificada. |
result: a API responde com HTTP 500 e o código E100, no mesmo padrão das demais APIs da MOST:{
"result": null,
"requestId": "3bUIc1lnyZ9oeOkXxCseX",
"elapsedMilliseconds": 3609,
"status": {
"message": "The request could not be processed",
"code": "E100",
"errors": []
}
}result.fields)fields segue o formato:| Propriedade | Tipo | Descrição |
|---|---|---|
name | string | Nome do campo. |
extractionValue | string ou null | Valor extraído da CNH. null quando o campo não foi identificado. |
vioValue | string ou null | Valor obtido no QR Code (VIO). |
score | number ou null | Similaridade entre o valor extraído e o valor do VIO, de 0 a 1. null quando o valor está indisponível em um dos lados ou quando o campo não participa da validação. |
status | string ou null | Resultado da comparação do campo (ver tabela abaixo). |
status do campo | Significado |
|---|---|
MATCH | O valor extraído atende ao critério de comparação do campo. |
NO_MATCH | O valor extraído não atende ao critério de comparação do campo. |
UNAVAILABLE | O valor não está disponível em um dos lados (extração ou VIO). Em um campo obrigatório para comparação, resulta no status final INCONCLUSIVA. |
null | O campo não participa da validação (doc, data_primeira_habilitacao, local_uf e observacoes). |
| Campo | Descrição |
|---|---|
nome | Nome do condutor. |
data_nascimento | Data de nascimento, no formato AAAA-MM-DD. |
cpf | CPF do condutor, com 11 dígitos e sem máscara. |
doc | Documento de identidade, com órgão emissor e UF. |
registro | Número de registro da CNH. |
cat_hab | Categoria de habilitação. |
data_validade | Data de validade, no formato AAAA-MM-DD. |
data_primeira_habilitacao | Data da primeira habilitação, no formato AAAA-MM-DD. |
data_emissao | Data de emissão, no formato AAAA-MM-DD. |
local_uf | UF de emissão. |
renach | Número do RENACH. |
codigo_seguranca | Código de segurança da CNH. |
observacoes | Observações registradas na CNH. |
status do corpo da resposta, com result igual a null. Quando aplicável, status.errors traz o detalhe com field e message. Veja detalhes aqui.