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