Package 'perutranspaeconomica'

Title: Consulta el portal de 'Transparencia Económica' de Perú
Description: Usa una interfaz de programación consistente y escalable para obtener datos del portal de 'Transparencia Económica' de Perú <https://www.mef.gob.pe/es/seguimiento-de-la-ejecucion-presupuestal-consulta-amigable>.
Authors: Samuel Calderon [aut, cre, cph]
Maintainer: Samuel Calderon <[email protected]>
License: MIT + file LICENSE
Version: 0.3.1.9000
Built: 2024-10-16 05:34:12 UTC
Source: https://github.com/calderonsamuel/perutranspaeconomica

Help Index


Ejecutar consulta de seguimiento a la ejecución presupuestal

Description

Ejecutar consulta de seguimiento a la ejecución presupuestal

Usage

consultar(x)

Arguments

x

Objeto de clase ⁠<transpaeco>⁠ recipiente de los parámetros de la consulta deseada

Value

Un data.frame que contiene el resultado de la consulta solicitada

Examples

iniciar_transparencia_economica(modulo = "gasto") %>%
    elegir_periodo_anual(2022) %>%
    consultar()

Elegir destino de uso del presupuesto.

Description

Estas funciones permiten desglosar la busqueda de acuerdo al destino de uso del presupuesto. Debido a que solo se pueden usar en el módulo de gasto, ambas tienen el mismo comportamiento.

Usage

elegir_destino(
  x,
  categoria_presupuestal = NULL,
  producto = NULL,
  actividad = NULL,
  funcion = NULL,
  division_funcional = NULL,
  grupo_funcional = NULL,
  meta = NULL
)

elegir_en_que_se_gasta(
  x,
  categoria_presupuestal = NULL,
  producto = NULL,
  actividad = NULL,
  funcion = NULL,
  division_funcional = NULL,
  grupo_funcional = NULL,
  meta = NULL
)

Arguments

x

Objeto de clase ⁠<transpaeco>⁠ recipiente de los parámetros de la consulta deseada

categoria_presupuestal

chr. Código de programa presupuestal de forma "0000" (4 digitos). Para Acciones Centrales usar "9001" y para APnoP usar "9002".

producto

chr. Código de producto o proyecto de inversión de forma "0000000" (7 digitos).

actividad

chr. Código de actividad, acción de inversión u obra, de forma "0000000" (7 digitos).

funcion

chr. Código de función de forma "00" (2 digitos).

division_funcional

chr. Código de división funcional de forma "000" (3 digitos).

grupo_funcional

chr. Código de grupo funcional de forma "0000" (4 digitos).

meta

chr. Código de meta. No tiene forma estandarizada y no es obtenerla a partir de la información provista. Es el parametro de consulta mas problematico.

Value

Un objeto con clase ⁠<transpaeco>⁠

Examples

iniciar_transparencia_economica(modulo = "gasto") %>%
    elegir_periodo_anual(2022) %>%
    elegir_en_que_se_gasta(categoria_presupuestal = "todos")

iniciar_transparencia_economica(modulo = "gasto") %>%
    elegir_periodo_anual(2022) %>%
    elegir_en_que_se_gasta(categoria_presupuestal = "todos") %>%
    consultar()

Elegir la estructura con la que se usa el presupuesto

Description

Estas funciones permiten desglosar la busqueda de acuerdo a valores de estructura presupuestal. elegir_como_se_estructura_gasto() y elegir_como_se_estructura_recaudacion() sirven para los módulos de gasto e ingresos, respectivamente. elegir_estructura() es una versión agnóstica que sirve para ámbos módulos. Ver Detalles para entender la conformacion del formato de consulta de cada parametro.

Usage

elegir_estructura(
  x,
  generica = NULL,
  subgenerica = NULL,
  detalle_subgenerica = NULL,
  especifica = NULL,
  detalle_especifica = NULL
)

elegir_como_se_estructura_gasto(
  x,
  generica = NULL,
  subgenerica = NULL,
  detalle_subgenerica = NULL,
  especifica = NULL,
  detalle_especifica = NULL
)

elegir_como_se_estructura_recaudacion(
  x,
  generica = NULL,
  subgenerica = NULL,
  detalle_subgenerica = NULL,
  especifica = NULL,
  detalle_especifica = NULL
)

Arguments

x

Objeto de clase ⁠<transpaeco>⁠ recipiente de los parámetros de la consulta deseada

generica

chr. Código de genérica. En módulo de gasto debe tener la forma "0-0-0" y en módulo de ingreso debe tener la forma "0-0".

subgenerica

chr. Código de sub-genérica de forma "0-0-0"

detalle_subgenerica

chr. Código de detalle de sub-genérica de forma "0-0-0-0"

especifica

chr. Código de específica de forma "0-0-0-0-0"

detalle_especifica

chr. Código de detalle de específica de forma "0-0-0-0-0-0"

Details

Estos endpoints se construyen secuencialmente en base a los valores de genérica.

Para escribir el código de genérica se debe alterar un poco la representación típica. Por ejemplo, la genérica de gasto "7-28" debe pasarse a generica como "7-2-8".

A partir del nivel subgenerica debe omitirse solo el primer dígito de la genérica. Por ejemplo, la sub-genérica "7-28.2" debe pasarse como "2-8-2" y para el detalle de la sub-genérica "7-28.2.1" debe pasarse "2-8-2-1". La específica y detalle de específica siguen este patrón.

Estas funciones aplicarán una validación de la forma para cada argumento mediante expresiones regulares. Sumado a ello, se aplica una validación para evitar valores anómalos.

Value

Un objeto con clase ⁠<transpaeco>⁠

Examples

iniciar_transparencia_economica(modulo = "gasto") %>%
    elegir_periodo_anual(2022) %>%
    elegir_como_se_estructura_gasto(generica = "todos") 

iniciar_transparencia_economica(modulo = "gasto") %>%
    elegir_periodo_anual(2022) %>%
    elegir_como_se_estructura_gasto(generica = "todos") %>%
    consultar()

# notese la forma de `generica`
iniciar_transparencia_economica(modulo = "gasto") %>%
    elegir_periodo_anual(2022) %>%
    elegir_como_se_estructura_gasto(
        generica = "5-2-0", 
        subgenerica = "todos"
    ) 

# cuando no se respeta la forma, el mensaje de error 
# muestra la expresion regular esperada
tryCatch({
    iniciar_transparencia_economica(modulo = "gasto") %>%
        elegir_periodo_anual(2022) %>%
        elegir_como_se_estructura_gasto(
            generica = "5-20", 
            subgenerica = "todos"
        ) 
}, error = function(e) print(e))

Elegir la institucion que utiliza el presupuesto

Description

Estas funciones permiten desglosar la busqueda haciendo uso del clasificador institucional. elegir_quien_gasta() y elegir_quien_recauda() sirven los módulos de gasto e ingresos, respectivamente. elegir_institucion() es una versión agnóstica que sirve para ámbos módulos.

Usage

elegir_institucion(
  x,
  nivel = NULL,
  sector = NULL,
  pliego = NULL,
  unidad_ejecutora = NULL,
  goblocal_o_manc = NULL,
  mancomunidad = NULL,
  departamento = NULL,
  provincia = NULL,
  municipalidad = NULL
)

elegir_quien_gasta(
  x,
  nivel = NULL,
  sector = NULL,
  pliego = NULL,
  unidad_ejecutora = NULL,
  goblocal_o_manc = NULL,
  mancomunidad = NULL,
  departamento = NULL,
  provincia = NULL,
  municipalidad = NULL
)

elegir_quien_recauda(
  x,
  nivel = NULL,
  sector = NULL,
  pliego = NULL,
  unidad_ejecutora = NULL,
  goblocal_o_manc = NULL,
  mancomunidad = NULL,
  departamento = NULL,
  provincia = NULL,
  municipalidad = NULL
)

Arguments

x

Objeto de clase ⁠<transpaeco>⁠ recipiente de los parámetros de la consulta deseada

nivel

chr. Nivel de gobierno. Puede ser "E" (gobierno nacional), "M" (gobiernos locales) o "R" (gobiernos regionales). Si es "E" o "R", le corresponde sector. Si es "M", le corresponde goblocal_o_manc.

sector

chr. Codigo de sector, de forma "00" (2 digitos).

pliego

chr. Código de pliego, de forma "000" (3 digitos).

unidad_ejecutora

chr. Código de Unidad Ejecutora. No tiene forma estandar, puede tener entre uno (1) y seis (6) digitos.

goblocal_o_manc

chr. Escoger entre "M" (gobierno local) o "N" (mancomunidad). Si es "M", puede desglosarse por departamento, provincia y municipalidad. Si es "N", le corresponde mancomunidad.

mancomunidad

chr. Código de mancomunidad, de forma "000000" (6 digitos).

departamento

chr. Código de departamento, de forma "00" (2 digitos). El valor "07" corresponde a Callao.

provincia

chr. Código de provincia, de forma "00" (2 digitos). El valor "01" corresponde a capital de departamento.

municipalidad

chr. Código de municipalidad, de forma "000000" (6 digitos). No es lo mismo que el ubigeo. Los dos primeros digitos deben ser "30".

Details

Estas funciones aplicarán una validación de la forma para cada argumento mediante expresiones regulares. Sumado a ello, se aplica una validación para evitar valores anómalos.

Value

Un objeto con clase ⁠<transpaeco>⁠

Examples

iniciar_transparencia_economica(modulo = "gasto") %>%
    elegir_periodo_anual(2022) %>%
    elegir_quien_gasta(nivel = "todos")

# informacion de todas las UEs del Ministerio de Educacion
iniciar_transparencia_economica(modulo = "gasto") %>%
    elegir_periodo_anual(2022) %>%
    elegir_quien_gasta(
        nivel = "E", 
        sector = "10",
        pliego = "010",
        unidad_ejecutora = "todos"
    ) %>%
    consultar()

# informacion de todas las provincias de Amazonas.
# notese que devuelve codigos de provincia de 4 digitos.
iniciar_transparencia_economica(modulo = "gasto") %>%
    elegir_periodo_anual(2022) %>%
    elegir_quien_gasta(
        nivel = "M", 
        goblocal_o_manc = "M",
        departamento = "01",
        provincia = "todos"
    ) %>%
    consultar()

# para desglosar por provincia, deben usarse solo dos digitos.
# por ejemplo, para ver los municipios de la provincia de Bagua
# debe usarse "02"
iniciar_transparencia_economica(modulo = "gasto") %>%
    elegir_periodo_anual(2022) %>%
    elegir_quien_gasta(
        nivel = "M", 
        goblocal_o_manc = "M",
        departamento = "01",
        provincia = "02",
        municipalidad = "todos"
    ) %>%
    consultar()

# cuando no se respeta la forma, el mensaje de error
# muestra la expresion regular esperada
tryCatch({
    iniciar_transparencia_economica(modulo = "gasto") %>%
        elegir_periodo_anual(2022) %>%
        elegir_quien_gasta(
            nivel = "M", 
            goblocal_o_manc = "M",
            departamento = "01",
            provincia = "0102",
            municipalidad = "todos"
        )
}, error = function(e) print(e))

Elegir lugar de uso del presupuesto

Description

Estas funciones permiten desglosar la busqueda de acuerdo al lugar de uso del presupuesto. Debido a que solo se pueden usar en el módulo de gasto, ambas tienen el mismo comportamiento.

Usage

elegir_lugar(x, departamento_meta = NULL)

elegir_donde_se_gasta(x, departamento_meta = NULL)

Arguments

x

Objeto de clase ⁠<transpaeco>⁠ recipiente de los parámetros de la consulta deseada

departamento_meta

chr. Código de departamento, de forma "00" (2 digitos). Para obtener "Callao" usar "07", y para obtener 'Exterior' usar "98".

Value

Un objeto con clase ⁠<transpaeco>⁠

Examples

iniciar_transparencia_economica(modulo = "gasto") %>%
    elegir_periodo_anual(2022) %>%
    elegir_donde_se_gasta(
        departamento_meta = "todos"
    )

iniciar_transparencia_economica(modulo = "gasto") %>%
    elegir_periodo_anual(2022) %>%
    elegir_donde_se_gasta(
        departamento_meta = "todos"
    ) %>%
    consultar()

# cuando no se respeta la forma, el mensaje de error
# muestra la expresion regular esperada
tryCatch({
    iniciar_transparencia_economica(modulo = "gasto") %>%
        elegir_periodo_anual(2022) %>%
        elegir_donde_se_gasta(
            departamento_meta = "2-0"
        )
}, error = function(e) print(e))

Elegir el origen del presupuesto

Description

Estas funciones permiten desglosar la busqueda de acuerdo al origen del financiamiento del presupuesto. elegir_con_que_se_financia() y elegir_fuentes_de_recaudacion() sirven los módulos de gasto e ingresos, respectivamente. elegir_origen() es una versión agnóstica que sirve para ámbos módulos.

Usage

elegir_origen(
  x,
  fuente_financiamiento = NULL,
  rubro = NULL,
  tipo_de_recurso = NULL
)

elegir_con_que_se_financia(
  x,
  fuente_financiamiento = NULL,
  rubro = NULL,
  tipo_de_recurso = NULL
)

elegir_fuentes_de_recaudacion(
  x,
  fuente_financiamiento = NULL,
  rubro = NULL,
  tipo_de_recurso = NULL
)

Arguments

x

Objeto de clase ⁠<transpaeco>⁠ recipiente de los parámetros de la consulta deseada

fuente_financiamiento

int. Código de fuente de financiamiento. En su versión más reciente va del 1 al 5.

rubro

chr. código de rubro, de forma "00" (2 digitos).

tipo_de_recurso

chr, Código de tipo de recurso. No tiene forma estandar, puede ser de una letra mayuscula, un digito, o dos digitos.

Value

Un objeto con clase ⁠<transpaeco>⁠

Examples

iniciar_transparencia_economica(modulo = "gasto") %>%
    elegir_periodo_anual(2022) %>%
    elegir_con_que_se_financia(
        rubro = "todos"
    )

iniciar_transparencia_economica(modulo = "gasto") %>%
    elegir_periodo_anual(2022) %>%
    elegir_con_que_se_financia(
        rubro = "todos"
    ) %>%
    consultar()

# desglose de tipo de recurso del rubro de "13: Donaciones y transferencias"
# notese la variacion en los codigos de tipo de recurso
iniciar_transparencia_economica(modulo = "gasto") %>%
    elegir_periodo_anual(2022) %>%
    elegir_con_que_se_financia(
        rubro = "13",
        tipo_de_recurso = "todos"
    ) %>%
    consultar()

# cuando no se respeta la forma, el mensaje de error
# muestra la expresion regular esperada
tryCatch({
    iniciar_transparencia_economica(modulo = "gasto") %>%
        elegir_periodo_anual(2022) %>%
        elegir_con_que_se_financia(
            rubro = "13",
            tipo_de_recurso = "AA"
        )
}, error = function(e) print(e))

Elegir periodo anual de consulta

Description

Elegir periodo anual de consulta

Usage

elegir_periodo_anual(x, periodo = NULL)

Arguments

x

Objeto de clase ⁠<transpaeco>⁠ recipiente de los parámetros de la consulta deseada

periodo

numeric. Periodo anual de consulta. Actualmente solo se puede consultar a partir del 2012.

Value

Un objeto con clase ⁠<transpaeco>⁠

Examples

iniciar_transparencia_economica() %>%
    elegir_periodo_anual(periodo = 2022)

# pueden consultarse multiples periodos al mismo tiempo
# por ejemplo, los dos primeros años de pandemia por Covid 19
iniciar_transparencia_economica() %>%
    elegir_periodo_anual(periodo = 2020:2021) %>%
    consultar()

# se emite mensaje de error si se intenta elegir periodos no abarcados
tryCatch({
    iniciar_transparencia_economica(modulo = "gasto") %>%
        elegir_periodo_anual(periodo = 2011)
}, error = function(e) print(e))

Elegir el tiempo en que se usa el presupuesto

Description

Estas funciones permiten desglosar la busqueda de acuerdo al tiempo en el periodo anual. elegir_cuando_se_hizo_gasto() y elegir_cuando_se_hizo_recaudacion() sirven los módulos de gasto e ingresos, respectivamente. elegir_tiempo() es una versión agnóstica que sirve para ámbos módulos. Al desglosar por mes o trimestre se pierde información de PIA, PIM y porcentaje de avance (en gasto).

Usage

elegir_tiempo(x, trimestre = NULL, mes = NULL)

elegir_cuando_se_hizo_gasto(x, trimestre = NULL, mes = NULL)

elegir_cuando_se_hizo_recaudacion(x, trimestre = NULL, mes = NULL)

Arguments

x

Objeto de clase ⁠<transpaeco>⁠ recipiente de los parámetros de la consulta deseada

trimestre

int. Número del 1 al 4

mes

int. Número del 1 al 12.

Value

Un objeto con clase ⁠<transpaeco>⁠

Examples

iniciar_transparencia_economica(modulo = "gasto") %>%
    elegir_periodo_anual(2022) %>%
    elegir_cuando_se_hizo_gasto(mes = "todos")

iniciar_transparencia_economica(modulo = "gasto") %>%
    elegir_periodo_anual(2022) %>%
    elegir_cuando_se_hizo_gasto(mes = "todos") %>%
    consultar()

# se emite mensaje de error si se intenta elegir periodos no abarcados
tryCatch({
    iniciar_transparencia_economica(modulo = "gasto") %>%
        elegir_periodo_anual(periodo = 2022) %>%
        elegir_cuando_se_hizo_gasto(trimestre = "5")
        
}, error = function(e) print(e))

Iniciar consulta de transparencia economica

Description

Iniciar consulta de transparencia economica

Usage

iniciar_transparencia_economica(
  modulo = "gasto",
  actualizacion = "diaria",
  psize = 1000L
)

Arguments

modulo

chr. Uno de c("gasto", "ingreso")

actualizacion

chr. Uno de c("mensual", "diaria")

psize

Cantidad máxima de filas del resultado. No cambiar a menos que se sepa con mucha seguridad lo que implica.

Value

Un objeto con clase ⁠<transpaeco>⁠

Examples

iniciar_transparencia_economica(modulo = "gasto")
iniciar_transparencia_economica(modulo = "gasto", actualizacion = "diaria")
iniciar_transparencia_economica(modulo = "ingreso")