Register digitálnych produktových pasov už má dokumentáciu pre vývojárov

Kiril ShivachevKiril Shivachev•Publikované •6 minút čítania
Optický patch panel s očíslovanými portami a žltými káblami

Stačí jeden chybný pas a z ostatných 99 v tej istej požiadavke sa nezaregistruje ani jeden. Toto pravidlo je zapísané v dokumentácii registra EÚ pre digitálne produktové pasy. Európska komisia ju zverejnila 30. októbra 2026 a Generálne riaditeľstvo pre vnútorný trh, priemysel, podnikanie a malé a stredné podniky ju oficiálne oznámilo 16. novembra. Prvýkrát je čierne na bielom opísané, ako sa pas dostane do registra. Zatiaľ však máme len opis. Funkcie na testovanie budú pribúdať postupne, skôr ako register začne naplno fungovať.

Čo Komisia zverejnila 30. októbra

Na stránke so zdrojmi k digitálnemu produktovému pasu Komisia zverejnila šesť technických dokumentov, všetky vo verzii 1.0, s dátumom 30. októbra 2026 a len v angličtine. Pre výrobcov a dovozcov sú najdôležitejšie tri z nich:

  • API Integration Guide opisuje, ako sa pasy posielajú na registráciu a ako sa sleduje výsledok;
  • Semantic Data Guide určuje, podľa akých schém a slovníkov register kontroluje údaje;
  • Self-Hosted Authentication Guide opisuje, ako musí server, na ktorom je pas uložený, odpovedať registru.

Zvyšné tri sú špecifikácie OpenAPI, súbory so sémantickými artefaktmi a príručka k servisným účtom (Service Account guide).

Register funguje od 20. júla 2026, no doteraz sa v ňom mohli registrovať len organizácie. Príručka pre hospodárske subjekty stále uvádza, že v súčasnosti nie je možné pas úspešne zaregistrovať. Nové dokumenty opisujú, ako sa to bude robiť. Ak si chcete najprv prečítať, čo je register, písali sme o jeho spustení v júli.

Päť endpointov, najviac 100 pasov v požiadavke, všetko alebo nič

Rozhranie na registráciu digitálnych produktových pasov, opísané v API Integration Guide v1.0 z 30. októbra 2026, má presne päť verejných endpointov. Prvý vracia zoznam skupín a podskupín výrobkov, ktoré register prijíma. Druhý prijíma pasy na registráciu. Zvyšné tri ukazujú, kam spracovanie pokročilo: zoznam úloh, stav konkrétnej úlohy a výsledok pre každý pas zvlášť (v JSON alebo CSV).

Registrácia neprebehne okamžite. Pošlete požiadavku a register odpovie kódom 202 a číslom úlohy. Výsledok si overíte neskôr. Každá požiadavka nesie povinný kľúč (Idempotency-Key). Vďaka nemu nevzniknú duplicity, ani keď sa spojenie preruší a rovnakú požiadavku pošlete znova.

Obmedzenia sú konkrétne:

  • od 1 do 100 pasov v jednej požiadavke, spolu najviac 10 MB;
  • jedna skupina a jedna podskupina výrobkov na požiadavku (napríklad batérie, podskupina LMT);
  • požiadavka je atomická: ak čo i len jeden pas nespĺňa podmienky, nezaregistruje sa žiadny.

Posledné pravidlo má priamy praktický dôsledok. Ak ste dovozca a pasy dostávate od viacerých dodávateľov, posielajte radšej samostatnú požiadavku pre každého z nich. Inak jedna chyba v údajoch jedného dodávateľa zastaví aj pasy ostatných. Opravený balík sa posiela ako nová požiadavka s novým kľúčom.

Jedinečný identifikátor musí byť webová adresa, ktorá otvorí pas

Podľa dokumentácie API od Komisie musí byť jedinečný identifikátor výrobku (UPI) adresa URL s HTTPS s dĺžkou od 8 do 2000 znakov. Register v požiadavke nedostáva samotný pas. Dostane adresu, v okamihu kontroly ju otvorí a obsah overí podľa vykonávacieho nariadenia (EÚ) 2026/1778. Ak sa adresa neotvorí, chyba je UPI_NOT_RESOLVABLE, a keďže je požiadavka atomická, neprejde celý balík. Prečítaný obsah si register neukladá.

Preto platí pevné poradie: najprv pas zverejníte, potom ho zaregistrujete. Dodávateľ, ktorý hovorí „nahráme ho, keď ho zaregistrujete“, obracia postup a registrácia neprejde. Holé sériové číslo z vášho systému tiež nie je UPI. Môže byť súčasťou adresy, ale register chce funkčnú adresu.

Príručka k vlastnému hostingu (Self-Hosted Authentication Guide) pridáva niekoľko ďalších pravidiel pre server, na ktorom je pas uložený. Verejná časť sa musí otvoriť bez prihlásenia a najviac cez tri presmerovania. Chránené údaje sa sprístupnia len vtedy, keď register predloží podpísaný token zo systému overovania Komisie, platný najviac 120 sekúnd. Pri neplatnom tokene musí server prístup odmietnuť, a nie potichu vrátiť verejnú verziu namiesto chránenej.

Pred prvou požiadavkou: overená organizácia a servisný účet

Register DPP prijíma požiadavky len od organizácie, ktorá prešla overením. Overuje sa kvalifikovanou elektronickou pečaťou a tu firmy často zakopnú, pretože bežný elektronický podpis nestačí. Podrobne sme to rozobrali v článku o elektronickej pečati. Overený status platí do skončenia platnosti pečate, najdlhšie však tri roky. Potom register neprijíma nové registrácie ani zmeny, kým sa overenie neobnoví.

Samotné požiadavky na API podáva servisný účet (service account). Príručka k servisným účtom, tiež z 30. októbra, stanovuje tieto hranice:

  • účet zakladá administrátor organizácie a účet dostane rolu „Register DPPs“;
  • jedna organizácia môže mať najviac 5 takýchto účtov;
  • každý účet môže mať najviac 2 aktívne kľúče s odporúčanou platnosťou jeden rok a maximálne dva roky;
  • za súkromný kľúč zodpovedá hospodársky subjekt: vytvára ho, uchováva a kontroluje.

Podľa príručky pre hospodárske subjekty sa pri registri nepočíta s predplatným. Skutočnými nákladmi sú pečať a integrácia.

JSON je jediný povinný formát a schémy zatiaľ existujú len pre batérie

Sémantická príručka Komisie (Semantic Data Guide v1.0) uvádza, že pri registrácii sa bude vyžadovať JSON, pretože je to jediný povinný formát podľa normy EN 18216:2026. JSON-LD a XML sa tiež kontrolujú, ak ich pošlete, ale povinné nie sú. Pre malé a stredné firmy je to dobrá správa: na registráciu pasu nepotrebujú prepojené údaje (linked data) ani RDF.

Konkrétne schémy a slovníky zatiaľ existujú len pre batérie, v troch podskupinách: batérie do elektrických vozidiel, priemyselné batérie a batérie do ľahkých dopravných prostriedkov (LMT). Textil, nábytok, železo a oceľ a stavebné výrobky majú spoločné jadro 12 základných pojmov (identifikátor, stav, dátum poslednej zmeny, jazyk a ďalšie), vlastné schémy však zatiaľ nemajú. Dostanú ich s delegovanými aktmi pre jednotlivé skupiny. Rozhranie na registráciu zostane rovnaké, v požiadavke sa zmení len skupina výrobkov.

Niektoré veci ešte nie sú jasné. V dokumentoch chýba úplný katalóg chybových kódov, nie sú uvedené limity počtu požiadaviek a formát identifikátora, ktorý register vracia, nie je opísaný. Nebolo ani oznámené, kedy register začne prijímať testovacie pasy batérií. Komisia organizuje 26. novembra 2026 webinár o API a sémantickom modeli. Novinky zachytíme na stránke so zmenami v predpisoch.

Čo môžete pripraviť, skôr ako budú funkcie na testovanie dostupné

S dokumentáciou registra z 30. októbra môžete s prípravou začať hneď a nemusíte čakať, kým register začne naplno fungovať:

  • overte, či má vaša organizácia kvalifikovanú elektronickú pečať a kedy jej končí platnosť;
  • rozhodnite, kto bude v registri administrátorom a kde sa budú uchovávať súkromné kľúče servisného účtu;
  • vyžiadajte si od dodávateľov potvrdenie, že ich pasy budú zverejnené na funkčnej adrese HTTPS skôr, než ich zaregistrujete;
  • plánujte požiadavky podľa podskupiny výrobkov a podľa dodávateľa, aby jedna chyba nezastavila všetko.

My vo WIARA staviame platformu DigitalProductPassport podľa príručiek vo verzii 1.0: pasy sa zverejňujú v JSON na trvalej adrese a overený identifikátor každej organizácie sa ukladá ako samostatné nastavenie. Registráciu vyskúšame v prostredí Komisie, keď budú funkcie na testovanie dostupné. Súkromný kľúč pre register zostáva u vás, nie u nás. Ak chcete vedieť, čo to znamená pre vaše výrobky, napíšte nám.

DigitalProductPassport v ďalších krajinách: Albánsko · Bulharsko · Česko · Grécko · Chorvátsko · Maďarsko · Poľsko · Rumunsko · Slovinsko · Srbsko · Európska únia