Pular para conteúdo

filings-rfb Receita Federal emblem

Typed pandas readers for the Receita Federal do Brasil (RFB) CNPJ open data: Empresas, Estabelecimentos, Socios, Simples and the six lookup tables, read as memory-flat chunks.

Unofficial, community library. Not affiliated with or endorsed by the Receita Federal do Brasil; the emblem belongs to that agency.

Contents

Section Description
Usage Installation, imports, and usage examples
Examples Task-oriented recipes per reader
API Reference Module-level functions and public interface
FAQ Common questions

Quick start

pip install filings-rfb

from filings_rfb import read_companies

for df_chunk in read_companies("2026-10"):
    ...

The RFB publishes one folder per month. Estabelecimentos (up to 2.3 GB per compressed part) and Simples (~3.2 GB inflated) are large: the readers stream them to disk and yield chunks.