[{"data":1,"prerenderedAt":333},["ShallowReactive",2],{"page-\u002Fdpp-registry\u002Fapi":3,"sources":217},{"id":4,"title":5,"answer":6,"body":7,"cta":181,"description":182,"extension":183,"eyebrow":184,"legal":181,"meta":185,"metaTitle":186,"navigation":187,"path":188,"planFree":189,"relatedPages":190,"seo":207,"sources":208,"stem":214,"updatedAt":215,"__hash__":216},"pages\u002Fdpp-registry\u002Fapi.md","DPP Registry API – jak przygotować integrację?","DPP Registry udostępnia API do rejestracji paszportów i odbierania informacji z rejestru. Integracja powinna przesyłać dane z kanonicznego modelu produktu, obsługiwać automatyczną walidację, statusy i błędy oraz zapisywać zwrócony identyfikator rejestracyjny. Szczegóły endpointów i uwierzytelnienia należy implementować wyłącznie według aktualnej dokumentacji technicznej Komisji.",{"type":8,"value":9,"toc":170},"minimark",[10,15,19,22,25,29,34,37,41,44,69,72,76,79,96,100,103,106,124,127,131,134,137,160,164,167],[11,12,14],"h2",{"id":13},"co-oficjalnie-obsługuje-api","Co oficjalnie obsługuje API?",[16,17,18],"p",{},"Rozporządzenie wykonawcze (UE) 2026\u002F1778 wymienia API jako jeden z elementów architektury Registry. Kanał ten ma umożliwiać rejestrację DPP i odbieranie informacji z rejestru. Po pomyślnej walidacji unikalny identyfikator rejestracyjny jest zwracany w odpowiedzi API.",[16,20,21],{},"Komisja zapowiada również dokumentowane API do repozytorium semantycznego zawierającego maszynowo czytelne modele danych, definicje i słownictwo dla grup produktowych.",[16,23,24],{},"Aktualny publiczny User Guide dla operatorów koncentruje się na formularzu online i przesyłaniu plików JSON\u002FXML. Nie publikuje pełnego kontraktu endpointów ani kompletnej procedury uwierzytelnienia integracji. Tych elementów nie należy zgadywać — źródłem prawdy musi być bieżąca dokumentacja techniczna dostępna w Registry.",[11,26,28],{"id":27},"gdzie-umieścić-adapter-registry","Gdzie umieścić adapter Registry?",[30,31],"dpp-flow",{":steps":32,"label":33},"[\"ERP \u002F PIM\",\"Mapowanie\",\"Model kanoniczny\",\"Wersja DPP\",\"Adapter Registry\",\"Wynik + audit log\"]","Dane z ERP i PIM trafiają przez mapowanie do kanonicznego modelu produktu, następnie do wersji DPP, adaptera Registry i obsługi wyniku walidacji",[16,35,36],{},"Registry powinno pozostać adapterem integracyjnym. Schemat Komisji ani format konkretnego ERP nie powinny stać się rdzeniem modelu produktu. Dzięki temu zmiana API, schematu produktowego albo systemu źródłowego nie wymusza przebudowy całej aplikacji.",[11,38,40],{"id":39},"dane-potrzebne-przed-wywołaniem","Dane potrzebne przed wywołaniem",[16,42,43],{},"Zakres zależy od aktu dla grupy produktu, ale proces powinien umieć przygotować co najmniej:",[45,46,47,51,54,57,60,63,66],"ul",{},[48,49,50],"li",{},"unikalny identyfikator produktu prowadzący do DPP",[48,52,53],{},"identyfikatory modelu i partii, gdy dotyczą wybranej granularności",[48,55,56],{},"właściwą grupę produktu i poziom model–partia–sztuka",[48,58,59],{},"wymagane dane rejestracyjne i metadane wysokiego poziomu",[48,61,62],{},"kod towarowy, gdy jest wymagany",[48,64,65],{},"odniesienie do dostawcy usług DPP i backupu, gdy jest wymagane",[48,67,68],{},"identyfikator zweryfikowanego operatora i kontekst uprawnień",[16,70,71],{},"Pełna treść produktu pozostaje w DPP utrzymywanym poza Registry. Integracja nie powinna wysyłać dodatkowych danych prywatnych tylko dlatego, że są dostępne w ERP.",[11,73,75],{"id":74},"jak-obsłużyć-automatyczną-walidację","Jak obsłużyć automatyczną walidację?",[16,77,78],{},"Adapter powinien rozróżniać błędy danych od awarii technicznych. Rozporządzenie przewiduje kontrole semantyki, spójności danych, granularności, kodu towarowego i linku backupu. Przewodnik pokazuje też błędy niezgodnego schematu, zduplikowanego UPI, niepoprawnego URL i chwilowej niedostępności walidacji semantycznej.",[45,80,81,84,87,90,93],{},[48,82,83],{},"błąd deterministyczny danych: oznacz wpis jako wymagający korekty i nie ponawiaj bez zmiany danych",[48,85,86],{},"błąd przejściowy usługi: zastosuj kontrolowane ponowienie zgodnie z dokumentacją API",[48,88,89],{},"wynik w toku: zachowaj correlation ID i odczytuj status w obsługiwany sposób",[48,91,92],{},"sukces: zapisz identyfikator rejestracyjny przy konkretnej wersji DPP",[48,94,95],{},"częściowa porażka: nie zakładaj częściowego sukcesu bez potwierdzenia kontraktu; w przepływie plikowym jeden błędny DPP odrzuca całe zgłoszenie",[11,97,99],{"id":98},"idempotencja-i-duplikaty","Idempotencja i duplikaty",[16,101,102],{},"Każdy DPP musi mieć jednoznaczny identyfikator. Ponowienie po timeoutcie nie może bez kontroli tworzyć kolejnego logicznego wpisu lub maskować wcześniejszego sukcesu.",[16,104,105],{},"Przed wdrożeniem ustal:",[107,108,109,112,115,118,121],"ol",{},[48,110,111],{},"klucz idempotencji lub mechanizm równoważny opisany w dokumentacji API,",[48,113,114],{},"sposób sprawdzenia wcześniejszego wyniku po correlation ID,",[48,116,117],{},"regułę ponawiania tylko błędów przejściowych,",[48,119,120],{},"unikalność UPI w zakresie organizacji i katalogu,",[48,122,123],{},"powiązanie odpowiedzi Registry z niezmienną wersją opublikowanego DPP.",[16,125,126],{},"Jeżeli dokumentacja API nie definiuje danego mechanizmu, nie należy zakładać jego istnienia. Wtedy bezpiecznym minimum jest zatrzymanie automatycznego ponowienia do czasu ustalenia statusu wcześniejszego żądania.",[11,128,130],{"id":129},"środowisko-testowe","Środowisko testowe",[16,132,133],{},"Komisja udostępnia odrębne środowisko do testowania enrolmentu i rejestracji. Operacje testowe nie wpływają na produkcję, nie są do niej migrowane i mogą zostać usunięte. Przewodnik wskazuje także konieczność użycia innego EU Login niż w środowisku produkcyjnym.",[16,135,136],{},"Testy integracji powinny objąć:",[45,138,139,142,145,148,151,154,157],{},[48,140,141],{},"prawidłowy i nieprawidłowy UPI HTTPS",[48,143,144],{},"niezgodny schemat i brak wymaganych pól",[48,146,147],{},"nieprawidłową granularność",[48,149,150],{},"zduplikowany identyfikator",[48,152,153],{},"brak dostępności semantycznej walidacji",[48,155,156],{},"timeout po wysłaniu i bezpieczne ustalenie statusu",[48,158,159],{},"zapis identyfikatora rejestracyjnego i pełnego śladu audytowego",[11,161,163],{"id":162},"czego-nie-deklarować-przed-integracją","Czego nie deklarować przed integracją?",[16,165,166],{},"DPP Compliance nie powinno komunikować „integracji z EU Registry” na podstawie samego eksportu JSON lub znajomości rozporządzenia. Funkcja jest wdrożona dopiero wtedy, gdy adapter działa na aktualnym kontrakcie Komisji, obsługuje uwierzytelnienie, walidację, statusy i błędy oraz przeszedł testy w udostępnionym środowisku.",[16,168,169],{},"Na obecnym etapie ta strona opisuje wymagania i architekturę przygotowania integracji, a nie potwierdza dostępności automatycznej rejestracji w produkcie DPP Compliance.",{"title":171,"searchDepth":172,"depth":172,"links":173},"",2,[174,175,176,177,178,179,180],{"id":13,"depth":172,"text":14},{"id":27,"depth":172,"text":28},{"id":39,"depth":172,"text":40},{"id":74,"depth":172,"text":75},{"id":98,"depth":172,"text":99},{"id":129,"depth":172,"text":130},{"id":162,"depth":172,"text":163},true,"DPP Registry API w praktyce: architektura integracji, UPI, walidacja semantyczna, statusy, błędy i przygotowanie ERP lub PIM.","md","DPP Registry • integracja API",{},"DPP Registry API – integracja i rejestracja DPP",false,"\u002Fdpp-registry\u002Fapi",null,[191,195,199,203],{"title":192,"href":193,"description":194},"Jak zarejestrować DPP","\u002Fdpp-registry\u002Frejestracja","Pełny proces od EU Login do identyfikatora rejestracyjnego.",{"title":196,"href":197,"description":198},"Błędy DPP Registry","\u002Fdpp-registry\u002Fbledy","Walidacja schematu, UPI, semantyki i zgłoszeń zbiorczych.",{"title":200,"href":201,"description":202},"Integracja DPP z ERP","\u002Fbaza-wiedzy\u002Fdpp-api-i-wymiana-danych","Kanoniczny model danych i mapowanie niezależne od dostawcy ERP.",{"title":204,"href":205,"description":206},"Standardy DPP","\u002Fstandardy-dpp","Normy dotyczące API, wymiany danych i interoperacyjności.",{"title":5,"description":182},[209,210,211,212,213],"registry","registryLaunch","registryImplementingRegulation","registryUserGuide","dppStandardsDecision","dpp-registry\u002Fapi","2026-08-25","8FfwXYFf-teaUwuN8Cy2cJupOPtEUo2ELjK3R3Yqutk",{"id":218,"extension":219,"items":220,"meta":330,"stem":331,"__hash__":332},"sources\u002Fdata\u002Fsources.yml","yml",[221,226,230,235,239,243,247,251,255,259,263,267,271,275,279,283,286,290,294,298,302,306,310,314,317,320,323,326],{"key":222,"name":223,"url":224,"type":225},"espr","Rozporządzenie (UE) 2024\u002F1781 (ESPR)","https:\u002F\u002Feur-lex.europa.eu\u002Feli\u002Freg\u002F2024\u002F1781\u002Foj","prawo-ue",{"key":227,"name":228,"url":229,"type":225},"batteries","Rozporządzenie (UE) 2023\u002F1542 w sprawie baterii i zużytych baterii","https:\u002F\u002Feur-lex.europa.eu\u002Feli\u002Freg\u002F2023\u002F1542\u002Foj",{"key":231,"name":232,"url":233,"type":234},"batteryPassportCommission","Komisja Europejska — Battery Passport","https:\u002F\u002Fsingle-market-economy.ec.europa.eu\u002Fsingle-market\u002Fdigital-product-passport\u002Fbatteries_en","komisja-europejska",{"key":236,"name":237,"url":238,"type":234},"batteryPassportDataPoints","Komisja Europejska — Digital Batteries Passport, 71 data points by category, wersja 2.0","https:\u002F\u002Fsingle-market-economy.ec.europa.eu\u002Fdocument\u002Fdownload\u002Fcd1e5e6c-4a4a-4b99-995a-49eb6916187e_en?filename=Digital+Batteries+Passport+-+data+point+by+category.pdf",{"key":240,"name":241,"url":242,"type":234},"steelDppCommission","Komisja Europejska — Digital Product Passport for Iron and Steel","https:\u002F\u002Fsingle-market-economy.ec.europa.eu\u002Fsingle-market\u002Fdigital-product-passport\u002Firon-steel_en",{"key":244,"name":245,"url":246,"type":234},"steelDppJrcProposal","JRC — ESPR Steel DPP Content Proposal, projekt do konsultacji z 23 marca 2026 r.","https:\u002F\u002Fsusproc.jrc.ec.europa.eu\u002Fproduct-bureau\u002Fsites\u002Fdefault\u002Ffiles\u002F2026-03\u002FSubmission_ESPR%20Steel%20DPP%20Content%20Proposal_0.pdf",{"key":248,"name":249,"url":250,"type":234},"steelJrcDocuments","JRC Product Bureau — dokumenty badania przygotowawczego dla żelaza i stali","https:\u002F\u002Fsusproc.jrc.ec.europa.eu\u002Fproduct-bureau\u002Fproduct-groups\u002F642\u002Fdocuments",{"key":252,"name":253,"url":254,"type":234},"textileDppCommission","Komisja Europejska — Textile Apparel and the Digital Product Passport","https:\u002F\u002Fsingle-market-economy.ec.europa.eu\u002Fsingle-market\u002Fdigital-product-passport\u002Ftextile-apparel_en",{"key":256,"name":257,"url":258,"type":234},"textileDppJrcStudy","JRC — Study on DPP content for textile apparel products under ESPR, 13 maja 2026 r.","https:\u002F\u002Fsusproc.jrc.ec.europa.eu\u002Fproduct-bureau\u002Fsites\u002Fdefault\u002Ffiles\u002F2026-05\u002FTextiles_DPP_20260513.pdf",{"key":260,"name":261,"url":262,"type":234},"textileJrcDocuments","JRC Product Bureau — dokumenty badania przygotowawczego dla tekstyliów","https:\u002F\u002Fsusproc.jrc.ec.europa.eu\u002Fproduct-bureau\u002Fproduct-groups\u002F467\u002Fdocuments",{"key":264,"name":265,"url":266,"type":234},"dppJrcMethodology","JRC — Methodology for defining data requirements for the Digital Product Passport under the ESPR framework","https:\u002F\u002Fpublications.jrc.ec.europa.eu\u002Frepository\u002Fhandle\u002FJRC145830",{"key":268,"name":269,"url":270,"type":225},"detergents","Rozporządzenie (UE) 2026\u002F405 w sprawie detergentów i środków powierzchniowo czynnych","https:\u002F\u002Feur-lex.europa.eu\u002Feli\u002Freg\u002F2026\u002F405\u002Foj",{"key":272,"name":273,"url":274,"type":225},"toys","Rozporządzenie (UE) 2025\u002F2509 w sprawie bezpieczeństwa zabawek","https:\u002F\u002Feur-lex.europa.eu\u002Feli\u002Freg\u002F2025\u002F2509\u002Foj",{"key":276,"name":277,"url":278,"type":225},"constructionProducts","Rozporządzenie (UE) 2024\u002F3110 w sprawie wyrobów budowlanych","https:\u002F\u002Feur-lex.europa.eu\u002Feli\u002Freg\u002F2024\u002F3110\u002Foj",{"key":280,"name":281,"url":282,"type":234},"dppRoadmap","Digital Product Passport — harmonogram Komisji Europejskiej","https:\u002F\u002Fsingle-market-economy.ec.europa.eu\u002Fsingle-market\u002Fdigital-product-passport_en",{"key":213,"name":284,"url":285,"type":225},"Decyzja wykonawcza Komisji (UE) 2026\u002F1736 — sześć norm zharmonizowanych DPP","https:\u002F\u002Feur-lex.europa.eu\u002Feli\u002Fdec_impl\u002F2026\u002F1736\u002Foj",{"key":287,"name":288,"url":289,"type":234},"dppStandardsFaq","Digital Product Passport — oficjalne FAQ Komisji Europejskiej","https:\u002F\u002Fsingle-market-economy.ec.europa.eu\u002Fsingle-market\u002Fdigital-product-passport\u002Fexplore-our-faqs_en",{"key":291,"name":292,"url":293,"type":234},"dppEconomicOperators","Digital Product Passport — obowiązki operatorów gospodarczych i sprzedaż na odległość","https:\u002F\u002Fsingle-market-economy.ec.europa.eu\u002Fsingle-market\u002Fdigital-product-passport\u002Feconomic-operators_en",{"key":295,"name":296,"url":297,"type":234},"dppPublicAuthorities","Digital Product Passport — kontrole celne i nadzór rynku","https:\u002F\u002Fsingle-market-economy.ec.europa.eu\u002Fsingle-market\u002Fdigital-product-passport\u002Fpublic-authorities_en",{"key":299,"name":300,"url":301,"type":234},"publicProcurementActProposal","COM(2026) 590 final — projekt unijnego rozporządzenia o zamówieniach publicznych i koncesjach","https:\u002F\u002Feur-lex.europa.eu\u002Flegal-content\u002FEN\u002FTXT\u002F?uri=COM:2026:590:FIN",{"key":303,"name":304,"url":305,"type":225},"esprUnsoldDisclosure","Rozporządzenie wykonawcze Komisji (UE) 2026\u002F2 — ujawnianie danych o niesprzedanych produktach","https:\u002F\u002Feur-lex.europa.eu\u002Feli\u002Freg_impl\u002F2026\u002F2\u002Foj",{"key":307,"name":308,"url":309,"type":225},"esprUnsoldDerogations","Rozporządzenie delegowane Komisji (UE) 2026\u002F296 — wyjątki od zakazu niszczenia","https:\u002F\u002Feur-lex.europa.eu\u002Feli\u002Freg_del\u002F2026\u002F296\u002Foj",{"key":311,"name":312,"url":313,"type":234},"workingPlan","ESPR and Energy Labelling Working Plan 2025–2030","https:\u002F\u002Feur-lex.europa.eu\u002Flegal-content\u002FPL\u002FTXT\u002F?uri=CELEX:52025DC0187",{"key":209,"name":315,"url":316,"type":234},"DPP Registry — European Commission","https:\u002F\u002Fsingle-market-economy.ec.europa.eu\u002Fsingle-market\u002Fdigital-product-passport\u002Fdpp-registry_en",{"key":211,"name":318,"url":319,"type":225},"Rozporządzenie wykonawcze Komisji (UE) 2026\u002F1778 — zasady działania DPP Registry","https:\u002F\u002Feur-lex.europa.eu\u002Feli\u002Freg_impl\u002F2026\u002F1778\u002Foj",{"key":210,"name":321,"url":322,"type":234},"Komisja Europejska — DPP Registry działa od 20 lipca 2026 r.","https:\u002F\u002Fsingle-market-economy.ec.europa.eu\u002Fnews\u002Fdigital-product-passport-registry-now-live-2026-07-20_en",{"key":212,"name":324,"url":325,"type":234},"DPP Registry User Guide for Economic Operators, wersja 1.01","https:\u002F\u002Fsingle-market-economy.ec.europa.eu\u002Fdocument\u002Fdownload\u002F079a45e2-469f-4eec-b1e5-32e8e05d1357_en?filename=dpp_registry_user_guide_for_economic_operators.pdf",{"key":327,"name":328,"url":329,"type":234},"standardisation","JRC — Digital Product Passport","https:\u002F\u002Fjoint-research-centre.ec.europa.eu\u002Fprojects-and-activities\u002Fdigital-product-passport_en",{},"data\u002Fsources","G8uMT0QC2Jjs5t7hyRPPvjjwZy3TEHYQBDnXeNIL8uY",1790144109352]