Fejlesztői dokumentációt kapott a digitális termékútlevél-nyilvántartás

Egyetlen hibás útlevél elég ahhoz, hogy ugyanabban a kérésben a többi 99 közül egyiket se regisztrálja a nyilvántartás. Ez a szabály a digitális termékútlevelek uniós nyilvántartásának dokumentációjában áll. Az Európai Bizottság 2026. október 30-án tette közzé, a Belső Piaci, Ipar-, Vállalkozás- és KKV-politikai Főigazgatóság pedig november 16-án jelentette be hivatalosan. Most először olvasható feketén-fehéren, hogyan kerül be egy útlevél a nyilvántartásba. Egyelőre azonban csak a leírás van meg. A tesztelési funkciók fokozatosan jelennek majd meg, mielőtt a nyilvántartás teljes körűen működni kezdene.
Mit tett közzé a Bizottság október 30-án
A digitális termékútlevél forrásoldalán a Bizottság hat műszaki dokumentumot tett közzé, mindegyik 1.0-s verziójú, 2026. október 30-i keltezésű és csak angolul érhető el. A gyártóknak és az importőröknek ezek közül három a legfontosabb:
- az API Integration Guide leírja, hogyan kell regisztrációra beküldeni az útleveleket, és hogyan követhető az eredmény;
- a Semantic Data Guide meghatározza, milyen sémák és szótárak alapján ellenőrzi a nyilvántartás az adatokat;
- a Self-Hosted Authentication Guide leírja, hogyan kell annak a szervernek, amelyen az útlevél található, válaszolnia a nyilvántartásnak.
A másik három az OpenAPI-specifikációk, a szemantikai artefaktumokat tartalmazó fájlok és a szolgáltatásfiókokról szóló útmutató (Service Account guide).
A nyilvántartás 2026. július 20. óta működik, de eddig csak szervezetek regisztrálhattak benne. A gazdasági szereplőknek szóló útmutató még mindig azt írja, hogy útlevelet jelenleg nem lehet sikeresen regisztrálni. Az új dokumentumok azt írják le, hogyan fog ez történni. Ha előbb arról olvasna, mi is ez a nyilvántartás, a júliusi indulásáról is írtunk.
Öt végpont, kérésenként legfeljebb 100 útlevél, mindent vagy semmit
A digitális termékútlevelek regisztrációs felülete, ahogy a 2026. október 30-i API Integration Guide v1.0 leírja, pontosan öt nyilvános végpontot (endpoint) kínál. Az első visszaadja azoknak a termékcsoportoknak és alcsoportoknak a listáját, amelyeket a nyilvántartás fogad. A második fogadja a regisztrálandó útleveleket. A maradék három azt mutatja, hol tart a feldolgozás: a feladatok listáját, egy adott feladat állapotát és az egyes útlevelek eredményét külön-külön (JSON vagy CSV formátumban).
A regisztráció nem azonnali. Ön elküldi a kérést, a nyilvántartás 202-es kóddal és egy feladatszámmal válaszol, az eredményt pedig később ellenőrzi. Minden kéréshez kötelező kulcs (Idempotency-Key) tartozik. Ennek köszönhetően, ha megszakad a kapcsolat, és ugyanazt a kérést újra elküldi, nem keletkeznek duplikátumok.
A korlátok konkrétak:
- egy kérésben 1–100 útlevél, összesen legfeljebb 10 MB;
- kérésenként egy termékcsoport és egy alcsoport (például akkumulátorok, LMT-alcsoport);
- a kérés atomi: ha akár csak egy útlevél nem felel meg a követelményeknek, egyiket sem regisztrálják.
Az utolsó szabálynak közvetlen gyakorlati következménye van. Ha Ön importőr, és több beszállítótól kap útleveleket, érdemes mindegyikükhöz külön kérést küldenie. Különben egyetlen beszállító adataiban lévő hiba a többiek útleveleit is megállítja. A javított csomagot új kérésként, új kulccsal kell elküldeni.
Az egyedi azonosítónak az útlevelet megnyitó webcímnek kell lennie
A Bizottság API-dokumentációja szerint az egyedi termékazonosítónak (UPI) 8–2000 karakter hosszú HTTPS URL-nek kell lennie. A nyilvántartás a kérésben nem magát az útlevelet kapja meg. A címet kapja meg, az ellenőrzés pillanatában megnyitja, és a tartalmat az (EU) 2026/1778 végrehajtási rendelet szerint ellenőrzi. Ha a cím nem nyílik meg, UPI_NOT_RESOLVABLE hiba keletkezik, és mivel a kérés atomi, az egész csomag elbukik. A beolvasott tartalmat a nyilvántartás nem tárolja.
Ezért a sorrend kötött: először közzéteszi az útlevelet, aztán regisztrálja. Az a beszállító, aki azt mondja, „feltöltjük, miután regisztrálta”, megfordítja a sorrendet, és a regisztráció nem megy át. A saját rendszeréből származó puszta sorozatszám sem UPI. Lehet a cím része, de a nyilvántartás működő címet vár.
A saját tárhelyre vonatkozó útmutató (Self-Hosted Authentication Guide) további szabályokat ír elő arra a szerverre, amelyen az útlevél található. A nyilvános résznek bejelentkezés nélkül kell megnyílnia, legfeljebb három átirányítással. A védett adatokat csak akkor szabad kiadni, ha a nyilvántartás a Bizottság hitelesítési rendszeréből származó, aláírt tokent mutat fel, amely legfeljebb 120 másodpercig érvényes. Érvénytelen token esetén a szervernek meg kell tagadnia a hozzáférést, és nem adhatja vissza csendben a nyilvános változatot a védett helyett.
Az első kérés előtt: ellenőrzött szervezet és szolgáltatásfiók
A DPP-nyilvántartás csak ellenőrzésen átesett szervezettől fogad kéréseket. Az ellenőrzés minősített elektronikus bélyegzővel történik, és a cégek itt gyakran elakadnak, mert a hagyományos elektronikus aláírás nem elég. Részletesen írtunk erről az elektronikus bélyegzőről szóló cikkünkben. Az ellenőrzött státusz a bélyegző lejártáig érvényes, de legfeljebb három évig. Ezután a nyilvántartás nem fogad új regisztrációt és módosítást, amíg az ellenőrzést meg nem újítják.
Magukat az API-kéréseket egy szolgáltatásfiók (service account) küldi. A szolgáltatásfiókokról szóló, szintén október 30-i útmutató a következő korlátokat szabja:
- a fiókot a szervezet adminisztrátora hozza létre, és a fiók „Register DPPs” szerepkört kap;
- egy szervezetnek legfeljebb 5 ilyen fiókja lehet;
- minden fióknak legfeljebb 2 aktív kulcsa lehet, ajánlott érvényességük egy év, legfeljebb két év;
- a privát kulcsért a gazdasági szereplő felel: ő hozza létre, őrzi és ellenőrzi.
A gazdasági szereplőknek szóló útmutató szerint a nyilvántartásért várhatóan nem kell előfizetési díjat fizetni. A valódi költség a bélyegző és az integráció.
A JSON az egyetlen kötelező formátum, sémák egyelőre csak az akkumulátorokra vannak
A Bizottság szemantikai útmutatója (Semantic Data Guide v1.0) szerint a regisztrációhoz JSON kell majd, mert az EN 18216:2026 szabvány szerint ez az egyetlen kötelező formátum. A JSON-LD-t és az XML-t is ellenőrzik, ha elküldi őket, de nem kötelezők. A kis- és középvállalkozásoknak ez jó hír: egy útlevél regisztrálásához nincs szükségük kapcsolt adatokra (linked data) és RDF-re.
Konkrét sémák és szótárak egyelőre csak az akkumulátorokra léteznek, három alcsoportban: elektromos járművek akkumulátorai, ipari akkumulátorok és könnyű szállítóeszközök akkumulátorai (LMT). A textíliákra, a bútorokra, a vasra és acélra, valamint az építési termékekre már vonatkozik a 12 alapfogalomból álló közös mag (azonosító, állapot, utolsó módosítás dátuma, nyelv és mások), saját sémájuk azonban még nincs. Ezeket az egyes csoportokra vonatkozó, felhatalmazáson alapuló jogi aktusokkal kapják meg. A regisztrációs felület ugyanaz marad, a kérésben csak a termékcsoport változik.
Néhány dolog még nem világos. A dokumentumokból hiányzik a hibakódok teljes katalógusa, nincsenek megadva a kérések számára vonatkozó korlátok, és az sincs leírva, milyen formátumú azonosítót ad vissza a nyilvántartás. Azt sem jelentették be, mikor kezdi fogadni a nyilvántartás az akkumulátorok tesztútleveleit. A Bizottság 2026. november 26-án webináriumot tart az API-ról és a szemantikai modellről. Az újdonságokat a jogszabályi változások oldalán követjük.
Mit készíthet elő, mielőtt elérhetővé válnak a tesztelési funkciók
A nyilvántartás október 30-i dokumentációja alapján már most elkezdheti a felkészülést, nem kell megvárnia, hogy a nyilvántartás teljesen működni kezdjen:
- ellenőrizze, van-e a szervezetének minősített elektronikus bélyegzője, és mikor jár le;
- döntse el, ki lesz az adminisztrátor a nyilvántartásban, és hol tárolják a szolgáltatásfiók privát kulcsait;
- kérjen megerősítést a beszállítóktól, hogy az útleveleik működő HTTPS-címen elérhetők lesznek, mielőtt regisztrálja őket;
- a kéréseket termékalcsoport és beszállító szerint tervezze meg, hogy egyetlen hiba ne állítson le mindent.
Mi a WIARA-nál az 1.0-s útmutatók szerint építjük a DigitalProductPassport platformot: az útlevelek JSON formátumban, állandó címen jelennek meg, az egyes szervezetek ellenőrzött azonosítója pedig külön beállításként tárolódik. A regisztrációt a Bizottság környezetében teszteljük majd, amikor a tesztelési funkciók elérhetővé válnak. A nyilvántartáshoz tartozó privát kulcs Önnél marad, nem nálunk. Ha szeretné megtudni, mit jelent ez az Ön termékeire nézve, írjon nekünk.
DigitalProductPassport más országokban: Albánia · Bulgária · Csehország · Görögország · Horvátország · Lengyelország · Románia · Szerbia · Szlovákia · Szlovénia · Európai Unió
