Integrace digitálního produktového pasu s ERP a PIM přes REST API, hromadnou synchronizaci a webhooky. Rozdělení dat, zabezpečení a postup zavedení integrace.
Před integrací je dobré ujasnit si rozdělení odpovědností. ERP nebo PIM obvykle zůstává zdrojem základních dat: názvu, SKU, GTIN, značky, modelu a popisů. DPPC přebírá to, co tyto systémy zpravidla neřeší dobře: materiálové složení s podílem a původem, dokumenty a certifikáty s kontrolou a datem platnosti, data o dodavatelích, schvalování výrobků a zveřejnění pasu s QR kódem. Každá informace tak má jedno místo, kde se upravuje.
DPPC poskytuje REST API ve verzi v1 s dokumentací a schématem OpenAPI ke stažení. API pokrývá výrobky, materiály, dokumenty, dodavatele, certifikáty a šablony oborových polí a také akce schvalovacího procesu: schválení, zamítnutí, zveřejnění a archivaci výrobku. Hotové konektory pro konkrétní systémy ERP nejsou k dispozici. Integraci staví váš IT tým nebo integrátor, který zná váš ERP nebo PIM, a API DPPC je navržené tak, aby taková integrace byla jednoduchá a předvídatelná.
U velkých katalogů je pohodlnější posílat data po dávkách. Synchronizační úlohy přijímají až 500 záznamů výrobků, dodavatelů nebo certifikátů najednou, vytvářejí nové záznamy nebo aktualizují stávající a zpracovávají se ve frontě na pozadí. Stav úlohy, počet zpracovaných záznamů a popis chyb lze zjistit přes API. Před uložením lze data také poslat k ověření v režimu náhledu, které vrátí upozornění bez změny dat v systému.
Integrace funguje oběma směry. DPPC odesílá webhooky při vytvoření, změně a smazání výrobků, materiálů, dokumentů, dodavatelů a certifikátů a také při zveřejnění pasu. Každé oznámení je podepsané algoritmem HMAC-SHA256, takže příjemce může ověřit, že pochází z DPPC. Neúspěšná doručení se opakují třikrát, po jedné, pěti a patnácti minutách, a v nastavení organizace lze odeslat testovací událost.
Každý systém se připojuje vlastním klíčem API s vybranými oprávněními, například jen pro čtení výrobků nebo pro zápis certifikátů, takže klíč pro e-shop nemůže data měnit. Zápisové operace podporují hlavičku Idempotency-Key: opakované odeslání téhož požadavku, například po přerušení spojení, nevytvoří duplicity. Limity jsou 180 čtení a 60 zápisů za minutu pro jeden klíč.
Začněte mapováním polí: která data z ERP nebo PIM se přenášejí do DPPC a do jakých polí, včetně oborových polí ze šablony dostupné v API. Potom vytvořte klíč API s minimálními oprávněními a vyzkoušejte ověření v režimu náhledu na několika výrobcích. Následně spusťte první hromadnou synchronizaci jedné kategorie a nastavte webhooky, pokud mají na změny reagovat další systémy. Dokumenty a certifikáty se obvykle doplňují přímo v DPPC, protože tam procházejí kontrolou.
FAQ
Hotové konektory pro konkrétní systémy nejsou k dispozici. Integrace probíhá přes zdokumentované REST API, hromadnou synchronizaci a webhooky, což umožňuje propojit DPPC s jakýmkoli ERP nebo PIM, který umí volat API.
Ne. Na začátek lze data naimportovat ze souborů CSV podle šablon. Integraci se vyplatí postavit, když proces funguje na pilotní kategorii a data v ERP se často mění.
Dokumentace API v1 je veřejně dostupná na stránce /api-docs spolu se schématem OpenAPI ke stažení, které lze importovat do vývojářských nástrojů.
Pokud má zápisový požadavek hlavičku Idempotency-Key, DPPC opakování rozpozná a místo vytvoření duplicity vrátí výsledek prvního volání. Synchronizační úlohy aktualizují stávající záznamy, místo aby vytvářely nové.
Ano, API poskytuje akce schválení, zamítnutí, zveřejnění a archivace. Zveřejnění přes API se řídí stejnými pravidly jako v aplikaci: výrobek musí mít všechna povinná data a dokumenty.
Související průvodci
Software pro digitální produktový pas (DPP): jak vybrat nástroj a zavést ho ve firmě
Jak vybrat nástroj pro správu DPP a zavést digitální produktový pas ve firmě: kritéria výběru, postup zavedení a otázky, které stojí za to položit dodavateli.
Průvodce procesem produktové dokumentace
Jak vybudovat čistý proces pro produktové soubory, prohlášení, certifikáty, verze a veřejnou produktovou komunikaci.
Jak kontrolovat produktové dokumenty a certifikáty před zveřejněním
Praktický průvodce kontrolou produktových dokumentů a certifikátů: co kontrolovat, jak pomáhají automatické předběžné kontroly a kdy musí rozhodnout člověk.