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
- Cada caractere vale o seu código ASCII menos 48. Assim, de 0 a 9 valem 0 a 9, e de A a Z valem 17 a 42.
- Multiplique da direita para a esquerda pelos pesos 2, 3, 4, 5, 6, 7, 8, 9, voltando a 2 depois do 9.
- Some e tire o resto da divisão por 11. Resto 0 ou 1 dá dígito 0; nos outros casos, o dígito é 11 menos o resto.
- O primeiro dígito sai dos 12 primeiros caracteres; o segundo, dos 12 mais o primeiro dígito. Os dois são sempre números.
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
| Entrada | cnpjValido | Resposta da API |
|---|---|---|
37.853.407/0001-71 | true | 200, a ficha da empresa |
37853407000172 | false | 400 cnpj_invalido |
12.ABC.345/01DE-35 | true | 404 nao_encontrado: válido, ainda fora da base |
11111111111111 | false | nã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