Artigo TechTool
Validação de CNPJ em cadastros B2B: o que checar antes da integração
Reduza erros de cadastro empresarial antes de enviar dados para ERP, CRM ou fiscal.
O que a validação local resolve
A checagem de CNPJ evita sequências com tamanho incorreto, números repetidos e dígitos verificadores inválidos. É uma primeira barreira barata antes de acionar APIs externas ou sistemas fiscais.
Limites da validação matemática
Um CNPJ matematicamente válido pode não existir, estar baixado ou não pertencer à empresa informada. Em produção, a validação cadastral deve ser complementada por fonte oficial ou fornecedor autorizado.
Testes que valem a pena
Monte cenários com CNPJ formatado, sem pontuação, com zeros à esquerda, inválido por tamanho e inválido por dígito. Isso melhora mensagens de erro e evita rejeições tardias em integrações.
Checklist prático
- ✓ Aceite CNPJ com máscara, mas normalize para apenas números antes de enviar à integração.
- ✓ Bloqueie entradas com menos de 14 dígitos e sequências repetidas.
- ✓ Separe erro de formato local de erro cadastral retornado por fornecedor externo.
Perguntas frequentes
Validar CNPJ confirma se a empresa está ativa?
Não. A validação por dígito verificador não consulta situação cadastral, razão social, endereço ou atividade econômica.
Quando consultar uma fonte oficial?
Consulte fonte oficial ou fornecedor autorizado quando o processo tiver impacto fiscal, financeiro, contratual ou regulatório.
CNPJ fictício serve para nota fiscal?
Não. Ele serve para testes e homologação. Emissão fiscal real exige dados verdadeiros e validações oficiais.