CASO DE USO
Onboarding com identifiers de varios paises LATAM em um unico flow
Seu produto opera em varios paises LATAM. Cada um tem seu tax ID, seu algoritmo de check-digit, seu formato de mascara, suas regras de prefixo. Manter uma biblioteca por pais — cada uma com sua API, sua cadencia de updates, seu drift de manutencao — e overhead operacional. Uma API unica para validar tax IDs de todos os paises consolida a stack.
O PROBLEMA
Multiplos paises = multiplas implementacoes de validacao
Um produto LATAM que cresce para 5-10 paises termina com 5-10 validadores por pais. Cada um com sua API, sua shape de resposta, sua manutencao. Drift entre eles e inevitavel.
Cada pais tem seu algoritmo
CPF (BR) usa duplo digito verificador sequencial. CUIT (AR) usa modulo-11 com pesos fixos. RFC (MX) tem homoclave complexa. RUT (CL) usa modulo-11 com tabela. NIT (CO), RUC (PE), CI (EC) — cada um com sua formula.
Drift entre bibliotecas por pais
A biblioteca de CPF atualizou ano passado. A de CUIT nao mexe ha tres anos. Cada uma tem um mantenedor diferente, uma cadencia diferente de releases, um nivel diferente de testes. A consistencia entre paises e fragil.
Response shape diferente por biblioteca
Uma biblioteca retorna boolean. Outra retorna enum. Outra retorna objeto. O time de produto escreve wrappers para uniformizar — e mantem tres niveis de adapter.
POR QUE AS SOLUCOES PADRAO NAO SAO SUFICIENTES
Por que as solucoes existentes nao consolidam bem
Uma biblioteca npm/PyPI por pais
Funciona mas soma N dependencias. Cada update de uma biblioteca e um release do seu produto. Versoes ficam pinned e desatualizadas.
Validar tudo no backend com codigo custom
Implementar 10 algoritmos corretamente, com testes, casos de borda, performance e manutencao — e projeto de meses e trabalho recorrente.
Confiar na validacao do KYC vendor
Funciona mas o vendor cobra por tentativa. Voce gasta dinheiro em validacao estrutural que poderia ser feita mais barato upstream.
COMO O NORMADATA AJUDA
Como o Normadata ajuda
Chame /v1/validate/tax-ids com country e type. O response shape é o mesmo para todos os países: valid, normalized, type, error. Seu código de produto é um só.
Passe country e type em cada item do lote. O mesmo endpoint valida 1 ou N itens (até 1.000 por request), então você cobre o signup e a auditoria batch com um único contrato.
Mesmo endpoint, mesmo schema, multiplos paises: BR (CPF/CNPJ), AR (CUIT/CUIL/DNI), CL (RUT), CO (NIT/RUT/CC), PE (RUC/DNI), UY (RUT/CI), EC (CI). MX (RFC/CURP) em validators client-side; endpoint API em desenvolvimento.
VEJA EM ACAO
Veja em acao
# One batch, multiple countries — each item carries its own country
$ curl -X POST api.normadata.io/v1/validate/records \
-H "X-API-Key: nd_a8f3b2c1d4e5f6g7h8i9j0k1l2m3n4o5" \
-d '{"items":[
{"reference_id":"ar-1","country":"AR","tax_id":"20-12345678-6","name":"Ana Ruiz"},
{"reference_id":"br-1","country":"BR","tax_id":"111.444.777-35","name":"João Dias"}
]}'
{
"results": [
{ "reference_id": "ar-1", "readiness": { "billing": { "status": "ready" } } },
{ "reference_id": "br-1", "readiness": { "billing": { "status": "ready" } } }
]
}
# Same request and response shape across AR / BR (live) and CL / CO / PE / UY (beta)LIMITACOES
O que o Normadata nao faz aqui
—O Normadata nao auto-roteia por jurisdicao legal. Se um usuario argentino se cadastra no seu produto BR, validamos o tax ID — mas a decisao sobre que regras legais aplicam (qual entidade legal, que pais factura) e sua.
—O Normadata nao e um rule engine de compliance. Nao conhece regras de KYC, AML ou tax por pais — isso fica com suas integracoes especializadas (KYC vendor, tax engine, etc).
PERGUNTAS FREQUENTES
Perguntas frequentes
Detecta o pais sem passar country no request?
Você passa country e type explícitos em cada item. É um contrato determinístico: o mesmo input sempre devolve o mesmo resultado, sem adivinhar o tipo.
Suporta os 10 principais paises LATAM?
Sim — BR, AR, CL, CO, PE, UY, EC, VE tem endpoint API hoje. MX (RFC/CURP) tem validators client-side disponiveis; o endpoint API esta em desenvolvimento. Todos compartilham o mesmo response shape.
Integre o Normadata no seu stack
Acesso antecipado. Entre na lista e daremos acesso à API.