CNPJ API

Atualização e defasagem dos dados

Snapshots, versões publicadas, saúde das fontes e como distinguir indisponibilidade de ausência.

A API lê snapshots imutáveis publicados pelos coletores. Downloads, staging e artefatos brutos não são expostos. Se uma coleta falha, o ponteiro público continua na última versão bem-sucedida.

Onde verificar

  • GET /health/sources mostra saúde, último sucesso, próxima execução e versão publicada;
  • respostas de perfil incluem fontes e snapshot_fingerprint;
  • listagens incluem um objeto fonte com status e versao;
  • a página pública de status resume esses campos sem expor mensagens internas de erro.

Estados

EstadoInterpretação
saudavelfonte publicada e dentro da janela esperada
atrasadoúltima publicação excedeu a janela configurada
degradadohá falhas depois do último sucesso
indisponivelnenhum snapshot publicado está disponível
desabilitadocoleta desativada operacionalmente

As periodicidades editoriais exatas das fontes externas e os SLAs comerciais ainda estão a confirmar. Não derive garantia de atualização apenas do nome do campo de versão; use os timestamps de saúde e os termos vigentes.

Origem

  • CNPJ, dados tributários RFB, CNO e CAFIR: Receita Federal do Brasil;
  • dívida ativa: Procuradoria-Geral da Fazenda Nacional (PGFN).

O portal descreve os dados tal como publicados pelas fontes e processados pelos coletores. Limitações ou atrasos na origem podem se refletir na API.

Nesta página