Wortic

Wortic CNPJ / Guias

Enriquecer uma planilha de CNPJs dentro do limite

Uma lista de CNPJs vira uma lista com razão social, situação e estado. Uma consulta por segundo, sem repetir CNPJ e sem gastar consulta com número errado.

Publicado em .

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

Enriquecer cadastro é o uso mais comum da API. O cuidado é só um: andar no ritmo do limite, sem pressa e sem repetição.

O código

export async function enriquecer(lista, aoTerminarCada = () => {}) {
  const feitos = new Map(), saida = [];
  for (const bruto of lista) {
    const cnpj = limparCnpj(bruto);
    if (!cnpjValido(cnpj)) { saida.push({ cnpj, erro: "cnpj_invalido" }); continue; }   // não gasta consulta
    if (!feitos.has(cnpj)) {
      const r = await consultar(`/cnpj/${cnpj}`);                                 // guia do 402
      if (r.status === 402 || r.status === 429 || r.status === 403) { saida.push({ cnpj, erro: r.corpo.erro.codigo }); break; }
      feitos.set(cnpj, r);
      await new Promise((ok) => setTimeout(ok, 1000));                            // uma por segundo
    }
    const r = feitos.get(cnpj);
    saida.push(r.status === 200
      ? { cnpj, razao_social: r.corpo.razao_social, situacao: r.corpo.situacao.descricao, uf: r.corpo.endereco.uf }
      : { cnpj, erro: r.corpo.erro.codigo });
    aoTerminarCada(saida.length, lista.length);
  }
  return saida;
}

Conferido com quatro linhas

await enriquecer(["37.853.407/0001-71", "37853407000171", "11111111111111", "20885605000203"]);
// [ { cnpj: "37853407000171", razao_social: "WORTIC LTDA", situacao: "Ativa", uf: "SP" },
//   { cnpj: "37853407000171", razao_social: "WORTIC LTDA", situacao: "Ativa", uf: "SP" },   // repetido: sem consulta
//   { cnpj: "11111111111111", erro: "cnpj_invalido" },                                     // inválido: sem consulta
//   { cnpj: "20885605000203", razao_social: "WORTICE ENERGIA LTDA EM RECUPERACAO JUDICIAL", situacao: "Ativa", uf: "AL" } ]

Quatro linhas, duas consultas. As funções limparCnpj, cnpjValido e consultar estão nos guias de validação e do 402.

Para ler a planilha, exporte em CSV e passe a coluna do CNPJ. Grave o resultado aos poucos com aoTerminarCada: se a rede cair no meio, você não perde o que já foi feito.

Perguntas e respostas

Quanto tempo leva para enriquecer uma planilha?

Sem chave, uma consulta por segundo: cerca de 60 CNPJs por minuto, 3.600 por hora. O limite do dia é de 2.000 consultas, por IP. CNPJ repetido e CNPJ com dígito errado não gastam consulta.

O que acontece se a planilha passar do limite?

Com uma consulta por segundo ela não passa do minuto. Se receber 402 limite_gratis do dia, 429 bloqueado ou 403, o código para a planilha em vez de insistir.

E para planilhas grandes?

Use uma chave no cabeçalho x-api-key: vale o limite do seu plano. Fale com a Wortic em wortic.com.br.

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