CNPJ Alfanumérico de Teste

A API do CNPJ.ws já está preparada. Adapte sua aplicação com calma usando esse exemplo e você estará pronto quando as primeiras inscrições alfanuméricas começarem a ser emitidas, em julho de 2026.

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.

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

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

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

Exemplo com JavaScript / Node.js

Usando fetch:

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

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

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.