> For the complete documentation index, see [llms.txt](https://docs.cnpj.ws/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cnpj.ws/blog/cnpj-alfanumerico-de-teste.md).

# CNPJ Alfanumérico de Teste

Use o CNPJ de exemplo `UKPVME1E8HI996` para testar sua integração com o novo formato

A partir de julho de 2026 a Receita Federal poderá emitir novas inscrições no CNPJ no formato alfanumérico (com letras e números). Os cadastros existentes não serão alterados. Se quiser entender como o novo formato funciona e como calcular os dígitos verificadores, veja o artigo [CNPJ Alfanumérico](https://docs.cnpj.ws/blog/cnpj-alfanumerico).

A API do CNPJ.ws já está preparada para o novo formato. Para ajudar quem está adaptando seus sistemas, criamos um **CNPJ alfanumérico de exemplo** que você pode usar para testar sua validação de dígitos verificadores e sua integração com a API antes que as inscrições reais entrem em circulação.

#### CNPJ de exemplo

```
UKPVME1E8HI996
```

Formatado, fica assim:

```
UK.PVM.E1E/8HI9-96
```

Repare na estrutura, que segue o mesmo padrão do CNPJ atual:

| Parte | Valor      | Descrição                                                  |
| ----- | ---------- | ---------------------------------------------------------- |
| Raiz  | `UKPVME1E` | Identifica a empresa (8 caracteres, alfanuméricos)         |
| Ordem | `8HI9`     | Identifica o estabelecimento (4 caracteres, alfanuméricos) |
| DV    | `96`       | Dígitos verificadores (2 caracteres, sempre numéricos)     |

Os dígitos verificadores `96` foram calculados a partir dos doze primeiros caracteres usando o módulo 11, exatamente como descrito no artigo [CNPJ Alfanumérico](https://docs.cnpj.ws/blog/cnpj-alfanumerico). Ou seja: é um CNPJ válido do ponto de vista do algoritmo, ideal para validar a sua implementação.

#### Testando a validação dos dígitos verificadores

Se você implementou o cálculo dos DVs no seu sistema, rode o algoritmo sobre os doze primeiros caracteres (`UKPVME1E8HI9`) e confira se o resultado é `96`. Se bater, sua validação está correta.

Para conferir manualmente, basta substituir cada caractere pelo seu valor (ASCII − 48), aplicar os pesos de 2 a 9 da direita para a esquerda e tirar o resto da divisão por 11 — o passo a passo completo está no [artigo do cálculo](https://docs.cnpj.ws/blog/cnpj-alfanumerico).

#### Testando na API CNPJ.ws

O CNPJ de exemplo pode ser enviado diretamente para a API, **sem caracteres especiais** (sem pontos, barra ou traço).

**Método:** `GET`

**Endpoint:** `https://publica.cnpj.ws/cnpj/UKPVME1E8HI996`

**Exemplo com cURL**

```shell
curl https://publica.cnpj.ws/cnpj/UKPVME1E8HI996
```

**Exemplo com JavaScript / Node.js**

Usando `fetch`:

```js
async function consultarCNPJ(cnpj) {
  const resposta = await fetch(`https://publica.cnpj.ws/cnpj/${cnpj}`);
  const dados = await resposta.json();
  console.log(dados);
}

consultarCNPJ("UKPVME1E8HI996");
```

**Exemplo com o pacote `consultar-cnpj`**

Também mantemos o pacote oficial [`consultar-cnpj`](https://github.com/cnpj-ws/consultar-cnpj) ([npm](https://www.npmjs.com/package/consultar-cnpj)), que facilita a integração em Node.js. **A partir da versão 1.0.22 ele já aceita CNPJ alfanumérico**, então basta atualizar para a última versão:

```shell
yarn add consultar-cnpj
# ou
npm i consultar-cnpj --save
```

```js
const consultarCNPJ = require("consultar-cnpj");

async function getCNPJ() {
  // O token é opcional — sem ele, usa a API Pública (3 consultas/min)
  const token = "INFORME O SEU TOKEN DE ACESSO";

  try {
    const empresa = await consultarCNPJ("UKPVME1E8HI996", token);
    console.log(empresa);
  } catch (e) {
    console.log(e);
  }
}

getCNPJ();
```

> **Importante:** por se tratar de um CNPJ fictício, criado apenas para testes, ele **não retorna dados cadastrais de uma empresa real**. O objetivo é validar que sua aplicação aceita, trata e envia o formato alfanumérico corretamente em toda a cadeia — do formulário até a chamada da API. Para receber dados reais, utilize um CNPJ existente.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cnpj.ws/blog/cnpj-alfanumerico-de-teste.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.