CNPJ alfanumérico: o que muda e como testar na API

Desde julho de 2026 a Receita Federal emite CNPJs com letras. Eles já existem e já aparecem nos dados públicos. Se o seu sistema só aceita números no campo de CNPJ, ele vai recusar empresas reais.

A cnpj-api já consulta, valida e formata o novo formato em todos os endpoints. Nada muda para os CNPJs numéricos. Este artigo mostra um CNPJ alfanumérico real, o que mudou no número, como a API responde e o que revisar do seu lado.

Um CNPJ real para testar

00.000.000/E08G-12

É uma agência do Banco do Brasil em Brasília, aberta em 31/07/2026. Está na base da Receita Federal e já responde na API. As letras estão na parte da filial (E08G), e a raiz 00.000.000 continua numérica: é assim que a maioria dos primeiros CNPJs alfanuméricos aparece, como novas filiais de empresas que já existem.

Você pode abrir a página pública desta empresa em cnpj-api.com/cnpj/00000000E08G12.

O que mudou no número

O tamanho continua sendo 14 caracteres e a formatação continua sendo XX.XXX.XXX/XXXX-XX. O cálculo dos dígitos verificadores é o mesmo módulo 11 de sempre, com uma regra a mais: cada letra vale o seu código ASCII menos 48, ou seja, A=17, B=18, e assim por diante até Z=42. Os dígitos mantêm o valor normal.

Os dois formatos convivem. Nenhum CNPJ numérico deixa de valer, e nenhuma empresa existente teve o número trocado.

Como a cnpj-api responde

Consulte um CNPJ alfanumérico do mesmo jeito que um numérico:

curl "https://api.cnpj-api.com/v1/cnpj/00000000E08G12" \
  -H "api-token: SEU_TOKEN"

Resposta, com os campos principais:

{
  "cnpj": "00000000E08G12",
  "razao_social": "BANCO DO BRASIL SA",
  "data_abertura": "2026-07-31",
  "matriz": false,
  "mei": false,
  "situacao": { "codigo": 2, "descricao": "Ativa" },
  "atividade_principal": {
    "codigo": 6422100,
    "descricao": "Bancos múltiplos, com carteira comercial"
  },
  "endereco": { "municipio": "BRASILIA", "uf": "DF" },
  "empresa": {
    "cnpj_basico": "00000000",
    "porte": { "codigo": 5, "sigla": "Demais", "descricao": "Demais" }
  }
}

A API aceita o CNPJ com ou sem pontuação, em maiúsculas ou minúsculas. A resposta devolve sempre em maiúsculas. O mesmo vale para /v1/simples, para a consulta em lote e para os formatos de compatibilidade receitaws e cnpja.

O novo campo mei

Junto com o suporte ao formato alfanumérico, a resposta de /v1/cnpj ganhou um campo na raiz:

{
  "cnpj": "00000000E08G12",
  "mei": false
}

mei é true quando a empresa está enquadrada no MEI e false nos demais casos, inclusive quando ela nunca optou pelo Simples Nacional. Está sempre presente, então dá para filtrar sem checar se empresa.simei existe. É um campo a mais: nada foi removido ou renomeado. A documentação do endpoint descreve a resposta completa, e o guia Como saber se um CNPJ é MEI explica o que o enquadramento significa e as outras formas de conferir.

O que revisar no seu sistema

Validação. Onde o sistema confere se o CNPJ tem 14 números, passe a aceitar letras nas 12 primeiras posições. Na prática: troque ^\d{14}$ por ^[A-Z0-9]{12}\d{2}$ e aplique o mapeamento de letras no cálculo dos dígitos verificadores.

Campos de formulário. Máscaras que descartam letras e inputmode="numeric" impedem o usuário de digitar o CNPJ novo. O campo precisa aceitar letras e números.

Banco de dados. Colunas numéricas, ou CHAR(14) com validação de dígitos, precisam aceitar letras. Se o CNPJ é usado como chave, confira também índices e integrações que recebem o valor.

Para conferir um número na mão, o validador de CNPJ mostra cada etapa do cálculo e diz se o número é tradicional ou alfanumérico. O gerador de CNPJ alfanumérico cria números válidos para os seus testes.

Empresas novas aparecem primeiro nos dados em tempo real

Todo CNPJ alfanumérico é uma empresa ou filial recém-aberta. No plano gratuito, a consulta usa a base mensal da Receita Federal, então uma empresa aberta nesta semana só aparece na próxima atualização. Nos planos Basic e Pro, a consulta busca em tempo real quando o CNPJ ainda não está na base.

Perguntas frequentes

Meu CNPJ atual vai mudar?

Não. CNPJs já emitidos continuam iguais e continuam válidos. Só novos registros recebem o formato alfanumérico.

Os dígitos verificadores continuam numéricos?

Sim. As posições 13 e 14 são sempre dígitos, nos dois formatos.

A consulta em lote aceita o novo formato?

Sim. Envie o CNPJ alfanumérico na lista como qualquer outro. A resposta devolve o número em maiúsculas.

Encontrei um CNPJ alfanumérico que não respondeu como esperado

Escreva para [email protected] com o número. A equipe olha cada caso.