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 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 forma escalonada amb el següent ordre previst:
- Contractes
- Subvencionis
- Convenis
- Altres
- Resta
Poden consultar l'estat d'implementació i definició dels diferents endpoints en:estat de 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 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 de implantación de les fases en els entorns previs i a l'entorn de producció.
Versions del servei (índex)
Accés i ús del servei (índex)
Per accedir als serveis publicats, les unitats interessades hauran de seguir el procediment d'alta especificat a la pàgina de
catàleg de serveis web, i en concret segons es detalla en el document “Procediment de sol·licitud d'accés d'entitats externes als serveis WEB corporatius de l'Oficina d'Informàtica Pressupostària” publicat en ella. Durant el procés d'alta es facilitarà informació tant de contacte tècnic per a resolució de qüestions tècniques, com sobre el mecanisme de connexió amb els serveis (certificat que s'utilitzarà en la connexió segura/segura).
Internament es recaptarà autorització del Responsable Funcional de CoFFEE-MRR que verificarà la legitimitat de l'intercanvi que es pretén establir.
Per a l'ús correcte del servei s'haurà d'afegir a les peticions a l'API REST de l'interfície publicat dos paràmetres que permetran identificar l'origen de les trucades, i que hauran estat proporcionats prèviament pel contacte tècnic de l'Oficina d'Informàtica Pressupostària durant el procés de l'alta. Los parámetros son:
- idAplicacion: identificador del API de CoFFEE-MRR
- idUsuario: identificador del usuario de servicio
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 d'@Signatura.
Les unitats interessades no hauran de tramitar les sol·licituds d'accés fins que s'hagi comunicat la disponibilitat dels serveis en els entorns previs de proves.
Més informació (índex)
Per obtenir més informació, consulti la pàgina de respostes a preguntes més freqüents, que s'actualitzarà de forma periòdica amb les respostes a les consultes plantejades.
Per 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).