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.
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 no Portal de Dados Abertos têm como máximo de granularidade os chamados "Projeto-Atividade" do Orçamento.
Um manual detalhado sobre o funcionamento da API pode ser acessado aqui.
Também há um glossário sobre os principais conceitos orçamentários e um manual introdutório para formação sobre o tema do Orçamento.
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.
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.
Por enquanto, neste repositório há dois tutoriais sobre a API:
À medida que for avançando em outras explorações, vou acrescentando aqui!
Este tutorial foi escrito por mim, Fernanda Campagnucci. Agradeço especialmente ao Fernando Paiva, pelas dicas de código para consumo da API; aos colegas Eduardo Paiva 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.