Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/campagnucci/api_sof

Tutorial para acessar a API do Sistema de Orçamento e Finanças _SOF da cidade de São Paulo, utilizando Python e a biblioteca Pandas, realizar análises e salvar arquivo CSV/Excel
https://github.com/campagnucci/api_sof

api-rest dados-abertos open-data sao-paulo sof

Last synced: 1 day ago
JSON representation

Tutorial para acessar a API do Sistema de Orçamento e Finanças _SOF da cidade de São Paulo, utilizando Python e a biblioteca Pandas, realizar análises e salvar arquivo CSV/Excel

Awesome Lists containing this project

README 

        
# Explorando as despesas da cidade de São Paulo



Este é um tutorial de primeiros passos para acessar a execução orçamentária do município usando Python e a biblioteca de análise de dados Pandas - muito bem documentada [aqui](https://pandas.pydata.org/pandas-docs/stable/).



## O que é o SOF?



O SOF é o Sistema de Execução Orçamentária da Prefeitura de São Paulo. Todas as despesas realizadas pelos órgãos e entidades municipais são cadastradas nesse sistema, de acordo com códigos padronizados no orçamento.



A Secretaria Municipal da Fazenda de São Paulo mantém uma API para publicação diária das despesas, com informações detalhadas sobre empenhos, contratos e fornecedores, com a série histórica disponível a partir de 2003. É o registro orçamentário mais detalhado possível da cidade, pois as [bases de dados disponíveis](http://orcamento.sf.prefeitura.sp.gov.br/orcamento/execucao.html) no Portal de Dados Abertos têm como máximo de granularidade os chamados "Projeto-Atividade" do Orçamento.



## Documentação de apoio



Um manual detalhado sobre o funcionamento da API pode ser acessado [aqui](https://api.prodam.sp.gov.br/store/site/themes/fancy/templates/api/documentation/download.jag?tenant=null&resourceUrl=/registry/resource/_system/governance/apimgt/applicationdata/provider/admin/SOF/v2.1.0/documentation/files/MANUAL_SOF_API.pdf).



Também há um [glossário](http://orcamento.sf.prefeitura.sp.gov.br/orcamento/uploads/glossario.pdf) sobre os principais conceitos orçamentários e um manual [introdutório](https://www.paulofreire.org/images/pdfs/livros/Cadernos_Formacao_Planejamento_Orcamento.pdf) para formação sobre o tema do Orçamento.



## Jupyter Notebook



O Jupyter Notebook é uma forma muito bacana de documentar código, pois permite rodar comandos no navegador, visualizar os testes e alternar com texto e imagens. Conheça mais e instale [aqui](http://jupyter.org/).



Este tutorial foi escrito num Jupyter Notebook, e o github permite visualização desse arquivo. Desta forma, você pode visualizá-lo aqui mesmo, sem necessidade de instalar a ferramenta.



## Tutoriais



Por enquanto, neste repositório há dois tutoriais sobre a API:



* [Parte 1](https://github.com/campagnucci/api_sof/blob/master/SOF_Execucao_Orcamentaria_PMSP.ipynb) - Explorando as despesas

* [Parte 2](https://github.com/campagnucci/api_sof/blob/master/SOF_Contratos.ipynb) - Explorando os contratos (depende do primeiro)



À medida que for avançando em outras explorações, vou acrescentando aqui!



## Créditos e agradecimentos



Este tutorial foi escrito por mim, Fernanda Campagnucci. Agradeço especialmente ao [Fernando Paiva](https://github.com/fernandosjp), pelas dicas de código para consumo da API; aos colegas [Eduardo Paiva](https://github.com/eduspano) e Marcelo Cabral, também gestores públicos entusiastas dos dados e do software livre, com quem venho aprendendo e me inspirando bastante; e aos colegas técnicos da Secretaria Municipal da Fazenda, que estão abertos ao diálogo para melhoria da ferramenta.