# 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. Endereço: https://cnpj.wortic.com/guias/enriquecer-planilha Fonte dos dados: Receita Federal, dados abertos do CNPJ, pela Wortic. Wortic CNPJ (/) / Guias (/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. 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 (/guias/) · Documentação com exemplos em 10 linguagens (/docs) · openapi.json (/openapi.json) · Versão para IA (/llms.txt)