API DE VALIDAÇÃO DE DADOS · POR PAÍS

Valide registros antes que quebrem sua operação.

A Normadata é uma API developer-first para validar documentos, contas, e-mails, telefones, nomes e endereços. Detecte dados inválidos, incompletos e inconsistentes antes de pagamentos, faturamento, CRM, ERP, folha de pagamento ou onboarding.

Sem KYC. Sem governo. Sem titularidade bancária. Validação estrutural, normalização e consistência operacional.

  • Validação por país
  • Batch no mesmo endpoint
  • Normalização e erros acionáveis
  • Consistência entre campos
  • Readiness por processoDisponível
  • Sem KYC nem titularidade bancária
2
PAÍSES EM PRODUÇÃO
+20
IDENTIFICADORES
5
ENDPOINTS
items[] → results[]AO VIVO
ARCUIT20-12345678-6 20123456786✓ valid
BRCPF123.456.789-0912345678909✓ valid
CLRUT9.876.543-K9876543K✓ valid
BRCNPJ11.222.333/0001-8111222333000181✓ valid
CONIT900.123.456-79001234567✓ valid
PERUC 20512345678 20512345678✓ valid
ARCBU0170 0599 2000 0000 0001 230170059920000000000123✓ valid
BRCPF111.111.111-11checksum failed✗ invalid
EMAIL ROGER@Normadata.IO roger@normadata.io✓ valid
IBANDE89 3704 0044 0532 0130 00DE89370400440532013000✓ valid
ARDNI12.345.67812345678✓ valid
CLRUT1-9checksum failed✗ invalid
PECUI1234567812345678✓ valid
COCC 1.020.345.6781020345678✓ valid
ARPHONE+54 (11) 4555-2233+541145552233✓ valid
01 · O PROBLEMA

Os dados falham antes do sistema falhar.

Um registro mal cadastrado não quebra na hora: quebra depois, no pagamento, na nota fiscal ou no relatório.

  • Documentos mal formados
  • Contas inválidas
  • Telefones incompletos
  • E-mails incorretos
  • Endereços impossíveis de usar
  • Nomes inconsistentes
  • País e tipo de dado incompatíveis
  • Fornecedores duplicados
  • Clientes incontactáveis
  • Pagamentos rejeitados
  • Faturamento bloqueado
02 · PRODUTO

Validação por campo ou por registro completo.

Use os validadores pontuais quando precisar checar um dado. Use a Records API quando precisar saber se uma entidade completa está pronta para operar.

Validadores pontuais · no ar hoje
Records API

Records API

Você envia o registro etiquetado e recebe validação por campo, consistência entre os dados e readiness por processo.

Disponível
03 · READINESS

Um registro pode estar pronto para faturar e bloqueado para pagar.

Readiness por processo: o mesmo registro avança em um fluxo e trava em outro, conforme quais dados estejam bem montados.

Exemplo conceitualilustrativo
BillingReady
PaymentBlocked
04 · COMO FUNCIONA

Uma request. Uma resposta previsível.

Todos os validadores compartilham a mesma resposta plana, com um array de warnings. Sem onboarding por país, sem SDK por país.

POST /v1/validate/tax-ids
$ curl -X POST https://api.normadata.io/v1/validate/tax-ids \
    -H "X-API-Key: nd_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
    -H "Content-Type: application/json" \
    -d '{"items":[
      {"id":"a","value":"20-12345678-6","country":"AR","type":"cuit"},
      {"id":"b","value":"123.456.789-09","country":"BR"}
    ]}'
Response · 200 OKapplication/json
{
  "results": [
    {
      "id":         "a",
      "country":    "AR",
      "type":       "cuit",
      "valid": true,
      "normalized": "20123456786",
      "formatted":  "20-12345678-6"
    },
    {
      "id":         "b",
      "country":    "BR",
      "type":       "cpf",
      "valid": true,
      "normalized": "12345678909",
      "formatted":  "123.456.789-09"
    }
  ]
}
05 · VALIDAÇÃO EM LOTE

Valide dados em lote: 1 ou 1.000 registros em uma única request.

Toda a API é batch nativo. O mesmo endpoint que valida um dado valida uma lista inteira: você envia um array items e recebe um results por item, correlacionado pelo id que você define. Pensado para limpar bases de clientes, fornecedores ou funcionários, validação antes de pagamentos e jobs noturnos de data quality.

Mesmo endpoint para 1 ou N

Não há endpoint separado para lotes: você envia 1 item ou 1.000, o contrato é o mesmo.

Correlação pelo seu id

Cada resultado volta com o id que você enviou, então você casa cada linha da sua base com sua validação.

Nunca falha parcial

O que não pode ser normalizado volta com seu motivo acionável; o resto do lote é processado normalmente.

Peças (emails · tax-ids · accounts · phones)até 1.000 itens / request
Recordsaté 500 itens / request

Para datasets maiores, você pagina no lado do cliente — o teto é por memória/payload, não por velocidade.

06 · COBERTURA

Cobertura por país.

Argentina e Brasil em produção; o resto com status explícito. Alguns validadores aceitam formatos globais como IBAN quando aplicável.

PaísIdentificadoresExemploStatus
🇦🇷Argentina AR
CUITCUILDNICBUCVU
20-12345678-9no ar
🇧🇷Brasil BR
CPFCNPJ
123.456.789-09no ar
PADRÕES GLOBAIS · sem restrição por país
IBANISO 13616 · mod-97
SWIFTISO 9362 · BIC
Ver cobertura completa
07 · PARA QUEM

Para quem é a Normadata?

Seis perfis que sofrem com a falta de pré-validação de dados regionais.

  • Fintech
    Pré-valida antes do KYC e dos payout rails
    Tax IDs e contas estruturalmente válidas antes de pagar o fornecedor de KYC ou de enviar ao rail. Cada CUIT/CPF/RFC mal formado que você evita é dinheiro.
  • Marketplace
    Rejeita IDs de seller malformados no formulário
    O gatekeeper antes de provisionar a conta. Uma API multipaís em vez de cinco bibliotecas por stack.
  • ERP / Master data
    Um formato canônico para tax IDs entre países
    O mesmo CUIT/CNPJ/RFC em cinco formatos quebra joins, duplica registros e estraga relatórios. Normalização determinística como source of truth.
  • CRM
    Limpa contatos regionais na importação
    CSVs importados, leads de formulário, bases legadas — tax IDs e nomes normalizados antes que contaminem o pipeline.
  • Folha / Payouts
    Valida o formato antes de cada rodada
    Folha e payouts movem centenas de transferências. Um único CBU/Pix/CLABE malformado trava o lote. Pré-check antes da fila.
  • Times de dados
    Normaliza datasets regionais em escala
    Tax IDs e endereços normalizados em pipelines dbt/Airflow. Detecção de format drift no batch noturno.
08 · POR QUE NÃO INTERNO

Uma regra local se copia. Manter cobertura regional não.

Validar um CUIT, CPF ou RUT pode parecer simples. O problema aparece quando seu produto opera em vários países, com diferentes documentos, contas, telefones, regras de formato, normalização e processos. A Normadata centraliza essas regras em uma API mantida para times técnicos.

09 · NÃO É KYC

Não fazemos KYC. Validamos que seus dados estejam bem montados.

A Normadata não consulta governos, bancos nem bureaus. Não confirma identidade, existência, titularidade bancária nem risco. Validamos estrutura, formato, normalização e consistência operacional para que seu sistema saiba se um registro pode avançar.

  • Sem consultas a registros governamentais.
  • Sem verificação de identidade.
  • Sem KYC, KYB nem AML.
  • Sem scoring de fraude nem risco.
  • Sem confirmação de titularidade de contas bancárias.
  • Não confirmamos que o endereço exista fisicamente.
  • Sem confirmação de status legal ou fiscal.
10 · DEVELOPER-FIRST

Solicitar acesso.

O acesso à Normadata é concedido manualmente. Conte seu caso de uso e entramos em contato por e-mail.

ACESSO ANTECIPADO · O QUE INCLUI
acesso antecipado
  • +Validadores core (Tax IDs, Contas, Pessoas, Endereços)
  • +Records API disponível
  • +Argentina e Brasil em produção
  • +REST + JSON · tempo real e batch
  • +Sem consultas a governo
  • +Suporte da comunidade

Beta privado · pricing e planos serão definidos antes do GA.

11 · FAQ

Perguntas frequentes

O que é a Normadata?

Uma API de validação de dados por país. Valida e normaliza documentos, contas, nomes e endereços, e detecta inconsistências antes de pagamentos, faturamento, CRM, ERP ou onboarding.

O que ela valida exatamente?

Estrutura, formato, comprimento, dígito verificador, normalização e consistência entre campos. Onde aplicável, resolve dados derivados como o banco de um CBU ou de uma CLABE.

Quais países cobre?

Trabalhamos por país, não por região. Consulte a lista completa e o estado de cada um na cobertura.

A Normadata faz KYC?

Não. Não verificamos identidade, não consultamos registros governamentais nem fazemos scoring de fraude. Validamos que o dado esteja bem montado, não quem é seu dono.

Confirma a titularidade de uma conta?

Não. Validamos que a conta esteja bem formada (formato, comprimento, checksum e banco quando aplicável). Não confirmamos que exista nem quem é seu titular.

Posso validar em batch?

Sim, e é central: um mesmo endpoint valida 1 ou milhares de itens em uma única chamada (até 1.000 por lote nas peças, 500 em registros). Nunca falha parcialmente: o que não pode ser normalizado volta com seu motivo.

O que é a Records API?

A camada que valida um registro completo: você envia a entidade etiquetada e recebe validação por campo, consistência e readiness por processo (payment e billing). Está disponível.

Como é cobrado?

Os planos serão definidos antes do lançamento geral. Hoje é beta privado — escreva para a gente e vemos o seu caso.

Qual a diferença em relação a uma biblioteca?

Uma biblioteca valida um campo em um país. A Normadata mantém vários países, normaliza e checa consistência entre campos como API mantida — sem que você carregue as regras locais.

Qual a diferença em relação a um provedor de KYC?

O KYC confirma identidade contra fontes externas. A Normadata valida que os dados estejam bem montados antes desse passo. É a camada anterior, não o substituto.

Pare de manter validadores regionais no seu backend.

O acesso é concedido manualmente. Conte seu caso de uso.