# 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**\
[![image-1779190331447.31.16.png](https://kb.illimitar.pro/uploads/images/gallery/2026-05/scaled-1680-/image-1779190331447-31-16.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-05/image-1779190331447-31-16.png)

**Configuração Geral → Parceiro**\
[![image-1779190587990.34.42.png](https://kb.illimitar.pro/uploads/images/gallery/2026-05/scaled-1680-/image-1779190587990-34-42.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-05/image-1779190587990-34-42.png)

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:
[![](https://kb.illimitar.pro/uploads/images/gallery/2026-05/scaled-1680-/image-1779191586916-53-03.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-05/image-1779191586916-53-03.png)

[![](https://kb.illimitar.pro/uploads/images/gallery/2026-05/scaled-1680-/image-1779191614957-53-30.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-05/image-1779191614957-53-30.png)

- máscara válida;
- DV válido;
- cadastro permitido.
  

---

#### Exemplo inválido

`12.ABC.345/01DE-99`

Resultado:
[![](https://kb.illimitar.pro/uploads/images/gallery/2026-05/scaled-1680-/image-1779191677895-54-34.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-05/image-1779191677895-54-34.png)

[![](https://kb.illimitar.pro/uploads/images/gallery/2026-05/scaled-1680-/image-1779191694621-54-50.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-05/image-1779191694621-54-50.png)
- 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.