Um formulário pode aceitar um CPF com dígitos corretos e, ainda assim, não encontrar seus dados em uma base cadastral. Isso não é uma contradição: validar o número e consultar um registro respondem a perguntas diferentes. Separar essas etapas ajuda a escrever mensagens claras e a escolher a integração adequada.
Pense em uma pessoa preenchendo um cadastro. Primeiro, o sistema precisa perceber um erro de digitação. Depois, pode consultar informações disponíveis para auxiliar o preenchimento. A comprovação de quem está usando o formulário exige outro mecanismo; receber um nome não resolve essa terceira tarefa.
O que a validação dos dígitos verifica
A validação matemática confere o tamanho, rejeita sequências inválidas e calcula os dígitos verificadores. Ela pode acontecer no navegador, antes de qualquer requisição. O validador de CPF faz essa verificação localmente.
Um resultado válido indica que o número passou pelo cálculo. Não demonstra emissão do documento, situação regular, ausência de dívidas nem que o visitante é seu titular. Por isso, uma mensagem como “Dígitos conferidos” descreve melhor o resultado do que “Identidade aprovada”.
O que uma consulta cadastral acrescenta
No CPF Direto, a consulta pesquisa a base disponível e, quando encontra um registro, retorna nome, CPF, nascimento e gênero informado. É possível usar esses campos para apoiar o cadastro e permitir que a pessoa revise o preenchimento.
A resposta não representa consulta em tempo real a um órgão público. O horário em meta.consultedAt identifica o processamento do pedido, não a atualização do registro. Um resultado ausente também não equivale a CPF inexistente: significa que não houve um registro disponível para aquela busca.
Um fluxo que evita conclusões erradas
- Confira os dígitos antes de habilitar a consulta.
- Apresente o resultado encontrado para revisão, sem substituir dados confirmados silenciosamente.
- Quando não houver resultado, ofereça preenchimento manual ou análise pela sua equipe.
- Quando a tarefa exigir comprovação de titularidade, trate essa exigência separadamente.
Em uma loja, por exemplo, a consulta pode ajudar a preencher um nome. Ela não deve marcar o pagamento como autorizado. Em um sistema de assinaturas, pode apoiar o cadastro inicial, mas não autentica quem tenta acessar uma conta existente.
Escolha a ferramenta pela pergunta
Se a pergunta é “o número foi digitado corretamente?”, comece pelo validador. Se é “quais dados cadastrais estão disponíveis para esse CPF?”, use a consulta. Se envolve score, situação fiscal ou identidade, os campos desta API não atendem a essa necessidade.
Veja o contrato e os exemplos na documentação da API ou faça uma consulta no painel para conhecer os resultados antes de integrar.
Conteúdo sobre consultas, cadastros e integração com a nossa API.
Leve a consulta para o seu fluxo.
Teste no painel ou faça sua primeira chamada pela API.
Criar conta grátis Ver documentação