Desde 2026, a Receita Federal emite CNPJs alfanuméricos. As oito posições da raiz e as quatro da ordem podem conter letras e dígitos. Os dois dígitos verificadores continuam numéricos. Este artigo aborda o formato, o que quebra, a regra do dígito com um exemplo calculado passo a passo e como a API do cnpj.ia.br trata os dois formatos.
Exemplos de CNPJ
CNPJ Numérico: 00.000.000/0001-91, do Banco do Brasil.
CNPJ Alfanumérico: 12.ABC.345/01DE-35, exemplo de formato do contrato da API.
Formato Antigo e Novo
O formato antigo continua válido, os números existentes não mudam, e a rotina nova aceita os dois formatos. Quem atualiza a validação uma vez cobre o estoque e o fluxo novo.
Problemas com o Bigint e o VARCHAR(14)
- Letras não cabem em número: 12ABC34501DE35 não é inteiro. A primeira inserção de um CNPJ alfanumérico em coluna BIGINT ou NUMERIC(14) falha. Em alguns modos de banco, pior: trunca em silêncio e grava lixo.
- Zero à esquerda some: 00000000000191 como inteiro vira 191. Toda leitura precisa reaplicar padding com LPAD, e toda comparação direta com string falha sem aviso.
- Pontuação varia: 00.000.000/0001-91 e 00000000000191 são a mesma empresa em duas strings distintas. Coluna numérica resolve esse caso por acidente e quebra nos dois anteriores.
A forma que sobrevive: texto de 14 caracteres, maiúsculas, sem pontuação. O fluxo de entrada fica assim:
- Remove pontos, barra, hífen e espaços.
- Valida comprimento (14) e dígitos verificadores.
- Guarda na forma normalizada. Formata só na exibição.
Máscaras de Entrada
Máscaras de entrada no padrão ##.###.###/####-## passam a aceitar letras nas doze primeiras posições. Os dois últimos campos continuam numéricos. Comparações e chaves estrangeiras usam a forma normalizada que a API devolve.
Como a API do cnpj.ia.br Trata o Formato
A API aceita o formato antigo e o novo, com ou sem pontuação, minúsculas ou maiúsculas. Remove pontos, barra e hífen antes de validar, valida os dígitos pelo algoritmo alfanumérico e devolve cnpj e raiz_cnpj normalizados. Nada muda nos endpoints nem nos créditos.
Resumo para o Banco do Brasil
A API do cnpj.ia.br responde com 400 invalid_cnpj ou 404 not_found para formatos ou CNPJs inválidos. Toda resposta informa a data da base em meta.data_as_of. A base é a da Receita Federal, atualizada mensalmente. O basic custa 1 crédito; o full, 6. O plano gratuito inclui 60 créditos.
Conclusão
Este guia aborda a validação e tratamento do formato CNPJ alfanumérico, incluindo a regra do dígito e como a API do cnpj.ia.br trata os dois formatos. A API é flexível, respeitando tanto o formato antigo quanto o novo, sem alterar os endpoints ou os créditos.