Documentation

La extensión de Presupuestos y Gastos extiende la extensión de budget breakdown y la sección de implementación del contrato para permitir la publicación de asignaciones de presupuesto detalladas y la ejecución de las mismas para un proceso de contrataciones

Un [ artículo de discusión que muestra los antecedentes del enfoque puede encontrarse aquí ] (https://docs.google.com/document/d/1b43JeG5YQ62tGTTbP7jTE4XqUxYzG-r-emgRILZPRn4/edit).

Este repositorio se encuentra en un desarrollo activo, y actualmente contiene ejemplos  de como se puede usar esta extensión para registrar compromisos financieros anuales a un proceso de contrataciones y contratos individuales

En resumen

Esta extensión introduce tres nuevas funciones que surgen de la extensión budget breakdown:

  • classifications permiten que se den clasificaciones funcionales, económicas y administrativas para cada detalle del presupuesto;
  • measures - permite que se usen diferentes medidas de presupuesto (planeadas, cometidas, ejecutadas, etc.) a nivel del proceso de contrataciones para cada set de clasificaciones de presupuesto
  • fiscalBreakdownFieldMapping - da una manera de enlazar al archivo datapackage.json del Fiscal Data Package que define el significado de cada clasificación y medida, y que da acceso a datos relacionados con el nivel de presupuesto

Adicionalmente, introduce el objeto financialProgress  en contracts/implementation, permitiendo mostrar el detalle de la ejecución financiera de cada contrato, utilizando las mismas funciones classifications, measures y fiscalBreakdownFieldMapping como para budgetBreakdown.

Para comenzar

La mejor manera de utilizar esta extensión es viendo los ejemplos desarrollados.

  • El ejemplo de coordinación muestra cómo expresar los datos en una asignación de presupuesto y ejecución que pudieron haber surgido de diferentes sistemas de datos (ej. sistemas financieros y sistemas de compras).
  • El ejemplo de integración muestra cómo las referencias a un Fiscal Data Package pueden soportar una visualización de datos a los usuarios, y la comparación entre los datos del nivel del proceso de contrataciones y el nivel de presupuesto.
  • The flat data example illustrates how the structured data published using this extension can be analyzed using spreadsheet tools.

Conceptos claves

Esta extensión da las herramientas para crear datos que relacionen budgets, contracting processes y spending

A partir de las definiciones de Global Initiative for Fiscal Transparency (GIFT):

A budget is a forward-looking statements of how an organization proposes to raise revenues, spend resources, and finance its operations. The National Government budget should cover all the activities of a state. Detailed budgets may also exist at the level of agencies and projects. In public contracting, the funding for a contracting process may come from a particular section of the National budget, or from an organizational budget. It may also come wholly or partially from an external funders budget (e.g. an International Development Bank), either directly, or passing through government systems.

Las líneas de presupuesto se construyen a partir de un set de classifications (generalmente descritas en términos de clasificaciones funcional, administrativas o económicas) y las measures (como el monto original designado a un conjunto particular de clasificaciones, o los montos modificados o ejecutados).

Fiscal reports are records of [an organization's] actual (historical) revenues, spending and financing. They may report the fiscal activities of the central government, state governments, or local governments, or of all levels of government in a country (referred to as the general government). Reports may cover a whole government in aggregate as an entity, and/or individual government entities e.g. ministries, departments or agencies. They may be on a cash or accruals basis (full or partial). As payments are made during the execution of a contract, these may be allocated against one or more sections of the budget. In some cases, this may allow the creation of fiscal reporting at the level of individual contracts.

El Open Contracting Data Standard se usa para compartir información sobre procesos de contratación. Un proceso de contrataciones puede pasar por diferentes etapas a través del tiempo, incluyendo planeación, licitación, adjudicación, firma de contrato e implementación.

Relacionando presupuesto, contrataciones y gasto

Budget, Contract and Spending relationships

La imagen anterior presenta un representación esquemática de como pueden interactuar las bases de datos de presupuesto, contratación y gasto

Debe notar que:

  • Esto no representa una secuencia linear de eventos. Los datos pueden estar disponibles en diferentes punto en el tiempo, como cuando el presupuesto se hace en un ciclo anual, pero los contratos se firman a través de los años. En muchos casos, la información de presupuesto en la sección de planning de un proceso de contratación OCDS puede actualizarse después de que los contratos se adjudiquen y se estén implementando.
  • Los datos de presupuesto y gasto pueden darse en diferentes niveles de detalle, desde una línea de presupuesto única que financia múltiples procesos de contrataciones, hasta la clasificación fiscal de partes únicas contra un contrato en particular. Los publicadores de datos van a variar de acuerdo al nivel de detalle que se puede extraer con confianza de sus sistemas.
  • Los datos de ejecución del presupuesto pueden existir en un nivel transaccional, o puede existir en un nivel más agregado. Esta extensión actualmente cubre la ejecución del presupuesto, pero no cubre las clasificaciones detalladas de las transacciones.

Estándares de datos unidos: conexiones con el paquete de datos fiscales

El The Fiscal Data Package desarrollado por Open Knowledge con el apoyo de f GIFT da un "formato sencillo y orientado al usuario para publicar y consumir datos fiscales". A diferencia del OCDS, el cual requiere que los datos se conviertan en una estructura JSON antes de publicarse, el Paquete de Datos Fiscales consiste de:

  • A data package definition (datapackage.json) which describes the 'logical model' to apply to existing data files. This defines columns, their relationship to fiscal concepts, and how they should be transformed by consuming applications in order to create normalized data.
  • Los archivos de datos, que dan el 'modelo físico'  para la base de datos de presupuesto o de gastos, y puede ser exportado de los sistemas existentes.

Se ha hecho bastante investigación y test en usuarios para desarrollar el Paquete de Datos Fiscales, estableciendo que, en vez de buscar un acuerdo en un set global de conceptos fiscales, es importante, considerando la diversidad de sistemas de compras y presupuesto alrededor del mundo, permitir a los usuarios publicar sus datos utilizando sus conceptos fiscales existentes, y luego complementar estos con datos adicionales que pueden apoyar el análisis y la comparación entre bases de datos.

Para evitar la duplicación de esfuerzo por parte de los publicadores de datos y los consumidores, esta extensión se refiere al modelo del Paquete de Datos Fiscales con respecto a la definición de conceptos fiscales, y sigue el enfoque del PDF al permitir el uso de columnas de datos existentes. Mientras que el PDF no hace una distinción directa entre 'classifications' y 'measures', pues considera ambas como instancias de 'fiscal concepts', en esta extensión hacemos una diferencia para permitir que las medidas 'measures' se validen como numéricas mientras que las clasificaciones 'classifications'  pueden ser valores string o números.

Antecedentes

Una exploración completa del enfoque que se toma en esta extensión se puede encontrar en el background discussion paper.

Historias de usuarios y requisitos

La extensión de presupuesto y gasto se diseñó alrededor de una serie de historias de usuarios

  • U1: Como periodista quiero ver cuál es la fuente de presupuesto de un proceso de contratación particular para poder entender si el presupuesto viene de recursos domésticos, préstamos u otras fuentes de ingreso internacionales
  • U2: As a journalist I want to find all the contracts funded through a particular budget source in order to analyze the extent to which the budget is spent via contracting or other means
  • U3: As a civil society organization focused on infrastructure I want to find all the contracting processes related to a given infrastructure programme or project so that I can carry out a review of compliance with infrastructure project transparency requirements.
  • U4: Como periodista quiero poder rastrear contratos sospechosos para poder identificar posibles conexiones entre los destinatarios y los funcionarios y políticos en control del presupuesto y el proceso de adjudicaciones para identificar y confirmar las asignaciones de presupuesto.
  • U5: Como un proveedor potencial quiero ver cuando se confirma la disponibilidad de presupuesto para un proceso de contrataciones especifico para poder planear un inventario de potenciales oportunidades de licitación.
  • U6: As a civil society monitoring organization I want to identify projects without confirmed budget so that I can analyze the funding gap for planned procurement
  • U7: Como un oficial de tesorería quiero compartir información sobre el estatus de las asignaciones de presupuesto y el gasto para cualquier contrato para poder demostrar al público que el presupuesto se esta gastando de acuerdo a los planes aprobados
  • U8: Como un monitor de compras quiero ver que parte del proyecto de infraestructura viene del presupuesto de capital vs el presupuesto de ingresos para poder monitorear si se gasto de más o de menos de lo planeado
  • U9: As a civil society organization I want to identify how far particular budget lines have spend allocated against them, and the status of that spend over time so that I can report on areas of over or under spending. Tracking the payment process
  • U10: As an academic I want to identify the gap between invoice date and payment date so that I can analyze how prices are affected by payment timelines
  • U11: Como auditor quiero los detalles completos sobre el proceso de cobro y de pago para poder identificar banderas rojas potenciales e investigar los procesos particulares

Estas historias de usuario se usan para identificar un set de requisitos que las extensiones deben alcanzar. La tabla debajo describe en qué medida la extensión actual cumple con los requisitos que se identificaron.

| ID | Requisito | Requisito Cumplido? | Cómo cumple la extensión este requisito? | |----|-------------|------------------|-----------------------------------------------| | R1 | Identificar de forma única cada línea presupuestaria relevante | Si | BudgetBreakdown se amplía con un objeto flexible de "clasificaciones" que puede incluir cualquier número de propiedades de clasificación, reflejando los términos y nombres de columna utilizados en los conjuntos de datos de presupuesto. | | R2 | Identificar de forma única los proyectos que proporcionan financiación a un proceso de contratación | Parcialmente | Actualmente no se introducen cambios para satisfacer este caso de uso. El objeto de presupuesto central ya incluye un campo projectID. | | R3 | Proporcionar montos para diferentes fases presupuestarias, incluidas las asignaciones presupuestarias confirmadas | Si | BudgetBreakdown se amplía con un objeto flexible de "medidas" que puede incluir cualquier número de propiedades de medidas, reflejando los términos y nombres de columnas utilizados dentro del presupuesto existente y los conjuntos de datos de gastos. | | R4 | Clasificar transacciones contra líneas presupuestarias | No | La información sobre el progreso financiero desagregado puede clasificarse según las líneas presupuestarias en la sección financialProgress / breakdown 'de la implementación del contrato, pero la extensión no modifica actualmente el bloque transaction` para permitir la clasificación en el nivel de transacción individual. | | R5 | Proporcionar información sobre el proceso de transacción, desde la factura hasta el pago | Parcial | Las "medidas" en "progreso financiero / desglose" para cada contrato pueden usarse para describir diferentes momentos del procesamiento de pagos. Sin embargo, esto solo proporciona un historial completo de la sincronización de los procesos de pago cuando se utiliza con un historial de versiones detallado de las versiones. En esta extensión no se ha incluido un enfoque alternativo de agregar detalles de "transacciones" para representar diferentes momentos, como solicitudes de pago y aprobaciones de pago, pero se puede desarrollar por separado en el futuro. | | R6 | Permitir que las asignaciones de cantidades individuales del presupuesto a contratar dentro de OCDS se verifiquen con las asignaciones de líneas de presupuesto generales en un conjunto de datos de presupuesto | Si | Mediante el uso de un enlace al Paquete de datos fiscales, es posible comparar la información financiera a nivel de contrato en OCDS con información clasificada de manera similar en un FDP. | | R7 | Proporcionar interfaces de usuario con la información necesaria para mostrar información del presupuesto a los usuarios | Si | Cuando se utilizan junto con un paquete de datos fiscales, las aplicaciones pueden buscar etiquetas y metadatos para cada "clasificación" y "medida" con el fin de mostrar información clara a los usuarios. |

Issues

Reporte los problemas de esta extensión en el [repositorio de extensiones de ocds] (https://github.com/open-contracting/ocds-extensions/issues), poniendo el nombre de la extensión en el título del problema.

Changelog

2019-03-20

  • Set "uniqueItems": true on array fields, and add "minLength": 1 on required string fields.