Register DPP ima zdaj dokumentacijo za razvijalce

Dovolj je en napačen potni list, pa ne bo registriran noben od preostalih 99 v isti zahtevi. To pravilo je zapisano v dokumentaciji registra digitalnih potnih listov izdelkov EU. Evropska komisija jo je objavila 30. oktobra 2026, Generalni direktorat za notranji trg, industrijo, podjetništvo ter mala in srednja podjetja pa jo je uradno predstavil 16. novembra. Prvič je črno na belem opisano, kako potni list pride v register. Zaenkrat pa imamo le opis. Funkcije za testiranje se bodo pojavljale postopoma, preden bo register v celoti zaživel.
Kaj je Komisija objavila 30. oktobra
Na strani z viri za digitalni potni list izdelka je Komisija objavila šest tehničnih dokumentov. Vsi so v različici 1.0, z dne 30. oktobra 2026, in samo v angleščini. Za proizvajalce in uvoznike so najpomembnejši trije:
- API Integration Guide opisuje, kako se potni listi pošiljajo v registracijo in kako se spremlja rezultat;
- Semantic Data Guide določa, po katerih shemah in slovarjih register preverja podatke;
- Self-Hosted Authentication Guide opisuje, kako mora strežnik, na katerem je potni list, odgovarjati registru.
Preostali trije so specifikacije OpenAPI, datoteke s semantičnimi artefakti in vodnik za storitvene račune (Service Account guide).
Register deluje od 20. julija 2026, vendar so se vanj doslej lahko registrirale samo organizacije. Vodnik za gospodarske subjekte še vedno navaja, da potnega lista trenutno ni mogoče uspešno registrirati. Novi dokumenti opisujejo, kako bo to potekalo. Če želite najprej prebrati, kaj register sploh je, smo pisali o njegovem zagonu julija.
Pet končnih točk, do 100 potnih listov na zahtevo, vse ali nič
Vmesnik za registracijo digitalnih potnih listov izdelkov, opisan v vodniku API Integration Guide v1.0 z dne 30. oktobra 2026, ima natanko pet javnih končnih točk (endpoints). Prva vrne seznam skupin in podskupin izdelkov, ki jih register sprejema. Druga sprejema potne liste v registracijo. Preostale tri kažejo, kako daleč je obdelava: seznam opravil, stanje posameznega opravila in rezultat za vsak potni list posebej (v obliki JSON ali CSV).
Registracija ne poteka takoj. Pošljete zahtevo, register pa odgovori s kodo 202 in številko opravila. Rezultat preverite pozneje. Vsaka zahteva nosi obvezen ključ (Idempotency-Key). Zaradi njega podvojenih vnosov ne bo, če se povezava prekine in isto zahtevo pošljete znova.
Omejitve so konkretne:
- od 1 do 100 potnih listov v eni zahtevi, skupaj do 10 MB;
- ena skupina izdelkov in ena podskupina na zahtevo (na primer baterije, podskupina LMT);
- zahteva je atomarna: če le en potni list ne izpolnjuje pogojev, se ne registrira noben.
Zadnje pravilo ima neposredno praktično posledico. Če ste uvoznik in dobivate potne liste od več dobaviteljev, je bolje, da za vsakega pošljete ločeno zahtevo. Sicer bo ena napaka v podatkih enega dobavitelja ustavila tudi potne liste ostalih. Popravljeni paket se pošlje kot nova zahteva z novim ključem.
Edinstvena oznaka mora biti spletni naslov, ki odpre potni list
Po dokumentaciji API Komisije mora biti edinstvena identifikacijska oznaka izdelka (UPI) naslov URL s protokolom HTTPS, dolg od 8 do 2.000 znakov. Register v zahtevi ne prejme samega potnega lista. Prejme naslov, ga odpre v trenutku preverjanja in vsebino preveri v skladu z Izvedbeno uredbo (EU) 2026/1778. Če se naslov ne odpre, register vrne napako UPI_NOT_RESOLVABLE. Ker je zahteva atomarna, pri tem odpade celoten paket. Register prebrane vsebine ne shrani.
Zato je vrstni red strog: najprej objavite potni list, nato ga registrirate. Dobavitelj, ki pravi „naložili ga bomo, ko ga boste registrirali“, obrne zaporedje in registracija ne bo uspela. Tudi gola serijska številka iz vašega sistema ni UPI. Lahko je del naslova, vendar register zahteva delujoč naslov.
Vodnik za lastno gostovanje (Self-Hosted Authentication Guide) dodaja še nekaj pravil za strežnik, na katerem je potni list. Javni del se mora odpreti brez prijave, z največ tremi preusmeritvami na poti. Zaščiteni podatki se posredujejo samo, ko register predloži podpisan žeton iz Komisijinega sistema za preverjanje pristnosti, veljaven največ 120 sekund. Pri neveljavnem žetonu mora strežnik zavrniti dostop in ne sme tiho vrniti javne različice namesto zaščitene.
Pred prvo zahtevo: potrjena organizacija in storitveni račun
Register DPP sprejema zahteve samo od organizacije, ki je bila preverjena. Preverjanje poteka s kvalificiranim elektronskim žigom in tu se podjetja pogosto zataknejo, ker navaden elektronski podpis ne zadošča. Podrobno smo to obravnavali v članku o elektronskem žigu. Potrjeni status velja do izteka žiga, vendar največ tri leta. Potem register ne sprejema novih registracij ali sprememb, dokler preverjanje ni obnovljeno.
Same zahteve prek API-ja pošilja storitveni račun (service account). Vodnik za storitvene račune, prav tako z dne 30. oktobra, postavlja te meje:
- račun ustvari skrbnik organizacije, račun pa dobi vlogo „Register DPPs“;
- organizacija ima lahko največ 5 takih računov;
- vsak račun ima lahko do 2 aktivna ključa, s priporočeno veljavnostjo enega leta in največ dveh let;
- za zasebni ključ je odgovoren gospodarski subjekt: ustvari ga, hrani in nadzoruje.
Po vodniku za gospodarske subjekte naročnine za register ni pričakovati. Dejanska stroška sta žig in integracija.
JSON je edini obvezni format, sheme pa so zaenkrat samo za baterije
Komisijin semantični vodnik (Semantic Data Guide v1.0) navaja, da se bo pri registraciji zahteval JSON, ker je to edini obvezni format po standardu EN 18216:2026. Tudi JSON-LD in XML se preverita, če ju pošljete, vendar nista obvezna. Za mala in srednja podjetja je to dobra novica: za registracijo potnega lista ne potrebujejo povezanih podatkov (linked data) niti RDF.
Konkretne sheme in slovarji so zaenkrat na voljo samo za baterije, v treh podskupinah: baterije za električna vozila, industrijske baterije in baterije za lahka prevozna sredstva (LMT). Tekstil, pohištvo, železo in jeklo ter gradbeni proizvodi imajo skupno jedro 12 osnovnih pojmov (identifikator, status, datum zadnje spremembe, jezik in drugi), nimajo pa še lastnih shem. Dobili jih bodo z delegiranimi akti za posamezno skupino. Vmesnik za registracijo bo ostal enak, spremenila se bo le skupina izdelkov v zahtevi.
Nekatere stvari še niso jasne. V dokumentih ni celotnega kataloga kod napak, omejitve števila zahtev niso navedene, oblika identifikatorja, ki ga vrne register, pa ni opisana. Prav tako še ni objavljeno, kdaj bo register začel sprejemati testne potne liste za baterije. Komisija 26. novembra 2026 organizira spletni seminar o API-ju in semantičnem modelu. Novosti bomo zabeležili na strani s spremembami.
Kaj lahko pripravite, preden bodo funkcije za testiranje na voljo
Z dokumentacijo registra z dne 30. oktobra lahko s pripravami začnete že zdaj, ne da bi čakali, da register v celoti zaživi:
- preverite, ali ima vaša organizacija kvalificirani elektronski žig in kdaj poteče;
- odločite, kdo bo skrbnik v registru in kje se bodo hranili zasebni ključi storitvenega računa;
- od dobaviteljev zahtevajte potrditev, da bodo njihovi potni listi objavljeni na delujočem naslovu HTTPS, preden jih registrirate;
- zahteve načrtujte po podskupini izdelkov in po dobavitelju, da ena napaka ne ustavi vsega.
V podjetju WIARA gradimo platformo DigitalProductPassport po vodnikih različice 1.0: potni listi so objavljeni v obliki JSON na stalnem naslovu, potrjeni identifikator vsake organizacije pa hranimo kot ločeno nastavitev. Registracijo bomo preizkusili v Komisijinem okolju, ko bodo funkcije za testiranje na voljo. Zasebni ključ za register ostane pri vas, ne pri nas. Če želite izvedeti, kaj to pomeni za vaše izdelke, nam pišite.
