Autocompletar empresa pelo nome
Quem não sabe o CNPJ digita o nome e escolhe na lista. A busca devolve até 50 empresas ativas, com cidade, estado e se é matriz ou filial.
Publicado em .
Fontes oficiais: o CNPJ na Receita Federal e os dados abertos do CNPJ.
A rota é GET /empresas?nome=&uf=. O estado é opcional. Cada item traz o CNPJ, a razão social, a cidade, o estado, a situação e se é matriz.
O código, com espera entre teclas
const entrada = document.querySelector("#empresa");
const lista = document.querySelector("#sugestoes");
let espera, ultimo = "";
entrada.addEventListener("input", () => {
clearTimeout(espera);
const termo = entrada.value.trim();
if (termo.length < 4) { lista.replaceChildren(); return; } // a API pede 4 letras
espera = setTimeout(async () => {
if (termo === ultimo) return;
ultimo = termo;
const r = await fetch(`https://cnpj.wortic.com/empresas?nome=${encodeURIComponent(termo)}`);
if (r.status !== 200) return;
const { empresas } = await r.json();
lista.replaceChildren(...empresas.map((e) => {
const item = document.createElement("li");
item.textContent = `${e.razao_social} · ${e.cidade}/${e.uf} · ${e.matriz ? "matriz" : "filial"}`;
item.dataset.cnpj = e.cnpj;
return item;
}));
}, 400);
});
A espera de 400 ms faz uma consulta quando a pessoa para de digitar, e não uma por letra. Isso mantém o seu sistema bem abaixo das 60 consultas por minuto.
O que volta para "wortic"
{"termo":"wortic","empresas":[
{"cnpj":"20885605000114","razao_social":"WORTICE ENERGIA LTDA EM RECUPERACAO JUDICIAL","matriz":true,"uf":"SP","cidade":"SERTAOZINHO","situacao":"Ativa", ...},
{"cnpj":"37853407000171","razao_social":"WORTIC LTDA","matriz":true,"uf":"SP","cidade":"SAO PAULO","situacao":"Ativa", ...},
{"cnpj":"20885605000203","razao_social":"WORTICE ENERGIA LTDA EM RECUPERACAO JUDICIAL","matriz":false,"uf":"AL","cidade":"MACEIO","situacao":"Ativa", ...}
],"total":3,"fonte":"Receita Federal, dados abertos do CNPJ (base Wortic); só empresas ativas"}
A busca acha nomes parecidos: "wortic" trouxe também "WORTICE". Mostre cidade e estado na lista para a pessoa escolher a certa. Com a empresa escolhida, busque a ficha completa pelo CNPJ.
Perguntas e respostas
Quantas letras a busca por nome precisa?
Pelo menos 4. Com menos, a API responde 400 com o código termo_curto.
A busca traz empresas baixadas?
Não. A busca por nome devolve só empresas ativas, até 50 por pedido. Para conferir uma empresa baixada, consulte pelo CNPJ.
Como filtrar por estado?
Acrescente uf ao endereço: /empresas?nome=wortic&uf=AL traz só as empresas de Alagoas.
Todos os guias · Documentação com exemplos em 10 linguagens · openapi.json · Versão para IA