CNPJ alfanumérico no Protheus: já começou, e não é só o campo do cadastro
O primeiro CNPJ alfanumérico saiu em 31 de julho de 2026. O seu não muda, mas o do próximo cliente sim. Veja os 8 campos alterados no Protheus, o procedimento oficial e o que quebra além do cadastro.
Em 31 de julho de 2026 a Receita Federal emitiu o primeiro CNPJ alfanumérico do país. A maior parte do conteúdo publicado sobre o assunto ainda diz “prepare-se para julho”. Julho passou.
Se você respondeu por um ambiente TOTVS nos últimos meses, provavelmente ouviu as três frases erradas sobre essa mudança: que o seu CNPJ vai mudar, que por isso não te afeta, e que resolver é só ajustar a máscara de um campo. Nenhuma das três se sustenta.
O seu CNPJ não muda. O do seu próximo cliente muda. E não é só o campo do cadastro.
Este guia mostra o que a Receita mudou de fato, quais 8 campos a TOTVS já alterou no Protheus, qual é o procedimento oficial de aplicação, e o que quebra além do cadastro, que é a parte que quase ninguém está olhando.
Não sabe se o seu ambiente está pronto? A WeePulse revisa o seu TOTVS já em operação, aplica a correção na sua release e testa a emissão antes de liberar produção. Falar com um especialista.
O que muda, o que não muda
Comece pela parte que acalma: CNPJ já existente continua igual. A Receita Federal é explícita no portal do projeto, quem já está inscrito permanece com o seu número válido. O MEI também continua com CNPJ numérico. Não existe migração, não existe renumeração, não existe prazo para você trocar o seu.
O formato alfanumérico vale exclusivamente para novas inscrições, a partir de julho de 2026.
É exatamente aí que mora o problema para quem opera ERP. A partir do momento em que empresas novas nascem com letra no CNPJ, elas viram seu cliente, seu fornecedor, seu transportador. E aí o CNPJ com letra chega no seu cadastro, no seu XML e nos seus relatórios, mesmo que o seu próprio número nunca mude.
O risco não está no seu cadastro de empresa. Está no cadastro de terceiros.
A estrutura nova e o dígito verificador
O CNPJ mantém as 14 posições de sempre. O que muda é a composição:
- as 12 primeiras posições passam a aceitar números de 0 a 9 e letras de A a Z
- os 2 dígitos verificadores continuam numéricos
Nos schemas XML, isso virou a expressão [A-Z0-9]{12}[0-9]{2}.
O cálculo do dígito verificador continua sendo módulo 11, e essa foi uma escolha inteligente da Receita. O que mudou é a origem do valor: em vez do dígito em si, usa-se o valor da tabela ASCII do caractere menos 48. Assim o “0” continua valendo 0, o “9” continua valendo 9, e as letras entram na sequência: A vale 17, B vale 18, C vale 19 e assim por diante.
Os pesos de 2 a 9 seguem sendo distribuídos da direita para a esquerda, recomeçando depois do oitavo caractere. O resto da divisão por 11 dá o dígito, com a mesma regra de sempre: resto 0 ou 1 resulta em dígito 0.
O efeito prático dessa escolha é importante: como os caracteres numéricos mantêm exatamente o mesmo valor, a validação dos CNPJs antigos continua funcionando. Um algoritmo corretamente atualizado valida os dois formatos com o mesmo código.
Um exemplo oficial de CNPJ alfanumérico completo, com os dois dígitos calculados: 12.ABC.345/01DE-35.
Vale registrar uma pendência. Circula com frequência a informação de que as letras I, O, U, Q e F não serão aceitas, para evitar confusão visual com números. A própria documentação da TOTVS registra isso como uma solicitação técnica do ENCAT à Receita Federal que ainda precisa de confirmação. Ou seja, é provável, mas não é regra publicada. Não construa validação assumindo essa exclusão sem confirmar.
Os 8 campos que a TOTVS já alterou no Protheus
Aqui está a parte concreta que raramente aparece nos conteúdos sobre o tema.
No Faturamento, a TOTVS tratou o CNPJ alfanumérico por meio do pacote de Expedição Contínua, alterando máscara e validação dos campos. Vale para todas as versões:
| Campo | Picture anterior | Nova picture | Validação (X3_VALID) |
|---|---|---|---|
A1_CGC | @R 99.999.999/9999-99 | @!R NN.NNN.NNN/NNNN-99 | Já possui validação padrão |
A1U_CGC | @R 99.999.999/9999-99 | @!R NN.NNN.NNN/NNNN-99 | Já possui validação padrão |
A4_CGC | @R 99.999.999/9999-99 | @!R NN.NNN.NNN/NNNN-99 | Já possui validação padrão |
AD0_CNPJ | @1 | @!R NN.NNN.NNN/NNNN-99 | Vazio() .Or. CGC(M->AD0_CNPJ) |
ADL_CGC | sem picture | @!R NN.NNN.NNN/NNNN-99 | Vazio() .Or. CGC(M->ADL_CGC) |
C5_CGCINT | @! | @!R NN.NNN.NNN/NNNN-99 | Vazio() .Or. CGC(M->C5_CGCINT) |
D9_CNPJ | @! | @!R NN.NNN.NNN/NNNN-99 | Vazio() .Or. CGC(M->D9_CNPJ) |
F2_CGCCLI | @R 99.999.999/9999-99 | @!R NN.NNN.NNN/NNNN-99 | Vazio() .Or. CGC(M->F2_CGCCLI) |
Repare no padrão da picture nova: o 9 (que aceita apenas dígito) deu lugar ao N (que aceita letra e dígito) nas doze primeiras posições, enquanto os dois últimos continuam 9. É a tradução exata da regra da Receita para o dicionário do Protheus.
Uma ressalva que a própria TOTVS faz e que é fácil perder de vista: o Faturamento atua apenas nesses cadastros. O pacote não cobre tudo o que toca CNPJ no seu ambiente, e questões de transmissão da nota são tratadas por outra equipe. Tratar a aplicação do pacote como “assunto encerrado” é o erro clássico aqui.
Como aplicar
O procedimento oficial tem três passos, e os três precisam ser feitos:
- Aplicar o pacote de Expedição Contínua correspondente à sua release. Se você não tem certeza de qual release roda hoje, ou está numa versão fora do ciclo de vida, vale checar antes o nosso guia de atualização do Protheus, porque release sem suporte não recebe pacote
- Aplicar o dicionário que vem na pasta
sdf: abra a pastaSDF, depois a pastabra, e copie as pastas substituindo o conteúdo emprotheus > protheus_data > systemload - Rodar o UPDDISTR para compatibilizar os dicionários e as tabelas
O pacote de expedição contínua abrange os módulos ATF, COM, CRM, CTB, EST, FAT, FIN, FIS e PCO.
Se o seu ambiente é Cloud, o processo de aplicação de pacote é diferente e tem documentação própria da TOTVS. Não tente reproduzir o procedimento on-premise num ambiente Cloud.
E o de sempre: isso vai para homologação antes de produção. Alteração de dicionário com UPDDISTR mexe na estrutura, não é patch de tela.
O que quebra além do cadastro
Esta é a parte que separa quem entendeu o tamanho da mudança de quem achou que era ajuste de máscara.
A chave de acesso da NF-e deixa de ser numérica
A chave de acesso tem 44 posições e é composta por UF, ano e mês, CNPJ do emitente, modelo, série, número, tipo de emissão, código numérico e dígito verificador.
Como o CNPJ está dentro dela, a chave inteira deixa de ser uma sequência puramente numérica. A nova expressão passa a ser [0-9]{6}[A-Z0-9]{12}[0-9]{26}.
Pense em quantos lugares do seu ambiente tratam chave de acesso como número: rotina de consulta, integração, relatório, planilha de conferência, campo de banco de dados tipado como numérico. Cada um desses é um ponto de quebra em potencial.
O código de barras do DANFE muda de padrão
O código de barras dos documentos auxiliares (DANFE, DACTE e afins) usa hoje o padrão CODE-128C, que não suporta letras. Com o CNPJ alfanumérico dentro da chave, passa a ser necessário alternar dinamicamente com o CODE-128A.
Há um efeito colateral físico nisso: o código de barras fica maior, porque passa a carregar mais símbolos. Isso exige mais espaço no leiaute do documento auxiliar para que a leitura continue funcionando nos diversos leitores em uso no mercado. Quem tem DANFE customizado, com layout apertado, vai precisar rever o desenho.
Os web services precisam de adequação
A Nota Técnica 2026.004, publicada em 30 de abril de 2026, alterou o schema da NF-e e da NFC-e para viabilizar o CNPJ alfanumérico. O alcance é amplo: identificação de emitente, destinatário, transportador e intermediador, além de campos presentes em eventos, consultas e distribuição de documentos.
A mesma nota exige adequação nas mensagens de entrada e saída dos web services, em processos como autorização, registro de eventos, consulta de protocolo, cadastro e distribuição de DF-e. O cronograma dela foi homologação a partir de 1º de junho de 2026 e produção a partir de 1º de julho de 2026.
Existe ainda a Nota Técnica Conjunta dos documentos fiscais eletrônicos, a DFe-NTCJ-2025.001, que é o guarda-chuva do tema. Vale a mesma atenção que recomendamos no cluster da Reforma Tributária: notas técnicas com numeração parecida tratam de coisas diferentes, e confundir uma com a outra gera erro de versão e de prazo.
O ponto cego: a sua customização
O pacote da TOTVS corrige o padrão. Ele não conhece o que foi escrito no seu ambiente.
Em Protheus com anos de customização, a premissa “CNPJ é só número” costuma estar espalhada em camadas diferentes, e cada uma quebra de um jeito:
- Relatórios e rotinas próprias que fazem tratamento de string assumindo apenas dígitos, ou que aplicam
Val()sobre o campo - Validadores próprios de CNPJ escritos antes de 2024, que reprovam qualquer caractere não numérico
- Integrações com bancos, marketplaces, EDI e transportadoras que validam o formato do lado de fora
- Campos de tabelas customizadas que replicam o CNPJ com picture antiga e não recebem o dicionário do pacote
- Consultas e filtros que ordenam ou comparam CNPJ como número
Ambientes muito customizados têm mais pontos de exposição justamente porque a mesma premissa foi repetida em vários lugares ao longo dos anos. É o mesmo padrão que vimos na virada do IBS e CBS, quando customização em cima do fonte fiscal virou o gargalo da correção, como detalhamos no caso da rejeição 1111.
O pacote não vai encontrar esses pontos para você. Só um levantamento no ambiente encontra.
Como testar antes de precisar
A Receita Federal disponibilizou um Simulador do CNPJ Alfanumérico no Portal de Serviços. Ele gera CNPJs alfanuméricos fictícios, valida o formato e exporta em txt, com matrizes e filiais.
Na prática, é a forma mais rápida de montar massa de teste para homologação: gere um conjunto de CNPJs alfanuméricos, cadastre como cliente e fornecedor, emita nota, imprima o DANFE e rode os seus relatórios. O que quebrar, quebra em homologação, que é onde deve quebrar.
Um detalhe que evita falso negativo: informação com CNPJ alfanumérico enviada antes das datas de implantação é rejeitada mesmo passando na validação do schema. Teste no ambiente e na janela corretos antes de concluir que algo está errado no seu lado.
E não trate “julho de 2026” como data única para todo o universo fiscal. O cronograma varia por obrigação e por ente. A produção do CNPJ alfanumérico na e-Financeira, por exemplo, foi adiada por ato específico. Confira a obrigação que a sua operação entrega. O panorama de datas do momento fiscal está no nosso guia da Reforma Tributária no TOTVS.
Checklist
- Identifique a sua release e confirme a disponibilidade do pacote de Expedição Contínua
- Aplique pacote e dicionário, e rode o UPDDISTR
- Confirme que os 8 campos ficaram com a picture nova
- Levante onde há customização que toca CNPJ: relatórios, integrações, validadores, tabelas próprias
- Verifique se algum campo trata chave de acesso como numérico
- Revise o leiaute do DANFE customizado, por causa do código de barras maior
- Gere massa de teste no simulador da Receita
- Emita, imprima e concilie em homologação
- Cheque o cronograma da obrigação específica que você entrega
- Só então libere produção
Como a WeePulse ajuda
O CNPJ alfanumérico é o tipo de mudança que parece pequena no papel e se espalha pelo ambiente inteiro. A parte padrão a TOTVS resolve com pacote. A parte que sobra é a que costuma travar operação, e é onde a gente entra.
A mudança atinge as três linhas, e a lógica se repete em Protheus, RM e Datasul. Atuamos nos três já em operação, com:
- Aplicação do pacote e do dicionário na release correta, com UPDDISTR e validação em homologação
- Levantamento das customizações que ainda tratam CNPJ como campo numérico
- Revisão de integrações e leiautes de documentos auxiliares
- Montagem de massa de teste e roteiro de homologação
- Suporte e sustentação (AMS) para as próximas fases do calendário fiscal
Se você não sabe dizer hoje quantos pontos do seu ambiente assumem que CNPJ é só número, fale com um especialista.
Perguntas frequentes sobre o CNPJ alfanumérico
O CNPJ da minha empresa vai mudar?
Não. A Receita Federal confirma que quem já está inscrito permanece com o seu número válido. O formato alfanumérico vale exclusivamente para novas inscrições a partir de julho de 2026. O MEI também continua com CNPJ numérico.
Se o meu CNPJ não muda, por que preciso mexer no sistema?
Porque o CNPJ de terceiros muda. Empresas abertas a partir de julho de 2026 podem receber CNPJ com letras, e elas viram seus clientes, fornecedores e transportadores. O formato novo chega no seu cadastro, no seu XML e nos seus relatórios mesmo sem o seu número mudar.
Como fica o cálculo do dígito verificador?
Continua sendo módulo 11, mas o valor de cada caractere passa a ser o código ASCII menos 48. Os números mantêm o mesmo valor de antes e as letras entram na sequência, com A valendo 17, B valendo 18 e assim por diante. Isso preserva a validação dos CNPJs numéricos já existentes.
O que a TOTVS já entregou para o Protheus?
No Faturamento, a alteração das máscaras e validações de oito campos de CNPJ, entregue pelo pacote de Expedição Contínua, válido para todas as versões. A aplicação exige o pacote, a cópia do dicionário da pasta sdf e a execução do UPDDISTR.
Aplicar o pacote resolve tudo?
Não. A própria TOTVS delimita que o Faturamento atua apenas nos cadastros indicados. Customizações do seu ambiente, integrações externas e leiautes próprios não são cobertos pelo pacote e precisam de revisão individual.
O CNPJ alfanumérico afeta a chave de acesso da NF-e?
Sim, e esse é um dos pontos mais subestimados. Como o CNPJ do emitente compõe a chave de 44 posições, a chave deixa de ser puramente numérica e passa a seguir a expressão [0-9]{6}[A-Z0-9]{12}[0-9]{26}. Qualquer rotina que trate chave de acesso como número precisa ser revista.
As letras I, O, U, Q e F serão aceitas?
Circula a informação de que essas letras seriam excluídas para evitar confusão visual com números, mas isso consta como uma solicitação técnica do ENCAT à Receita Federal ainda pendente de confirmação. Enquanto não houver publicação oficial, não é recomendável construir validação assumindo essa exclusão.
Fontes oficiais
- Receita Federal do Brasil: portal do projeto CNPJ Alfanumérico (cronograma de implantação)
- Instrução Normativa RFB nº 2.229/2024, publicada em 15/10/2024
- Receita Federal: Simulador do CNPJ Alfanumérico e documento técnico de cálculo do dígito verificador
- TOTVS, Central de Atendimento: Cross Segmentos, Backoffice Protheus, SIGAFAT, CNPJ Alfanumérico no Faturamento
- TOTVS, Espaço Legislação: CNPJ Alfanumérico (estrutura, dígito verificador, chave de acesso e código de barras)
- Nota Técnica 2026.004 v1.00, de 30/04/2026 (schema da NF-e e NFC-e)
- Nota Técnica Conjunta DFe-NTCJ-2025.001, CNPJ Alfa
Continuar lendo
Posts relacionados
Rejeição 1111 no Protheus: por que a NF-e trava mesmo com a rejeição adiada
A 1111 não é falta de IBS e CBS, é excesso: o grupo gDevTrib enviado onde não podia. Veja a causa real, o patch por release do Protheus e por que a solução que circula vira passivo fiscal.
NF-e sem IBS e CBS: rejeição adiada, obrigação mantida no Protheus
A rejeição da NF-e sem IBS e CBS foi adiada em 3 de agosto de 2026, mas a obrigação de preencher continua valendo. Veja os prazos, o checklist no Protheus e o que fazer se você usa outro sistema.
cClassTrib no Protheus: como atualizar a tabela do Informe Técnico 2025.002 v1.60
A v1.60 do Informe Técnico 2025.002 vigora desde 10 de julho e encerrou os códigos do CST 220. Veja como atualizar a tabela cClassTrib no Configurador de Tributos do Protheus antes de 3 de agosto.