Wortic

Wortic CNPJ / Guias

Guardar as respostas do jeito certo

Cada resposta diz por quanto tempo pode ser guardada. Respeitar esse tempo deixa o seu sistema mais rápido e longe do limite.

Publicado em .

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

A base da Receita não muda a cada minuto. Por isso a API diz no cabeçalho cache-control quanto tempo cada resposta vale. Guardar por esse tempo é o que mais reduz consultas.

O que a API manda

RespostaCabeçalhoGuarde por
200, a fichapublic, max-age=8640024 horas
404 nao_encontradopublic, max-age=36001 hora
Com x-api-keyprivate, no-storenão guarde

O código

export function criarCache() {
  const guardado = new Map();
  return async function fichaComCache(cnpj) {
    const chave = limparCnpj(cnpj), agora = Date.now(), item = guardado.get(chave);
    if (item && item.vence > agora) return { ...item.valor, do_cache: true };
    const r = await fetch(`https://cnpj.wortic.com/cnpj/${chave}`);
    const idade = Number((r.headers.get("cache-control") || "").match(/max-age=(\d+)/)?.[1] || 0);
    const valor = { status: r.status, corpo: await r.json() };
    if (r.status === 200 || r.status === 404) guardado.set(chave, { valor, vence: agora + idade * 1000 });
    return { ...valor, do_cache: false };
  };
}

const ficha = criarCache();
await ficha("37853407000171");        // vai à API
await ficha("37.853.407/0001-71");    // vem do cache: mesmo CNPJ, outra escrita

A chave do cache é o CNPJ limpo. Assim, o mesmo número escrito com ou sem pontuação vira uma consulta só. A função lê o tempo do próprio cabeçalho, então segue certa se a API mudar o prazo. Com no-store a idade é zero e nada fica guardado.

Para guardar muitas fichas e buscar nelas depois, sem subir um banco, veja o guia sobre jsonW.

Perguntas e respostas

Por quanto tempo posso guardar a ficha de uma empresa?

A resposta 200 vem com cache-control: public, max-age=86400, ou seja, 24 horas.

E a resposta de CNPJ não encontrado?

A resposta 404 vem com max-age=3600: guarde por 1 hora, porque a base pode receber o CNPJ na próxima carga.

Com chave de API as respostas também podem ser guardadas?

Não. Com x-api-key a resposta vem com cache-control: private, no-store, porque cada consulta é contada no seu plano.

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