Preguntas frecuentes sobre o API

Preguntas xerais sobre o API

Cal é o formato das datas?

Son todos os campos do API obrigatorios?

Podo enviar múltiples declaracións de execución contable na mesma chamada POST?

Si, cada chamada pode conter cantas declaracións deséxense do mesmo declarante (un único declarante), como vén especificado no tipo de datos “DeclaracionEjecucion” do esquema.

En relación ás declaracións de progreso de indicadores: o campo “data” (a data de referencia do progreso), ten que ser a data actual?

A data de referencia do progreso dun indicador é aquela en que se considera alcanzado o valor do indicador que se actualiza, e por tanto ten que ser anterior ou igual á data actual, é dicir, non se permiten datas futuras.

Por que no caso de indicadores cuantitativos infórmase a “variación” e no caso de indicadores cualitativos infórmase o “valor”?

Os indicadores son medidores do progreso e poden ser cuantitativos (o seu valor é un dato numérico dentro dun rango) ou cualitativos (poden adoptar un valor de entre un conxunto pechado de opcións)

• No caso de indicadores cuantitativos débese informar a variación producida desde o valor anterior do indicador. Por exemplo, se o indicador é “Número de vehículos eléctricos matriculados” e pasouse de 1000 a 3000 vehículos, declararase “2000”.

• No caso de indicadores cualitativos débese informar o novo valor que tomou de entre os posibles (inicio, en curso e finalizado).

O motivo polo que para os indicadores cuantitativos proporciónase a variación é que o sistema permite incorporar unha xustificación (textual e, opcionalmente, acompañada de arquivos). Enténdese que no momento da declaración está a xustificarse o valor incrementado (ou decrementado) dun indicador, e non o valor final alcanzado (no exemplo anterior, xustifícanse os 2000 vehículos que se matricularon).

No caso dos indicadores cualitativos, prodúcese un cambio no seu estado, e por tanto declárase o estado alcanzado.

En relación ás declaracións de execución contable: o campo “fechaContable” (A data de referencia do progreso), pode ser unha data posterior á actual?

A data contable ten que ser anterior ou igual á data actual, é dicir, non se permiten datas futuras.

Que é a referencia dun instrumento xurídico?

Nas declaracións de execución contable especifícase unha referencia do instrumento xurídico baixo o que se fai a declaración. O caso típico é un contrato ou unha subvención, pero todos os instrumentos previstos deben poder ser identificados.

A referencia é, por tanto, un código que identifica o instrumento xurídico concreto no ámbito da Actuación para a que se rexistra a execución.

Habitualmente a referencia coincide co propio código do instrumento que establece a persoa que o dá de alta en CoFFEE (ben sexa por pantalla, carga masiva, ...).

Por exemplo, no caso dunha subvención dada de alta en CoFFEE co código BDNS "576282", a referencia é exactamente ese mesmo código. Ou un contrato (non PLACSP) que se deu de alta en CoFFEE co código de contrato "2023OIP45544", terá ese mesmo código como referencia.

Con todo, hai un caso máis complexo que é o dos contratos PLACSP, e que se trata especificamente na seguinte cuestión.

Como se diferencia un contrato que está dado de alta na Plataforma de Contratación do Sector Público (PLACSP) dun que non o está?

Os contratos PLACSP identifícanse por tres códigos: código de órgano de contratación, código de licitación, e código de contrato (ver seguinte cuestión para unha explicación detallada). Os contratos non PLACSP identifícanse mediante un único código.

Nas entradas de alta de contratos en CoFFEE, os dous tipos de contrato identifícanse de forma separada.

Dado que as referencias de instrumentos xurídicos fanse a través dun único campo, no caso de contratos PLACSP (que, como se indicou, teñen tres códigos) a referencia corresponde á concatenación do tres valores utilizando o separador “” entre eles, mesmo aínda que os campos estivesen baleiros.

Que son os códigos órgano de contratación, de licitación e de contrato de PLACSP?

O código do órgano de contratación é un identificador que usa a Plataforma de Contratación do Sector Público (PLACSP) asociado a cada un dos órganos (en PLACSP denomínase “IDE Plataforma”). Cada órgano de contratación pode consultar o seu propio na pantalla de administrador do perfil “administrador do órgano de contratación” de PLACSP.

Ademais, a Dirección Xeral de Patrimonio do Estado publica periodicamente a relación de códigos nunhafolla Excel que van actualizando.

No caso de PLACSP e para cada órgano de contratación, os códigos de licitación e de contrato son os que identifican de forma única un contrato que se incorpora á Plataforma de Contratos do Sector Público:

O código de licitación correspóndese co Número de Expediente na PLACSP, que é o número de expediente que proporciona cada órgano de contratación.

O código de contrato corresponde co Contrato da PLACSP. É tamén un valor que determina o órgano de contratación. Corresponde a cada contrato dentro do expediente.

En calquera caso, ambos son valores que proporciona o xestor á PLACSP. Ambos pódense ver na seguinte imaxe:

Cando se cobre o campo “Outras Fontes de financiamento”?

A información sobre outras fontes de información cubrirase cando a actuación á que corresponde a operación estea financiada por algunha outra fonte, de maneira adicional ao financiamento con cargo ao Mecanismo de Recuperación e Resiliencia. Neste caso, identificarase o mecanismo ou fondo que financiou a operación.

 

Para o caso de envío de información contable: teñen que estar dados de alta en CoFFEE previamente á remisión de información os contratos/subvenciones que se inclúan?

Si, é necesario que os terceiros estean dados de alta en CoFFEE previamente á remisión da información contable. O API proporciona os servizos necesarios

No caso de envío de información contable, teñen que estar dados de alta en CoFFEE previamente á remisión de información os terceiros (beneficiarios, contratistas, etc.) que se inclúan?

Si, é necesario que os terceiros estean dados de alta en CoFFEE previamente á remisión da información contable. O API proporciona os servizos necesarios

No caso de fases contables “barradas” (A/, D/, Ou/, AD/, ADO/, PR/, RE/), os importes débense reflectir en positivo ou en negativo?

Os importes en documentos barrados son sempre positivos; a barra xa indica que os importes se tratarán contablemente en negativo.

Unha vez enviada a información de execución contable ou de progreso de indicadores: Recibirei algún xustificante de recepción?

Si, o sistema proporcionará un xustificante de recepción electrónico que permita a rastrexabilidade das operacións.

• Ruta:
• Actualizouse a ruta POST /ejecucion/outros-instrumentos/destinatarios
• Actualizáronse as rutas de detalle dun instrumento xurídico. O parámetro {referencia} convértese en parámetro de query. Por exemplo, GET /estrutura/actuacións/{codigo}/convenios/{referencia} convértese en GET /estrutura/actuacións/{codigo}/convenios/detalle?referencia={referencia}
• Actuacion:
• Actualizouse o campo transferenciaDeRecursosEconomicosAOtroSubproyecto de Actuacion, convértese en opcional.
• Engadiuse o campo hitosObjetivosCriticos a Actuacion.
• Actualizouse o tipo do campo recursosEconomicos de Actución.
• Subproxecto:
• Eliminouse o campo costeEstimado de recursosEconomicos de Subproxecto.
• SubproyectoInstrumental:
• Eliminouse o campo costeEstimado de recursosEconomicos de SubproyectoInstrumental.

• Alta de instrumento xurídico: na resposta da operación de alta devólvese o código único asignado ao instrumento xurídico. Por exemplo: POST /v2.0/contratos
• Consulta de instrumentos xurídicos dunha actuación: a listaxe de instrumentos xurídicos inclúe o código único de cada instrumento xurídico. GET /v2.0/actuacións/{codigo}/instrumentos-juridicos
• Consulta de código único: existe unha utilidade para obter o código único dun instrumento xurídico a partir do código de actuación e a referencia do instrumento xurídico. GET /v2.0/instrumentos-juridicos/utilidades/codigo-unico

• Subida do documento: Engádese un documento novo ao sistema e obtense o localizador necesario para outras operacións. O documento créase co tipo PENDENTE. Os documentos subidos e non asociados a un elemento serán borrados periodicamente. O servizo utilizado é: POST /v2.0/documentos
• Asociación do documento cun elemento: O documento subido no punto anterior asóciase a un elemento. Na asociación indícase o localizar o documento, o tipo efectivo e os metadatos adicionais. O servizo utilizado depende do elemento, por exemplo, para engadir un documento a un contrato, o servizo é: POST /v2.0/contratos/{codigo-unico}/documentos

Outras dúbidas

Teño dúbidas funcionais sobre a xestión do Plan de Recuperación Transformación e Resiliencia e o sistema de xestión do mesmo, onde podo dirixirme?

Teño máis dúbidas técnicas relacionadas co API, onde podo dirixirme?