CNPJ Alfanumérico
CNPJ Alfanumérico no Cadastro de Parceiro
Manual para configuração da máscara e validação do novo padrão de CNPJ alfanumérico.
1. Visão geral
O sistema passa a aceitar o novo padrão de CNPJ alfanumérico.
O CNPJ continua com 14 posições, porém as 12 primeiras posições podem conter letras e números.
Exemplo:
12.ABC.345/01DE-35
As duas últimas posições continuam sendo os dígitos verificadores e devem ser numéricas.
2. Onde configurar
Acesse:
Configuração Geral
Configuração Geral → Parceiro
Campos disponíveis:
| Campo | Finalidade |
|---|---|
| Máscara do CNPJ alfanumérico | Define o formato permitido para preenchimento |
| Validar CNPJ alfanumérico | Define se o sistema validará o dígito verificador |
3. Máscara do CNPJ alfanumérico
A máscara define quais posições aceitam letras e quais posições aceitam apenas números.
Máscara padrão sugerida
SS.SSS.SSS/SSSS-VV
4. Tipos de caracteres
| Tipo | O que aceita | Quando usar |
|---|---|---|
| S | Letras A–Z ou números 0–9 | Posições alfanuméricas do CNPJ |
| N | Apenas números 0–9 | Posições exclusivamente numéricas |
| V | Apenas números 0–9 | Dígitos verificadores |
5. Exemplos de máscara
Modelo totalmente alfanumérico
Máscara:
SS.SSS.SSS/SSSS-VV
Aceita:
-
12.ABC.345/01DE-35 -
AB.123.CD4/EF56-78
Modelo parcialmente numérico
Máscara:
NN.NNN.NNN/SSSS-VV
Aceita:
-
12.345.678/ABCD-90
Não aceita:
-
AB.345.678/ABCD-90
6. Validar CNPJ alfanumérico
Essa opção define se o sistema irá validar os dígitos verificadores do CNPJ.
| Opção | Comportamento | Recomendação |
|---|---|---|
| Sim | Valida máscara e calcula o dígito verificador | Recomendado para produção |
| Não | Valida somente o formato da máscara | Indicado para homologação, testes ou transição |
7. Quando marcar “Sim”
Use Sim quando o ambiente exigir validação completa do CNPJ.
Com essa opção ativa, o sistema:
- valida o preenchimento da máscara;
- calcula os dígitos verificadores;
- aplica a regra oficial da Receita Federal.
Recomendado para ambiente de produção.
8. Quando marcar “Não”
Use Não quando a necessidade for apenas validar o formato informado.
Com essa opção ativa, o sistema:
- valida somente a máscara;
- não calcula o dígito verificador;
- não confirma se o CNPJ é válido pela regra oficial.
Indicado para homologação, testes ou fase de transição.
9. Funcionamento do dígito verificador
O cálculo do DV utiliza módulo 11, considerando letras e números nas 12 primeiras posições.
As letras são convertidas para valores numéricos antes do cálculo.
| Caractere | Valor utilizado |
|---|---|
| A | 17 |
| B | 18 |
| C | 19 |
| D | 20 |
O usuário não precisa calcular o DV manualmente.
Quando a validação estiver habilitada, o sistema faz isso automaticamente.
10. Exemplos de utilização
Exemplo válido
12.ABC.345/01DE-35
Resultado:
- máscara válida;
- DV válido;
- cadastro permitido.
Exemplo inválido
12.ABC.345/01DE-99
Resultado:
- máscara válida;
- DV inválido;
- cadastro bloqueado quando a validação estiver habilitada.
11. Recomendações
| Ambiente | Configuração recomendada |
|---|---|
| Produção | Validar CNPJ alfanumérico = Sim |
| Homologação/Testes | Validar CNPJ alfanumérico = Não |
12. Observações importantes
- As letras são permitidas apenas nas 12 primeiras posições do CNPJ.
- Os dois últimos caracteres devem ser numéricos.
- Os caracteres da máscara, como ponto, barra e hífen, são exibidos conforme configurados.
- A máscara pode ser personalizada conforme necessidade operacional.
- O CNPJ numérico tradicional continua sendo aceito.