Gobierno de España. Ministerio de Hacienda y Función Pública. Abre nueva ventana
Administración Presupuestaria

Exchange format

Introduction (table of contents)

The CoFFEE-MRR API provides integration services for the management systems of organisations responsible for the Recovery, Transformation and Resilience Plan.

The services are provided via a REST interface, documented in OpenAPI 3.0 format.

Updates (index)

[March 2024]
Production environment
In collaboration with the Secretariat-General for European Funds, the procedure for authorising access to the service is being reviewed in order to simplify both the technical and management configuration. The environment will be available once the procedure has been implemented.
Publication of version 1.5.2
Release of version 1.5.2 with functionality improvements: optional codigoPropietario parameter in some listings and project information in subproject, instrumental subprojects and actions. The specific changes can be found in the FAQ section: Notable changes from v1.5.1 to v1.5.2
Publication of version 2.0.0

Version 2.0 includes the following cross-cutting improvements:

  • Pagination of listings
  • Document upload mechanism by locator (more information in FAQ section)

The published definition covers:

  • Full definition of services for the management of legal instruments.
  • List of the endpoints foreseen for the recording of progress and monitoring of indicators, in anticipation of the full definition to be published in the near future.
  • List of the endpoints foreseen for the registration of sub-projects, instrumental sub-projects and actions, in anticipation of the full definition to be published soon.

Services for the management of legal instruments will be implemented in a staggered manner in the following planned order:

  • Contracts
  • Subsidies
  • Agreements
  • Other
  • Rest

You can check the status of implementation and definition of the different endpoints at: endpoint status.

[January 2024]
Release of version 1.5.1 which fixes bugs found in 1.5.0. The specific changes can be found in the FAQ section: Notable changes from v1.5.0 to v1.5.1
For organisational reasons, the first phase will not include the implementation of the financial execution registration service ('/ejecucion/financiera')
The test environment will be available from Thursday 1 February. A form will also be made available to make the access request. The following services will be available:
1. Structure information consultation services.
2. Registration services for legal instruments and addressees.
[November 2023]
API version 1.5.0 has been released, which adapts the previous version to the current CoFFEE information architecture.
The definition will be implemented in phases. The initial phases will group the following services: 1. We offer services for structuring information consultations, registering legal instruments and addressees, and registering executions.
2.Recording progress indicators and other services may be provided based on agency demand. Units interested in this project will be notified of the timetable for the implementation of the phases in the upstream and production environments via this page and/or email.

Service versions (index)

DateVersionSettingAPI LinkUpdates
March 20242.0.0Tests Link to version 2.0.0 endpoints_previstos_progreso_indicadores.md
March 20241.5.2Tests Link to version 1.5.2Parameter codigoPropietario optional in some listings and project information in subproject, instrumental subprojects and actions.
January 20241.5.1Tests Link to version 1.5.1Adaptation of the definition of services to the functional changes in CoFFEE. Correction of errors.
November 20231.5.0Not implemented Link to version 1.5.0Adaptation of the definition of services to the functional changes in CoFFEE. Correction of errors.
April 20221.3.1Not implemented Link to version 1.3.1Progress indicators (including limiting possible values for qualitative indicators) and financial performance are treated separately. Finally, the accounting documents DO and DO/ are also included.

Access and use of the service (index)

To access the published services, interested parties must follow the registration procedure specified on the web services catalogue, page. The procedure is detailed in the document “Procedure for requesting access by external entities to the corporate WEB services of the Budgetary Informatics Office” published on the same page. During the registration process, we will provide information on both the technical contact for resolving technical issues and the mechanism for connecting to our services (the certificate used for secure connections).

Internally, approval will be sought from the Head of Operations of CoFFEE-MRR, who will verify the legitimacy of the intended exchange.
To use the service correctly, you must include two parameters in the requests to the REST API of the published interface. These parameters will identify the origin of the calls and will have been provided by the technical contact of the Budget IT Office during the registration process. The parameters are:
- idAplicacion: API CoFFEE-MRR identifier
- idUsario: service user identifier
The client's web services will be authenticated using HTTPS/TLS with an electronic seal certificate issued by one of the certification service providers recognised by the @Firma web service.
Units should not process access requests until the availability of services in the pre-test environments has been communicated.

More information (index)

For additional information, please refer to the Frequently Asked Questions page. This page will be updated regularly with answers to any questions you may have.

For any technical inquiries, service definition corrections, or other feedback, units may send an email to the development team's email account (CoFFEE-Desarrollo@igae.hacienda.gob.es).