Rodrigo E. S. Borges 2026-09-20
O transfRgov é um pacote em R que facilita o acesso aos dados
disponíveis na API Fundo a Fundo (TransfereGov). O pacote monta as
consultas aos diferentes endpoints da API no padrão PostgREST por meio
de um helper interno, sem depender de pacotes externos de acesso ao
PostgREST. Cada endpoint é acessado por uma função cujo nome inicia com
ler_ ou get_, permitindo filtrar os resultados pelos próprios nomes
das colunas da API no formato nome_parametro = valor (traduzido para
nome_parametro=eq.valor na requisição HTTP interna).
O pacote também baixa dados abertos do Portal da Transparência e do Tesouro Transparente, como os arquivos mensais de transferências para municípios, a tabela de correspondência entre códigos SIAFI e IBGE e os registros de renúncias fiscais.
A versão de desenvolvimento pode ser instalada pelo GitHub:
# Instale o transfRgov a partir do GitHub
devtools::install_github("DistintiveLab/transfRgov")
Após a publicação no CRAN, o pacote poderá ser instalado com:
install.packages("transfRgov")
Carregue o pacote e utilize as funções para acessar os dados dos diversos endpoints da API.
library(transfRgov)
# Exemplo: Ler dados de programas filtrando pelo ano 2020 e modalidade "Ordinário"
dados_programa <- ler_programas(ano_programa = 2020, modalidade_programa = "Ordinário")
head(dados_programa)
# Exemplo: Ler empenhos do ano de 2020 para um determinado plano de ação
dados_empenho <- ler_empenho(ano_empenho = 2020, id_plano_acao = 1234)
head(dados_empenho)
# Exemplo: Ler relatórios de gestão para um plano de ação específico
dados_relatorio <- ler_relatorio_gestao(id_plano_acao = 1234)
head(dados_relatorio)
# Exemplo: Baixar as transferências de janeiro de 2023 e acrescentar o código IBGE
transferencias <- download_transferencias_uniao(ano = 2023, mes = 1)
head(transferencias)
As funções de leitura da API Fundo a Fundo são:
ler_programas: retorna informações sobre os programas.
ler_programa_beneficiario: retorna dados dos beneficiários dos
programas.
ler_programa_gestao_agil: retorna informações da gestão ágil dos
programas.
ler_programa_especial: retorna os dados dos programas especiais.
get_plano_acao: retorna os dados dos planos de ação.
get_plano_acao_dado_bancario: retorna os dados bancários dos planos
de ação.
get_plano_acao_destinacao_recursos: retorna os dados de destinação
de recursos dos planos de ação.
get_plano_acao_historico: retorna o histórico dos planos de ação.
ler_plano_acao_meta: retorna as metas dos planos de ação.
ler_plano_acao_meta_acao: retorna as ações associadas às metas dos
planos de ação.
ler_plano_acao_analise: retorna os dados das análises dos planos de
ação.
ler_plano_acao_analise_responsavel: retorna os responsáveis pelas
análises dos planos de ação.
get_termo_adesao: retorna os dados dos termos de adesão.
ler_termo_adesao_historico: retorna o histórico dos termos de
adesão.
ler_gestao_financeira_lancamentos: retorna os lançamentos da gestão
financeira.
ler_gestao_financeira_subtransacoes: retorna as subtransações dos
lançamentos de gestão financeira.
ler_gestao_financeira_categorias_despesa: retorna as categorias de
despesa da gestão financeira.
ler_empenho: retorna os dados dos empenhos.
ler_empenho_especial: retorna os dados dos empenhos especiais.
ler_relatorio_gestao: retorna os relatórios de gestão.
ler_relatorio_gestao_acoes: retorna as ações dos relatórios de
gestão.
ler_relatorio_gestao_analise: retorna as análises dos relatórios de
gestão.
ler_relatorio_gestao_analise_responsavel: retorna os responsáveis
pelas análises dos relatórios de gestão.
download_transferencias_uniao: baixa e lê os arquivos mensais de
transferências da União publicados pelo Portal da Transparência,
opcionalmente acrescentando o código IBGE do município.
baixa_municipio_siafibge: baixa a tabela de correspondência entre
códigos de município SIAFI e IBGE publicada pelo Tesouro Transparente.
consultar_renuncias_fiscais: consulta os registros de renúncias
fiscais na API do Portal da Transparência. Requer uma chave de API na
variável de ambiente PORTAL_TRANSPARENCIA_API_KEY.
municipios_siafi_ibge: dataset com o mapeamento entre códigos SIAFI
e IBGE.
metafaftab: dataset com os parâmetros aceitos por cada endpoint da
API Fundo a Fundo.
Cada função retorna os dados da API Fundo a Fundo como uma lista ou data frame, contendo as colunas especificadas pela documentação da API. Estes dados podem ser manipulados e analisados diretamente no R.
Contribuições são bem-vindas! Envie issues e pull requests para melhorar o pacote.
Este pacote é distribuído sob a Licença MIT.
Este pacote não é uma ferramenta oficial do Ministério da Gestão ou de qualquer órgão do governo federal. Ele foi desenvolvido de forma voluntária e independente, sem qualquer vínculo, afiliação ou endosso por parte de autoridades governamentais. Os desenvolvedores não assumem responsabilidade por alterações na API Fundo a Fundo, eventuais inconsistências ou interrupções na disponibilidade dos dados.