Ohiko galderak API interfazeari buruz

Badago mugarik zerbitzua erabiltzeko?

• Eskaeraren gehieneko tamaina: 100 MB.
• Dokumentuaren gehieneko tamaina: 60 MB.
• Bilduma bateko elementuen gehieneko muga: 100 elementu.
• Eskaera-kopurua minutuko: ezartzeke.

Galdera orokorrak API interfazeari buruz

Zein da daten formatua?

API interfazearen eremu guztiak derrigorrezkoak dira?

Hainbat kontularitzako egikaritzeko aitorpen bidal ditzaket POST dei berean?

Bai, dei bakoitzak deklaratzaile bereko (deklaratzaile bakarra) nahi adina aitorpen izan ditzake, eskemaren “DeclaracionEjecucion” datu-motak zehazten duen moduan.

Adierazleen aurrerabide-aitorpenei dagokienez: “data” eremuak (aurrerabidearen erreferentzia-data) gaurko data izan behar du?

Adierazle baten aurrerabidearen erreferentzia-data da eguneratzen den adierazlearen balioa lortutzat jotzen dena eta, ondorioz, gaurko data edo aurrekoa izan behar da, hau da, ez dira etorkizuneko datak onartzen.

Zergatik adierazle kuantitatiboak direnean “aldakuntza” jakinarazten da, eta adierazle kualitatiboak direnean “balioa” jakinarazten da?

Adierazleak aurrerabidearen neurgailuak dira, eta kuantitatiboak (balioa zenbakizko datu bat da, tarte baten barruan) edo kualitatiboak (balio bat eduki dezakete aukera-multzo itxi batean) izan daitezke.

• Adierazle kuantitatiboetan adierazlearen aurreko baliotik nagusitu den aldakuntza jakinarazi beharra dago. Adibidez, adierazlea “Matrikulatu diren ibilgailu elektrikoen kopurua” bada eta 1000 ibilgailutik 3000 ibilgailura pasatu bada, “2000” adieraziko da.

• Adierazle kualitatiboetan adierazleak aukeren artean hartu duen balio berria jakinarazi beharra dago (hasiera, aribidean eta amaituta).

Adierazle kuantitatiboetan aldakuntza ematen da sistemak justifikazio bat gehitzeko aukera ematen duelako (idatziz eta, hautaz, artxiboekin batera). Aitorpena egiten den unean adierazle baten handitutako (edo txikitutako) balioa arrazoitzen ari dela ulertzen da, ez lortutako azken balioa (aurreko adibidean, matrikulatu egin diren 2000 ibilgailuak arrazoitu egiten dira).

Adierazle kualitatiboetan egoeraren aldaketa gertatzen da eta, beraz, lortutako egoera adierazi egingo da.

Kontularitzako egikaritzeko aitorpenei dagokienez: “KontularitzakoData” eremuak (aurrerabidearen erreferentzia-data) gaurkoa baino geroagoko data izan daiteke?

Kontularitzako data gaurko data edo aurrekoa izan behar da, hau da, ez dira etorkizuneko datak onartzen.

Zer da tresna juridiko baten erreferentzia?

Kontabilitate-betearazpeneko aitorpenetan, aitorpena egiteko tresna juridikoaren erreferentzia bat zehazten da. Ohiko kasua kontratu edo dirulaguntza bat da, baina aurreikusitako tresna guztiak identifikatzeko gai izan behar da.

Erreferentzia, beraz, betearazpenari dagokion jarduketaren esparruko tresna juridiko zehatza identifikatzen duen kodea da.

Normalean, erreferentzia bat dator CoFFEE-n alta ematen duen pertsonak ezartzen duen tresnaren kodearekin (pantailaz, karga masiboz…).

Adibidez, CoFFEE-n “576282” BDNS kodearekin alta emanda dagoen dirulaguntza baten kasuan, erreferentzia kode hori bera da. Edo CoFFEE-n “2023OIP45544” kontratu-kodearekin alta emanda dagoen kontratu batek (ez PLACSP) kode hori bera izango du erreferentzia gisa.

Hala ere, kasu konplexuago bat dago, PLACSP kontratuen kasua, hain zuzen, eta hurrengo galderan jorratzen da zehazki.

Nola bereizten dira Sektore Publikoko Kontratazio Plataforman (PLACSP) alta emanda dagoen kontratu bat eta alta emanda ez dagoen bat?

PLACSP kontratuak hiru koderen bidez identifikatzen dira: kontratazio-organoaren kodea, lizitazio-kodea eta kontratu-kodea (ikus hurrengo galdera azalpen zehatza ikusteko). PLACSP ez diren kontratuak kode bakar baten bidez identifikatzen dira.

CoFFEE-ko kontratuen alta-sarreretan, bi kontratu-motak bereizita identifikatzen dira.

Tresna juridikoen erreferentziak eremu bakar baten bidez egiten direnez, PLACSP kontratuen kasuan (esan bezala, hiru kode dituzte), erreferentzia hiru balioak lotzeari dagokio, “~” banatzailea erabiliz, baita eremuak hutsik egon arren ere.

Zer dira PLACSP plataformaren kontratazio-, lizitazio- eta kontratu-organoaren kodeak?

Kontratazio-organoaren kodea Sektore Publikoko Kontratazio Plataformak (PLACSP, gaztelaniaz) erabiltzen duen identifikadore bat da, organo bakoitzari lotuta (PLACSP plataforman “ID Plataforma” deitzen da). Kontratazio-organo bakoitzak berea kontsulta dezake PLACSP plataformaren “kontratazio-organoen kudeatzailea” profilaren kudeatzailearen pantailan.

Gainera, Estatuko Ondarearen Zuzendaritza Nagusiak aldizka argitaratzen du kodeen zerrenda eguneratuz joaten denExcel orrialde batean.

PLACSP plataformaren kasuan, eta kontratazio-organo bakoitzerako, lizitazio- eta kontratu-kodeak Sektore Publikoko Kontratazio Plataforman txertatzen den kontratu bat modu bakarrean identifikatzen dutenak dira:

Lizitazio-kodea PLACSP plataforman datorren espediente-zenbakiarekin dator bat, eta kontratazio-organo bakoitzak ematen duen espediente-zenbakia da.

Kontratu-kodea PLACSP plataforman datorren kontratuarekin dator bat. Kontratazio-organoak zehazten duen balioa da ere bai. Espedientearen barruan dagoen kontratu bakoitzari dagokio.

Nolanahi ere, bi balio horiek kudeatzaileak eman behar dizkio PLACSP plataformari. Honako irudi honetan ikus daitezke biak.

Noiz bete behar da “Bestelako finantzaketa-iturriak” eremua?

Bestelako finantzaketa-iturriei buruzko informazioa eragiketaren jarduketa beste iturri batek finantzatzen duenean bete beharko da, Susperraldirako eta Erresilientziarako Mekanismoaren konturako finantzaketaz gain. Kasu honetan, eragiketa finantzatu duen mekanismoa edo funtsa identifikatuko da.

Kontularitzako informazioa bidaltzeari dagokionez: txertatzen diren kontratuak/dirulaguntzak CoFFEE sisteman altan emanda egon behar dira bidalketa egin baino lehen?

Bai, beharrezkoa da hirugarrenak CoFFEE-n alta emanda egotea kontabilitateko informazioa igorri aurretik. APIak beharrezko zerbitzuak ematen ditu

Kontularitzako informazioa bidaltzeari dagokionez, txertatzen diren bitartekoak (onuradunak, kontratistak eta abar) CoFFEE sisteman altan emanda egon behar dira bidalketa egin baino lehen?

Bai, beharrezkoa da hirugarrenak CoFFEE-n alta emanda egotea kontabilitateko informazioa igorri aurretik. APIak beharrezko zerbitzuak ematen ditu

Kontularitzako fase “barradunei” dagokienez (A/, D/, O/, AD/, ADO/, PR/, RE/), zenbatekoak positibo edo negatibo islatu behar dira?

Zenbatekoak dokumentu barradunetan beti positibo dira; barrak ezartzen du dagoeneko zenbatekoak negatibotzat hartuko direla kontularitzari dagokionez.

Kontularitzako egikaritzeko edo adierazleen aurrerabideko informazioa bidali ondoren: jaso izanaren adierazpenik jasoko dut?

Bai, sistemak jaso izanaren adierazpen elektronikoa bidaliko du, eragiketak jarraitzeko aukera emango duena

• Ruta:
• POST /ejecucion/otros-instrumentos/destinatarios bidea eguneratu da
• Tresna juridikoaren xehetasun-bideak eguneratu dira. {referencia} parametroa query parametro bihurtu da. Adibidez, GET /estructura/actuaciones/{codigo}/convenios/{referencia} orain GET /estructura/actuaciones/{codigo}/convenios/detalle?referencia={referencia} bihurtu da.
• Actuacion:
• Actuacion motako transferenciaDeRecursosEconomicosAOtroSubproyecto eguneratu da; aukerakoa bihurtu da.
• hitosObjetivosCriticos eremua gehitu da Actuacion motan.
• Actuacion motako recursosEconomicos eremua eguneratu da.
• Subproyecto:
• Subproyecto motako recursosEconomicos eremuko costeEstimado eremua ezabatu da.
• SubproyectoInstrumental:
• SubproyectoInstrumental motako recursosEconomicos eremuko costeEstimado eremua ezabatu da.

• Tresna juridikoaren alta: alta-eragiketaren erantzunean, tresna juridikoari esleitutako kode bakarra itzultzen da. Adibidez: POST /v2.0/contratos
• Jarduketa baten tresna juridikoen kontsulta: tresna juridikoen zerrendan tresna juridiko bakoitzaren kode bakarra dago. GET /v2.0/actuaciones/{codigo}/instrumentos-juridicos
• Kode bakarraren kontsulta: tresna juridiko baten kode bakarra lortzeko balio du, jarduketa-kodean eta tresna juridikoaren erreferentzian oinarrituta. GET /v2.0/instrumentos-juridicos/utilidades/codigo-unico