Conteúdo e tecnologia de dados · iniciativa KomplianceFontes e metodologia
BASE DE CNPJdados empresariais
Guia Base de CNPJ

Como validar CNPJ alfanumérico sem quebrar cadastros existentes

A adaptação correta exige mais do que trocar uma máscara. O identificador precisa ser normalizado sem destruir letras, validado conforme o novo conjunto de caracteres e armazenado sem conversão numérica.

Para validar CNPJ alfanumérico, preserve letras e números das 12 primeiras posições, exija dois dígitos numéricos no final e aplique o cálculo oficial dos verificadores. Nunca normalize o identificador removendo letras.

Não use tipo numérico no banco

CNPJ é identificador, não quantidade. Mesmo antes do novo padrão, armazená-lo como número já era frágil por causa de zeros à esquerda. Com letras, a necessidade de campo textual fica explícita.

Normalização precisa mudar

Rotinas antigas frequentemente aplicam uma expressão que mantém apenas 0–9. No novo cenário, isso mutila o identificador. A normalização deve remover pontuação, manter caracteres alfanuméricos permitidos e padronizar caixa.

Validação estrutural e consulta são coisas diferentes

Um CNPJ pode passar no algoritmo de verificação e ainda precisar de confirmação cadastral. O validador desta página verifica estrutura e dígitos; não consulta a Receita Federal.

Teste toda a cadeia

Inclua formulário, API, banco, exportação CSV/XLSX, integrações, filtros, chaves, deduplicação, logs e relatórios. Um único componente numérico no meio da cadeia pode causar rejeição ou perda silenciosa.

Nota: este conteúdo explica dados cadastrais e metodologia. Para confirmação oficial de uma empresa ou serviço público específico, consulte os canais oficiais correspondentes.

Teste o formato e os dígitos verificadores

O teste é local, no seu navegador. Não consulta a situação cadastral nem envia o CNPJ para um servidor.