O que a tecnologia VIO faz
Em termos práticos, um QR Code pode carregar uma representação estruturada de informações de um documento. Uma solução de leitura recebe esse conteúdo, identifica o formato que consegue reconhecer e produz campos para que outro sistema os apresente, revise ou use em um fluxo de trabalho. Isso reduz a transcrição manual em situações como cadastro de condutor, abertura de conta, recepção ou registro de veículo.
Essa leitura não é uma sentença sobre a autenticidade de uma pessoa, de um documento ou de uma operação. Dados extraídos precisam passar pelas regras do produto que os recebe: conferência de campos, validações próprias, prevenção a fraude, permissões e, quando necessário, análise humana. Uma integração responsável trata a leitura como uma entrada de dados, não como um mecanismo automático de aprovação.
App oficial, serviços oficiais e API de integração não são a mesma coisa
Há diferentes experiências associadas ao nome VIO. O aplicativo e os canais mantidos pelo poder público têm finalidade e condições próprias. Já uma API de integração é usada por empresas que querem receber campos estruturados dentro de seu software. A Consulta pertence a esta segunda categoria: é uma plataforma independente para capturar o conteúdo técnico de QR Codes, devolver JSON e oferecer um componente de Autofill.
Por isso, a Consulta não representa o SERPRO, a SENATRAN, o gov.br nem o aplicativo oficial VIO. Ela também não substitui qualquer verificação que sua operação seja obrigada a fazer. Para compreender o funcionamento institucional da tecnologia, consulte a introdução ao VIO do SERPRO e o serviço do App VIO no gov.br.
Como o QR Code entra em uma integração
O fluxo começa no dispositivo que lê o código. Pode ser uma câmera no navegador, um aplicativo nativo, uma imagem enviada pelo usuário ou um PDF processado no backoffice. Em vez de enviar uma foto inteira sem necessidade, a integração identifica o conteúdo técnico do QR Code e o envia ao backend com uma chave de API. A resposta contém o template reconhecido e os campos disponíveis; a foto só aparece quando o documento e a opção da requisição permitem.
- 1.Capture o QR Code no canal escolhido e obtenha o payload em Base64.
- 2.Envie o payload para a API em um servidor controlado pela sua empresa; nunca exponha a chave secreta no navegador.
- 3.Confira o template e trate campos ausentes como parte normal do contrato de integração.
- 4.Apresente os dados para revisão ou aplique suas regras de negócio antes de qualquer decisão.
CNH, CRLV e documentos compatíveis
CNH-e e CRLV-e são os casos mais comuns em fluxos de cadastro. A CNH pode iniciar um formulário de condutor; o CRLV pode reduzir a digitação de placa, RENAVAM e informações de veículo. A cobertura não deve ser tratada como uma promessa de que todo QR Code, versão ou campo será reconhecido. A página de documentos catalogados mostra o que está descrito publicamente e cada ficha aponta as variações que uma integração precisa acomodar.
O catálogo público tem uma finalidade diferente da cobertura interna do motor: ele serve para documentar apenas páginas que podem ser revisadas e mantidas. Antes de depender de um documento específico em produção, valide amostras legítimas e autorizadas no seu ambiente de homologação.
Desempenho, segurança e LGPD
O tempo de aproximadamente 10 microssegundos divulgado pela Consulta é um benchmark da etapa interna do decoder. Ele não inclui rede, upload, captura da câmera, extração de imagem, autenticação ou o tempo de processamento do seu sistema. Para projetar a experiência real do usuário, meça a latência ponta a ponta com seus payloads e sua infraestrutura.
Documentos podem conter dados pessoais. Defina uma finalidade legítima, colete somente o necessário, retenha dados pelo tempo adequado e deixe claro para a pessoa como o formulário será preenchido. A API usa chave no servidor e os webhooks podem ser assinados com HMAC. Ainda assim, cabe ao integrador proteger suas credenciais, permissões e registros de auditoria.
Limite importante: uma leitura bem-sucedida não valida identidade, não autoriza uma transação e não elimina revisão humana quando ela for exigida pelo seu processo.
Quando usar Autofill e quando usar a API
O Consulta Autofill é adequado quando a pessoa está diante de um formulário e precisa revisar os campos antes de avançar. Ele reduz atrito em onboarding, atendimento presencial e cadastro de motorista ou veículo. A API REST é mais adequada para backoffices, integrações de sistemas, filas de documentos ou fluxos em que seu produto já possui interface e regras próprias.
As duas abordagens podem coexistir. Uma locadora pode usar Autofill no balcão e a API no backoffice; um marketplace pode começar com um teste de câmera e evoluir para webhooks conforme o volume. O ponto de partida seguro é testar o fluxo público, criar uma conta gratuita, gerar uma chave e executar uma leitura com dados autorizados.
Perguntas frequentes
O que é VIO?
VIO é uma tecnologia usada para conferir informações presentes em QR Codes de documentos. O uso, a origem e as regras aplicáveis dependem do documento e do serviço que faz a leitura.
A Consulta é o aplicativo oficial VIO?
Não. A Consulta é um serviço independente para integração e preenchimento de cadastros. O aplicativo oficial e os serviços governamentais têm seus próprios canais e condições.
Ler um QR Code aprova ou valida um cadastro?
Não. A leitura devolve dados técnicos estruturados. A decisão de aprovar uma pessoa, veículo ou operação continua sendo responsabilidade do sistema e da equipe que o utiliza.
Posso testar antes de criar uma conta?
Sim. O demo público permite experimentar a leitura e a revisão de campos antes de integrar a API.