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

Formatos de Intercambio

Introdución (índice)

A través do API de CoFFEE-MRR proporciónanse servizos de integración para os sistemas de xestión dos órganos con responsabilidade no Plan de Recuperación, Transformación e Resiliencia.

Os servizos ofrécense a través dunha interface REST, que se documenta en formato OpenAPI 3.0.

Novidades (índice)

[Marzo de 2025]
Planificación
Os seguintes servizos xa se atopan dispoñibles na contorna de produción:
  • Definición de subproxectos (alta, edición, borrado)
  • Definición de subproxectos instrumentais (alta, edición, borrado)
  • Planificación de actuacións (alta, edición, borrado)
  • Definición de proxectos (alta, edición, borrado)
  • Definición de fitos e obxectivos (alta, edición, borrado)
  • Servizos de instrumentos financeiros (alta, edición, borrado)
Publicación da versión 2.0.4
Publicouse unha nova versión con novos enpoints dispoñibles e cos cambios necesarios detectados durante a implementación dos serviciós de planificación. Poden consultar os cambios concretos na sección de preguntas frecuentes: cambios destacados de v2.0.3 a v2.0.4
 
[Febreiro de 2025]
Planificación
Os servizos para de instrumentos financeiros directos e inderectos xa se encuetnra dispoñibles na contorna de probas.
Unha vez probados e validados despregaranse na contorna de produción.
 
[Febreiro de 2025]
Planificación
Os servizos para a definición e planificación xa se atopan dispoñibles na contorna de probas:
  • Definición de subproxectos (alta, edición, borrado)
  • Definición de subproxectos instrumentais (alta, edición, borrado)
  • Planificación de actuacións (alta, edición, borrado)
  • Definición de proxectos (alta, edición, borrado)
  • Definición de fitos e obxectivos (alta, edición, borrado)
Respecto dos instrumentos xurídicos financeiros:
  • Implementación de servizos de instrumentos financeiros: Segunda quincena de febreiro.
Unha vez probados e validados despregaranse na contorna de produción.
 
[Xaneiro de 2025]
Planificación
Actualízase a planificación na contorna de probas:
  • Definición de subproxectos (alta, edición, borrado): Xa dispoñibles na contorna de probas
  • Definición de subproxectos instrumentais (alta, edición, borrado): Segunda quincena de xaneiro.
  • Planificación de actuacións (alta, edición, borrado): Primeira quincena de febreiro.
  • Definición de proxectos (alta, edición, borrado): Primeira quincena de febreiro.
  • Definición de fitos e obxectivos(alta, edición, borrado): Primeira quincena de febreiro.
  • Implementación de servizos de instrumentos financeiros: Primeira quincena de febreiro.
Unha vez probados e validados despregaranse na contorna de produción.
 
[Decembro de 2024]
Instrumentos xurídicos
Publícase a definición dos servizos orientados a dar soporte á xestión dos préstamos en CoFFEE nas súas primeiras fases. En concreto, os instrumentos xurídicos: acordo de execución, acordo de intermediación, instrumento financeiro directo e instrumento financeiro indirecto.
[Outubro de 2024]
Rexistro de progreso de indicadores
Atópanse dispoñibles na contorna de produción os servizos v2.0 de rexistro de progreso de indicadores. (alta, edición, borrado) segundo a especificación v2.0.2.
[Outubro de 2024]
Rexistro de progreso de indicadores
Atópanse dispoñibles na contorna de probas os servizos v2.0 de rexistro de progreso de indicadores. (alta, edición, borrado) segundo a especificación v2.0.2.
Unha vez probados e validados despregaranse na contorna de produción. (Estado de endpoints)
 
Publicación da versión 2.0.2
A versión 2.0.2 inclúe:
  • Definición definitiva dos endpoints de rexistro de progreso de indicadores.
  • Definición dos servizos para a consulta de certificados de (non) revogación.
Poden consultar os cambios concretos na sección de preguntas frecuentes: cambios destacados de v2.0.1 a v2.0.2
A versión v2.0 da contorna de probas implementa está especificación. Unha vez probada e validada despregarase na contorna de produción. As integracións actuais non se ven afectadas.
 
Planificación
Mantense a planificación na contorna de probas:
  • Definición de subproxectos (alta, edición, borrado): Segunda quincena de novembro.
  • Definición de subproxectos instrumentais (alta, edición, borrado): Primeira quincena de decembro.
  • Planificación de actuacións (alta, edición, borrado): Segunda quincena de decembro.
  • Definición de proxectos (alta, edición, borrado): Segunda quincena de decembro.
Unha vez probados e validados despregaranse na contorna de produción.
 
[Setembro de 2024]
Contorna de produción
Atópase dispoñible na contorna de produción os servizos v2.0 de consulta do plan e xestión de instrumentos xurídicos. (Estado de endpoints)
 
Planificación
Publicación dos servizos na contorna de probas:
  • Execución. Rexistro de progreso de indicadores (alta, edición, borrado): Primeira quincena de outubro.
  • Definición de subproxectos (alta, edición, borrado): Segunda quincena de novembro.
  • Definición de subproxectos instrumentais (alta, edición, borrado): Primeira quincena de decembro.
  • Planificación de actuacións (alta, edición, borrado): Segunda quincena de decembro.
  • Definición de proxectos (alta, edición, borrado): Segunda quincena de decembro.
Unha vez probados e validados despregaranse na contorna de produción.
 
[Xuño de 2024]
Contorna de produción
Atópase dispoñible a contorna de produción e as instrucións para o acceso á contorna de produción.
 
Servizos para a xestión de instrumentos xurídicos
Atópanse dispoñibles na contorna de probas os servizos para a xestión de instrumentos xurídicos segundo a versión v2.0 da API.
Unha vez probados e validados despregaranse na contorna de produción.
 
Publicación da versión 2.0.1
A versión 2.0.1 inclúe:
  • Correción de erros na definición dos servizos para a xestión de instrumentos xurídicos. (Máis información na sección de «preguntas frecuentes»)
  • Definición completa dos servizos para a alta de actuacións, subproxectos instrumentais, subproxectos e proxectos.
  • Definición completa dos servizos para o rexistro de progreso e seguimento de indicadores.
Os servizos implementaranse de forma graduada coa seguinte orde previsto:
  1. Seguimento do plan (GETs).
  2. Alta de actuacións, subproxectos instrumentais, subproxectos e proxecto.
  3. Progreso de indicadores (POSTs).
Informarase da implementación dos servizos a través dun correo informativo por bloques implementados, pódese consultar o estado de implementación dos diferentes endpoints en: estado de endpoints. En calquera caso, a planificación pode ser modificada en función da demanda ou outras necesidades que se recibiron.
 
[Marzo de 2024]
Contorna de produción
Está a revisarse, en colaboración coa Secretaría Xeral de Fondos Europeos, o procedemento de autorización de acceso ao servizo que simplifique a configuración tanto técnica como a nivel de xestión. A contorna estará dispoñible unha vez implantouse o procedemento.
 
Publicación da versión 1.5.2
Publicación da versión 1.5.2 con melloras na funcionalidade: parámetro codigoPropietario opcional nalgunhas listaxes e información de proxecto en subproxecto, subproxectos instrumentais e actuacións. Poden consultar os cambios concretos na sección de preguntas frecuentes: cambios destacados de v1.5.1 a v1.5.2
 
Publicación da versión 2.0.0
A versión 2.0 inclúe as seguintes melloras transversais:
  • Paginación de listaxes
  • Mecanismo de subida de documento por localizador (máis información na sección de preguntas frecuentes)
A definición publicada abarca:
  • Definición completa dos servizos para a xestión de instrumentos xurídicos.
  • Listaxe dos endpoints previstos para o rexistro de progreso e seguimento de indicadores, como anticipo da definición completa que se publicará proximamente.
  • Listaxe dos endpoints previstos para a alta de subproxectos, subproxectos instrumentais e actuacións, como anticipo da definición completa que se publicará proximamente.
Os servizos para a xestión de instrumentos xurídicos implementaranse de forma graduada coa seguinte orde previsto:
  • Contratos
  • Subvencións
  • Convenios
  • Outros
  • Resto
Poden consultar o estado de implementación e definición dos diferentes endpoints en: estado de endpoints.
 
[Xaneiro de 2024]
Publicación da versión 1.5.1 que corrixe erros atopados na 1.5.0. Poden consultar os cambios concretos na sección de preguntas frecuentes: cambios destacados de v1.5.0 a v1.5.1
Por cuestións organizativas, a primeira fase non incluirá a implementación do servizo de rexistro de execución financeira ('/ejecucion/financeira')
A contorna de probas estará dispoñible a partir do xoves 1 de febreiro. Habilitarase tamén o formulario para realizar a solicitude de acceso. Estarán dispoñibles os seguintes servizos:
1. Servizos de consulta da información de estrutura.
2. Servizos de alta de instrumentos xurídicos e destinatarios.
 
[Novembro de 2023]
Publicación da versión 1.5.0 do API, adaptación da versión anterior á arquitectura de información actual de CoFFEE. 
A implementación da definición levarase a cabo por fases; as primeiras agruparán os seguintes servizos:
1. Servizos de consulta da información de estrutura; servizos de alta de instrumentos xurídicos e destinatarios; servizos de rexistro de execución.
2. Servizos de rexistro de progreso de indicadores e posiblemente outros servizos resultado da demanda dos organismos.
Pola vía desta mesma páxina e/ou a través de correo electrónico comunicarase ás unidades interesadas o calendario previsto de implantación das fases nas contornas previas e na contorna de produción.
 

Versións do servizo (índice)

Actualmente atópanse dispoñibles as seguintes versións:
DataVersiónContornaEspecificaciónNotas
Abril 20252.0Produción v2.0.7
Versión recomendada.
Adáptase aos cambios funcionais de CoFFEE-MRR.
Marzo 20241.5Produción v1.5.2
Versión dispoñible.
Non se adapta aos cambios funciones de CoFFEE-MRR.
O histórico de versións atópase dispoñible na sección de "Preguntas frecuentes".

Acceso e uso do servizo (índice)

No caso de que se desexe proceder a integrar unha aplicación de xestión externa con CoFFEE debe remitirse unha solicitude a través do Catálogo de Servizos Web, onde se atopa dispoñible o formulario de solicitude de acceso á API.
 
Como seguinte paso, tras o envío do formulario inicial, a OIP porase en contacto co departamento técnico solicitante a través da caixa de correos de correo CoFFEE-Desarrollo@igae.hacienda.gob.es. As comunicacións necesarias para a configuración técnica, así como o resto dos pasos de configuración (incluíndo a alta final en produción) recibiranse desde a mesma dirección de correo electrónico.
 
Antes de poder utilizar a API, os responsables da información dos nodos (proxectos, subproxectos e subproxectos instrumentais do PRTR) deben autorizar que o usuario que identifica a aplicación de xestión que lles dá servizo poida acceder e editar os datos dos nodos; para iso, durante o proceso de configuración solicitarase a autorización a través do enchemento do documento que figura a seguir, e o seu contido será verificado pola Secretaría Xeral de Fondos Europeos. Esta autorización deberá producirse unha única vez por cada responsable, e terá efecto sobre todos os nodos (existentes e futuros) que dependan del. O responsable da información dun nodo correspóndese co titular do órgano xestor do este nodo, e será a persoa que deba asinar a autorización ou revogación.
 
 
Para o uso correcto do servizo deberase engadir aos pedimentos ao API REST da interface publicado dous parámetros que permiten identificar a orixe das chamadas, e que serán proporcionados polo contacto técnico da Oficina de Informática Orzamentaria durante o proceso da alta. Os parámetros son:
- idAplicacion: identificador do API de CoFFEE-MRR
- idUsuario: identificador do usuario da aplicación de xestión.
 
Os servizos Web cliente autenticaranse mediante HTTPS/TLS cun certificado de selo electrónico emitido por algún dos fornecedores de servizos de certificación recoñecidos polo servizo web de @Firma.
 

Máis información (índice)

Para obter máis información, consulte a páxina de respostas a preguntas máis frecuentes, que se actualizará de forma periódica coas respostas ás consultas expostas.

Para facer calquera consulta de carácter técnico, comunicación de erratas na definición dos servizos ou outra achega, as unidades pódense dirixir mediante correo electrónico á conta do equipo de desenvolvemento (CoFFEE-Desarrollo@igae.hacienda.gob.es).