Validação de formato vs. consulta a cadastros oficiais
Quando a validação de formato é suficiente e quando você precisa consultar a fonte oficial?
Um dos equívocos mais comuns ao integrar APIs de qualidade de dados no Brasil: confundir "validar o CPF" com "verificar que o CPF existe na Receita Federal". São duas operações completamente distintas, com custos, latências, casos de uso e garantias diferentes. Este guia explica quando cada abordagem é a correta.
Comparação rápida
| Aspecto | Validação de formato (Normadata) | Consulta a cadastro oficial |
|---|---|---|
| O que verifica? | Estrutura, dígito verificador, prefixos válidos | Existência e situação atual no cadastro oficial |
| Latência típica | <50 ms (sem chamada externa) | 200 ms – 3 s (depende do órgão) |
| Custo por consulta | Baixo (processamento local do algoritmo) | Maior (chamadas a APIs externas ou raspagem) |
| Garante que o número está ativo? | Não | Sim (se o órgão expõe essa informação) |
| Requer conexão com o órgão? | Não | Sim (Receita Federal, SEFAZ, Banco Central, etc.) |
| Detecta erros de digitação? | Sim — o dígito verificador falha na maioria dos erros de digitação | Sim, mas com maior custo e latência |
| Adequado para validação em tempo real (pré-envio)? | Sim | Às vezes (depende do SLA do órgão) |
| O Normadata faz isso? | Sim | Não — o Normadata não consulta cadastros oficiais |
Quando usar cada um?
- Pré-checkout: impedir que um usuário avance com CPF ou CNPJ com erro de digitação antes de processar o pagamento.
- Pré-KYC: filtrar formatos inválidos antes de enviar dados a provedores como Idwall, Unico ou Truora — reduz chamadas frustradas e custos.
- Pré-PIX ou TED: validar que o CPF ou CNPJ do destinatário é estruturalmente correto antes de iniciar a transferência.
- Limpeza de CRM: normalizar e filtrar registros históricos com dados inconsistentes em lote.
- Defesa contra erros de digitação em formulários: feedback imediato ao usuário sem latência de rede.
- Multi-país em uma única API: validar CPF, CNPJ, CUIT, RFC, RUT, NIT com um endpoint unificado.
- KYC completo: confirmar que uma pessoa ou empresa existe e tem situação ativa na Receita Federal.
- Prevenção de fraude: verificar que o CNPJ não está cancelado, suspenso ou corresponde a uma empresa de fachada.
- Situação fiscal real: saber se uma empresa está em recuperação judicial, inapta ou com pendências na Receita Federal.
- Relatórios de compliance: auditorias que exigem evidência de consulta direta à fonte primária (Receita Federal ou SEFAZ).
O equívoco mais comum: 'validar CPF' não é 'consultar a Receita Federal'
Quando um desenvolvedor diz 'preciso validar o CPF do usuário', pode querer dizer três coisas bem diferentes: (1) verificar que o formato está correto (11 dígitos, dois dígitos verificadores válidos pelo algoritmo módulo 11), (2) verificar que esse CPF existe na base da Receita Federal, ou (3) verificar que esse CPF pertence à pessoa que está informando. O Normadata faz (1). Ninguém faz (3) sem documentação física ou biometria. Para (2), uma consulta direta na Receita Federal via serviço web ou API de terceiros é necessária — e isso tem suas próprias implicações de disponibilidade, custo e requisitos legais de convênio.
Como o Normadata funciona: exemplo real de /v1/validate/tax-ids
O Normadata executa o algoritmo de validação localmente — módulo 11 com pesos específicos por país, verificação de prefixo, comprimento e formato. Para o CPF, aplica as duas rodadas de cálculo do dígito verificador; para o CNPJ, os dois dígitos com pesos distintos. A resposta inclui o resultado booleano, o tipo inferido e, se falhou, o campo específico que causou o erro. Nenhuma chamada externa à Receita Federal ou qualquer outro órgão é feita.
Quando combinar as duas abordagens
O padrão mais eficiente em produção: usar o Normadata no frontend ou na entrada de dados (formato, erros de digitação, feedback imediato) e a consulta direta na Receita Federal apenas quando o usuário supera o formulário e entra no fluxo formal de onboarding ou KYC. Isso reduz em 60-80% as chamadas ao órgão, porque você filtra os erros de formato antes. O custo e a latência da consulta oficial só são pagos para números que já são estruturalmente válidos.
Exemplos de código
curl -X POST https://api.normadata.io/v1/validate/tax-ids \
-H "X-API-Key: nd_your_key" \
-H "Content-Type: application/json" \
-d '{
"items": [
{ "id": "1", "value": "111.444.777-35", "country": "BR" }
]
}'
# Response — one result per item, correlated by id
{
"results": [
{
"id": "1",
"country": "BR",
"type": "cpf",
"valid": true,
"normalized": "11144477735",
"formatted": "111.444.777-35"
}
]
}O Normadata valida formato e estrutura — não consulta a Receita Federal, SEFAZ, Banco Central nem nenhum órgão oficial. Um número que passa a validação do Normadata é estruturalmente correto, mas pode não estar cadastrado ou pode estar inativo. Para confirmação de situação cadastral ativa, é necessária uma consulta direta ao órgão competente ou a um provedor especializado em consulta de cadastros oficiais.
Perguntas frequentes
O Normadata consulta a Receita Federal?
Não. O Normadata executa algoritmos de validação localmente. Nenhuma chamada à Receita Federal ou a qualquer outro órgão oficial é feita. O resultado do Normadata é sobre estrutura e formato, não sobre situação cadastral.
Posso usar o Normadata para KYC?
Como etapa de pré-filtro, sim: eliminar formatos inválidos antes de enviar dados ao seu provedor de KYC (Idwall, Unico, Truora, Veriff) reduz custos por tentativa. Como substituto de KYC, não — o KYC exige verificação de identidade que envolve consulta a fontes primárias e processos regulatórios que o Normadata não cobre.
O que acontece se um CPF passa a validação de formato mas está cancelado na Receita Federal?
O Normadata retornará valid: true porque o formato está correto. A situação cadastral na Receita Federal é informação que apenas a Receita pode fornecer. Para casos em que você precisa confirmar a situação ativa, adicione uma consulta ao órgão como segundo passo no seu fluxo de onboarding.
Quanto o uso do Normadata antes de uma consulta ao cadastro oficial reduz custos?
Depende da qualidade dos seus dados de entrada. Em formulários com usuários finais, erros de formato tipicamente representam 15-40% dos inputs. Filtrá-los antes da consulta ao cadastro oficial reduz essa porcentagem de chamadas caras. Em processos de limpeza de CRM legado, a economia pode ser ainda maior.
O dígito verificador garante que o número é real?
Não. O dígito verificador é um mecanismo de detecção de erros de digitação, não uma garantia de existência. Qualquer pessoa pode construir um CPF com formato válido que nunca foi atribuído pela Receita Federal. O que o dígito verificador garante: se alguém digitar um número aleatório ou cometer um erro de um dígito, o algoritmo o detecta com alta probabilidade.