Który system powinien być źródłem jakich danych
Przed integracją warto ustalić podział odpowiedzialności. ERP lub PIM zwykle pozostaje źródłem danych podstawowych: nazwy, SKU, GTIN, marki, modelu i opisów. DPPC przejmuje to, czego te systemy zazwyczaj nie obsługują dobrze: skład materiałowy z udziałem i pochodzeniem, dokumenty i certyfikaty z przeglądem i datą ważności, dane dostawców, zatwierdzanie produktów i publikację paszportu z kodem QR. Dzięki temu każda informacja ma jedno miejsce, w którym jest edytowana.
Jak wygląda integracja z DPPC
DPPC udostępnia REST API w wersji v1 z dokumentacją i schematem OpenAPI do pobrania. API obejmuje produkty, materiały, dokumenty, dostawców, certyfikaty i szablony pól branżowych, a także akcje obiegu: zatwierdzenie, odrzucenie, publikację i archiwizację produktu. Nie ma gotowych wtyczek do konkretnych systemów ERP. Integrację buduje Wasz zespół IT albo integrator, który zna Wasz ERP lub PIM, a API DPPC jest zaprojektowane tak, żeby taka integracja była prosta i przewidywalna.
Synchronizacja wsadowa zamiast pojedynczych wywołań
Przy dużych katalogach wygodniej wysyłać dane partiami. Zadania synchronizacji przyjmują do 500 rekordów produktów, dostawców lub certyfikatów naraz, tworzą nowe rekordy albo aktualizują istniejące i są przetwarzane w kolejce w tle. Status zadania, liczbę przetworzonych rekordów i opis błędów można sprawdzić przez API. Przed zapisem dane można też wysłać do walidacji w trybie podglądu, która zwraca ostrzeżenia bez zmiany danych w systemie.
Webhooki: informacja o zmianach z powrotem do Waszych systemów
Integracja działa w obie strony. DPPC wysyła webhooki przy utworzeniu, zmianie i usunięciu produktów, materiałów, dokumentów, dostawców i certyfikatów, a także przy publikacji paszportu. Każde powiadomienie jest podpisane algorytmem HMAC-SHA256, więc odbiorca może sprawdzić, że pochodzi z DPPC. Nieudane dostarczenia są ponawiane trzykrotnie, po minucie, pięciu i piętnastu minutach, a w ustawieniach organizacji można wysłać testowe zdarzenie.
Bezpieczeństwo i niezawodność integracji
Każdy system łączy się własnym kluczem API z wybranymi uprawnieniami, na przykład tylko do odczytu produktów albo do zapisu certyfikatów, więc klucz dla sklepu internetowego nie może zmieniać danych. Operacje zapisu obsługują nagłówek Idempotency-Key: ponowne wysłanie tego samego żądania, na przykład po zerwaniu połączenia, nie tworzy duplikatów. Limity wynoszą 180 odczytów i 60 zapisów na minutę dla jednego klucza.
Integracja DPP z ERP krok po kroku
Zacznijcie od mapowania pól: które dane z ERP lub PIM trafiają do DPPC i pod jakie pola, w tym pola branżowe z szablonu dostępnego w API. Potem utwórzcie klucz API z minimalnymi uprawnieniami i przetestujcie walidację w trybie podglądu na kilku produktach. Następnie uruchomcie pierwszą synchronizację wsadową jednej kategorii i skonfigurujcie webhooki, jeśli inne systemy mają reagować na zmiany. Dokumenty i certyfikaty zwykle uzupełnia się już w DPPC, bo tam przechodzą przegląd.