Como validar CNPJ em JavaScript (inclusive o alfanumérico)
Ver em .mdOs dígitos verificadores do CNPJ numérico e do alfanumérico em TypeScript, e como conferir se o CNPJ existe e está ativo.
Validar um CNPJ tem duas partes: conferir os dígitos verificadores (o CNPJ é bem formado?) e consultar a Receita (ele existe e está ativo?). A primeira roda no navegador, sem rede; a segunda precisa de uma API.
1. Os dígitos verificadores
Desde julho de 2026 a Receita emite CNPJs alfanuméricos: os 12 primeiros caracteres podem ter letras (A–Z), os dois últimos continuam sendo dígitos. A conta é a mesma do CNPJ numérico, com um detalhe: cada caractere vale o seu código ASCII menos 48. Assim os dígitos mantêm o valor (0–9) e as letras valem de 17 (A) a 42 (Z). Um validador escrito assim aceita os dois formatos.
/** Mantém o que um CNPJ pode ter: letras só nos 12 primeiros caracteres. */
export function limparCnpj(valor: string): string {
let out = "";
for (const c of valor.toUpperCase()) {
if (out.length >= 14) break;
if ((c >= "0" && c <= "9") || (c >= "A" && c <= "Z" && out.length < 12)) out += c;
}
return out;
}
function digito(corpo: string): number {
let soma = 0;
let peso = 2;
for (let i = corpo.length - 1; i >= 0; i--) {
soma += (corpo.charCodeAt(i) - 48) * peso;
peso = peso === 9 ? 2 : peso + 1;
}
const resto = soma % 11;
return resto < 2 ? 0 : 11 - resto;
}
export function cnpjValido(valor: string): boolean {
const v = limparCnpj(valor);
if (!/^[0-9A-Z]{12}[0-9]{2}$/.test(v) || /^(.)\1{13}$/.test(v)) return false;
const d1 = digito(v.slice(0, 12));
const d2 = digito(v.slice(0, 12) + d1);
return v.slice(12) === `${d1}${d2}`;
}
cnpjValido("33.000.167/0001-01"); // true
cnpjValido("33.000.167/0001-02"); // falseDois cuidados: guarde o CNPJ como texto (não como número: zeros à esquerda e letras somem) com 14 caracteres, em maiúsculas; e mostre-o com a máscara 00.000.000/0000-00, que vale também para o alfanumérico.
2. Ele existe e está ativo?
Dígitos certos não garantem que a empresa existe. Para isso, consulte o cadastro na Receita pela API de CNPJ. Para um formulário, a rota /nome é a mais leve:
const res = await fetch(
`https://cnpj.apizen.com.br/v1/cnpj/${limparCnpj(valor)}/nome`,
{ headers: { Authorization: `Bearer ${process.env.CNPJ_API_KEY}` } },
);
if (res.status === 404) throw new Error("CNPJ não encontrado na Receita");
const { razao_social, nome_fantasia } = await res.json();Para saber se está ativo (e preencher endereço, CNAE, Simples), use /v1/cnpj/{cnpj} e o campo ativa. A chave é secreta: faça a chamada no seu servidor (uma rota da sua API, uma Server Action), nunca direto do navegador.
Crie uma chave grátis: 5 mil consultas por mês, sem cartão.