Wortic

Wortic CNPJ / Guias

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