Dívida Ativa da União

Software que baixa e transforma/limpa a base de dados de devedores da Dívida Ativa da União, disponibilizados pela Procuradoria-Geral da Fazenda Nacional.

Licença

A licença do código é LGPL3 e dos dados convertidos Creative Commons Attribution ShareAlike. Caso utilize os dados, cite a fonte original e quem tratou os dados, como: Fonte: Procuradoria-Geral da Fazenda Nacional, dados tratados por Álvaro Justen/Brasil.IO. Caso compartilhe os dados, utilize a mesma licença.

Se esses dados forem úteis você pode considerar doar para o Brasil.IO.

Rodando

Você precisará do docker compose e do make para executar os comandos abaixo (a execução fora de container, em virtualenv Python, é possível, mas essa documentação não abordará essa maneira de execução).

make build  # Constrói os containers
make start  # Inicia o container do banco de dados (postgres)
make run  # Executa o script de ETL dentro do container principal

Para finalizar a execução do container postgres, execute make stop. Execute make help para ver outros comandos disponíveis.

Baixando/importando trimestres específicos

Os dados estão disponíveis para vários trimestres, mas o comando make run baixa, importa e limpa os dados apenas para o último trimestre disponível. Para personalizar esse comportamento, execute make bash e, dentro do container, execute cada um dos comandos em ./run.sh manualmente, passando a opção --trimestre=YYYY-T para o script divida_ativa.py. Para mais detalhes, veja as opções executando: python divida_ativa.py download --help e python divida_ativa.py import --help.