WeePulse Blog Logo

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.

Por WeePulse
Imagem de capa do post CNPJ alfanumérico no Protheus: já começou, e não é só o campo do cadastro
CategoriasFiscalProtheus

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:

CampoPicture anteriorNova pictureValidação (X3_VALID)
A1_CGC@R 99.999.999/9999-99@!R NN.NNN.NNN/NNNN-99Já possui validação padrão
A1U_CGC@R 99.999.999/9999-99@!R NN.NNN.NNN/NNNN-99Já possui validação padrão
A4_CGC@R 99.999.999/9999-99@!R NN.NNN.NNN/NNNN-99Já possui validação padrão
AD0_CNPJ@1@!R NN.NNN.NNN/NNNN-99Vazio() .Or. CGC(M->AD0_CNPJ)
ADL_CGCsem picture@!R NN.NNN.NNN/NNNN-99Vazio() .Or. CGC(M->ADL_CGC)
C5_CGCINT@!@!R NN.NNN.NNN/NNNN-99Vazio() .Or. CGC(M->C5_CGCINT)
D9_CNPJ@!@!R NN.NNN.NNN/NNNN-99Vazio() .Or. CGC(M->D9_CNPJ)
F2_CGCCLI@R 99.999.999/9999-99@!R NN.NNN.NNN/NNNN-99Vazio() .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:

  1. 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
  2. Aplicar o dicionário que vem na pasta sdf: abra a pasta SDF, depois a pasta bra, e copie as pastas substituindo o conteúdo em protheus > protheus_data > systemload
  3. 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

  1. Identifique a sua release e confirme a disponibilidade do pacote de Expedição Contínua
  2. Aplique pacote e dicionário, e rode o UPDDISTR
  3. Confirme que os 8 campos ficaram com a picture nova
  4. Levante onde há customização que toca CNPJ: relatórios, integrações, validadores, tabelas próprias
  5. Verifique se algum campo trata chave de acesso como numérico
  6. Revise o leiaute do DANFE customizado, por causa do código de barras maior
  7. Gere massa de teste no simulador da Receita
  8. Emita, imprima e concilie em homologação
  9. Cheque o cronograma da obrigação específica que você entrega
  10. 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

Ver todos

Vamos revisar o seu ambiente?

Conte qual release do Protheus você usa e onde há customização que toca CNPJ (relatórios, integrações, validadores próprios). Um especialista da WeePulse devolve o mapa do que precisa ser ajustado.

Informe um e-mail corporativo válido.