Perguntas frequentes

Como buscar por CNAE, UF, etc.?

Isso encarece computacionalmente o Minha Receita (consultas mais pesadas ao banco de dados, paginação, etc.), ou seja:

ou aumentaria os custos para manter a API no ar (e as doações não cobrem nem os custos atuais)
ou comprometeria a disponibilidade da API.

Para evitar isso, a API não tem qualquer forma de filtro ou paginação.

No entanto, criando o seu banco de dados localmente, é possível utilizar consultas diratemente no PostgreSQL, como por exemplo:

busca por UF com SELECT * FROM cnpj WHERE json->>'uf' = 'PR'
busca por CNAE (apenas o primário, fiscal) com SELECT * FROM cnpj WHERE json->>'cnae_fiscal' = '6204000'
busca por CNAE (incluindo secundários) com

SELECT *
FROM cnpj
WHERE json->>'cnae_fiscal' = '6204000'
  AND json->'cnaes_secundarios' @> '[{"codigo":6204000}]

Você pode ainda criar índices para essas buscas ficarem mais rápidas, como por exemplo CREATE INDEX cnpj_uf_idx ON cnpj((json->'uf')).

Para referência:

um índice criado apenas com o código do CNAE fiscal (CREATE INDEX cnpj_cnae_fiscal_idx ON cnpj((json->'cnae_fiscal'))) ocupou certa de 2Gb em disco
um índice composto com UF e código do município (CREATE INDEX cnpj_uf_municipio_idx ON cnpj((json->'uf'), (json->>'codigo_municipio'))) ocupou cerca de 1,5Gb em disco.

Como consigo um CSV único dos dados?

Os dados oficiais da Receita Federal já são em CSV e talvez o mais fácil seja você utilizar os CSVs originais.

Caso queira gerar um CSV a partir dos dados consolidados, com ou sem filtragem de dados, o Minha Receita pode ajudar. Criando o seu banco de dados localmente, é possível utilizar o PostgreSQL para tal, como por exemplo:

COPY (
  SELECT
      id AS cnpj,
      json->>'razao_social' AS razao_social,
      json->>'nome_fantasia' AS nome_fantasia
      -- adicione os campos que desejar
  -- WHERE uf = '…' caso queira filtar, por exemplo
  FROM cnpj
)
TO 'nome-do-arquivo.csv' DELIMITER ',' CSV HEADER;

Com qual periodicidade a API é atualizada?

A atualização é manual e normalmente ocorre alguns dias depois de a Receita Federal liberar uma nova versão dos dados — salvo quando a Receita Federal divulga dados absurdos, como empresas abertas no ano 202 ou 4100.

Para saber a data de divulgação pela Receita Federal dos dados disponíveis no Minha Receita, consulte a própria API.

Não consigo baixar os dados, pode me passar?

O Minha Receita mantém um espelho dos dados em uma diretório compartilhado. Nele está disponível:

Uma cópia dos públicos baixados da Receita Federal em , organizados por diretórios com a data de extração divulgada pela Receita Federal
Executáveis do Minha Receita
Uma versão dos links em JSON enviando o cabeçalho Accept: application/json ao servidor