Cadastrar parceiro com CNPJ alfanumérico

Etapa 7 de 7 do processo Cadastrar parceiros. Anterior: Consultar e validar CNPJ e inscrição estadual.

A Receita Federal passou a emitir CNPJ com letras nas 12 primeiras posições (sistemas em produção desde 27/07/2026; primeiro CNPJ alfanumérico implantado em 31/07/2026). O cadastro de parceiro da 16.0 aceita e valida o novo formato; o cenário mostra o cadastro com a recusa de um dígito verificador errado. Os trechos que ainda só aceitam número (DF-e, MDF-e, remessa CNAB e manifestação) estão nos limites.

Visão geral: Cadastrar um cliente no Brasil

Limites deste cenário

Cobre só o cadastro e a validação do parceiro. A chave de acesso com letras, a consulta de DF-e da própria empresa, a importação de XML de emitente alfanumérico, a manifestação do destinatário, o MDF-e e a remessa CNAB ainda tratam o CNPJ como número e podem falhar com o novo formato; a correção do cadastro consta do PR 4634 da 16.0. O formulário do parceiro não aplica máscara nem converte para maiúsculas o que se digita (vale também para o CNPJ numérico); a consulta de IE na SEFAZ também usa só dígitos. A biblioteca de validação rejeita as letras I, O, U, Q e F; a norma fala em letras de A a Z, então a recusa deve ser tratada como provável defeito da biblioteca, até conferir o Anexo XV da IN RFB 2.229/2024. Fato com fonte: segundo a página da Receita, os sistemas entraram em produção em 27/07/2026 e o primeiro CNPJ alfanumérico foi implantado em 31/07/2026 (a página não lista as letras permitidas). Para a data de obrigatoriedade em cada documento, conferir a norma de cada documento fiscal. Fontes oficiais: https://www.gov.br/receitafederal/pt-br/acesso-a-informacao/acoes-e-programas/programas-e-atividades/cnpj-alfanumerico ; pesquisa: https://www.projetoacbr.com.br/forum/topic/93888 , https://www.projetoacbr.com.br/forum/topic/92082 , https://www.contabeis.com.br/artigos/78470/a-nova-era-do-cnpj-alfanumerico-a-transicao-comeca-agora/ , https://atendimento.tecnospeed.com.br/hc/pt-br/articles/33028028157719 .

Importante

A consulta online de CNPJ não é acionada neste vídeo: depende de serviço externo.

Vídeo

Duração: 1 min 35 s. Sem áudio: a narração está nas legendas, na faixa de baixo do vídeo.

Antes de começar

Exemplo usado neste cenário

Cadastro do cliente fictício Distribuidora Alfa Exemplo Ltda, de São Paulo, com o CNPJ alfanumérico fictício A1.B2C.3D4/E5G6-30. O vídeo digita primeiro o dígito verificador errado (-31), vê a recusa, e depois digita o CNPJ correto, com máscara, que o sistema aceita.

Como os valores são calculados:

  • Cada caractere vale o seu código ASCII menos 48: dígitos de 0 a 9 e letras de A=17 a Z=42. A raiz A1B2C3D4E5G6 vira 17,1,18,2,19,3,20,4,21,5,23,6.

  • Primeiro dígito: pesos 5,4,3,2,9,8,7,6,5,4,3,2 dão soma 712; 712 mod 11 = 8, DV = 11 - 8 = 3.

  • Segundo dígito: pesos 6,5,4,3,2,9,8,7,6,5,4,3,2 sobre os 12 valores e o primeiro DV (3) dão soma 705; 705 mod 11 = 1, menor que 2, DV = 0. O CNPJ correto termina em 30; terminar em 31 é recusado.

  • Formato: 12 posições com números ou letras maiúsculas e 2 dígitos verificadores numéricos (IN RFB 2.229/2024; Nota Técnica Conjunta 2025.001). CNPJ numérico já existente não muda.

Passo a passo

  1. Abra o aplicativo Contatos pelo menu de aplicativos e clique em Novo.

  2. Marque a opção Empresa.

  3. No campo do nome, digite Distribuidora Alfa Exemplo Ltda.

  4. Escolha o Estado São Paulo e a Cidade São Paulo.

  5. Em CNPJ/Id Estrangeiro, digite A1.B2C.3D4/E5G6-31, com o último dígito errado.

  6. Salve o cadastro: o sistema recusa o CNPJ inválido.

  7. Clique em OK para fechar o aviso.

  8. Corrija o CNPJ para A1.B2C.3D4/E5G6-30.

  9. Salve o cadastro: o CNPJ é aceito.

  10. Confira o CNPJ salvo, com letras e máscara.

  11. Aponte a lupa ao lado do CNPJ: a consulta na Receita é serviço externo e não é acionada aqui.

Resultado esperado

Parceiro salvo com o CNPJ alfanumérico como foi digitado, com máscara, depois de recusado o dígito verificador errado. A busca e a comparação interna usam a forma sem pontuação, A1B2C3D4E5G630.

Se houver erro

  • O sistema recusa um CNPJ alfanumérico que a Receita emitiu. A biblioteca de validação do Odoo recusa as letras I, O, U, Q e F nas 12 primeiras posições. A norma fala em letras de A a Z, então a recusa é provável defeito da biblioteca, até conferir o Anexo XV da IN RFB 2.229/2024. Conferir o Anexo XV da IN RFB 2.229/2024; se a letra for válida, desative a validação de CNPJ apenas para esse cadastro e abra um chamado para o mantenedor.

  • O CNPJ fica com letras minúsculas. O campo do formulário grava o texto como foi digitado, sem converter para maiúsculas. Digite as letras em maiúsculas; o XML da NF-e só aceita A a Z maiúsculas.

Módulos usados

Também usa: l10n_br_cnpj_search. Os valores do exemplo foram conferidos automaticamente na execução gravada; a conferência não substitui a validação do contador da sua empresa.