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 |
Ejecutar consulta de seguimiento a la ejecución presupuestal
consultar(x)
consultar(x)
x |
Objeto de clase |
Un data.frame que contiene el resultado de la consulta solicitada
iniciar_transparencia_economica(modulo = "gasto") %>% elegir_periodo_anual(2022) %>% consultar()
iniciar_transparencia_economica(modulo = "gasto") %>% elegir_periodo_anual(2022) %>% consultar()
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.
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 )
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 )
x |
Objeto de clase |
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. |
Un objeto con clase <transpaeco>
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()
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()
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.
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 )
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 )
x |
Objeto de clase |
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" |
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.
Un objeto con clase <transpaeco>
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))
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))
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.
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 )
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 )
x |
Objeto de clase |
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 |
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 |
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". |
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.
Un objeto con clase <transpaeco>
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))
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))
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.
elegir_lugar(x, departamento_meta = NULL) elegir_donde_se_gasta(x, departamento_meta = NULL)
elegir_lugar(x, departamento_meta = NULL) elegir_donde_se_gasta(x, departamento_meta = NULL)
x |
Objeto de clase |
departamento_meta |
chr. Código de departamento, de forma "00" (2 digitos). Para obtener "Callao" usar "07", y para obtener 'Exterior' usar "98". |
Un objeto con clase <transpaeco>
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))
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))
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.
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 )
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 )
x |
Objeto de clase |
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. |
Un objeto con clase <transpaeco>
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))
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
elegir_periodo_anual(x, periodo = NULL)
elegir_periodo_anual(x, periodo = NULL)
x |
Objeto de clase |
periodo |
numeric. Periodo anual de consulta. Actualmente solo se puede consultar a partir del 2012. |
Un objeto con clase <transpaeco>
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))
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))
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).
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)
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)
x |
Objeto de clase |
trimestre |
int. Número del 1 al 4 |
mes |
int. Número del 1 al 12. |
Un objeto con clase <transpaeco>
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_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
iniciar_transparencia_economica( modulo = "gasto", actualizacion = "diaria", psize = 1000L )
iniciar_transparencia_economica( modulo = "gasto", actualizacion = "diaria", psize = 1000L )
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. |
Un objeto con clase <transpaeco>
iniciar_transparencia_economica(modulo = "gasto") iniciar_transparencia_economica(modulo = "gasto", actualizacion = "diaria") iniciar_transparencia_economica(modulo = "ingreso")
iniciar_transparencia_economica(modulo = "gasto") iniciar_transparencia_economica(modulo = "gasto", actualizacion = "diaria") iniciar_transparencia_economica(modulo = "ingreso")