O CNPJ alfanumérico já está em produção. Seu sistema aceita letras?
A Receita Federal colocou o novo formato em produção em julho de 2026. Os CNPJs existentes continuam válidos, mas novas inscrições podem usar letras e números nas 12 primeiras posições. Sistemas que assumem “14 dígitos” precisam ser revisados.
Conteúdo técnico e informativo. Para regras oficiais, prevalecem Receita Federal e atos normativos aplicáveis.
A mudança parece pequena no cadastro — mas atravessa o stack inteiro.
O problema não é apenas a tela de cadastro. Qualquer componente que trate CNPJ como número puro pode falhar: regex, schemas, colunas numéricas, serialização, máscaras, ETL, integrações e regras de validação.
“Só dígitos” deixou de ser uma premissa segura
Validações que aceitam apenas 0–9 nas 12 primeiras posições precisam ser revistas.
CNPJ deve ser tratado como identificador
Campos numéricos, conversões para inteiro e operações que descartam letras podem corromper o novo formato.
A compatibilidade precisa existir ponta a ponta
Uma aplicação pode aceitar letras na interface e ainda quebrar em CSV, webhook, API, fila ou sistema legado.
Revise estes pontos antes de dizer “compatível”.
- Tipo de dado no banco e nos schemas
- Normalização sem remover letras
- Máscara e formatação
- Validação de caracteres e tamanho
- Cálculo de dígitos verificadores conforme a norma
- CSV, XLSX e importadores
- JSON, APIs e webhooks
- Filas, caches e chaves de estado
- Logs e sistemas de busca
- Testes com formato numérico e alfanumérico
Uma regex antiga pode rejeitar um CNPJ válido.
// hipótese antiga
^\d{14}$
// problema
00000000E08G12
// contém letras e não passa na regra acimaCompatibilidade não é “trocar um campo e acabou”.
Um plano seguro separa descoberta, correção e regressão. Sistemas antigos continuam precisando aceitar CNPJs numéricos ao mesmo tempo em que passam a aceitar o novo formato.
Validação em lote e migration checking já disponíveis.
O Validador CNPJ Alfanumérico está publicado na Apify. Ele aceita listas, texto, JSON e CSV, calcula dígitos verificadores, aponta erros e duplicados e gera um relatório de migração da base.
Baseie a implementação na norma.
Dúvidas comuns.
Meu CNPJ atual vai mudar?
Não. A Receita Federal informa que CNPJs já existentes permanecem válidos. O novo formato é aplicado progressivamente às novas inscrições.
O CNPJ continua com 14 posições?
Sim. As 12 primeiras posições podem combinar letras e números; as duas últimas permanecem dígitos verificadores numéricos.
Se meu formulário aceita letras, meu sistema já está compatível?
Não necessariamente. A compatibilidade também depende de banco, schemas, validação, cálculo de DV, integrações, importadores, APIs, filas e outros pontos do fluxo.
A JM Forge já modificou o Actor CNPJ atual?
Não. O Actor publicado com usuários permanece congelado durante a validação paralela. A nova lógica será provada separadamente antes de qualquer decisão de migração.
O novo formato abre uma etapa de migração — não elimina o legado.
A arquitetura correta precisa aceitar os dois formatos e preservar os workflows que já funcionam.