Jak zaplanować integrację sklepu z ERP

0
3
Rate this post

Ostatnia aktualizacja: 2026-10-14

Integrację sklepu z ERP planuje się od procesów, danych i odpowiedzialności za ich poprawność — nie od wyboru konektora.

  • 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.
Techniczne połączenie sklepu internetowego z systemem ERP nie wystarczy, jeśli nie wiadomo, który system tworzy dane, kiedy mogą być one zmieniane i co powinno nastąpić po błędzie. Plan integracji powinien więc opisywać cały proces biznesowy, a nie tylko sposób przesyłania rekordów.

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.

  1. Opisz zdarzenie. Ustal, co rozpoczyna proces, na przykład utworzenie produktu albo złożenie zamówienia.
  2. Wskaż dane. Zapisz, jakie informacje są potrzebne na każdym etapie oraz gdzie obecnie się znajdują.
  3. Przypisz odpowiedzialność. Określ, który system tworzy dane, który może je zmieniać i kto reaguje na błąd.
  4. Rozpisz wyjątki. Uwzględnij brak wymaganej informacji, rozbieżność danych oraz niedostępność jednego z systemów.
  5. 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 danychWłaściciel danychKierunek wymianyWyzwalacz lub częstotliwośćIdentyfikatorReakcja na rozbieżność
Produkty i wariantyDo ustalenia dla procesuDo ustaleniaUtworzenie lub zmianaSKU i identyfikator wariantuWalidacja mapowania
CenyDo ustalenia dla cennika i kanałuDo ustaleniaZmiana cenyIdentyfikator produktu lub wariantuWstrzymanie błędnej aktualizacji
Stany magazynoweDo ustalenia dla sposobu zarządzania dostępnościąDo ustaleniaZmiana stanu lub synchronizacja cyklicznaProdukt, wariant i magazynUzgodnienie wartości w obu systemach
ZamówieniaDo ustalenia dla danego etapu procesuMoże zmieniać się wraz z etapemUtworzenie albo zmiana statusuIdentyfikator zamówieniaKontrola duplikatu i bezpieczne ponowienie
Statusy i dokumentyDo ustalenia osobnoDo ustaleniaZmiana etapu realizacjiIdentyfikator procesu lub dokumentuWeryfikacja 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.

WariantKiedy jest kandydatemCo trzeba zweryfikowaćGłówne ograniczenie decyzyjne
Gotowy konektorGdy obsługuje wymagane procesy i mapowaniaZakres encji, statusów, wyjątków, monitoringu i wsparciaStandardowy przepływ może nie pokrywać niestandardowego procesu
MiddlewareGdy potrzebna jest warstwa pośrednicząca między kilkoma systemamiMapowanie, monitoring, odpowiedzialność za konfigurację i utrzymanieWarstwa pośrednia nie usuwa problemów jakości danych
Integracja dedykowanaGdy proces wymaga indywidualnej obsługi danych lub wyjątkówZakres budowy, testów, dokumentacji, monitoringu i dalszych zmianDecyzja 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

  1. Jak zaplanować integracje sklepu internetowego?, MAJKOMPANY.
  2. Najczęstsze błędy przy integracji sklepu internetowego z systemem ERP (i jak ich uniknąć), Webtom.
  3. Integracja sklepu z ERP (Comarch, Enova, Sage) — jak to działa, 2bi.
  4. WooCommerce REST API Documentation v3, WooCommerce.
  5. WooCommerce REST API Documentation, WooCommerce.
  6. About webhooks, Shopify.
  7. APIs for apps, Shopify.
  8. Integracja ERP ze sklepem internetowym — wdrożenie, ceny, Oprogramowanie ERP.

+Artykuł Sponsorowany+