CNPJ Alfanumérico de Prueba

La API de CNPJ.ws ya está preparada. Adapta tu aplicación con calma usando este ejemplo y estarás listo cuando las primeras inscripciones alfanuméricas comiencen a emitirse, en julio de 2026.

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.

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. 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.

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

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

Ejemplo con JavaScript / Node.js

Usando fetch:

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 (npm), 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:

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

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.