# Como validar CNPJ em JavaScript (inclusive o alfanumérico)

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

```ts
/** 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"); // false
```

Dois 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](https://apizen.com.br/docs/cnpj). Para um formulário, a rota `/nome` é a mais leve:

```ts
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](https://apizen.com.br/entrar): 5 mil consultas por mês, sem cartão.
