Registr digitálních pasů výrobků už má dokumentaci pro vývojáře

Stačí jeden chybný pas a z ostatních 99 ve stejném požadavku se nezaregistruje ani jeden. Toto pravidlo je zapsáno v dokumentaci registru EU pro digitální pasy výrobků. Evropská komise ji zveřejnila 30. října 2026 a Generální ředitelství pro vnitřní trh, průmysl, podnikání a malé a střední podniky ji oficiálně oznámilo 16. listopadu. Poprvé je černé na bílém popsáno, jak se pas do registru dostane. Zatím ale máme jen popis. Funkce pro testování budou přibývat postupně, než registr začne plně fungovat.
Co Komise zveřejnila 30. října
Na stránce se zdroji k digitálnímu pasu výrobku Komise zveřejnila šest technických dokumentů, všechny ve verzi 1.0, s datem 30. října 2026 a pouze v angličtině. Pro výrobce a dovozce jsou nejdůležitější tři z nich:
- API Integration Guide popisuje, jak se pasy odesílají k registraci a jak se sleduje výsledek;
- Semantic Data Guide určuje, podle jakých schémat a slovníků registr kontroluje data;
- Self-Hosted Authentication Guide popisuje, jak musí server, na kterém je pas uložen, odpovídat registru.
Zbylé tři jsou specifikace OpenAPI, soubory se sémantickými artefakty a příručka k servisním účtům (Service Account guide).
Registr funguje od 20. července 2026, ale dosud se v něm mohly registrovat jen organizace. Příručka pro hospodářské subjekty stále uvádí, že v tuto chvíli pas úspěšně zaregistrovat nelze. Nové dokumenty popisují, jak se to bude dělat. Pokud si chcete nejdřív přečíst, co registr je, psali jsme o jeho spuštění v červenci.
Pět endpointů, až 100 pasů v požadavku, všechno, nebo nic
Rozhraní pro registraci digitálních pasů výrobků, popsané v API Integration Guide v1.0 z 30. října 2026, má přesně pět veřejných endpointů. První vrací seznam skupin a podskupin výrobků, které registr přijímá. Druhý přijímá pasy k registraci. Zbylé tři ukazují, kam zpracování došlo: seznam úloh, stav konkrétní úlohy a výsledek pro každý pas zvlášť (v JSON nebo CSV).
Registrace neproběhne okamžitě. Odešlete požadavek a registr odpoví kódem 202 a číslem úlohy. Výsledek si ověříte později. Každý požadavek nese povinný klíč (Idempotency-Key). Díky němu nevzniknou duplicity, ani když se spojení přeruší a stejný požadavek odešlete znovu.
Omezení jsou konkrétní:
- 1 až 100 pasů v jednom požadavku, celkem nejvýše 10 MB;
- jedna skupina a jedna podskupina výrobků na požadavek (například baterie, podskupina LMT);
- požadavek je atomický: pokud byť jediný pas nesplňuje podmínky, nezaregistruje se žádný.
Poslední pravidlo má přímý praktický dopad. Pokud jste dovozce a pasy dostáváte od více dodavatelů, posílejte raději pro každého z nich samostatný požadavek. Jinak jedna chyba v datech jednoho dodavatele zastaví i pasy ostatních. Opravená dávka se odesílá jako nový požadavek s novým klíčem.
Jedinečný identifikátor musí být webová adresa, která otevře pas
Podle dokumentace API Komise musí být jedinečný identifikátor výrobku (UPI) adresa URL s HTTPS o délce 8 až 2000 znaků. Registr v požadavku nedostává samotný pas. Dostane adresu, v okamžiku kontroly ji otevře a obsah ověří podle prováděcího nařízení (EU) 2026/1778. Pokud se adresa neotevře, chyba zní UPI_NOT_RESOLVABLE, a protože je požadavek atomický, neprojde celá dávka. Přečtený obsah si registr neukládá.
Proto platí pevné pořadí: nejdřív pas zveřejníte, pak ho zaregistrujete. Dodavatel, který říká „nahrajeme ho, až ho zaregistrujete“, obrací pořadí a registrace neprojde. Holé sériové číslo z vašeho systému také není UPI. Může být součástí adresy, ale registr chce funkční adresu.
Příručka k vlastnímu hostování (Self-Hosted Authentication Guide) přidává několik dalších pravidel pro server, na kterém pas leží. Veřejná část se musí otevřít bez přihlášení a nejvýše přes tři přesměrování. Chráněná data se zpřístupní jen tehdy, když registr předloží podepsaný token ze systému ověřování Komise, platný nejvýše 120 sekund. Při neplatném tokenu musí server přístup odmítnout, a ne místo chráněné verze potichu vrátit veřejnou.
Před prvním požadavkem: ověřená organizace a servisní účet
Registr DPP přijímá požadavky jen od organizace, která prošla ověřením. Ověřuje se kvalifikovanou elektronickou pečetí a tady firmy často klopýtnou, protože běžný elektronický podpis nestačí. Podrobně jsme to rozebrali v článku o elektronické pečeti. Ověřený status platí do konce platnosti pečeti, nejdéle však tři roky. Potom registr nepřijímá nové registrace ani změny, dokud se ověření neobnoví.
Samotné požadavky na API podává servisní účet (service account). Příručka k servisním účtům, rovněž z 30. října, stanoví tato omezení:
- účet zakládá administrátor organizace a účet dostává roli „Register DPPs“;
- jedna organizace může mít nejvýše 5 takových účtů;
- každý účet může mít až 2 aktivní klíče s doporučenou platností jeden rok a maximální dva roky;
- za soukromý klíč odpovídá hospodářský subjekt: vytváří ho, uchovává a kontroluje.
Podle příručky pro hospodářské subjekty se u registru nepočítá s předplatným. Skutečnými náklady jsou pečeť a integrace.
JSON je jediný povinný formát a schémata zatím existují jen pro baterie
Sémantická příručka Komise (Semantic Data Guide v1.0) uvádí, že při registraci se bude vyžadovat JSON, protože je to jediný povinný formát podle normy EN 18216:2026. JSON-LD a XML se také kontrolují, pokud je pošlete, ale povinné nejsou. Pro malé a střední firmy je to dobrá zpráva: k registraci pasu nepotřebují propojená data (linked data) ani RDF.
Konkrétní schémata a slovníky zatím existují jen pro baterie, ve třech podskupinách: baterie do elektrických vozidel, průmyslové baterie a baterie do lehkých dopravních prostředků (LMT). Textil, nábytek, železo a ocel a stavební výrobky mají společné jádro 12 základních pojmů (identifikátor, stav, datum poslední změny, jazyk a další), vlastní schémata ale zatím nemají. Dostanou je s akty v přenesené pravomoci pro jednotlivé skupiny. Rozhraní pro registraci zůstane stejné, v požadavku se změní jen skupina výrobků.
Některé věci zatím jasné nejsou. V dokumentech chybí úplný katalog chybových kódů, nejsou uvedeny limity počtu požadavků a formát identifikátoru, který registr vrací, popsán není. Nebylo ani oznámeno, kdy registr začne přijímat testovací pasy baterií. Komise pořádá 26. listopadu 2026 webinář k API a sémantickému modelu. Novinky zachytíme na stránce se změnami v předpisech.
Co můžete připravit, než budou funkce pro testování k dispozici
S dokumentací registru z 30. října můžete s přípravou začít hned, aniž byste čekali, až registr začne plně fungovat:
- ověřte, zda má vaše organizace kvalifikovanou elektronickou pečeť a kdy jí končí platnost;
- rozhodněte, kdo bude v registru administrátorem a kde budou uloženy soukromé klíče servisního účtu;
- vyžádejte si od dodavatelů potvrzení, že jejich pasy budou zveřejněny na funkční adrese HTTPS dřív, než je zaregistrujete;
- plánujte požadavky podle podskupiny výrobků a podle dodavatele, aby jedna chyba nezastavila všechno.
My ve WIARA stavíme platformu DigitalProductPassport podle příruček ve verzi 1.0: pasy se zveřejňují v JSON na trvalé adrese a ověřený identifikátor každé organizace se ukládá jako samostatné nastavení. Registraci vyzkoušíme v prostředí Komise, až budou funkce pro testování k dispozici. Soukromý klíč pro registr zůstává u vás, ne u nás. Pokud chcete vědět, co to znamená pro vaše výrobky, napište nám.
