CASO DE USO
Vendor onboarding: validar tax IDs e contas antes do AP
Os fornecedores se cadastram sozinhos no seu portal com tax ID + conta bancária. Um typo e o primeiro pagamento de fatura volta — AP abre ticket, procurement contata o supplier de novo, a conciliação quebra. A Normadata roda no form de cadastro para que o master de AP só aceite records limpos.
O PROBLEMA
O primeiro pagamento ao fornecedor volta por dados mal preenchidos no onboarding
Self-service onboarding empurra a responsabilidade de captura para o supplier. Sem validação, erros estruturais sobrevivem até o primeiro pagamento — o momento mais caro para descobri-los.
CNPJ com sufixo de filial omitido
Posições 9-12 codificam a filial (0001 matriz, 0002+ filiais). Sem os 4, NF-e e AP não roteiam corretamente. O fornecedor preencheu 11 dígitos em vez de 14 — o form aceitou, o sistema rejeita três dias depois.
CBU colado com espaços a cada 4 dígitos
Os fornecedores copiam o CBU do app do banco com espaços. Sem normalização, o master guarda 22 chars + 4 espaços = 26 — a transferência falha por comprimento incorreto ao chegar no rail BCRA.
CBU vs CVU confundidos
Mesma estrutura de 22 dígitos, mas CBU é bancário e CVU é fintech (Mercado Pago, Ualá, Brubank). O fornecedor coloca o CVU no campo CBU. O rail bancário rejeita porque o prefixo de entidade não existe na tabela BCRA.
POR QUE AS SOLUCOES PADRAO NAO SAO SUFICIENTES
Por que os validadores genéricos não pegam esses erros
Validação visual do form
O form aceita qualquer string. A validação é só "não vazio" — sem estrutura, sem DV, sem matriz/filial.
Validação do seu ERP no insert
SAP/NetSuite/Oracle fazem format check básico mas não entendem DV mod-11 nem prefixos LATAM. Pra isso você instala 10 bibliotecas ou convive com lixo.
Revisão manual
Funciona a 10 fornecedores novos por semana. Não funciona a 200. E os erros aparecem dias depois, não no form.
COMO O NORMADATA AJUDA
Como o Normadata ajuda
POST /v1/validate/tax-ids no form de onboarding do fornecedor. Antes do submit, a Normadata valida CUIT/CPF/CNPJ/RFC com DV correto e devolve normalized + branch/is_headquarters quando aplicável.
POST /v1/validate/accounts no mesmo form para CBU/CVU/Pix/CLABE. Normaliza espaços, valida DV, distingue CBU vs CVU pelo prefixo de entidade.
Para auditorias do cadastro existente: rode a tabela de suppliers contra POST /v1/validate/tax-ids em lotes de até 1.000 — sinalize rows com tax_id malformado para limpeza dirigida.
VEJA EM ACAO
Veja em acao
# Validate the full supplier record before writing to the AP master
$ curl -X POST api.normadata.io/v1/validate/records \
-H "X-API-Key: nd_a8f3b2c1d4e5f6g7h8i9j0k1l2m3n4o5" \
-d '{"items":[
{"reference_id":"sup-001","country":"AR",
"tax_id":"20-12345678-6","account":"0170099220000067802779","account_type":"cbu",
"name":"Proveedor SA"}
]}'
{
"results": [
{
"reference_id": "sup-001",
"consistency": [
{ "check": "country_matches_tax_id", "ok": true },
{ "check": "country_matches_account", "ok": true }
],
"readiness": {
"payment": { "status": "ready" },
"billing": { "status": "ready" }
}
}
]
}
# tax_id + account + name validated together — block onboarding unless payment is readyLIMITACOES
O que a Normadata não faz em vendor onboarding
—Não verifica titularidade bancária do fornecedor. Format-only — o banco confirma o titular no primeiro pagamento.
—Não faz screening de sanções nem PEP. Isso é seu vendor de compliance — a Normadata roda antes, para que esse vendor receba só inputs limpos.
PERGUNTAS FREQUENTES
Perguntas frequentes
Integra com SAP/Oracle/NetSuite?
É uma REST API. Seu middleware (Boomi, Mulesoft, integração caseira) chama antes de escrever no master de AP. Não há conector nativo — mas você não precisa, são ~10 linhas de código.
Devolve a razão social do fornecedor?
Não. Format-only. Para razão social use um provedor de enriquecimento (Serasa, Equifax) ou os serviços oficiais de Receita/AFIP/SAT.
Integre o Normadata no seu stack
Acesso antecipado. Entre na lista e daremos acesso à API.