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 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 o 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 prevista:
  • 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 levará 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)

DataVersiónContornaLigazón ao APINovidades
Marzo 20242.0.0Probas Ligazón á versión 2.0.0 endpoints_previstos_progreso_indicadores.md
enndpoints_previstos_alta.md
Marzo 20241.5.2Probas Ligazón á versión 1.5.2Parámetro codigoPropietario opcional nalgunhas listaxes e información de proxecto en subproxecto, subproxectos instrumentais e actuacións.
Xaneiro 20241.5.1Substituída por v1.5.2 Ligazón á versión 1.5.1Adaptación da definición dos servizos aos cambios funcionais de CoFFEE. Corrección de erros.
Novembro 20231.5.0Non implementado Ligazón á versión 1.5.0Adaptación da definición dos servizos aos cambios funcionais de CoFFEE.
Abril 20221.3.1Non Implementado Ligazón á versión 1.3.1Trátanse separadamente as declaracións de progreso de indicadores (tamén se limitan os valores posibles para os indicadores cualitativos) e de execución financeira. Finalmente inclúense os documentos contables DO e DO/.

Acceso e uso do servizo (índice)

Para acceder aos servizos publicados, as unidades interesadas deberán seguir o procedemento de alta especificado na páxina de catálogo de servizos web, e en concreto segundo detállase no documento “Procedemento de solicitude de acceso de entidades externas aos servizos WEB corporativos da Oficina de Informática Orzamentaria” publicado nela.  Durante o proceso de alta facilitarase información tanto de contacto técnico para resolución de cuestións técnicas, como sobre o mecanismo de conexión cos servizos (certificado que se utilizará na conexión segura).

Internamente solicitarase autorización do Responsable Funcional de CoFFEE-MRR que verificará a lexitimidade do intercambio que se pretende establecer.
 
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 do alta. Os parámetros son:
- idAplicacion: identificador do API de CoFFEE-MRR
- idUsuario: identificador do usuario de servizo
 
Os servizos Web cliente autenticaranse mediante HTTPS/TLS cun certificado de selo electrónico emitido por algún dos prestadores de servizos de certificación recoñecidos polo servizo web de @Firma.
As unidades interesadas non deberán tramitar as solicitudes de acceso ata que se comunicou a dispoñibilidade dos servizos nas contornas previas de probas.

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).