CASO DE USO
Pre-valide tax IDs antes de emitir NF-e ou CFDI
SEFAZ rejeita NF-e por CNPJ com digito verificador invalido. SAT rejeita CFDI por RFC com homoclave malformada. AFIP rejeita a fatura por CUIT com modulo-11 incorreto. Sao rejeicoes estruturais — o orgao nem chegou a validar regra de negocio, rejeitou o documento porque o identificador esta mal formado. O Normadata roda antes do gerador de XML para filtrar essa classe de erro no momento da entrada do dado.
O PROBLEMA
Rejeicoes estruturais poderiam ser filtradas antes do XML
Cada NF-e/CFDI/fatura rejeitada por tax ID malformado exige cancelamento, reemissao e as vezes correcao fora de banda com o cliente. O custo operacional e desproporcional ao custo de validar formato.
SEFAZ rejeita NF-e por CNPJ com DV invalido
Antes de validar regras de negocio (CFOP, CST, valores), a SEFAZ roda as verificacoes estruturais. Um CNPJ com duplo digito verificador incorreto faz o XML ser rejeitado no momento da autorizacao. Seu sistema recebe codigo de erro e precisa cancelar e reemitir.
SAT MX rejeita CFDI por RFC malformado
O RFC do receptor em CFDI 4.0 precisa cumprir estrutura: 4 caracteres de pessoa/empresa + 6 digitos de data + 3 caracteres de homoclave. Um caractere errado em qualquer posicao gera a rejeicao do CFDI, e voce precisa cancelar e timbrar de novo.
AFIP rejeita fatura por CUIT com DV errado
O CUIT com prefixo de tipo de contribuinte (20, 23, 24, 27, 30, 33, 34) e digito verificador modulo-11 ponderado e verificavel sem chamar a AFIP. Se seu sistema emite a fatura com um CUIT cujo DV nao fecha, AFIP rejeita o documento e ele fica em estado de erro.
POR QUE AS SOLUCOES PADRAO NAO SAO SUFICIENTES
Por que o problema nao e filtrado no ERP
Validacao apenas no frontend do ERP
Muitos ERPs validam comprimento e caracteres do tax ID no formulario, mas nao calculam os digitos verificadores. Isso deixa passar erros de digitacao plausiveis que falham em SEFAZ/SAT/AFIP igual.
Bibliotecas por pais com drift
Manter implementacoes corretas de CNPJ, RFC e CUIT no ERP exige atualizacoes periodicas. Bibliotecas open source frequentemente ficam desatualizadas ou cobrem so um pais.
Esperar pelo codigo de erro do orgao
Se voce descobre o erro so quando SEFAZ/SAT/AFIP rejeita, o documento ja esta em estado de erro no seu sistema e precisa cancelamento. O custo e alto comparado a ter detectado no formulario.
COMO O NORMADATA AJUDA
Como o Normadata ajuda
Chame verify/tax-id antes de montar o payload de NF-e, CFDI ou fatura AFIP. Se valid=false, bloqueie a emissao e retorne o erro para correcao upstream — no ERP, CRM ou formulario de cadastro.
Uma API, um schema, todos os tax IDs principais de LATAM (CNPJ, CPF, RFC, CUIT, RUT, NIT, RUC). Sua logica pre-emissao e a mesma para todos os paises onde voce factura.
Para campos de endereco que tambem aparecem no documento fiscal, complemente com verify/address para detectar CEPs malformados antes de montar o XML.
VEJA EM ACAO
Veja em acao
# Pre-validate CNPJ before emitting NF-e to SEFAZ
$ curl -X POST api.normadata.io/v1/verify/tax-id \
-H "X-API-Key: nd_a8f3b2c1d4e5f6g7h8i9j0k1l2m3n4o5" \
-d '{"country":"BR","type":"cnpj","value":"11.222.333/0001-81"}'
{
"valid": true,
"normalized": "11222333000181",
"identifier": {
"type": "CNPJ",
"category": "tax_id"
}
}
# valid=true → safe to build NF-e XML payload
# valid=false → block NF-e emission, fix tax ID upstream
# Same gate for MX (RFC → CFDI) and AR (CUIT → factura AFIP)LIMITACOES
O que o Normadata nao faz aqui
—O Normadata nao se conecta a SEFAZ, SAT nem AFIP. Nao emite nota, nao gera o XML de NF-e ou CFDI, nao assina digitalmente. E estritamente o gate de formato anterior.
—O Normadata nao valida campos de negocio do documento (CFOP, CST, valores, aliquotas). Apenas valida a estrutura do tax ID e outros identificadores. A validacao fiscal de negocio fica no seu sistema ou no orgao emissor.
PERGUNTAS FREQUENTES
Perguntas frequentes
O Normadata integra com SEFAZ, SAT ou AFIP?
Nao. O Normadata roda antes do envio ao orgao. Validamos que o tax ID esteja estruturalmente correto para que voce nao receba rejeicoes do orgao por erro de formato. A integracao com SEFAZ/SAT/AFIP fica no seu ERP ou provedor de facturacao eletronica.
Reduz rejeicoes de NF-e?
Sim — as rejeicoes estruturais (CNPJ com DV invalido, comprimento incorreto, prefixo incorreto). Nao reduz rejeicoes por validacoes de negocio (CFOP incorreto, valores nao batendo, situacao do contribuinte). Essas sao responsabilidade do sistema de facturacao e do orgao.
Integre o Normadata no seu stack
Acesso antecipado. Entre na lista e daremos acesso à API.