Ostatnia aktualizacja: 2026-10-14
- Rozpisz przepływ produktów, cen, stanów i zamówień.
- Dla każdej encji wskaż źródło prawdy, kierunek synchronizacji i regułę obsługi rozbieżności.
- Sprawdź mapowanie identyfikatorów, możliwości API oraz sposób obsługi błędów.
- Przed uruchomieniem wykonaj testy scenariuszy poprawnych i wyjątkowych.
Zakres trzeba dostosować do używanej platformy, ERP, modelu sprzedaży i faktycznych procesów firmy. Jeśli ten sam projekt obejmuje również usługę opisaną jako tworzenie stron internetowych Lublin, wymagania dotyczące sklepu i integracji powinny być uzgadniane razem, aby nie opierać projektu na dwóch różnych założeniach.
Zacznij od procesu, nie od konektora
Najpierw opisz procesy, dane i odpowiedzialność systemów, a dopiero potem wybierz sposób połączenia.[1][2] Integracja sklepu z ERP oznacza zaprojektowaną wymianę danych i obsługę zdarzeń między platformą sprzedażową a systemem zarządzającym wybranymi procesami firmy. Nie jest jedynie uruchomieniem wtyczki albo dostępu do interfejsu.
Jak rozpoznać proces wymagający integracji
Zacznij od sytuacji, w których dane powstają, zmieniają się lub są potrzebne w drugim systemie. Dotyczy to między innymi utworzenia produktu, zmiany ceny, aktualizacji dostępności oraz całego cyklu realizacji zamówienia. Dla każdego przebiegu trzeba ustalić zdarzenie początkowe, kolejne działania i oczekiwany rezultat.
- Opisz zdarzenie. Ustal, co rozpoczyna proces, na przykład utworzenie produktu albo złożenie zamówienia.
- Wskaż dane. Zapisz, jakie informacje są potrzebne na każdym etapie oraz gdzie obecnie się znajdują.
- Przypisz odpowiedzialność. Określ, który system tworzy dane, który może je zmieniać i kto reaguje na błąd.
- Rozpisz wyjątki. Uwzględnij brak wymaganej informacji, rozbieżność danych oraz niedostępność jednego z systemów.
- Dopiero wtedy oceń technologię. Porównaj dostępne sposoby połączenia z wymaganiami opisanego procesu.
Czego dokumentacja API nie rozstrzyga
API, czyli programowy interfejs wymiany danych, odpowiada przede wszystkim na pytanie, co dany system pozwala odczytać lub zapisać. Mapa procesów odpowiada natomiast na pytanie, co i kiedy powinno się wydarzyć.[4][7] Sama dostępność zasobu zamówień lub produktów nie określa źródła prawdy, zasad aktualizacji ani sposobu postępowania po rozbieżności.
W praktyce dokumentacja techniczna służy do potwierdzenia wykonalności wymagań, a nie do zastąpienia ich. Taka kolejność pozwala oceniać rozwiązania według tego, czy obsługują potrzebny proces.
Ustal zakres danych i źródła prawdy
Dla każdej grupy danych określ zakres, źródło prawdy, kierunek wymiany, sposób uruchamiania synchronizacji i reakcję na rozbieżność. Źródło prawdy to system, którego informację uznaje się za obowiązującą. Nie musi być ono takie samo dla produktu, ceny, stanu magazynowego i zamówienia.[3]
Co objąć pierwszym etapem integracji
Najczęściej analizuje się produkty i warianty, ceny, stany magazynowe, zamówienia oraz dane klienta. Dokumenty i statusy wymagają osobnego ustalenia.[5] Nie oznacza to, że każdy projekt powinien synchronizować wszystkie te obszary. Pierwszy etap może obejmować tylko dane potrzebne do wykonania określonego procesu, o ile granice automatyzacji są jasno opisane.
| Obszar danych | Właściciel danych | Kierunek wymiany | Wyzwalacz lub częstotliwość | Identyfikator | Reakcja na rozbieżność |
|---|---|---|---|---|---|
| Produkty i warianty | Do ustalenia dla procesu | Do ustalenia | Utworzenie lub zmiana | SKU i identyfikator wariantu | Walidacja mapowania |
| Ceny | Do ustalenia dla cennika i kanału | Do ustalenia | Zmiana ceny | Identyfikator produktu lub wariantu | Wstrzymanie błędnej aktualizacji |
| Stany magazynowe | Do ustalenia dla sposobu zarządzania dostępnością | Do ustalenia | Zmiana stanu lub synchronizacja cykliczna | Produkt, wariant i magazyn | Uzgodnienie wartości w obu systemach |
| Zamówienia | Do ustalenia dla danego etapu procesu | Może zmieniać się wraz z etapem | Utworzenie albo zmiana statusu | Identyfikator zamówienia | Kontrola duplikatu i bezpieczne ponowienie |
| Statusy i dokumenty | Do ustalenia osobno | Do ustalenia | Zmiana etapu realizacji | Identyfikator procesu lub dokumentu | Weryfikacja mapowania statusu |
Tabela jest punktem wyjścia do rozmowy biznesowej i technicznej. Właściciel danych oraz kierunek wymiany powinny wynikać z rzeczywistego procesu, a nie z założenia, że ERP zawsze zarządza każdą informacją.
Jak opisać cykl życia zamówienia
Integracji zamówień nie należy opisywać jako jednego transferu. Trzeba rozłożyć ją na etapy obejmujące pozycje, płatność, dostawę, rezerwację lub wydanie towaru, zmiany statusu, anulowanie i zwrot. Dokładna lista statusów zależy od modelu sprzedaży i konkretnego ERP.
Dla każdego etapu należy wskazać system inicjujący zmianę, dane przesyłane do drugiej strony i oczekiwaną odpowiedź. Dzięki temu można zauważyć, że utworzenie zamówienia, zmiana sposobu dostawy i anulowanie nie są tym samym zdarzeniem integracyjnym.
Przygotuj mapowanie identyfikatorów i statusów
Przed uruchomieniem przygotuj mapę SKU, identyfikatorów wariantów, jednostek, stawek podatkowych i statusów.[1][2] Celem jest jednoznaczne powiązanie tego samego rekordu oraz tego samego znaczenia procesowego w obu systemach.
Dlaczego nazwa produktu nie wystarcza
Nazwa służy użytkownikowi, ale nie powinna zastępować stabilnego identyfikatora. Produkt nadrzędny i jego warianty mogą być odrębnymi rekordami, dlatego trzeba sprawdzić, czy każdy z nich ma jednoznaczne powiązanie między sklepem a ERP.
- Zweryfikuj SKU produktów i wariantów.
- Ustal powiązania identyfikatorów używanych przez sklep i ERP.
- Sprawdź jednostki miary, stawki podatkowe i przypisania do magazynów.
- Określ sposób postępowania z rekordem bez wymaganego identyfikatora.
- Potwierdź, czy zmiana identyfikatora jest dozwolona i jak wpływa na istniejące powiązanie.
Jak mapować statusy według znaczenia procesu
Podobne nazwy statusów nie muszą wywoływać tych samych działań. Mapowanie powinno więc określać nie tylko nazwę, lecz także znaczenie operacyjne: czy towar został zarezerwowany, czy zamówienie można jeszcze zmienić i co ma się stać po anulowaniu albo zwrocie.
Dokładne statusy zależą od modelu sprzedaży i systemu ERP. Z tego powodu gotowej listy nie należy traktować jako uniwersalnego standardu. Potrzebny jest słownik przygotowany dla konkretnego procesu, a następnie użyty w scenariuszach testowych.
Dobierz model integracji do procesu i możliwości systemów
Konektor, middleware albo integrację dedykowaną wybiera się według pokrycia procesów, dostępnych interfejsów oraz wymagań dotyczących wyjątków i utrzymania. Techniczny model może wykorzystywać API, webhooki, synchronizację cykliczną lub warstwę pośredniczącą.[3][6] Dokładne możliwości zależą od wersji sklepu, ERP i używanych modułów.
| Wariant | Kiedy jest kandydatem | Co trzeba zweryfikować | Główne ograniczenie decyzyjne |
|---|---|---|---|
| Gotowy konektor | Gdy obsługuje wymagane procesy i mapowania | Zakres encji, statusów, wyjątków, monitoringu i wsparcia | Standardowy przepływ może nie pokrywać niestandardowego procesu |
| Middleware | Gdy potrzebna jest warstwa pośrednicząca między kilkoma systemami | Mapowanie, monitoring, odpowiedzialność za konfigurację i utrzymanie | Warstwa pośrednia nie usuwa problemów jakości danych |
| Integracja dedykowana | Gdy proces wymaga indywidualnej obsługi danych lub wyjątków | Zakres budowy, testów, dokumentacji, monitoringu i dalszych zmian | Decyzja wymaga precyzyjnie opisanego zakresu oraz utrzymania |
Gotowy konektor jest sensownym kandydatem, gdy pokrywa wymagane procesy, mapowania i sposób obsługi wyjątków. Nie ma jednak podstaw do uznania jednego modelu za najlepszy dla wszystkich sklepów.[8]
Co potwierdzić w API przed wyborem rozwiązania
Trzeba potwierdzić, czy interfejs pozwala wykonywać operacje wymagane przez proces: odczytywać i zapisywać właściwe dane, rozróżniać produkty oraz warianty, obsługiwać zamówienia i przekazywać potrzebne zmiany. Dokumentacja konkretnej platformy jest właściwym miejscem do potwierdzenia jej możliwości, ale nie definiuje procesu firmy.
Webhook to powiadomienie wysyłane po określonym zdarzeniu. Może sygnalizować zmianę zamówienia, produktu lub stanu, lecz sam nie zapewnia potwierdzenia kompletności procesu. Trzeba osobno zaprojektować odbiór, ponowienie, deduplikację i uzgadnianie danych.[4][6]
Kiedy gotowy konektor może nie wystarczyć
Problem pojawia się wtedy, gdy konektor nie obsługuje wymaganego kierunku wymiany, potrzebnego statusu, niestandardowego mapowania albo sposobu reagowania na błąd. Ocena powinna obejmować również możliwość monitorowania operacji i odpowiedzialność za zmiany po aktualizacji jednego z systemów.
Do wyceny potrzebna jest lista procesów i wyjątków, nie tylko nazwy sklepu oraz ERP. Brakuje niezależnych danych pozwalających wskazać uniwersalny przedział cenowy dla Polski, dlatego kwota bez opisanego zakresu nie jest miarodajnym kryterium porównania ofert.
Zaprojektuj monitoring i obsługę wyjątków
Obsługa błędów powinna wskazywać rekord, etap, przyczynę, właściciela działania i bezpieczny sposób ponowienia. Monitoring nie może ograniczać się do informacji, że integracja działa albo nie działa. Powinien pozwalać ustalić, która operacja się nie powiodła i co należy z nią zrobić.[2]
Jakie informacje powinien zawierać wpis błędu
- Rekord
- Produkt, wariant, zamówienie lub inna encja, której dotyczy problem.
- Etap
- Miejsce procesu, w którym operacja została przerwana albo odrzucona.
- Przyczyna
- Informacja pozwalająca odróżnić błąd danych od niedostępności systemu.
- Właściciel działania
- Osoba lub zespół odpowiedzialny za podjęcie decyzji i korektę.
- Ponowienie
- Sposób powtórzenia operacji bez niekontrolowanego utworzenia duplikatu.
- Potwierdzenie
- Kontrola, czy po naprawie oba systemy przechowują oczekiwane dane.
Zakres monitoringu należy dopasować do krytyczności procesu. Innej reakcji wymaga opóźnienie informacji pomocniczej, a innej brak zamówienia w systemie odpowiedzialnym za jego realizację. Dokładny mechanizm bezpiecznego ponowienia zależy od możliwości użytych systemów.
Po co uzgadniać dane po awarii
Samo ponowienie komunikatu nie potwierdza, że końcowy stan jest poprawny. Uzgadnianie danych polega na porównaniu odpowiadających sobie rekordów po synchronizacji lub naprawie błędu. Pozwala sprawdzić, czy operacja została wykonana raz i czy jej rezultat jest zgodny po obu stronach.
Dla każdego rodzaju wyjątku trzeba więc ustalić, gdzie jest widoczny, kto reaguje, czy można go bezpiecznie ponowić i jak potwierdzić poprawność po naprawie. Dzięki temu błąd staje się konkretnym zadaniem operacyjnym, a nie niejasnym komunikatem o awarii.
Przetestuj proces i przygotuj brief do wyceny
Przed uruchomieniem przetestuj scenariusze poprawne i wyjątkowe, a do briefu dla integratora dołącz procesy, dane, wyjątki i sposób utrzymania. Pojedynczy poprawny zakup nie potwierdza jeszcze obsługi zmian, anulowania, zwrotu, błędu mapowania ani ponownego przetwarzania.
Scenariusze testów przed uruchomieniem
Plan testów powinien wykraczać poza pojedynczy poprawny zakup i obejmować błędy mapowania, anulowanie, zwrot oraz ponowne przetworzenie.[2][3] Źródła branżowe nie przedstawiają jednak uniwersalnego standardu testów odbiorowych. Zestaw przypadków trzeba wyprowadzić z procesu i możliwości używanych systemów.
- Utworzenie poprawnego produktu lub zamówienia.
- Zmiana danych już zsynchronizowanego rekordu.
- Anulowanie zamówienia i zmiana odpowiadających mu statusów.
- Obsługa zwrotu zgodnie z zakresem integracji.
- Brak wymaganego identyfikatora albo niezgodne mapowanie.
- Czasowa niedostępność sklepu, ERP lub warstwy pośredniczącej.
- Ponowienie operacji i kontrola, czy nie powstał duplikat.
- Uzgodnienie danych po przywróceniu działania.
Kryterium odbioru powinno opisywać oczekiwany rezultat procesu, a nie tylko brak technicznego komunikatu o błędzie. Test połączenia i test całego przebiegu biznesowego odpowiadają na inne pytania.
Co przekazać integratorowi do wyceny
- Nazwy i wersje systemów oraz wykorzystywane moduły.
- Mapę procesów objętych integracją.
- Listę encji, pól i kierunków wymiany.
- Źródło prawdy dla każdej istotnej grupy danych.
- Mapowanie identyfikatorów, statusów i słowników.
- Obsługiwane wyjątki oraz sposób reakcji na błędy.
- Wymagania dotyczące monitoringu, ponowień i uzgadniania.
- Scenariusze testowe i kryteria odbioru.
- Podział odpowiedzialności za utrzymanie po uruchomieniu.
Taki brief umożliwia porównywanie ofert odnoszących się do podobnego zakresu. Nie tworzy jednak uniwersalnej wyceny ani terminu wdrożenia, ponieważ oba elementy zależą między innymi od procesów, dostępnych interfejsów i liczby wyjątków.
Najczęstsze pytania
Czy ERP zawsze powinien być źródłem prawdy dla stanów magazynowych?
Nie należy przyjmować tego automatycznie. Właściciela stanów ustala się dla konkretnego procesu i systemu, który faktycznie zarządza dostępnością. Trzeba też rozróżnić stan fizyczny, rezerwację oraz ilość udostępnianą do sprzedaży.
Czy webhook wystarczy, aby zsynchronizować zamówienia?
Webhook może poinformować o zdarzeniu, ale nie zastępuje reguł potwierdzenia odbioru, ponowienia, deduplikacji i kontroli rozbieżności. Jest elementem technicznego mechanizmu, a nie kompletnym projektem procesu.
Czy można najpierw wdrożyć produkty i stany, a zamówienia później?
Zakres pierwszego etapu można ograniczyć, jeśli odpowiada to procesowi firmy. Trzeba jednak jasno wskazać dane pozostające poza synchronizacją oraz ustalić, jak będą obsługiwane do czasu wdrożenia kolejnego etapu.
Źródła
- Jak zaplanować integracje sklepu internetowego?, MAJKOMPANY.
- Najczęstsze błędy przy integracji sklepu internetowego z systemem ERP (i jak ich uniknąć), Webtom.
- Integracja sklepu z ERP (Comarch, Enova, Sage) — jak to działa, 2bi.
- WooCommerce REST API Documentation v3, WooCommerce.
- WooCommerce REST API Documentation, WooCommerce.
- About webhooks, Shopify.
- APIs for apps, Shopify.
- Integracja ERP ze sklepem internetowym — wdrożenie, ceny, Oprogramowanie ERP.
+Artykuł Sponsorowany+






