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

Formats d'Intercanvi

Introducció (índex)

A través de l'API de CoFFEE-MRR es proporcionen serveis d'integració per als sistemes de gestió dels òrgans amb responsabilitat en el Pla de Recuperació, Transformació i Resiliència.

Els serveis s'ofereixen a través d'una interfície REST, que es documenta en format OpenAPI 3.0.

Novetats (índex)

[Març de 2025]
Planificació
Els següents serveis ja es troben disponibles a l'entorn de producció:
  • Definició de subprojectes (alta, edició, esborrat)
  • Definició de subprojectes instrumentals (alta, edició, esborrat)
  • Planificació d'actuacions (alta, edició, esborrat)
  • Definició de projectes (alta, edició, esborrat)
  • Definició de fites i objectius (alta, edició, esborrat)
  • Serveis d'instruments financers (alta, edició, esborrat)
Publicació de la versió 2.0.4
S'ha publicat una nova versió amb nous enpoints disponibles i amb els canvis necessaris detectats durant la implementació dels serviciós de planificació. Poden consultar els canvis concrets en la secció de preguntes freqüents: canvis destacats de v2.0.3 a v2.0.4
 
[Febrer de 2025]
Planificació
Els serveis para d'instruments financers directes i inderectos ja s'encuetnra disponibles a l'entorn de proves.
Una vegada provats i validats es desplegaran a l'entorn de producció.
 
[Febrer de 2025]
Planificació
Els serveis per a la definició i planificació ja es troben disponibles a l'entorn de proves:
  • Definició de subprojectes (alta, edició, esborrat)
  • Definició de subprojectes instrumentals (alta, edició, esborrat)
  • Planificació d'actuacions (alta, edició, esborrat)
  • Definició de projectes (alta, edició, esborrat)
  • Definició de fites i objectius (alta, edició, esborrat)
Respecte als instruments jurídics financers:
  • Implementació de serveis d'instruments financers: Segona quinzena de febrer.
Una vegada provats i validats es desplegaran a l'entorn de producció.
 
[Gener de 2025]
Planificació
S'actualitza la planificació a l'entorn de proves:
  • Definició de subprojectes (alta, edició, esborrat): Ja disponibles a l'entorn de proves
  • Definició de subprojectes instrumentals (alta, edició, esborrat): Segona quinzena de gener.
  • Planificació d'actuacions (alta, edició, esborrat): Primera quinzena de febrer.
  • Definició de projectes (alta, edició, esborrat): Primera quinzena de febrer.
  • Definició de fites i objectius(alta, edició, esborrat): Primera quinzena de febrer.
  • Implementació de serveis d'instruments financers: Primera quinzena de febrer.
Una vegada provats i validats es desplegaran a l'entorn de producció.
 
[Desembre de 2024]
Instruments jurídics
Es publica la definició dels serveis orientats a donar suport a la gestió dels préstecs en CoFFEE en les seves primeres fases. En concret, els instruments jurídics: acord d'execució, acord d'intermediació, instrument financer directe i instrument financer indirecte.
[Octubre de 2024]
Registre de progrés d'indicadors
Es troben disponibles a l'entorn de producció els serveis v2.0 de registre de progrés d'indicadors. (alta, edició, esborrat) segons l'especificació v2.0.2.
[Octubre de 2024]
Registre de progrés d'indicadors
Es troben disponibles a l'entorn de proves els serveis v2.0 de registre de progrés d'indicadors. (alta, edició, esborrat) segons l'especificació v2.0.2.
Una vegada provats i validats es desplegaran a l'entorn de producció. (Estat d'endpoints)
 
Publicació de la versió 2.0.2
La versió 2.0.2 inclou:
  • Definició definitiva dels endpoints de registre de progrés d'indicadors.
  • Definició dels serveis per a la consulta de certificats de (no) revocació.
Poden consultar els canvis concrets en la secció de preguntes freqüents: canvis destacats de v2.0.1 a v2.0.2
La versió v2.0 de l'entorn de proves implementa està especificació. Una vegada provada i validada es desplegarà a l'entorn de producció. Les integracions actuals no es veuen afectades.
 
Planificació
Es manté la planificació a l'entorn de proves:
  • Definició de subprojectes (alta, edició, esborrat): Segona quinzena de novembre.
  • Definició de subprojectes instrumentals (alta, edició, esborrat): Primera quinzena de desembre.
  • Planificació d'actuacions (alta, edició, esborrat): Segona quinzena de desembre.
  • Definició de projectes (alta, edició, esborrat): Segona quinzena de desembre.
Una vegada provats i validats es desplegaran a l'entorn de producció.
 
[Setembre de 2024]
Entorn de producció
Es troba disponible a l'entorn de producció els serveis v2.0 de consulta del pla i gestió d'instruments jurídics. (Estat d'endpoints)
 
Planificació
Publicació dels serveis a l'entorn de proves:
  • Execució. Registre de progrés d'indicadors (alta, edició, esborrat): Primera quinzena d'octubre.
  • Definició de subprojectes (alta, edició, esborrat): Segona quinzena de novembre.
  • Definició de subprojectes instrumentals (alta, edició, esborrat): Primera quinzena de desembre.
  • Planificació d'actuacions (alta, edició, esborrat): Segona quinzena de desembre.
  • Definició de projectes (alta, edició, esborrat): Segona quinzena de desembre.
Una vegada provats i validats es desplegaran a l'entorn de producció.
 
[Juny de 2024]
Entorn de producció
Es troba disponible l'entorn de producció i les instruccions per a l'accés a l'entorn de producció.
 
Serveis per a la gestió d'instruments jurídics
Es troben disponibles a l'entorn de proves els serveis per a la gestió d'instruments jurídics segons la versió v2.0 de l'API.
Una vegada provats i validats es desplegaran a l'entorn de producció.
 
Publicació de la versió 2.0.1
La versió 2.0.1 inclou:
  • Correción d'errors en la definició dels serveis per a la gestió d'instruments jurídics. (Més informació en la secció de «preguntes freqüents»)
  • Definició completa dels serveis per a l'alta d'actuacions, subprojectes instrumentals, subprojectes i projectes.
  • Definició completa dels serveis per al registre de progrés i seguiment d'indicadors.
Els serveis s'implementaran de manera escalonada amb el següent ordre previst:
  1. Seguiment del pla (GETs).
  2. Alta d'actuacions, subprojectes instrumentals, subprojectes i projecte.
  3. Progrés d'indicadors (Posts).
S'informarà de la implementació dels serveis a través d'un correu informatiu per blocs implementats, es pot consultar l'estat d'implementació dels diferents endpoints en: estat d'endpoints. En qualsevol cas, la planificació pot ser modificada en funció de la demanda o altres necessitats que s'hagin rebut.
 
[Març de 2024]
Entorn de producció
S'està revisant, en col·laboració amb la Secretaria General de Fons Europeus, el procediment d'autorització d'accés al servei que simplifiqui la configuració tant tècnica com a nivell de gestió. L'entorn estarà disponible una vegada s'hagi implantat el procediment.
 
Publicació de la versió 1.5.2
Publicació de la versió 1.5.2 amb millores en la funcionalitat: paràmetre codigoPropietario opcional en alguns llistats i informació de projecte en subprojecte, subprojectes instrumentals i actuacions. Poden consultar els canvis concrets en la secció de preguntes freqüents: canvis destacats de v1.5.1 a v1.5.2
 
Publicació de la versió 2.0.0
La versió 2.0 inclou les següents millores transversals:
  • Paginació de llistats
  • Mecanisme de pujada de document per localitzador (més informació en la secció de preguntes freqüents)
La definició publicada abasta:
  • Definició completa dels serveis per a la gestió d'instruments jurídics.
  • Llistat dels endpoints previstos per al registre de progrés i seguiment d'indicadors, com a bestreta de la definició completa que es publicarà pròximament.
  • Llistat dels endpoints previstos per a l'alta de subprojectes, subprojectes instrumentals i actuacions, com a bestreta de la definició completa que es publicarà pròximament.
Els serveis per a la gestió d'instruments jurídics s'implementaran de manera escalonada amb el següent ordre previst:
  • Contractes
  • Subvencions
  • Convenis
  • Uns altres
  • Resta
Poden consultar l'estat d'implementació i definició dels diferents endpoints en: estat d'endpoints.
 
[Gener de 2024]
Publicació de la versió 1.5.1 que corregeix errors oposats en la 1.5.0. Poden consultar els canvis concrets en la secció de preguntes freqüents: canvis destacats de v1.5.0 a v1.5.1
Per qüestions organitzatives, la primera fase no inclourà la implementació del servei de registre d'execució financera ('/ejecucion/financera')
L'entorn de proves estarà disponible a partir del dijous 1 de febrer. S'habilitarà també el formulari per a realitzar la sol·licitud d'accés. Estaran disponibles els següents serveis:
1. Serveis de consulta de la informació d'estructura.
2. Serveis d'alta d'instruments jurídics i destinataris.
 
[Novembre de 2023]
Publicació de la versió 1.5.0 de l'API, adaptació de la versió anterior a l'arquitectura d'informació actual de CoFFEE. 
La implementació de la definició es durà a terme per fases; les primeres agruparan els següents serveis:
1. Serveis de consulta de la informació d'estructura; serveis d'alta d'instruments jurídics i destinataris; serveis de registre d'execució.
2. Serveis de registre de progrés d'indicadors i possiblement altres serveis resultat de la demanda dels organismes.
Per la via d'aquesta mateixa pàgina i/o a través de correu electrònic es comunicarà a les unitats interessades el calendari previst d'implantación de les fases en els entorns previs i a l'entorn de producció.
 

Versions del servei (índex)

Actualment es troben disponibles les següents versions:
DataVersióEntornEspecificacióNotes
Abril 20252.0Producció v2.0.7
Versió recomanada.
S'adapta als canvis funcionals de CoFFEE-MRR.
Març 20241.5Producció v1.5.2
Versió disponible.
No s'adapta als canvis funcionis de CoFFEE-MRR.
L'històric de versions es troba disponible en la secció de "Preguntes freqüents".

Accés i ús del servei (índex)

En el cas que es desitgi procedir a integrar una aplicació de gestió externa amb CoFFEE ha de remetre's una sol·licitud a través del Catàleg de Serveis Web, on es troba disponible el formulari de sol·licitud d'accés a l'API.
 
Com a següent pas, després de l'enviament del formulari inicial, l'OIP es posarà en contacte amb el departament tècnic sol·licitant a través de la bústia de correu CoFFEE-Desarrollo@igae.hacienda.gob.es. Les comunicacions necessàries per a la configuració tècnica, així com la resta dels passos de configuració (incloent l'alta final en producció) es rebran des de la mateixa adreça de correu electrònic.
 
Abans de poder utilitzar l'API, els responsables de la informació dels nodes (projectes, subprojectes i subprojectes instrumentals del PRTR) han d'autoritzar que l'usuari que identifica l'aplicació de gestió que els dóna servei pugui accedir i editar les dades dels nodes; per a això, durant el procés de configuració es recaptarà l'autorització a través de l'emplenament del document que figura a continuació, i el seu contingut serà verificat per la Secretaria General de Fons Europeus. Aquesta autorització haurà de produir-se una única vegada per cada responsable, i tindrà efecte sobre tots els nodes (existents i futurs) que depenguin d'ell. El responsable de la informació d'un node es correspon amb el titular de l'òrgan gestor d'aquest node, i serà la persona que hagi de signar l'autorització o revocació.
 
 
Per a l'ús correcte del servei s'haurà d'afegir a les peticions a l'API REST de la interfície publicada dos paràmetres que permeten identificar l'origen de les crides, i que seran proporcionats pel contacte tècnic de l'Oficina d'Informàtica Pressupostària durant el procés de l'alta. Els paràmetres són:
- idAplicacion: identificador de l'API de CoFFEE-MRR
- idUsuario: identificador de l'usuari de l'aplicació de gestió.
 
Els serveis Web client s'autenticaran mitjançant HTTPS/TLS amb un certificat de segell electrònic emès per algun dels prestadors de serveis de certificació reconeguts pel servei web de @Signatura.
 

Més informació (índex)

Per a obtenir més informació, consulti la pàgina de respostes a preguntes més freqüents, que s'actualitzarà de manera periòdica amb les respostes a les consultes plantejades.

Per a fer qualsevol consulta de caràcter tècnic, comunicació d'errates en la definició dels serveis o una altra aportació, les unitats es poden dirigir mitjançant correu electrònic al compte de l'equip de desenvolupament (CoFFEE-Desarrollo@igae.hacienda.gob.es).