RREORGFdataR

Visão geral

RREORGFdataR é um pacote R que permite aos usuários acessar facilmente o conjunto de dados do Relatório Resumido da Execução Orçamentária (RREO) e do Relatório de Gestão Fiscal (RGF) utilizando a API do SICONFI (https://apidatalake.tesouro.gov.br/docs/siconfi/).

• RREOdata: (Em construção.)

• RGFdata: Realiza a extração dos dados do Relatório de Gestão Fiscal (RGF) de maneira mais intuitiva e fácil utilizando a API do SICONFI.

• siconfi_list: Opção padrão NULL retorna um data.frame contendo os códigos do IBGE e do Siconfi disponíveis para a API, juntamente com as instituições correspondentes. A escolha da opção options = down permite o download do arquivo (.pdf) disponibilizado pelo Tesouro Nacional.

Instalação

Você pode instalar a versão de desenvolvimento do RREORGFdataR no GitHub com:

# install.packages("devtools")
devtools::install_github("Natanaelsl/RREORGFdataR", build_vignettes = TRUE)

Exemplo

A seguir, demonstramos o quão simples é utilizar o pacote para obter um conjunto de dados do RGF e empregá-los na elaboração de um gráfico, por exemplo.

Dessa forma, podemos extrair do Anexo 1 (3º quadrimestre) de 2017 a 2023 os valores de Despesa com Pessoal Total para a União (Executivo).

 library(RREORGFdataR)
 library(dplyr)
 library(ggplot2)

 RREORGFdataR::RGFdata(cod.ibge = 1,
         ano = c(2017:2023),
         poder = 'E',
         periodo = 3,
         anexo = 1
         ) 
 
 `RGF-Anexo_01` <- `RGF-Anexo_01` %>%
   filter(rotulo == "União",
          cod_conta == "DespesaComPessoalTotal",
          coluna == "VALOR")
 
 `RGF-Anexo_01` %>%
   ggplot2::ggplot(aes(x = exercicio)) +
   ggplot2::geom_col(aes(y = valor), fill = "#004c4c") +
   ggplot2::geom_text(
     aes(y = valor, label = round(valor/1000000000, 0)),
     fontface = "bold",
     vjust = 1.4,
     size = 5,
     colour = "white"
   ) +
   ggplot2::labs(
     x = "Exercício", y = "",
     title = 'Despesa com Pessoal Total - Executivo - União',
     subtitle = '(Nominal, em Bilhões)',
     caption = "\nFonte: Elaborado com RREORGFdataR."
   ) +
   ggplot2::scale_x_continuous(n.breaks = 7) +
   ggplot2::theme_classic() +
   ggplot2::theme(
     legend.position = "none",
     text = element_text(size = 10),
     axis.line = element_blank(),
     legend.title = element_text(size = 12, face = "bold"),
     legend.text = element_text(size = 10),
     axis.text.y = element_blank(),
     axis.text.x = element_text(angle = 60, vjust = .95, hjust = 1, size = 8),
     axis.ticks.y = element_blank(),
     legend.background = element_blank(),
     axis.title.x = element_text(size = 10),
     axis.title.y = element_text(size = 10),
     plot.caption.position = "panel"
   )

Abaixo segue outros exemplos básicos que mostram como resolver um problema comum.

## Carregando o pacote
library(RREORGFdataR)

## Download dos dados do Relatório Resumido da Execução Orçamentária (RREO).
RREOdata()

## Extraindo dados do anexo 1 para o 3º quadrimestre do RGF de 2020 até 2023
## do Estado de Goiás para todos os poderes.
RGFdata(cod.ibge = 52,
        ano = c(2020:2023),
        poder = c('E','L','J','D','M'),
        periodo = 3,
        anexo = 1,
        simplificado = FALSE)

Informações

API SICONFI

O Tesouro Nacional disponibilizou a Application Programming Interface (API) de dados abertos para atender à demanda por dados brutos oriundos do Sistema de Informações Contábeis e Fiscais do Setor Público Brasileiro – Siconfi. Por meio dessa ferramenta, é possível ao usuário obter desde pequenas frações até grandes volumes de dados de todas as informações inseridas pelos entes subnacionais no Siconfi.

Vantagem

A sintaxe da função RREORGFdataR opera com a mesma lógica independentemente da base de interesse, o que torna intuitivo o download/extração de qualquer conjunto de dados usando uma única linha de código.

Código das instituições

A tabela abaixo apresenta os códigos do IBGE e do Siconfi compatíveis com a API, bem como a respectiva instituição. Disponível em: https://siconfi.tesouro.gov.br/siconfi/pages/public/arquivo/conteudo/Cod_instituicoes_siconfi.pdf

NOTA: O referido pacote está em fase de construção podendo não ter todas as informações disponíveis para utilização.