PORTAL DE DOCUMENTAÇÃO
eDocs - versão 5.8.16
Manual do usuário - eDocs > Documentos eletrônicos > Adaptação do eDocs para CNPJ Alfanumérico

Adaptação do eDocs para CNPJ Alfanumérico

A Receita Federal do Brasil está implementando um novo formato de Cadastro Nacional da Pessoa Jurídica (CNPJ), permitindo a utilização de caracteres alfanuméricos (letras de A a Z e números de 0 a 9) em substituição ao formato atual composto exclusivamente por 14 dígitos numéricos.

Para atender essa nova exigência, o eDocs foi adaptado para suportar o tratamento de CNPJ alfanumérico em seus processos de emissão, recebimento, validação, armazenamento, consulta, impressão e integração de documentos fiscais eletrônicos.

As alterações contemplam a adequação de campos, validações e regras de negócio anteriormente baseadas em valores numéricos, passando a considerar o novo padrão definido pelos órgãos fiscais.

Importante

Não foi possível realizar testes de ponta a ponta (transmissão efetiva à SEFAZ com autorização real) para os fluxos de emissão com CNPJ alfanumérico. Isso se deve ao fato de que, até o momento, não há certificados digitais válidos disponíveis para filiais com CNPJ no novo formato alfanumérico, impossibilitando a autorização dos documentos nos ambientes da SEFAZ (produção e homologação).

Toda a validação realizada foi baseada em testes de simulação interna de autorizações em base de dados, garantindo a corretude da lógica aplicacional de ponta a ponta dentro do sistema (integração do XML > persistência > consulta > impressão). Porém, cenários que dependem de resposta real da SEFAZ (rejeições específicas, comportamento de contingência em produção, etc.) só poderão ser validados quando o ambiente fiscal estiver disponível para o novo formato.

Dessa forma, embora o sistema esteja preparado para operar com CNPJ alfanumérico, podem existir ajustes necessários que só serão identificados após a disponibilização dos certificados digitais e a abertura do ambiente de homologação pela SEFAZ para o novo formato.

Documentos Adaptados

NF-e (Nota Fiscal Eletrônica) — NT 2026.004 v1.01

Observação

Eventos NF-e ainda sem schema oficial publicado pela SEFAZ

A NT 2026.004 não contemplou a publicação de schemas atualizados para os seguintes eventos. Portanto, esses eventos ainda não suportam o envio com CNPJ alfanumérico até que a SEFAZ disponibilize os schemas:

Nota: A consulta de documentos de interesse (Distribuição de DF-e) já suporta CNPJ alfanumérico conforme NT 2014.002 v1.40.

NFC-e (Nota Fiscal de Consumidor Eletrônica) — NT 2026.004 v1.01

CT-e (Conhecimento de Transporte Eletrônico) — NT 2025.001

MDF-e (Manifesto Eletrônico de Documentos Fiscais) — NT 2025.001 v1.03

NF3e (Nota Fiscal de Energia Elétrica Eletrônica) — NT 2025.001 v1.14a

NFCom (Nota Fiscal de Comunicação) — NT 2025.001

NFS-e — (Nota Fiscal de Serviço Eletrônica)

Observação

  • O eDocs adaptou o recebimento de NFS-e para que seja possível receber notas com o CNPJ alfanumérico. Porém, ainda é necessário que as prefeituras se adaptem.

    • EFD-Reinf — Versão 2.1.2g

    eSocial — NT 06/2026 - CNPJ alfanumérico

    Distribuição de DF-e (Consulta de Documentos de Interesse) — NT 2014.002 v1.40

    Documentos ainda não adaptados

     

    Documento Motivo
    NFS-e (Emissão) O processo de emissão não faz parte do escopo desta versão. As alterações contemplam exclusivamente o recebimento.
    DC-e (Declaração de Conteúdo Eletrônica) Schemas oficiais ainda não disponibilizados.
    GNRE Schemas oficiais ainda não disponibilizados.
    Recintos Aduaneiros Schemas oficiais ainda não disponibilizados.
    CF-e / SAT Schemas oficiais ainda não disponibilizados.
    PAF-ECF / Bloco X Schemas oficiais ainda não disponibilizados.
    Receituário Agronômico Schemas oficiais ainda não disponibilizados.

    RDLC Customizado — Adequacao para CNPJ Alfanumérico

    Com a adaptação do eDocs para suporte ao CNPJ alfanumérico, clientes que utilizam templates RDLC customizados para impressão de documentos fiscais (DACTE, DAMDFE, DANFE etc.) precisam adequar seus arquivos para evitar erros de formatação (#Error) nos campos de CNPJ/CPF.

    Importante

    Quem será afetado? Apenas clientes que possuem templates RDLC customizados precisam realizar essa adequação. Se você utiliza o template padrão do sistema, nenhuma ação é necessária, pois o eDocs já entrega os templates atualizados automaticamente.

    ClosedOpções de Adequação
    Opção Descrição Complexidade
    Restaurar o padrão Deixar de usar o customizado e restaurar o template padrão do sistema. Nenhuma
    Acionar o time de customização Solicitar ao time responsável pela customização que aplique as alterações. Baixa (para o cliente)
    Editar manualmente Abrir o RDLC em um editor de texto e aplicar as 4 alterações descritas abaixo. Média

     

    Alterações Necessárias (Edição Manual)

    Os arquivos RDLC são XML e podem ser editados com qualquer editor de texto (Notepad++, VS Code etc.).

    1. Alterar o tipo dos campos de CNPJ/CPF

    Nos templates de CT-e, CT-e OS, MDF-e, CC-e e PedPro, localize os campos de CNPJ na seção <Fields> e altere o tipo System.Int64 para System.String.

    <!-- DE: --> 

    <rd:TypeName>System.Int64</rd:TypeName>

    <!-- PARA: --> 

    <rd:TypeName>System.String</rd:TypeName>

    Campos Afetados:

    • RemetenteCpfCnpj
    • DestinatarioCpfCnpj
    • ExpedidorCpfCnpj
    • RecebedorCpfCnpj
    • TomadorCpfCnpj
    • EmissorCnpj
    • EmitenteCnpj
    • CnpjFornecedor
    • CnpjPagador
    • CpfCnpjChaveEsquerda
    • CpfCnpjChaveDireita
    • ProprietarioVeiculoCpfCnpj

    NF-e / NFC-e: Ja eram System.String. Pule esta etapa.

    2. Atualizar as expressões de exibição do CNPJ/CPF

    Nos templates de CT-e, CT-e OS, CT-e CC-e e MDF-e, as expressões utilizadas para exibir o CNPJ passaram a utilizar os novos campos DocumentoAlfanumerico.

    <!-- DE: --> 

    <Value>=Code.FormatarCPFCNPJ(Sum(Fields!TomadorCpfCnpj.Value, "Cte"), ...)</Value>

    <!-- PARA: --> 

    <Value>=Code.FormatarCPFCNPJ(First(Fields!TomadorDocumentoAlfanumerico.Value, "Cte"), ...)</Value>

    Padrão de Substituição

    • Sum(Fields!XxxCpfCnpj.Value, ...) muda para First(Fields!XxxDocumentoAlfanumerico.Value, ...)
    • Sum(Fields!EmissorCnpj.Value, ...) muda para First(Fields!EmissorDocumentoAlfanumerico.Value, ...)
    • Fields!CnpjFornecedor.Value muda para Fields!DocumentoFornecedorAlfanumerico.Value
    • First(Fields!EmitenteCnpj.Value, "Mdfe") muda para First(Fields!EmitenteDocumentoAlfanumerico.Value, "Mdfe")

    Para CCe (NF-e) e PedPro: apenas troque Sum por First (o nome do campo permanece o mesmo).

    NF-e / NFC-e: Pule esta etapa.

    3. Reduzir o tamanho da fonte (recomendado)

    Nos campos de CNPJ dos templates de CT-e e CT-e OS, reduza o valor de FontSize em 1 pt para evitar truncamento:

    • 7 pt, mudar para → 6 pt
    • 8 pt , mudar para → 7 pt

    4. Atualizar a função VB FormatarCPFCNPJ

    ⚠ Esta alteração aplica-se a todos os templates customizados (NFe, NFC-e, CT-e, MDF-e, NFS-e etc.).

    Na seção <Code> do RDLC, substitua a função:

    DE (versao antiga) 

    Public Function FormatarCPFCNPJ(Valor As String, ehCnpj As Boolean) As String 
 If Trim(Valor) = "" OR Valor = "0" Then
	FormatarCPFCNPJ = ""
 ElseIf ehCnpj Then
	...
	End If
End Function

    PARA (versão nova) 

    Public Function FormatarCPFCNPJ(Valor As Object, ehCnpj As Boolean) As String
									If IsNothing(Valor) Then
									FormatarCPFCNPJ = ""
									Exit Function
									End If

									Dim ValorStr As String = Valor.ToString().Trim()

									If ValorStr = "" OR ValorStr = "0" Then
									FormatarCPFCNPJ = ""
									ElseIf ehCnpj Then
									While Len(ValorStr) < 14
									ValorStr = "0" & ValorStr
									End While
									FormatarCPFCNPJ = Mid(ValorStr, 1, 2) & "." & Mid(ValorStr, 3, 3) & "." & Mid(ValorStr, 6, 3) & "/" & Mid(ValorStr, 9, 4) & "-" & Mid(ValorStr, 13, 2)
									Else
									While Len(ValorStr) < 11
									ValorStr = "0" & ValorStr
									End While
									FormatarCPFCNPJ = Mid(ValorStr, 1, 3) & "." & Mid(ValorStr, 4, 3) & "." & Mid(ValorStr, 7, 3) & "-" & Mid(ValorStr, 10, 2)
									End If
								End Function

    Resumo da mudança: substitua As String por As Object no parâmetro, adicione a verificação IsNothing(Valor) no início e utilize ValorStr (por meio de Valor.ToString().Trim()) no restante do corpo da função.

    Se existir também a função FormatarCPFCNPJEstilo, aplique a mesma alteração.

    Resumo Rapido

     

    Template O que fazer
    CT-e / CT-e OS Etapas 1 + 2 + 3 + 4
    CT-e CCe Etapas 1 + 2 + 3 + 4
    MDF-e Etapas 1 + 2 + 4
    CCe (NF-e) / PedPro Etapas 1 + 2 + 4
    NFS-e Recebimento Etapas 2 + 4
    NF-e / NFC-e Somente Etapa 4

    Após a edição

    1. Reimporte o template customizado no sistema.

     

    Este artigo ajudou você?

    Base de Conhecimento

    Portal de Exigências Legais

    Contrato de Licenciamento de Software e Prestação de Serviços

    Documentação em outros idiomas:

    English

    Español

    Senior Store

    Universidade Corporativa

    Fórum de Produtos

    Trabalhe conosco

    Blog

    Todos os direitos de cópias reservadas para Senior Sistemas S.A.

    A reprodução não autorizada desta publicação, no todo ou em parte, constitui violação dos direitos autorais (Lei 9.610/98).

    Ver site completo