Guia Técnico: Preparando sistemas para o CNPJ Alfanumérico

1. Atualização de Banco de Dados

A primeira barreira em sistemas legados é a tipagem do banco de dados.

• Se você armazena CNPJ como BIGINT, INT ou NUMERIC, será OBRIGATÓRIO migrar a coluna para VARCHAR ou CHAR(14).
• Aproveite a janela de manutenção para normalizar dados antigos (removendo pontuações) e definindo o campo estritamente para 14 posições (VARCHAR(14)).

2. Expressões Regulares (RegEx)

As validações de front-end ou máscaras que forçavam apenas números precisam ser revistas.

• RegEx Antiga (Numérica): `^\d{2}\.\d{3}\.\d{3}\/\d{4}\-\d{2}$`
• RegEx Nova (Alfanumérica): `^([A-Z0-9]{2})\.([A-Z0-9]{3})\.([A-Z0-9]{3})\/([A-Z0-9]{4})\-([0-9]{2})$`
• Note que os dois últimos dígitos (após o traço) continuam sendo obrigatórios na forma numérica `[0-9]{2}`.

3. Atualizando as Máscaras (Input Masks)

Se você usa bibliotecas de frontend (como jQuery Mask, Cleave.js ou bibliotecas React/Vue) para forçar pontuações, elas devem ser ajustadas.

Geralmente, máscaras usam "0" ou "9" para representar apenas números, e "A" para representar letras/números. Consulte a documentação da sua biblioteca para criar uma máscara como `AA.AAA.AAA/AAAA-00`.

4. Atualização do Algoritmo de Validação

A verificação matemática agora exige que cada caractere seja convertido em inteiro usando o valor ASCII subtraído de 48. (`charCodeAt(i) - 48`).

Não se esqueça de aplicar `.toUpperCase()` ao CNPJ antes de iniciar a validação, pois a Receita Federal utilizará apenas letras maiúsculas.

5. Integrações de Terceiros

Não basta apenas o seu software ser atualizado. É preciso mapear:

- APIs de consulta de crédito (Serasa, SPC)

- Gateways de pagamento (Asaas, Pagar.me, Stripe)

- Emissores de Notas Fiscais (Conta Azul, Bling)

- Órgãos do Governo Municipal e Estadual.

Acompanhe as atualizações dessas plataformas para garantir que elas não rejeitem os dados enviados pelo seu sistema.