> 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/es/blog/cnpj-alfanumerico-de-prueba.md).

# CNPJ Alfanumérico de Prueba

Usa el CNPJ de ejemplo `UKPVME1E8HI996` para probar tu integración con el nuevo formato

A partir de julio de 2026, la Receita Federal de Brasil podrá emitir nuevas inscripciones de CNPJ en formato alfanumérico (con letras y números). Las inscripciones existentes no se modificarán. Si quieres entender cómo funciona el nuevo formato y cómo calcular los dígitos verificadores, consulta el artículo [CNPJ Alfanumérico](https://docs.cnpj.ws/blog/cnpj-alfanumerico).

La API de CNPJ.ws ya está preparada para el nuevo formato. Para ayudar a quienes están adaptando sus sistemas, creamos un **CNPJ alfanumérico de ejemplo** que puedes usar para probar tu validación de dígitos verificadores y tu integración con la API antes de que las inscripciones reales entren en circulación.

#### CNPJ de ejemplo

```
UKPVME1E8HI996
```

Formateado, queda así:

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

Observa su estructura, que sigue el mismo patrón del CNPJ actual:

| Parte                 | Valor      | Descripción                                                |
| --------------------- | ---------- | ---------------------------------------------------------- |
| Raíz                  | `UKPVME1E` | Identifica a la empresa (8 caracteres alfanuméricos)       |
| Orden                 | `8HI9`     | Identifica al establecimiento (4 caracteres alfanuméricos) |
| Dígitos verificadores | `96`       | Dígitos de verificación (2 caracteres, siempre numéricos)  |

Los dígitos verificadores `96` se calcularon a partir de los doce primeros caracteres usando módulo 11, exactamente como se describe en el artículo [CNPJ Alfanumérico](https://docs.cnpj.ws/blog/cnpj-alfanumerico). Es decir: es un CNPJ válido desde el punto de vista del algoritmo, ideal para validar tu implementación.

#### Probar la validación de los dígitos verificadores

Si implementaste el cálculo de los dígitos verificadores en tu sistema, ejecuta el algoritmo sobre los doce primeros caracteres (`UKPVME1E8HI9`) y comprueba que el resultado sea `96`. Si coincide, tu validación es correcta.

Para comprobarlo manualmente, basta con sustituir cada carácter por su valor (ASCII − 48), aplicar los pesos de 2 a 9 de derecha a izquierda y obtener el resto de la división por 11 — el paso a paso completo está en el [artículo del cálculo](https://docs.cnpj.ws/blog/cnpj-alfanumerico).

#### Probar en la API de CNPJ.ws

El CNPJ de ejemplo se puede enviar directamente a la API, **sin caracteres especiales** (sin puntos, barra ni guion).

**Método:** `GET`

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

**Ejemplo con cURL**

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

**Ejemplo con JavaScript / Node.js**

Usando `fetch`:

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

consultarCNPJ("UKPVME1E8HI996");
```

**Ejemplo con el paquete `consultar-cnpj`**

También mantenemos el paquete oficial [`consultar-cnpj`](https://github.com/cnpj-ws/consultar-cnpj) ([npm](https://www.npmjs.com/package/consultar-cnpj)), que facilita la integración en Node.js. **A partir de la versión 1.0.21 ya acepta CNPJ alfanumérico**, así que basta con actualizar a la última versión:

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

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

async function getCNPJ() {
  // El token es opcional — sin él, se usa la API Pública (3 consultas/min)
  const token = "INGRESA TU TOKEN DE ACCESO";

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

getCNPJ();
```

> **Importante:** al tratarse de un CNPJ ficticio, creado únicamente para pruebas, **no devuelve datos registrales de una empresa real**. El objetivo es validar que tu aplicación acepta, procesa y envía el formato alfanumérico correctamente en toda la cadena — desde el formulario hasta la llamada a la API. Para recibir datos reales, utiliza un 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/es/blog/cnpj-alfanumerico-de-prueba.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.