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

Truke-formatuak

Sarrera (aurkibidea)

Suspertze, Transformazio eta Erresilientzia Planean erantzukizuna duten organoen kudeaketa-sistemetarako integrazio-zerbitzuak ematen dira CoFFEE-MRRRren APIren bidez.

Zerbitzuak REST interfaze baten bidez eskaintzen dira; interfaze hori OpenAPI 3.0 formatuan dokumentatzen da.

Berrikuntzak (aurkibidea)

[2025eko martxoa]
Plangintza
Zerbitzu hauek eskuragarri daude dagoeneko ekoizpen-ingurunean:
  • Azpiproiektuen definizioa (alta, edizioa, ezabatzea)
  • Azpiproiektu instrumentalak definitzea (alta, edizioa, ezabatzea)
  • Jardueren plangintza (alta, edizioa, ezabaketa)
  • Proiektuen definizioa (alta, edizioa, ezabatzea)
  • Mugarriak eta helburuak definitzea (alta, edizioa, ezabatzea)
  • Finantza-tresnen zerbitzuak (alta, edizioa, ezabatua)
2.0.4 bertsioa argitaratzea
Bertsio berri bat argitaratu da, eskuragarri dauden enpoint berriak eta plangintza-zerbitzuak ezartzean hautemandako aldaketak jasotzen dituena. Ohiko galderen atalean ikus ditzakezu aldaketa zehatzak: aldaketa nabarmenak v2.0.3tik v2.0.4ra.
[2025eko otsaila]
Plangintza
Finantza-tresna zuzenetarako eta inderektatuetarako zerbitzuak proben ingurunean erabilgarri daude.
Probatu eta baliozkotu ondoren, ekoizpen-ingurunean hedatuko dira.
[2025eko otsaila]
Plangintza
Definiziorako eta plangintzarako zerbitzuak dagoeneko eskura daude proben ingurunean:
  • Azpiproiektuen definizioa (alta, edizioa, ezabatzea)
  • Azpiproiektu instrumentalak definitzea (alta, edizioa, ezabatzea)
  • Jardueren plangintza (alta, edizioa, ezabaketa)
  • Proiektuen definizioa (alta, edizioa, ezabatzea)
  • Mugarriak eta helburuak definitzea (alta, edizioa, ezabatzea)
Finantza-tresna juridikoei dagokienez:
  • Finantza-tresnen zerbitzuen inplementazioa: otsaileko bigarren hamabostaldia.
Probatu eta baliozkotu ondoren, ekoizpen-ingurunean hedatuko dira.
[2025eko urtarrila]
Plangintza
Plangintza eguneratu egin da proben eremuan:
  • Azpiproiektuen definizioa (alta, edizioa, ezabatzea): dagoeneko eskuragarri daude proben ingurunean
  • Azpiproiektu instrumentalen definizioa (alta, edizioa, ezabaketa): urtarrileko bigarren hamabostaldia.
  • Jardueren plangintza (alta, edizioa, ezabaketa): Otsaileko lehen hamabostaldia.
  • Proiektuen definizioa (alta, edizioa, ezabaketa): Otsaileko lehen hamabostaldia.
  • Mugarriak eta helburuak definitzea (alta, edizioa, ezabaketa): Otsaileko lehen hamabostaldia.
  • Finantza-tresnen zerbitzuak ezartzea: Otsaileko lehen hamabostaldia.
Probatu eta baliozkotu ondoren, ekoizpen-ingurunean hedatuko dira.
[2024ko abendua]
Tresna juridikoak
CoFFEEko maileguen kudeaketari lehenengo faseetan laguntza emateko zerbitzuen definizioa argitaratzen da. Zehazki, tresna juridikoak: betearazpen-akordioa, bitartekaritza-akordioa, zuzeneko finantza-tresna eta zeharkako finantza-tresna.
[2024ko urria]
Adierazleen aurrerapen-erregistroa
Adierazleen aurrerapen-erregistroaren v2.0 zerbitzuak eskura daude ekoizpen-ingurunean. (alta, edizioa, ezabatua) v2.0.2 zehaztapenaren arabera.
[2024ko urria]
Adierazleen aurrerapen-erregistroa
Adierazleen aurrerapen-erregistroaren v2.0 zerbitzuak eskuragarri daude proben ingurunean. (alta, edizioa, ezabatua) v2.0.2 zehaztapenaren arabera.
Probatu eta baliozkotu ondoren, ekoizpen-ingurunean hedatuko dira. (Endpointen egoera)
2.0.2 bertsioa argitaratzea
2.0.2 bertsioan, hauek sartzen dira:
  • Adierazleen aurrerapen-erregistroaren endpointen behin betiko definizioa.
  • Baliogabetze (ez)-ziurtagiriak kontsultatzeko zerbitzuen definizioa.
Aldaketa zehatzak ohiko galderen atalean kontsulta daitezke: aldaketa nabarmenak v2.0.1etik v2.0.2 atalera
Proben ingurunearen v2.0 bertsioa zehaztu egin da. Probatu eta baliozkotu ondoren, ekoizpen-ingurunean hedatuko da. Gaur egungo integrazioek ez dute eraginik.
Plangintza
Proben inguruko plangintzari eutsi zaio:
  • Azpiproiektuen definizioa (alta, edizioa, ezabatua): Azaroko bigarren hamabostaldia.
  • Azpiproiektu instrumentalen definizioa (alta, edizioa, ezabaketa): abenduko lehen hamabostaldia.
  • Jardueren plangintza (alta, edizioa, ezabaketa): Abenduko bigarren hamabostaldia.
  • Proiektuen definizioa (alta, edizioa, ezabaketa): Abenduko bigarren hamabostaldia.
Probatu eta baliozkotu ondoren, ekoizpen-ingurunean hedatuko dira.
[2024ko iraila]
Ekoizpen-ingurunea
Ekoizpen-ingurunean eskuragarri daude planaren kontsultarako eta tresna juridikoen kudeaketarako v2.0 zerbitzuak. (Endpointen egoera)
Plangintza
Zerbitzuak proben ingurunean argitaratzea:
  • Betearaztea. Adierazleen aurrerapen-erregistroa (alta, edizioa, ezabaketa): urriko lehen hamabostaldia.
  • Azpiproiektuen definizioa (alta, edizioa, ezabatua): Azaroko bigarren hamabostaldia.
  • Azpiproiektu instrumentalen definizioa (alta, edizioa, ezabaketa): abenduko lehen hamabostaldia.
  • Jardueren plangintza (alta, edizioa, ezabaketa): Abenduko bigarren hamabostaldia.
  • Proiektuen definizioa (alta, edizioa, ezabaketa): Abenduko bigarren hamabostaldia.
Probatu eta baliozkotu ondoren, ekoizpen-ingurunean hedatuko dira.
[2024ko ekaina]
Ekoizpen-ingurunea
Ekoizpen-ingurunea eta ekoizpen-ingurunera sartzeko jarraibideak eskuragarri daude.
Tresna juridikoak kudeatzeko zerbitzuak
APIren v2.0 bertsioaren arabera tresna juridikoak kudeatzeko zerbitzuak eskuragarri daude proben ingurunean.
Probatu eta baliozkotu ondoren, ekoizpen-ingurunean hedatuko dira.
2.0.1 bertsioa argitaratzea
2.0.1 bertsioak honako hauek barne hartzen ditu:
  • Akatsak zuzentzea tresna juridikoak kudeatzeko zerbitzuen definizioan. (Informazio gehiago, «Ohiko galderak» atalean)
  • Jarduketen, azpiproiektu instrumentalen, azpiproiektuen eta proiektuen altarako zerbitzuen definizio osoa.
  • Aurrerapena erregistratzeko eta adierazleen jarraipena egiteko zerbitzuen definizio osoa.
Zerbitzuak mailaka ezarriko dira, aurreikusitako ordena honen arabera:
1.- Planaren jarraipena (GETak).
2.- Jarduketen, azpiproiektu instrumentalen, azpiproiektuen eta proiektuaren alta.
3.- Adierazleen aurrerapena (POSTak).
Zerbitzuak inplementatu direla jakinaraziko da, ezarritako blokekako informazio-mezu baten bidez. Endpointen inplementazio-egoera kontsulta daiteke: endpointen egoera. Nolanahi ere, plangintza aldatu egin daiteke eskaeraren edo jaso diren beste behar batzuen arabera.
[2024ko martxoa]
Ekoizpen-ingurunea
Europako Funtsen Idazkaritza Nagusiarekin lankidetzan, zerbitzuan sartzeko baimen-prozedura berrikusten ari gara, konfigurazio teknikoa eta kudeaketa-maila sinplifikatzeko. Prozedura ezarri ondoren, ingurunea eskuragarri egongo da.
1.5.2 bertsioa argitaratzea
1.5.2 bertsioa argitaratzea, funtzionaltasunaren hobekuntzekin: parametro kodigoAukerako jabeazenbait zerrendatan eta proiektuko informazioa azpiproiektuan, azpiproiektu instrumentalak eta jarduketak. Ohiko galderen atalean ikus daitezke aldaketa zehatzak: aldaketa nabarmenak v1.5.1-tik v1.5.2-ra.
2.0.0 bertsioa argitaratzea
2.0 bertsioak zeharkako hobekuntza hauek ditu:
  • Zerrenden orrikatzea
  • Dokumentua bilagailu bidez igotzeko mekanismoa (informazio gehiago ohiko galderen atalean)
Argitaratutako definizioak honako hauek hartzen ditu barnean:
  • Tresna juridikoak kudeatzeko zerbitzuen definizio osoa.
  • Adierazleen aurrerapen- eta jarraipen-erregistrorako aurreikusitako endpointen zerrenda, laster argitaratuko den definizio osoaren aurrerapen gisa.
  • Azpiproiektuei, azpiproiektu instrumentalei eta jarduketei alta emateko aurreikusitako endpointen zerrenda, laster argitaratuko den definizio osoaren aurrerapen gisa.
Tresna juridikoak kudeatzeko zerbitzuak mailaka ezarriko dira, aurreikusitako ordena honetan:
  • Kontratuak
  • Diru-laguntzak
  • Hitzarmenak
  • Beste batzuk
  • Gainerakoa
Endpointen inplementazio- eta definizio-egoera kontsulta dezakezue: endpoint-egoera.
[2024ko urtarrila]
1.5.1 bertsioaren argitalpena, 1.5.0 bertsioan aurkitutako akatsak zuzentzen dituena. Ohiko galderen atalean ikus ditzakezu aldaketa zehatzak: aldaketa nabarmenak v1.5.0tik v1.5.1-ra.
Antolaketa-arrazoiak direla eta, lehenengo fasean ez da sartuko finantza-betearazpenaren erregistro-zerbitzuaren ezarpena ('/betearazpena/finantzarioa').
Probak otsailaren 1etik aurrera (osteguna) izango dira ikusgai. Sarbide-eskaera egiteko formularioa ere gaituko da. Honako zerbitzu hauek egongo dira eskuragarri:
1.- Egitura-informazioa kontsultatzeko zerbitzuak.
2.- Tresna juridikoen eta hartzaileen alta-zerbitzuak.
[2023ko azaroa]
APIren 1.5.0 bertsioa argitaratzea, aurreko bertsioa CoFFEEren egungo informazio-arkitekturara egokitzea.
Definizioa faseka ezarriko da; lehenengoek honako zerbitzu hauek bilduko dituzte:
1.- egituraren informazioa kontsultatzeko zerbitzuak; tresna juridikoen eta hartzaileen alta-zerbitzuak; gauzatze-erregistroaren zerbitzuak.
2.- Adierazleen aurrerabidea erregistratzeko zerbitzuak eta, beharbada, erakundeen eskariaren ondoriozko beste zerbitzu batzuk.
Orrialde honen beraren bidez eta/edo posta elektronikoaren bidez jakinaraziko zaie unitate interesdunei faseak aurre-inguruneetan eta ekoizpen-ingurunean ezartzeko aurreikusitako egutegia.

Zerbitzuaren bertsioak (aurkibidea)

Gaur egun, bertsio hauek daude eskuragarri:
DataBertsioaInguruneaEspezifikazioaOharrak
2025eko martxoa2.0Ekoizpena v2.0.4
Bertsio gomendatua.
CoFFEE-MRR aldaketa funtzionaletara egokitzen da.
2024ko martxoa1.5.-Ekoizpena v1.5.2
Bertsio erabilgarria.
Ez da egokitzen CoFFEE-MRR funtzioen aldaketetara.
Bertsioen historia "Ohiko galderak" atalean dago eskuragarri.

Zerbitzuaren sarbidea eta erabilera (aurkibidea)

Kanpo-kudeaketako aplikazio bat CoFFEErekin integratu nahi izanez gero, eskaera bat bidali behar da Web Zerbitzuen Katalogoaren bidez. Katalogo horretan dago eskuragarri APIra sartzeko eskaera-formularioa.
Hurrengo urrats gisa, hasierako inprimakia bidali ondoren, OIP sail tekniko eskatzailearekin harremanetan jarriko da CoFFEE-Desarrollo@igae.hacienda.gob.es postontziaren bidez. Posta elektronikoko helbide beretik jasoko dira konfigurazio teknikorako beharrezko komunikazioak, bai eta gainerako konfigurazio-urratsak ere (ekoizpeneko azken alta barne).
API erabili aurretik, nodoen informazioaren arduradunek (PRTRren proiektu, azpiproiektu eta azpiproiektu instrumentalak) baimena eman behar dute zerbitzua ematen dien kudeaketa-aplikazioa identifikatzen duen erabiltzaileak nodoen datuak eskuratu eta editatu ahal izan ditzan. Horretarako, konfigurazio-prozesuan baimena eskatuko da ondoren azaltzen den dokumentua betez, eta haren edukia Europako Idazkaritza Nagusiak egiaztatuko du. Baimen hori arduradun bakoitzak behin bakarrik eman beharko du, eta haren mendeko nodo guztietan (lehendik daudenetan eta etorkizunekoetan) izango du eragina. Nodo bateko informazioaren arduraduna nodo horren organo kudeatzailearen titularrari dagokio, eta hark sinatuko du baimena edo errebokazioa.
Zerbitzua behar bezala erabiltzeko, argitaratutako interfazearen API REST eskaerei bi parametro gehitu beharko zaizkie, deien jatorria identifikatzeko aukera ematen dutenak, eta Aurrekontu Informatikako Bulegoaren kontaktu teknikoak emango ditu altaren prozesuan. Hona hemen parametroak:
- idAplikazioa: CoFFEE-MRRren APIaren identifikatzailea
- IDerabiltzailea: kudeaketa-aplikazioaren erabiltzailearen identifikatzailea.
Bezeroaren web-zerbitzuak HTTPS/TLS bidez kautotuko dira, @Firma web-zerbitzuak aitortutako ziurtapen-zerbitzuen emaileetako batek emandako zigilu elektronikoko ziurtagiri batekin.

Informazio gehiago (aurkibidea)

Informazio gehiago nahi izanez gero, kontsultatu ohiko galderen erantzunen orria, eta aldian-aldian eguneratuko da, egindako kontsulten erantzunen arabera.

Edozein kontsulta tekniko egiteko, zerbitzuen definizioan akatsak jakinarazteko edo beste ekarpen bat egiteko, unitateak posta elektronikoz bidal daitezke garapen-taldearen kontura (CoFFEE-Desarrollo@igae.hacienda.gob.es.