Regjistri i DPP-ve tani ka dokumentacion për programuesit

Kiril ShivachevKiril Shivachev•Publikuar më •7 minuta lexim
Patch panel optik me porta të numëruara dhe kabllo të verdha

Një pasaportë e gabuar mjafton që asnjë nga 99 të tjerat në të njëjtën kërkesë të mos regjistrohet. Ky rregull është shkruar në dokumentacionin e Regjistrit të BE-së për pasaportat digjitale të produkteve. Komisioni Evropian e publikoi më 30 tetor 2026, ndërsa Drejtoria e Përgjithshme për Tregun e Brendshëm, Industrinë, Sipërmarrjen dhe NVM-të e njoftoi zyrtarisht më 16 nëntor. Për herë të parë përshkruhet bardhë e zi se si një pasaportë hyn në regjistër. Për momentin, megjithatë, kemi vetëm përshkrimin. Funksionet për testim do të shfaqen gradualisht, para se regjistri të funksionojë plotësisht.

Çfarë publikoi Komisioni më 30 tetor

Në faqen me burime për pasaportën digjitale të produktit, Komisioni ngarkoi gjashtë dokumente teknike, të gjitha në versionin 1.0, me datë 30 tetor 2026 dhe vetëm në anglisht. Tri prej tyre janë më të rëndësishmet për prodhuesit dhe importuesit:

  • API Integration Guide përshkruan si dërgohen pasaportat për regjistrim dhe si ndiqet rezultati;
  • Semantic Data Guide përcakton me cilat skema dhe fjalorë i kontrollon regjistri të dhënat;
  • Self-Hosted Authentication Guide përshkruan si duhet t'i përgjigjet regjistrit serveri ku ndodhet pasaporta.

Tri të tjerat janë specifikimet OpenAPI, skedarët me artefaktet semantike dhe udhëzuesi për llogaritë e shërbimit (Service Account guide).

Regjistri funksionon që nga 20 korriku 2026, por deri tani në të mund të regjistroheshin vetëm organizatat. Udhëzuesi për operatorët ekonomikë thotë ende se për momentin nuk është e mundur që një pasaportë të regjistrohet me sukses. Dokumentet e reja përshkruajnë si do të bëhet kjo. Nëse doni të lexoni fillimisht se çfarë është regjistri, kemi shkruar për nisjen e tij në korrik.

Pesë pika fundore, deri në 100 pasaporta për kërkesë, gjithçka ose asgjë

Ndërfaqja për regjistrimin e pasaportave digjitale të produkteve, e përshkruar në API Integration Guide v1.0 të 30 tetorit 2026, ka saktësisht pesë pika fundore publike (endpoints). E para kthen listën e grupeve dhe nëngrupeve të produkteve që pranon regjistri. E dyta pranon pasaportat për regjistrim. Tri të tjerat tregojnë deri ku ka arritur përpunimi: listën e detyrave, statusin e një detyre të caktuar dhe rezultatin për secilën pasaportë veç e veç (në JSON ose CSV).

Regjistrimi nuk bëhet në çast. Dërgoni kërkesën dhe regjistri përgjigjet me kodin 202 dhe një numër detyre. Rezultatin e kontrolloni më vonë. Çdo kërkesë mbart një çelës të detyrueshëm (Idempotency-Key). Falë tij, nëse lidhja ndërpritet dhe e dërgoni sërish të njëjtën kërkesë, nuk krijohen dublikata.

Kufizimet janë konkrete:

  • nga 1 deri në 100 pasaporta në një kërkesë, gjithsej deri në 10 MB;
  • një grup dhe një nëngrup produktesh për kërkesë (për shembull bateri, nëngrupi LMT);
  • kërkesa është atomike: nëse qoftë edhe një pasaportë nuk i plotëson kushtet, nuk regjistrohet asnjë.

Rregulli i fundit ka një pasojë të drejtpërdrejtë praktike. Nëse jeni importues dhe merrni pasaporta nga disa furnitorë, është më mirë të dërgoni kërkesë të veçantë për secilin prej tyre. Përndryshe, një gabim në të dhënat e një furnitori do të ndalë edhe pasaportat e të tjerëve. Paketa e korrigjuar dërgohet si kërkesë e re, me çelës të ri.

Identifikuesi unik duhet të jetë një adresë uebi që hap pasaportën

Sipas dokumentacionit API të Komisionit, identifikuesi unik i produktit (UPI) duhet të jetë një adresë URL me HTTPS, me gjatësi nga 8 deri në 2000 karaktere. Regjistri nuk e merr vetë pasaportën në kërkesë. Merr adresën, e hap në momentin e kontrollit dhe e verifikon përmbajtjen sipas Rregullores Zbatuese (BE) 2026/1778. Nëse adresa nuk hapet, gabimi është UPI_NOT_RESOLVABLE dhe, meqë kërkesa është atomike, bie e gjithë paketa. Regjistri nuk e ruan përmbajtjen që ka lexuar.

Prandaj radha është e prerë: së pari e publikoni pasaportën, pastaj e regjistroni. Një furnitor që thotë „do ta ngarkojmë pasi ta regjistroni“ e përmbys radhën dhe regjistrimi nuk do të kalojë. As një numër serial i thjeshtë nga sistemi juaj nuk është UPI. Ai mund të jetë pjesë e adresës, por regjistri kërkon një adresë që funksionon.

Udhëzuesi për vetë-hostimin (Self-Hosted Authentication Guide) shton edhe disa rregulla për serverin ku ndodhet pasaporta. Pjesa publike duhet të hapet pa hyrë në llogari, me jo më shumë se tri ridrejtime gjatë rrugës. Të dhënat e mbrojtura jepen vetëm kur regjistri paraqet një token të nënshkruar nga sistemi i autentikimit të Komisionit, të vlefshëm jo më shumë se 120 sekonda. Nëse tokeni është i pavlefshëm, serveri duhet ta refuzojë aksesin, e jo të kthejë në heshtje versionin publik në vend të atij të mbrojtur.

Para kërkesës së parë: organizatë e verifikuar dhe llogari shërbimi

Regjistri i DPP-ve pranon kërkesa vetëm nga një organizatë që ka kaluar verifikimin. Verifikimi bëhet me vulë elektronike të kualifikuar dhe pikërisht këtu kompanitë shpesh pengohen, sepse nënshkrimi elektronik i zakonshëm nuk mjafton. E kemi shtjelluar në detaje në artikullin për vulën elektronike. Statusi i verifikuar vlen deri në skadimin e vulës, por jo më shumë se tre vjet. Pas kësaj, regjistri nuk pranon regjistrime dhe ndryshime të reja derisa verifikimi të rinovohet.

Vetë kërkesat drejt API-t i dërgon një llogari shërbimi (service account). Udhëzuesi për llogaritë e shërbimit, gjithashtu i 30 tetorit, vendos këta kufij:

  • llogarinë e krijon administratori i organizatës dhe i cakton rolin „Register DPPs“;
  • një organizatë mund të ketë jo më shumë se 5 llogari të tilla;
  • çdo llogari mund të ketë deri në 2 çelësa aktivë, me vlefshmëri të rekomanduar një vit dhe maksimumi dy;
  • çelësi privat është përgjegjësi e operatorit ekonomik: ai e krijon, e ruan dhe e kontrollon.

Sipas udhëzuesit për operatorët ekonomikë, nuk pritet që regjistri të ketë tarifë abonimi. Kostot reale janë vula dhe integrimi.

JSON është i vetmi format i detyrueshëm, ndërsa skemat ekzistojnë deri tani vetëm për bateritë

Udhëzuesi semantik i Komisionit (Semantic Data Guide v1.0) thotë se gjatë regjistrimit do të kërkohet JSON, sepse ky është i vetmi format i detyrueshëm sipas standardit EN 18216:2026. JSON-LD dhe XML kontrollohen gjithashtu nëse i dërgoni, por nuk janë të detyrueshëm. Për ndërmarrjet e vogla dhe të mesme ky është lajm i mirë: për të regjistruar një pasaportë nuk u duhen të dhëna të lidhura (linked data) dhe RDF.

Skema dhe fjalorë konkretë ka deri tani vetëm për bateritë, në tri nëngrupe: bateri për automjete elektrike, bateri industriale dhe bateri për mjete të lehta transporti (LMT). Tekstilet, mobiljet, hekuri e çeliku dhe produktet e ndërtimit kanë bërthamën e përbashkët me 12 koncepte bazë (identifikuesi, statusi, data e ndryshimit të fundit, gjuha etj.), por ende nuk kanë skemat e tyre. Do t'i marrin me aktet e deleguara të Komisionit për secilin grup. Ndërfaqja e regjistrimit do të mbetet e njëjta; do të ndryshojë vetëm grupi i produkteve në kërkesë.

Disa gjëra ende nuk janë të qarta. Në dokumente mungon një katalog i plotë i kodeve të gabimeve, nuk jepen kufij për numrin e kërkesave dhe nuk përshkruhet formati i identifikuesit që kthen regjistri. As nuk është njoftuar kur regjistri do të fillojë të pranojë pasaporta testuese për bateritë. Komisioni do të mbajë më 26 nëntor 2026 një webinar për API-n dhe modelin semantik. Të rejat do t'i pasqyrojmë në faqen e ndryshimeve.

Çfarë mund të përgatitni para se funksionet për testim të bëhen të disponueshme

Me dokumentacionin e regjistrit të 30 tetorit mund ta nisni përgatitjen që tani, pa pritur që ai të funksionojë plotësisht:

  • kontrolloni nëse organizata juaj ka vulë elektronike të kualifikuar dhe kur i skadon;
  • vendosni kush do të jetë administrator në regjistër dhe ku do të ruhen çelësat privatë të llogarisë së shërbimit;
  • kërkoni nga furnitorët konfirmim se pasaportat e tyre do të jenë të publikuara në një adresë HTTPS që funksionon, para se t'i regjistroni;
  • planifikoni kërkesat sipas nëngrupit të produkteve dhe sipas furnitorit, që një gabim të mos ndalë gjithçka.

Ne në WIARA po ndërtojmë platformën DigitalProductPassport sipas udhëzuesve të versionit 1.0: pasaportat publikohen në JSON në një adresë të përhershme, ndërsa identifikuesi i verifikuar i secilës organizatë ruhet si cilësim më vete. Regjistrimin do ta testojmë në mjedisin e Komisionit kur funksionet për testim të bëhen të disponueshme. Çelësi privat për regjistrin mbetet te ju, jo te ne. Nëse doni të kuptoni çfarë do të thotë kjo për produktet tuaja, na shkruani.

DigitalProductPassport në vende të tjera: Bullgaria · Çekia · Greqia · Hungaria · Kroacia · Polonia · Rumania · Serbia · Sllovakia · Sllovenia · Bashkimi Evropian