01 · METODOLOGIA
Metodologia
Somos transparentes sobre como a Normadata valida cada identificador nos nossos 10 mercados sul-americanos. Saber o que a API checa — e o que não checa — ajuda você a decidir onde ela encaixa no seu pipeline de qualidade de dados.
02 · WE DO
O que a API valida
- FormatoComprimento, conjunto de caracteres, padrões de prefixo.
- EstruturaRegras posicionais — ex.: o layout do RFC com 4 letras do nome + data de nascimento + homoclave.
- Dígito verificadorAplica o algoritmo oficial publicado por cada autoridade emissora.
- Regras de negócio por paísEx.: CPFs com todos os dígitos iguais são inválidos mesmo que o cálculo passe; o prefixo do CUIT codifica o tipo de entidade.
03 · WE DON'T
O que a API não valida
- ExistênciaA API não consulta nenhum registro. Um CUIT/CPF/RFC válido pode não corresponder a nenhum contribuinte cadastrado.
- IdentidadeA API não confirma que o identificador pertence a uma pessoa ou empresa específica.
- StatusA API não verifica se um tax ID está ativo, suspenso ou cancelado.
- Autenticidade de documentos físicosVerificação de documentos por imagem (RG, passaportes, etc.) está fora do escopo.
04 · SOURCES
Fontes
Cada validador é implementado com base na especificação oficial do algoritmo publicada pela autoridade emissora — AFIP (Argentina), Receita Federal (Brasil), SAT (México), SII (Chile), DIAN (Colômbia), SUNAT (Peru), ISO 13616 para IBAN, e IETF RFC 1035 para domínio. Quando a documentação oficial conflita com exemplos do mundo real, seguimos o algoritmo e registramos a discrepância.
05 · WHEN TO USE
Quando a validação é a ferramenta certa
- Validação de formulários no front-end antes de enviar ao backend.
- Verificações de higiene no backend antes de persistir dados de clientes.
- Limpeza em massa de registros legados de CRM/ERP.
- Verificações prévias antes de enviar a um provedor pago de KYC/KYB.
06 · ALSO NOT
Quando você precisa de mais que validação
- Verificação de identidadeUse um provedor regulamentado de KYC (Persona, Sumsub, Veriff, Onfido, MetaMap).
- Consulta de registro fiscalUse a API oficial da agência (quando disponível) ou um provedor especializado.
- Screening de sanções / PEPUse um provedor de compliance.
07 · DEEP DIVES
Análise técnica por algoritmo
- Dígito verificador do CUIT — Mod-11 →Pesos, exemplo numérico passo a passo, casos de borda, código Python e JavaScript.
- Dígito verificador do NIT colombiano — módulo 11 →Pesos [3,7,13,17,19,23,29,37,41] da direita para a esquerda, exemplo passo a passo, casos limite. Sem consulta à DIAN.
- Dígito verificador do CPF — dupla passagem Mod-11 →Dupla passagem Mod-11, exemplo numérico completo, caso de borda de dígitos repetidos, código.
- Dígito verificador do CNPJ — dupla passagem Mod-11 →Duplo dígito verificador para pessoas jurídicas, exemplo completo, código.
- Estrutura e validação do RFC mexicano →Letras do nome, data AAMMDD, homoclave — o que a Normadata valida e o que não valida.
- IBAN — algoritmo MOD-97 (ISO 13616) →Rearranjar → substituição de letras → mod 97 = 1. Exemplo completo, nota sobre BigInt em JS.
- Luhn vs Mod-11: comparativo →Quando usar cada um, comparativo de detecção de erros, tabela de identificadores por algoritmo.