CNPJ Alfanumérico 2026 — verifique seu código grátis online

6 linhas de um cadastro de fornecedor em TypeScript recusam o CNPJ 12.ABC.345/01DE-35. Se você é dev de ERP, e-commerce, fintech ou emissor de NF-e no Brasil, procure as mesmas 6 no seu código hoje.

O motivo é a IN RFB nº 2.229/2024. A Receita Federal atribui CNPJ alfanumérico a partir de julho de 2026, exclusivamente a novas inscrições. Quem já tem CNPJ continua com o número de sempre. Por isso o problema não aparece nos testes antigos nem nos clientes atuais: ele aparece quando a primeira empresa recém-aberta tenta se cadastrar, pagar ou receber uma nota, e o formulário responde "CNPJ inválido".

O formato novo mantém 14 caracteres. As 12 primeiras posições (raiz de 8 e ordem de 4) aceitam letras maiúsculas e números. As 2 últimas, o dígito verificador, continuam numéricas. O cálculo do DV continua sendo módulo 11 com pesos de 2 a 9, mas cada caractere passa a valer o código ASCII menos 48: os dígitos continuam valendo 0 a 9, a letra A vale 17, a B vale 18 e assim por diante.

Eu escrevi um cadastro típico, do jeito que ele era escrito até 2025, e passei o lint nele. Estas são as 6 linhas marcadas, cada uma com a correção:

1. cnpj: number na interface. Um tipo numérico não guarda letra e ainda perde zeros à esquerda. Correção: cnpj: string.

1. /^\d{14}$/. O regex clássico aceita só dígitos. Correção: /^[A-Z0-9]{12}\d{2}$/, depois de normalizar para maiúsculas.

1. .replace(/\D/g, ''). Esta é a mais traiçoeira: a limpeza apaga tudo que não é dígito, e 12ABC34501DE35 vira 123450135. Mesmo que você troque o regex, as letras já sumiram antes da validação. Correção: .replace(/[^A-Z0-9]/gi, '').toUpperCase().

1. parseInt(limpo.charAt(i)) no laço do DV. Para uma letra o resultado é NaN, e o DV sai errado. Correção: limpo.charCodeAt(i) - 48.

1. cnpj BIGINT na migration. O INSERT de um CNPJ alfanumérico falha no banco, não no formulário, e o erro chega como 500. Correção: CHAR(14) ou VARCHAR(14).

1. Um CNPJ de teste 12.ABC.345/01DE-53. O DV correto do exemplo oficial da Receita é 35. Um teste com DV inventado passa num validador errado e esconde o problema.

A versão corrigida do mesmo arquivo dá 0 achados.

Por que não resolver com um chatbot? Ele corrige bem o trecho que você cola. Mas a coluna BIGINT mora na migration, o teste com DV errado mora na pasta de testes, e o replace(/\D/g) pode estar num helper de outro módulo. O lint lê cada arquivo com as mesmas 11 regras: regex de 14 dígitos, regex da máscara formatada, limpeza que apaga letras, conversão para número, DV dígito a dígito, teste "só dígitos", tipo numérico, coluna numérica, campo de formulário numérico, máscara 99.999.999/9999-99 e CNPJ literal com DV errado. Ele funciona em JavaScript, TypeScript, Python, Java, C#, PHP e SQL.

A ferramenta no navegador é grátis e roda local: cole o arquivo e veja cada linha que recusa um CNPJ alfanumérico, com a correção. A extensão do VS Code faz o mesmo no arquivo aberto, no painel Problems. A versão completa varre o workspace inteiro de uma vez e exporta um relatório Markdown por arquivo para anexar ao PR da migração.

Comece pelo cadastro e pelo checkout de pagamento: são os dois lugares onde a empresa nova chega primeiro.