Wortic

Wortic CNPJ / Guias

Validar o CNPJ, inclusive o alfanumérico, antes de consultar

Confira os dígitos verificadores no seu sistema e só gaste consulta com CNPJ que pode existir. Funciona com o CNPJ de números e com o novo, com letras.

Publicado em .

Fontes oficiais: o CNPJ na Receita Federal e os dados abertos do CNPJ.

Um CNPJ tem 14 caracteres. Os dois últimos são dígitos verificadores, calculados a partir dos 12 primeiros. Se eles não conferem, o número foi digitado errado. Conferir isso no seu sistema é uma conta simples, sem ida à rede, e poupa uma consulta.

A regra, que vale para o CNPJ de números e o de letras

O código

export function limparCnpj(texto) {
  return String(texto).toUpperCase().replace(/[.\/\-\s]/g, "");
}

export function cnpjValido(texto) {
  const c = limparCnpj(texto);
  if (!/^[0-9A-Z]{12}[0-9]{2}$/.test(c)) return false;
  if (/^(.)\1{13}$/.test(c)) return false;            // 00000000000000, 11111111111111 ...
  const dv = (base) => {
    let soma = 0, peso = 2;
    for (let i = base.length - 1; i >= 0; i--) {
      soma += (base.charCodeAt(i) - 48) * peso;
      peso = peso === 9 ? 2 : peso + 1;
    }
    const r = soma % 11;
    return r < 2 ? 0 : 11 - r;
  };
  const d1 = dv(c.slice(0, 12)), d2 = dv(c.slice(0, 12) + d1);
  return c.endsWith(`${d1}${d2}`);
}

Conferido contra a API

EntradacnpjValidoResposta da API
37.853.407/0001-71true200, a ficha da empresa
37853407000172false400 cnpj_invalido
12.ABC.345/01DE-35true404 nao_encontrado: válido, ainda fora da base
11111111111111falsenão consulte

O servidor da API usa a mesma regra, com o mesmo cálculo de ASCII menos 48. Por isso o seu sistema e a API sempre concordam.

O exemplo de consulta em dez linguagens está na documentação.

Perguntas e respostas

O que acontece se eu consultar um CNPJ com o dígito errado?

A API responde 400 com o código cnpj_invalido e a consulta conta no seu limite de 60 por minuto e de 2.000 por dia. Validar antes evita esse gasto.

A API aceita o CNPJ alfanumérico?

Sim. GET /cnpj/12ABC34501DE35 é aceito: o dígito confere e, como esse número ainda não está na base, a resposta é 404 nao_encontrado, não 400.

Preciso tirar pontos, barra e traço antes de consultar?

Não. A API aceita o CNPJ com ou sem pontuação. A função abaixo limpa assim mesmo, para você guardar sempre no mesmo formato.

Todos os guias · Documentação com exemplos em 10 linguagens · openapi.json · Versão para IA