consulta.dev.brVIO API & Webhooks
Entrar
Consulta Autofill

Do documento ao cadastro em segundos.

Um componente pronto para ler documentos oficiais, revisar os dados encontrados e preencher qualquer formulário — sem digitação e sem expor a chave da API.

Ver formatos de integração
Revisão antes de preencher Chave protegida no servidor
cadastro.exemplo.com.br/novo-cliente

Novo condutor

Preencha os dados pessoais para continuar.

Tem sua CNH-e em mãos?Preencha o cadastro automaticamente.

Powered by consulta.dev.br
3 formatos

Uma experiência para cada contexto.

O parceiro escolhe o gatilho que combina com seu produto. A câmera, a revisão e o preenchimento continuam sendo do Consulta Autofill.

Opção 01

Ícone dentro do campo

Discreto e contextual. Ideal quando o Autofill auxilia um campo principal, como nome, CPF ou placa.

Opção 02 · Recomendada

Ação no topo do formulário

Explica o benefício antes do clique e deixa claro que vários campos serão preenchidos de uma só vez.

Powered by consulta.dev.br
Opção 03

Câmera, imagem ou PDF

Mais flexível para backoffices e cadastros assistidos, inclusive em computadores sem câmera.

Quer testar com seu próprio formulário?

Criar conta gratuita

Dados do condutor preenchidos5 campos atualizados pelo Consulta Autofill.

Motor de Alta Performance & Webhooks em Tempo Real

Decodifique QR Codes VIO Instantaneamente

API para leitura de CNH Digital, CRLV e outros documentos VIO brasileiros. Receba os campos estruturados e, quando disponível, a foto diretamente no seu sistema via webhooks assinados.

Criar Conta Gratuita
~10 µs
Tempo de Decodificação
189
Modelos de Documentos
BPG Nativo
Extração Direta de Foto
HMAC-SHA256
Webhooks Seguros
POST /api/v1/decode/payload
# 1. Defina CONSULTA_API_KEY no ambiente e envie o payload Base64
curl -X POST https://consulta.dev.br/api/v1/decode/payload \
  -H "X-API-Key: ${CONSULTA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"payload_base64": "ZBEiAQVAAEc...", "include_photo_base64": true}'
Webhook Event (Instantâneo)
// 2. Exemplo de evento entregue no seu Webhook em tempo real
{
  "id": "evt_k7m2p9x4qr",
  "event": "document.decoded",
  "created_at": "2026-09-02T10:00:00.000Z",
  "data": {
    "template_id": 83,
    "template_name": "CNH - Carteira Nacional de Habilitação",
    "template_owner": "SENATRAN",
    "fields": {
      "nome": "JOAO DA SILVA SANTOS",
      "cpf": "123.456.789-00",
      "data_nascimento": "15/03/1990",
      "rg": "12.345.678-9",
      "orgao_emissor": "SSP/SP",
      "registro": "04567890123",
      "validade": "20/11/2030",
      "primeira_habilitacao": "10/06/2010",
      "categoria": "AB",
      "observacoes": "EAR",
      "local": "SAO PAULO - SP",
      "data_emissao": "20/11/2025",
      "numero_espelho": "B000123456",
      "renach": "SP123456789",
      "codigo_seguranca": "12345678901",
      "nome_pai": "ANTONIO DA SILVA SANTOS",
      "nome_mae": "MARIA APARECIDA SANTOS",
      "nacionalidade": "BRASILEIRA"
    },
    "has_photo": true,
    "photo_base64": "iVBORw0KGgoAAAANSUhEUgAAANgA... (PNG Base64)",
    "photo_info": {
      "width": 216,
      "height": 264,
      "pixel_format": "YCbCr 4:2:0",
      "color_space": "sRGB IEC61966-2.1",
      "bit_depth": 8,
      "file_size": 7352
    }
  }
}
Diferencial Exclusivo

Integração sem Polling com Webhooks em Tempo Real

Esqueça requisições manuais em loop. Cadastre o endpoint do seu backend (Node, PHP, Python, Java, C#) e receba notificações imediatas assim que uma CNH ou documento for escaneado.

Assinatura HMAC-SHA256

Cada requisição contém o header X-Webhook-Signature para você validar a autenticidade.

Logs de entrega minimizados

Acompanhe status, duração, destino e hash de verificação sem persistir o corpo da resposta.

Foto do Condutor Embutida

O payload traz a foto em Base64 já convertida de BPG para PNG de alta fidelidade.

Fluxo de DisparoAutomático
1
Leitura do QR CodeVia câmera, app mobile ou chamada API
2
Motor Decodifica em ~10µsDescompactação 6-bit + BPG nativo em memória
3
Webhook disparado para seu servidorPOST https://seusistema.com/webhook com HMAC

Projetado para Escala e Velocidade

Um motor desenvolvido com arquitetura compilada de ultra baixa latência.

Microssegundos de Latência

Processamento ultra rápido capaz de decodificar cada documento em cerca de 10 microssegundos.

Decoder BPG Nativo

As fotos de CNH são codificadas em BPG/HEVC. Decodificamos a imagem diretamente em memória sem necessidade de processos pesados.

Templates VIO no motor

A cobertura inclui CNH, CRLV, documentos da Marinha, Exército, educação e conselhos profissionais.

Documentos Brasileiros Suportados

Conheça os documentos que possuem descrição técnica confirmada no catálogo público.

Abrir catálogo completo
CNH

CNH - Carteira Nacional de Habilitação

Documento oficial de habilitação de condutores com foto em alta compressão BPG e assinatura ECDSA.

Ver detalhes
CRLV

CRLV - Certificado de Registro e Licenciamento de Veículo

Documento digital anual de licenciamento de veículos em território nacional.

Ver detalhes
ATPV-e

ATPV-e - Autorização para Transferência de Veículo

Autorização digital para compra e venda de veículos e transferência de propriedade.

Ver detalhes
Diploma Digital

Diploma Digital de Graduação

Diploma digital de ensino superior com validação de conformidade e integridade acadêmica.

Ver detalhes
Identidade Militar do Exército

Carteira de Identidade Militar - Exército

Identificação militar de oficiais, praças e servidores das Forças Armadas.

Ver detalhes
Carteira Funcional da Marinha

Carteira Funcional - Marinha do Brasil

Identificação oficial de pessoal militar e aquaviários civis.

Ver detalhes

Planos Simples e Transparentes

Comece gratuitamente com sua chave de API e faça upgrade conforme seu volume aumentar.

Gratuito

Free
R$ 0 / mês

Ideal para testes e pequenos projetos de validação.

  • 5 consultas gratuitas por hora
  • Chave de API dedicada
  • Scanner Web via Câmera
  • 189 templates oficiais
  • Sem suporte a Webhooks
Começar Grátis

Starter

Starter
R$ 49 / mês

Para projetos e integrações iniciais com webhooks.

  • Até 3 webhooks com HMAC
  • 2.000 consultas incluídas
  • Logs de entrega por 30 dias
  • Extração de fotos PNG em Base64
  • Suporte via E-mail
Assinar Starter
Mais Popular

Profissional

Pro
R$ 99 / mês

Para aplicações, sistemas de onboarding e ERPs em escala.

  • 20.000 consultas incluídas
  • Logs de entrega por até 1 ano
  • Até 20 webhooks com HMAC
  • Extração de fotos PNG em Base64
  • Suporte Prioritário
Assinar Plano Pro

Enterprise

Custom
Sob Consulta

Para locadoras, seguradoras e fintechs com alto volume.

  • 100.000 consultas incluídas
  • Até 100 webhooks com HMAC
  • Retenção de logs por até 1 ano
  • Condições definidas em proposta
Falar com o comercial
Tire Suas Dúvidas

Perguntas Frequentes (FAQ)

Tudo o que você precisa saber sobre a API de decodificação VIO, integração por Webhooks e segurança.

Como funciona a API de leitura de QR Code VIO?
A API recebe em Base64 o conteúdo codificado do QR Code VIO. O motor identifica o template, estrutura os campos disponíveis e, quando o documento contém uma imagem compatível e a opção é solicitada, retorna a foto em PNG Base64 junto do JSON.
Quais documentos oficiais brasileiros são suportados?
O motor possui templates para diferentes documentos VIO. O catálogo público descreve exemplos confirmados no repositório, como CNH, CRLV, ATPV-e, Boletim de Acidente de Trânsito, CAUC, documentos da Marinha, diplomas e carteiras profissionais.
Como funciona a extração da foto do condutor na CNH?
Quando o template contém foto BPG compatível, o motor converte a imagem em memória para PNG e pode retorná-la em Base64. A disponibilidade, as dimensões e a qualidade dependem do conteúdo presente no documento lido.
Qual é o tempo de resposta e latência da API?
O benchmark interno divulgado para a etapa de decodificação é de aproximadamente 10 microssegundos. A latência total da API depende de rede, tamanho do payload, extração de imagem, carga do serviço e webhooks configurados; por isso deve ser medida no ambiente da integração.
O que são os Webhooks em tempo real e como garantir a segurança?
Os Webhooks permitem que seu servidor receba os dados decodificados sem polling. Cada entrega contém assinatura HMAC-SHA256, timestamp e identificador único. O consumidor deve validar o corpo bruto, rejeitar timestamps antigos e deduplicar o identificador da entrega.
Como integrar a API no meu sistema?
A integração usa uma requisição POST com a API key no header X-API-Key e um corpo JSON contendo o payload Base64. A documentação pública traz o contrato básico, exemplos em cURL e orientações para validar webhooks.
A plataforma está em conformidade com a LGPD?
A plataforma aplica minimização e controles técnicos descritos na Política de Privacidade. Gratuito e Starter não retêm o payload bruto; Profissional e Enterprise podem manter o payload de entrada criptografado. A conformidade de cada uso também depende da base legal e das obrigações do cliente controlador.
Como funciona a cobrança e o cancelamento dos planos?
O plano Gratuito possui limite compartilhado por conta e IP. Os limites e valores dos planos pagos são apresentados na página inicial; condições de contratação, alteração e cancelamento devem ser confirmadas nos Termos de Uso e no atendimento comercial.

Ainda tem alguma dúvida técnica ou comercial?

Nossa equipe técnica e comercial está pronta para atender seu projeto ou esclarecer dúvidas de integração.

Falar com Nossa Equipe