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

APIri buruzko ohiko galderak

Suspertze, Transformazio eta Erresilientzia Planari buruzko informazioa trukatzeko zerbitzu elektronikoei buruzko ohiko galderak.

Aurretiazko informazioa

APIren erabilgarritasuna

Konexioa eta zerbitzuaren erabilera

APIri buruzko galdera orokorrak

Aldez aurreko informazioa

Zer da CoFFEE eta CoFFEE-MRR?

CoFFEE (Europako Funtsen Plataforma Komuna) Europako funtsak kudeatzeko plataforma informatiko komuna da. 2021-2027ko urte anitzeko finantza-esparruan (MFP 21-27) Europako Funtsen Idazkaritza Nagusiaren (SGFE) eskumenekoak diren Europako funtsak kudeatzen laguntzen duten moduluak integratzea du helburu. 2021-2027ren aurreko finantza-esparruetan Eskualde Garapeneko Europako Funtsa (EGEF) kudeatzeko euskarri diren informazio-sistemen bilakaera da, baina beste funts edo mekanismo batzuen euskarri izateko sortu da.
CoFFEE-MRR CoFFEEren modulu bat da, eta teknologia, zeharkako prozesuak, informazioa gehitzeko mekanismoak eta abar aprobetxatzen ditu. plataformarena, eta Suspertze eta Erresilientzia Mekanismoari eta, zehazki, Suspertze, Transformazio eta Erresilientzia Planari (PRTR) lotutako ekimenen plangintzarako, kudeaketarako eta jarraipenerako behar den funtzionalitatea duena.

Nola eskatzen dut CoFFEE/CoFFEE-MRR atzipena?

Aurrekontu Administrazioaren sistemetara sarbidea eskatzeko prozedura Aurrekontu Administrazioaren Atariko “Sarbideen Kontrola” atalean dago deskribatuta.

APIren erabilgarritasuna

Zertarako balio du CoFFEEren APIak?

Zerbitzu elektronikoak abian jartzen dira ekimenak gauzatzen dituzten erakundeei errazteko Plana arautzen duen araudian ezarritakoa betetzea, eta, bereziki, irailaren 29ko HFP/1030/2021 Aginduan ezarritakoa; agindu horren bidez, Suspertze, Transformazio eta Erresilientzia Planaren kudeaketa-sistema (kudeaketa-agindua) eta irailaren 29ko HFP/1031/2021 Aginduan ezarritakoa betetzen da, zeinaren bidez ezartzen baita Estatuaren, autonomia-erkidegoen eta autonomia-erkidegoen arteko informazio-, kontabilitate- eta eraldatze-ahalmenaren formatua Estatuko, informazio- eta ordainketa-sistemek eskura dituzten informazio-sistemei eta egikaritze-sistemei buruzko informazioa emateko behar diren osagaiei dagokienez.
Gaitasun hori ez duten erakundeek informazioa modu interaktiboan gehitu dezakete; horretarako, sarbidea eskatu behar dute aldez aurretik.

Prest al dago REST APIa konektatzeko?

Bai. Endpoint-en ezarpen-egoera hemen ikus daiteke:endpointen egoera.

Bertsioen zerrenda

EgunaBertsioaInguruneaAPIrako estekaBerrikuntzak
2025eko maiatza2.0.8Ekoizpena2.0.8 bertsiorako estekaTresna juridikoen zenbatekoak editatzeko endpoint berria
Apirila 20252.0.7, 7Ekoizpena2.0.7 bertsiorako estekaAurrerapen-txostenaren aldea editatzeko endpoint berria
Apirila 20252.0.6Ekoizpena2.0.6 bertsiorako estekaCoFFEEren aldaketa funtzionaletara egokitzea
Apirila 20252.0.5.v2.0.6-k ordeztua2.0.5 bertsiorako estekaCoFFEEren aldaketa funtzionaletara egokitzea
Otsaila 20252.0.4v2.0.5ek ordeztua2.0.4 bertsiorako estekaCoFFEEren aldaketa funtzionaletara egokitzea
Abendua 20242.0.3v2.0.4k ordeztua2.0.3 bertsiorako estekaTresna juridiko berriak: ⦅ADMIN⦆ Instrumentos financieros directos, instrumentos financieros indirectos, acuerdos de ejecución, acuerdos de intermediación.
Urria 20242.0.2v2.0.3k ordeztua2.0.2 bertsiorako estekaAdierazleen aurrerapena erregistratzeko zerbitzuak definitzea. Ezeztatze (ez) ziurtagiriak kontsultatzeko zerbitzuen definizioa.
Ekaina 20242.0.1Honen ordez v2.0.2 ipiniko da.2.0.1 bertsiorako estekaJarduketei, tresnen azpiproiektuei, azpiproiektuei eta proiektuei alta emateko zerbitzuen definizioa. Aurrerapena erregistratzeko eta adierazleen jarraipena egiteko zerbitzuak definitzea.
Martxoa 20242.0.0v2.0.1ek ordeztua2.0.0 bertsiorako esteka
Maiatza ;20251.5.3EkoizpenaEsteka 1.5.3 bertsioraHartzaileei alta emateko metodoak zaharkitutzat joko dira.
Martxoa 20241.5.2.Ekoizpena1.5.2 bertsiorako estekaParametro kodigoa Hautatutako jabea zerrenda batzuetan eta azpiproiektu, azpiproiektu instrumental eta jarduketen inguruko informazioa.
Urtarrila 20241.5.1V1.5.2-k ordeztua1.5.1 bertsiorako estekaZerbitzuen definizioa CoFFEEren aldaketa funtzionaletara egokitzea. Hutsen zuzenketa.
Azaroa 20231.5.0.Ezarri gabeEsteka 1.5.0 bertsioraZerbitzuen definizioa CoFFEEren aldaketa funtzionaletara egokitzea.
Apirila 20221.3.1Ezarri gabe1.3.1 bertsiorako estekaAdierazleen aurrerabidearen deklarazioa (adierazle kualitatiboetarako balio posibleak ere mugatzen dira) eta exekuzio finantzarioaren deklarazioa bereizita tratatzen dira. Azkenik, DO eta DO/ kontabilitate-agiriak sartzen dira.

Ba al dago APIren ordezko mekanismorik plataformari informazioa emateko?

Bai, eman beharreko informazio-motaren arabera, sistemak mekanismoak jarriko ditu, sistemara konektatzen diren erabiltzaileek informazioa modu interaktiboan eman dezaten, baita tratatu beharreko datu guztiak dituen fitxategi bat modu interaktiboan gehituz ere.
Jakina, CoFFEEk baliozkotze berak egingo ditu informazioa modu masiboan ematen denean fitxategi bat kargatuta.

Zein da CoFFEEn kargatzen den JSON fitxategiaren kodetze-formatua?

Kodifikazioa UTF-8 da.

Konexioa eta zerbitzuaren erabilera

Nola eska dezaket APIrako sarbidea eta zein prozedura abiarazten du?

CoFFEErekin kanpo-kudeaketako aplikazio bat integratu nahi izanez gero, CoFFEEn informazioa API bidez eguneratzeko baimena betetzeko jarraibideak biltzen dituen dokumentua kontsultatu behar duzu.
Prozedura honako puntu hauetan laburbil daiteke:
CoFFEErekin integratuko den kudeaketa-aplikazioaren arduradunak 1.El Aurrekontu Administrazioaren Atariko Web Zerbitzuen Katalogoan dagoen formularioaren bidez sartzeko eskatzen du.
2.La OIP eskaera egin duen sail teknikoarekin harremanetan jarriko da CoFFEEDexarrollo@igae.hacienda.gob.es postontziaren bidez, eta kudeaketako aplikazioa identifikatzen duen erabiltzailea adieraziko du.
3.Los nodoetako informazioaren arduradunek (PRTRren proiektu, azpiproiektu eta azpiproiektu instrumentalak) baimentzen dute zerbitzua ematen dien kudeaketa-aplikazioa identifikatzen duen erabiltzailea nodoetako datuetara sartu eta horiek editatu ahal izatea.
4.El Teknikari eskatzaile batek osatuko du komunikazio segururako erabiliko den ziurtagiri elektronikoa.

Nola lortzen da segurtasuna atzipenean?

Bezeroaren web-zerbitzuak HTTPS/TLS (1.2 edo berriagoa) bidez kautotuko dira. Zehazki, administrazio-jarduera automatizaturako administrazio-zigiluaren, organoaren edo zuzenbide publikoko erakundearen ziurtagiri bat erabiliko da, edo, bestela, eIDAS araudiaren ondoriozko zigilu elektroniko kualifikatuko ziurtagiri bat, @Firma zerbitzuak aitortutako ziurtapen-zerbitzuen emaileren batek egina.

Sarbidea baimentzeko antolaketa-prozesuan, Aurrekontuen Informatika Bulegoaren eta organismo interesdunaren harreman teknikoaren artean adosten da zein ziurtagiri erabiliko duen zerbitzuaren azken bezeroak.

Nolakoa da zerbitzuarekiko ohiko elkarrekintza bat (APIren metodo baterako deia)?

Sarbidea baimentzeko prozesua amaitu ondoren, bezero-sistema zerbitzua erabiltzeko moduan egongo da. Horretarako, interakzio oro komunikazio seguru baten bidez (TLS) gauzatuko da, aurrez adostutako zigilu-ziurtagiria erabiliz.
REST zerbitzurako dei bakoitzak bi parametro gehigarri izango ditu HTTP eskaeran, zerbitzuaren beraren dokumentazioan adierazitako parametroez gain (idUsuario eta idAplicacion), eta sarbidea konfiguratzeko prozesuan eman ziren balioak izango dituzte.

Erakunde batek baino gehiagok erabili dezakete zigilu-ziurtagiri bera APIrekin elkarreragiteko?

Ohikoa ez bada ere, bi sarbide-eskaera izapidetzen badira (erakunde bakoitzeko bat) eta bietan ziurtagiri bera konfiguratzen bada bideratuko da aukera hori. Baimentze-prozesuan, zerbitzu-erabiltzaile (ID-Erabiltzaile) bana sortu eta esleituko zaie, eta CoFFEEn konfiguratuko dira eremu bakoitzean jarduten duten profilak.
Zerbitzuari egindako eskaera bakoitzak bere parametroen artean zerbitzuaren erabiltzailearen kodea (IDUsuario) duenez, CoFFEEk jatorria zehaztu ahal izango du, eta horren arabera jokatu, dagokion segurtasun-profila aplikatuz.
Hala eta guztiz ere, kontuan izan behar da erakundeetako batek besteari esleitutako ID-Erabiltzailea erabiliko balu, ez litzatekeela inolako mekanismorik egongo ordezkapena identifikatzeko; beraz, aukera hori bezero diren erakundeen arriskura gauzatuko litzateke.

Ba al dago zerbitzua erabiltzeko mugarik?

Honako muga hauek definitu dira:
  • Eskaeraren gehienezko tamaina: 100 MB.
  • Dokumentuaren gehienezko tamaina: 60 MB.
  • Bilduma bateko elementuen gehieneko muga: 100 elementu.
  • Segundoko eskarien gehieneko kopurua: 5 eskaera.
  • Lotu gabe igotako dokumentuen gehieneko kopurua: 20 dokumentu.

APIri buruzko galdera orokorrak

Zein da daten formatua?

RFC 3339, 5.6 atala definizioari erreferentzia egiten dion OpenApi 3.0 zehaztapenari jarraitzen zaio, adibidez, 2022-07-21.
Garrantzitsua da azpimarratzea eskatutako egun batzuk hiruhilekotan zehaztu behar direla.

APIko eremu guztiak nahitaezkoak dira?

Ez, halakotzat markatuta dauden eremuak baino ez dira nahitaezkoak (izartxo gorria dutenak).

Adierazleen aurrerapenari buruzko adierazpenei dagokienez, “data” eremuak (aurrerapenaren erreferentzia-data) gaurko data izan behar du?

Adierazle baten aurrerapenaren erreferentzia-data eguneratzen den adierazlearen balioa lortutzat hartzen dena da, eta, beraz, egungo data edo lehenagokoa izan behar du, hau da, ezin da geroko datarik ezarri.

Zergatik ematen da “aldaketa” adierazle kuantitatiboen kasuan eta “balioa” adierazle kualitatiboen kasuan?

Adierazleak aurrerabidearen neurtzaileak dira, eta kuantitatiboak (zenbaki bidez adierazten dira, tarte baten barruan) edo kualitatiboak (aukera\_multzo itxi baten barruan sar daitezke) izan daitezke.
  • Adierazle kuantitatiboen kasuan, adierazlearen aurreko baliotik izandako aldaketaren berri eman behar da. Adibidez, adierazlea “Matrikulatutako ibilgailu elektrikoen kopurua” baldin bada eta 1000 ibilgailutik 3000 ibilgailura pasatu bada, “2000” adieraziko da.
  • Adierazle kualitatiboen kasuan, balio posibleen artetik (hasiera, abian eta amaiera) hartu duen balio berria jakinarazi behar da.
Adierazle kuantitatiboetan aldaketa zergatik ematen den, sistemak justifikazio bat eransteko aukera ematen duelako da (testuala eta, nahi izanez gero, artxiboekin batera). Aitortzeko unean adierazle baten balio gehitua (edo gutxitua) justifikatzen ari dela ulertzen da, eta ez lortutako azken balioa (aurreko adibidean, matrikulatu diren 2000 ibilgailuak justifikatzen dira).
Adierazle kualitatiboen kasuan, horien egoera aldatu egiten da, eta, beraz, lortutako egoera adierazten da.

Zer da tresna juridiko baten erreferentzia?

Kontabilitate-betearazpenari buruzko adierazpenetan, adierazpena egiteko erabiltzen den tresna juridikoaren erreferentzia bat zehazten da. Ohiko kasua kontratu bat edo dirulaguntza bat da, baina aurreikusitako tresna guztiak identifikatu ahal izan behar dira.
Erreferentzia, beraz, kode bat da, betearazpena erregistratzen den jarduketaren eremuan tresna juridiko zehatza identifikatzen duena.
Normalean, erreferentzia bat dator CoFFEEn alta ematen dion pertsonak zehazten duen tresnaren kodearekin (pantailan, karga masiboan...).
Adibidez, CoFFEEn BDNS "576282" kodearekin alta emandako diru-laguntza baten kasuan, erreferentzia kode hori bera da. Edo CoFFEEn "2023OIP45544" kontratu-kodearekin alta eman duen kontratu batek (ez PLACSP) kode hori bera izango du erreferentzia gisa.
Hala ere, bada kasu konplexuago bat, PLACSP kontratuena, eta berariaz jorratzen da hurrengo gaian.

Nola bereizten dira Sektore Publikoaren Kontratazio Plataforman (PLACSP) alta emanda dagoen kontratu bat eta alta eman gabe dagoena?

PLACSP kontratuak hiru koderen bidez identifikatzen dira: kontratazio-organoaren kodea, lizitazio-kodea eta kontratu-kodea (ikus azalpen xehatu baterako galdera hau). PLACSP ez diren kontratuak kode bakar baten bidez identifikatzen dira.
CoFFEEn kontratuei alta emateko sarreretan, bi kontratu-motak bereiz identifikatzen dira.
Tresna juridikoen erreferentziak eremu bakar baten bidez egiten direnez, PLACSP kontratuen kasuan (adierazi den bezala, hiru kode dituzte) erreferentzia hiru balioen kateaketari dagokio, haien arteko “~” bereizlea erabiliz, baita eremuak hutsik egonda ere.

Zer dira PLACSPren kontratazio-organoaren, lizitazioaren eta kontratuaren kodeak?

Kontratazio-organoaren kodea Sektore Publikoaren Kontratazio Plataformak (PLACSP) erabiltzen duen identifikatzaile bat da, organo bakoitzari lotua (PLACSPn “ID Plataforma” deitzen zaio). Kontratazio-organo bakoitzak berea kontsulta dezake PLACSPren “kontratazio-organoaren administratzaile” profilaren administratzaile-pantailan.
PLACSP1.PNG
Gainera, Estatuko Ondarearen Zuzendaritza Nagusiak aldizka argitaratzen du kodeen zerrenda, eguneratzen duten Excel orri batean.
PLACSPren kasuan, kontratazio-organo bakoitzaren kasuan, lizitazio-kodeak eta kontratu-kodeak dira Sektore Publikoaren Kontratuen Plataforman sartzen den kontratu bat modu bakarrean identifikatzen dutenak:
Lizitazio-kodea bat dator PLACSPko espediente-zenbakiarekin, zeina kontratazio-organo bakoitzak ematen duen espediente-zenbakia baita.
Kontratu-kodea bat dator PLACSPren kontratuarekin. Kontratazio-organoak ere zehazten du balio hori. Espedientearen barruko kontratu bakoitzari dagokio.
Edonola ere, kudeatzaileak PLACSPri ematen dizkion balioak dira biak. Biak ikus daitezke ondorengo irudian.
PLACSP2.PNG

Noiz betetzen da “Beste finantziazio-iturri batzuk” eremua?

Beste informazio-iturri batzuei buruzko informazioa beteko da eragiketaren xede den jarduera beste iturriren batek finantzatzen duenean, Suspertze eta Erresilientzia Mekanismoaren kargurako finantzaketaz gain. Kasu horretan, eragiketa finantzatu duen mekanismoa edo funtsa identifikatuko da.

Aldaketa nabarmenak v1.3.1etik v1.5era

Datu\_motaren arabera, aldaketa nabarmenenak zerrendatzen dira:
  • Mota guztiak:
    • codigoIniciativa es ahora codigoActuacion
  • Neurria:
    • fechaHasiera: hiru hilean behin balio du
    • fechaFin bere balioa hiruhilekoa da
  • Kontratua:
    • PLACSP kontratua kodigoa daInstrumentua, kodea, lizitazioa eta kodea Organoa
    • Kontratu-zk. PLACSP kodea da orain
  • Diru-laguntza:
    • deialdia BDNS kodea da orain
  • Ekimena:
    • Proiektu, Azpiproiektu, Azpiproiektu Instrumental eta Jarduketan bereizia.
    • fechaHasiera: hiru hilean behin balio du
    • fechaFin bere balioa hiruhilekoa da
  • Finantza-adierazpena
  • AdierazpenAurreratua Adierazlea
    • codigoIniciativa, orain, codigoJatorri izena hartzen du: aurrerabidea
Oro har, desagertutako eremuen berri ez da eman behar.

Aldaketa nabarmenak v1.5.0-tik v1.3.1era

  • Ibilbidea:
    • POST/exekuzioa/beste tresna/hartzaileak bidea eguneratu da.
    • Tresna juridiko baten xehetasun ibilbideak eguneratu dira. {Erreferentzia} parametroa query-parametro bihurtzen da. Adibidez, GET /egitura/jarduerak/{codigo}/hitzarmenak/{referencia} bihurtzen da GET/egitura/jarduerak/{codigo}/hitzarmenak/detalle?referencia={referencia}
  • Jarduera:
    • Baliabide ekonomikoen transferentzia eguneratu daJarduera-azpiproiektua; aurrerantzean, aukerakoa izango da.
    • 'Jardueren helburu kritikoak' eremua gehitu da.
    • Eguneratu egin da jarduteko baliabide ekonomikoen eremuko mota.
  • Azpiproiektua:
    • Azpiproiektuko baliabide ekonomikoen kostu zenbatetsia eremua ezabatu da.
  • Azpiproiektu-instrumentala:
    • Azpiproiektu-instrumentaleko baliabide ekonomikoen kostu zenbatetsia eremua ezabatu da.

Aldaketa garrantzitsuak v1.5.1-etik v1.5.2-ra

  • codigoJabe parametroa hautazko bilakatuko da honako ibilbide hauetan:
    • /v1.5/egitura/proiektuak
    • /v1.5/egitura/azpiproiektuak
    • /v1.5/egitura/azpiproiektu instrumentalak
    • /v1.5/egitura/jarduerak
    Zerrendan ez badaude, erabiltzaileak eskura dituen elementu guztiak sartu behar dira zerrendan, bakoitzari dagokion motakoak.
  • proiektua. Azpiproiektu, tresnen azpiproiektu eta jarduerek dagokien proiektuaren (proiektu-propietatea) laburpena barne hartzen dute.

Aldaketa nabarmenak v2.0.0–tik v2.0.1–era

  • Tresna juridikoak.
    • PATCH eguneratze-metodoak PUT bidez aldatu dira bederatzi tresna juridiko motetarako.
    • Aldaketak Esleipendunari, Aldaketak Onuradunari eta Aldaketak eskemen arloak aldatu dira. Orain, deskribapena itzultzen da, eta ez objektu bat.
    • 'SinIVA' eremuaren izena eguneratu egin dugu, eta 'SinIva' jarri dugu.
    • Eragiketa-arduradunaren eskaerei unitatea gehitu zaie.
    • Tresna-profilen eskaeretan bug bat konpondu da, bide zuzena erakusten ez duen gasturik ez dakarrena.
    • Endpoint bat gehitu da tresna juridikoetan, eragiketa-arduradunaren eskaera bat baliogabetzeko.
    • Endpoint bat gehitu da tresna juridikoetan, eragiketa-arduradunaren eskaera baten datuak lortzeko.

Aldaketa nabarmenak v2.0.1etik v2.0.2 puntura

  • Adierazleen aurrerapena
    • Aurrerapen-erreportajeen url-a aldatzen ari da eta adierazle-url-a ere bai.
    • Txostena sartuta dagoen nodoaren kodea sartu da url-an.
    • Orrialdeka dokumentuak kontsultatzeko behar diren endpointak barne hartzen dira.
  • Tresna juridikoak.
    • Tresna juridiko baten informazioko SinIva, LehenMaila eta Guztizko LehenMaila eremuak itzultzen dira.
    • Kontratistetan numLote eremua editatu ahal izango da.
  • Mugarriak eta helburuak.
    • ⦅ADMIN⦆ Se definen e implementan los endpoints de consulta de certificados de (no) revocación.
  • Baliabide ekonomikoak
    • Baliabide ekonomikoak kontsultatzeko endpointak barne hartzen dira.

Aldaketa nabarmenak v2.0.2 eta v2.0.3 artean

  • Adierazleen aurrerapena
    • Aurrerapen-txostenen edizio-mota berriak.
  • Tresna juridikoak
    • Zuzeneko finantza-tresna.
    • Zeharkako finantza-tresna.
    • Betearazteko erabakia.
    • Bitartekaritza-akordioa
    • Hartzaileen edizio-mota berriak.
    • Sortze-dataren eremu berria.
  • Mugarriak eta helburuak.
    • Alta emateko eta editatzeko endpointak aldatzea.
  • Planaren jarraipena
    • PUT/azpiproiektuak/{kodea}/azpineurriak/{azpi-neurria}/-k aldatzea POST/azpiproiektuak/{kodea}/azpi-neurriak/{azpi-neurria}/

Aldaketa nabarmenak v2.0.3tik v2.0.4ra

  • Mugarriak eta helburuak.
    • \ldblquote Ziurtagiriaz gain beste dokumentazio bat\rdblquote dokumentu-mota berria
    • Ziurtagiri baten lehen mailako kontroletan hainbat dokumentu baimentzea
      • GET /-helburuak/{kodea}/segimendua/ziurtagiriak/{uid-certificado}/kontrolak -lehen-maila
      • GET /-helburuak/{kodea}/jarraipena/ziurtagiriak/{uid-certificado}/kontrolak -lehen-maila/{uid-dokumentua}
      • GET /-helburuak/{kodea}/jarraipena/ziurtagiriak/{uid-certificado}/kontrolak -lehen-maila/{uid-dokumentua}/edukia
    • Lorpen bati lotutako dokumentuetako informazioa hobetzea:
      • GET /-helburuak/{kodea}/jarraipena/dokumentuak
      • GET /-helburuak/{kodea}/jarraipena/dokumentuak/{uid-dokumentua}
      Honako hauek sartzen dira:
      • Dokumentuaren jatorria
      • Ziurtagiri sinatua
      • Goiko mailan inportatua
    • Baliogabetze-egoera (ez)
      • GET /-helburuak/{kodea}/jarraipena/egoera-baliogabetzea
    • Ezeztatze-ziurtagiri bati (ez) lotutako berrespen-zikloa
      • GET /-helburuak/{kodea}/jarraipena/\_errebokazioa/{uid-certificado}
  • Planaren jarraipena
    • Egoera-aldaketen informazioa P, SP eta SPIrako.
      • GET /proiektuak/{codigo}/historia-egoerak
      • GET /azpiproiektuak/{codigo}/historico-egoerak
      • GET/azpiproiektu instrumentalak/{codigo}/historico-egoerak
  • Dokumentuak
    • Igotako baina lotu gabeko dokumentuak kontsultatzeko Endpoint-a.
      • GET /malda duten dokumentuak

Aldaketa nabarmenak v2.0.4tik v2.0.5era

  • Mugarriak eta helburuak.
    • "Spreadsheet" dokumentu-mota berria HGC, HGnC eta CIDen
    • Dokumentu\_mota berria Egiaztatzeko mekanismoen aurkibidea
    • Beheko nodoak egiaztatzeko mekanismoetarako endpoint-ak
      • GET /-helburuak/{kodea}/jarraipena/behe-maila/dokumentuak
      • GET /-helburuak/{kodea}/jarraipena/behe-maila/dokumentuak/{uid-dokumentua}
      • GET /-helburuak/{kodea}/jarraipena/behe-maila/dokumentuak/{uid-dokumentua}/edukia
      • BLOG-MEZUAK /-helburuak/{kodea}/jarraipena/behe-maila/dokumentuak/{uid-dokumentua}/inportatu
      • DELETE /-helburuak/{kodea}/jarraipena/behe-maila/dokumentuak/{uid-dokumentua}
  • Tresna juridikoak.
    • Zuzeneko eta zeharkako finantza-tresna juridikoetan Lehen Maila Osoa gehitu da.
    • "COSECPUPR - Sektore publikoaren eta pribatuaren arteko lankidetza" izeneko kontratu-motaren kodea zuzendu da
  • Jarduketak.
    • Nahitaezko eremuak berrikustea.
    • Endpoint berria, jarduketako tresna juridiko bat aldatzeko.
      • POST /emanaldiak/{codigo}/instrumentu-juridikoak/{codigo-unico}/mover/{codigo-destino}
  • Adierazleak.
    • "Metatutako balioa" eremuak -1 itzuliko du mugarri edo helbururen batean balio desberdinak izanez gero
  • Dokumentuak.
    • Dokumentuen izenak 180 karakterera mugatu dira

Aldaketa nabarmenak v2.0.5etik v2.0.6ra

  • Tresna juridikoak.
    • 'Diru-laguntza gordin baliokidea' eremu berria, IFD eta IFI motako tresna juridikoen finantza-onuradunentzat

Aldaketa nabarmenak v2.0.6-tik v2.0.7-ra

  • Adierazleen aurrerapena.
    • Endpoint berria, txostenaren edizio diferentzialerako
      • POST /progres-adierazleena-kodea/{codigo}/reportes/{uid-reporte} aldaketak/diferencial
  • Planaren jarraipena.
    • Neurrien jarraipena egiteko endpoint berriak
      • GET /neurriak/{kodea}/jarraipena/dokumentuak
      • GET /neurriak/{kodea}/jarraipena/txostenak
      • GET /neurriak/{kodea}/jarraipena/erabiltzaileak
      • GET /neurriak/{kodea}/jarraipena/erantzukizun-eskaerak

Aldaketa nabarmenak v2.0.7-tik v2.0.8-ra

  • Tresna juridikoak
    • Endpoint berriak, IIJJ zenbatekoak historikoarekin editatzeko
      • GET /kontratua/{codigo-unico}/aldaketak
      • POST /kontratua/{codigo-unico}/aldaketak
      • GET /hitzarmena/{codigo-unico}/aldaketak
      • POST /hitzarmena/{codigo-unico}/aldaketak
      • ...
  • Planaren jarraipena
    • Neurrien jarraipena egiteko endpoint berriak
      • GET /neurriak/{kodea}/jarraipena/dokumentuak
      • GET /neurriak/{kodea}/jarraipena/txostenak

Aldaketa nabarmenak v2.0.8tik v2.0.9ra

  • Tresna juridikoak
    • Ordainketa-egoera zeharkako finantza-tresnetan sartzea

API v2.0ri buruzko galdera orokorrak

Nola lor dezaket tresna juridiko baten kode bakarra?

Tresna juridiko baten kode bakarra hiru modutan lortzen da:
  • Tresna juridikoaren alta: alta-eragiketari erantzutean, tresna juridikoari esleitutako kode bakarra itzultzen da. Adibidez: POST /v2.0/kontratuak
  • Jarduketa baten tresna juridikoak kontsultatzea: tresna juridikoen zerrendan tresna juridiko bakoitzaren kode bakarra dago. GET /v2.0/emanaldiak/{codigo}/instrumentu-juridikoak
  • Kode bakarraren kontsulta: tresna juridiko baten kode bakarra lortzeko erabilgarritasun bat dago, jarduera-kodea eta tresna juridikoaren erreferentzia oinarri hartuta. GET /v2.0/instrumentu-juridikoak/utilitateak/codigo-unico

Nola igotzen dira dokumentuak?

Dokumentuen igoerak bi urrats ditu:
  • Dokumentuaren igoera: Sistemari dokumentu berri bat gehitzen zaio, eta beste eragiketa batzuetarako behar den bilatzailea lortzen da. Dokumentua PENDIENTE motarekin sortzen da. Igotako dokumentuak, elementu bati lotuta ez daudenak, aldizka ezabatuko dira. Zerbitzu hau erabili da: POST /v2.0/dokumentuak
  • Dokumentua elementu batekin elkartzea: Aurreko puntuan igotako dokumentua elementu bati lotzen zaio. Elkartean, dokumentua, tasa efektiboa eta metadatu gehigarriak non dauden adierazten da. Erabiltzen den zerbitzua elementuaren araberakoa da; adibidez, kontratu bati dokumentu bat gehitzeko, hau da zerbitzua: POST /v2.0/kontratuak/{codigo-unico}/dokumentuak
Dokumentu bera hainbat elementurekin lotu nahi bada, dokumentua behin igo behar da, eta lokalizatzailea behar adina aldiz erabili ahal izango da.

Beste zalantza batzuk

Zalantza funtzionalak ditut Suspertze, Transformazio eta Erresilientzia Planaren kudeaketari eta planaren kudeaketa-sistemari buruz. Nora jo dezaket?

Planaren funtzionamenduaren deskribapenak bi ministro-agindu ditu:
  • HFP/1030/2021 Agindua, irailaren 29koa, Suspertze, Transformazio eta Erresilientzia Plana kudeatzeko sistema eratzen duena.
  • HFP/1031/2021 Agindua, irailaren 29koa, Estatuko, autonomia-erkidegoetako eta tokiko sektore publikoko entitateek informazioa emateko prozedura eta formatua ezartzen dituena Suspertze, Transformazio eta Erresilientzia Planaren ataletako neurrien mugarri eta helburuak zenbateraino betetzen diren jakiteko jarraipena egiteko eta neurrion aurrekontu- eta kontabilitate-betearazpenaren jarraipena egiteko.

APIrekin lotutako zalantza tekniko gehiago ditut. Nora jo dezaket?

CoFFEEren API REST sistemari buruzko gainerako zalantza teknikoentzat, mezu bat idatz daiteke laguntzako helbide elektroniko honetara:@soportesgffee.zendesk.com