Integracja sklepu Shoper z ERP, CRM i magazynem — przewodnik dla właścicieli sklepów
Przewodnik pomaga zaplanować przepływ zamówień między Shoper, ERP, CRM i magazynem: ustalić właścicieli danych, mapowanie statusów, obsługę błędów i kryteria testów.
Jak wdrożyć integrację Shoper krok po kroku
Integracja ERP Shoper: od czego zacząć planowanie
Integracja ERP Shoper zaczyna się od ustalenia, które dane mają przepływać i kto odpowiada za ich źródło. Inny system może być właścicielem katalogu i cen, inny stanów, a Shoper — przyjmowania zamówień. Te role zależą od procesu i konfiguracji konkretnego sklepu.
Przed wyborem sposobu komunikacji warto rozpisać operacje, ich kierunek, wymagane pola oraz wyjątki: anulowanie, zwrot, brak produktu czy konflikt aktualizacji. Dzięki temu zakres integracji wynika z procesu, a nie z samej listy dostępnych endpointów.
Jeśli potrzebujesz ocenić architekturę i zakres wykonania, zobacz usługę integracji systemów.
Ustal zakres danych i operacji wymienianych między Shoper a systemami ERP, CRM lub magazynem
API Shoper: jakie dane i operacje zaplanować
REST API Shopera udostępnia zasoby, w tym zamówienia i produkty. Szczegóły operacji, autoryzacji i pól trzeba sprawdzić w aktualnej dokumentacji REST API Shoper oraz w dokumentacji zasobu używanego przez konkretny przepływ.
Wybierz mapowanie odpowiadające procesowi: na przykład identyfikator zamówienia, pozycje i statusy. Dla każdego pola zapisz źródło prawdy, kierunek zapisu, regułę konfliktu oraz oczekiwane zachowanie przy wartości brakującej lub nieznanej.
API nie ustala samo, czy synchronizacja ma być wywoływana zdarzeniem, harmonogramem czy żądaniem operatora. Ten wybór zależy od możliwości konkretnego endpointu i systemu ERP/CRM; nie zakładaj, że każde wdrożenie zapewnia webhook, kolejkę lub synchronizację w czasie rzeczywistym.
Gotowy konektor czy dedykowana integracja ERP
Najpierw porównaj uzgodniony przepływ z zakresem gotowego konektora. Sprawdź obsługiwane wersję ERP, kierunek wymiany zamówień i stanów, mapowanie statusów oraz zwroty. Shoper opisuje zarówno synchronizator, jak i dedykowane połączenie przez API w przykładzie integracji ERP.
Dedykowaną warstwę warto rozważyć, gdy proces wymaga własnych reguł walidacji, kilku systemów lub oddzielnych dostępów dla partnerów, których wybrany konektor nie obsługuje. Zgodność ERP, CRM lub WMS zależy od jego wersji, licencji, metody komunikacji i uprawnień. Przed wyceną zweryfikuj dokumentację dostawcy i wykonaj próbę odczytu lub zapisu w środowisku testowym.
Nasze case study integratora zamówień Shoper pokazuje warstwę między partnerami a API sklepu, z walidacją żądań i obsługą operacji zbiorczych. Połączenie jej z konkretnym ERP wymaga osobnego określenia mapowania i dostępnych operacji.
Źródło stanów, mapowanie statusów i ponowienia
Dla stanów magazynowych wskaż system nadrzędny, kierunek synchronizacji, częstotliwość aktualizacji i sposób rozstrzygania równoczesnych zmian. Dla statusów zamówienia przygotuj tabelę przejść między Shoperem a ERP: które stany są równoważne, które wymagają działania człowieka i co zrobić z nieznaną wartością.
Ponowienia zaplanuj dla timeoutów, błędów chwilowych i odpowiedzi niejednoznacznych. Gdy API zwróci 429 z nagłówkiem Retry-After, uwzględnij wskazany czas oczekiwania. Określ też, jak rozpoznać duplikat i kiedy potrzebna jest ręczna kontrola.
Uzgodnij testy dla poprawnych i odrzuconych żądań, ponowionej operacji, częściowego błędu operacji zbiorczej, konfliktu stanu, nieznanego statusu oraz zwrotu lub anulowania.
- Właściciel stanów i statusów wskazany dla każdego przepływu
- Mapowanie pól i konfliktów zapisane dla wersji używanych systemów
- Ponowienia, duplikaty i przypadki niejednoznaczne opisane w kryteriach odbioru
- Testy akceptacyjne dobrane do uzgodnionych operacji i wyjątków
- Mamy powtarzalne procesy, które zajmują >5 godz./tygodniowo
- Dane są kopiowane ręcznie między systemami (ERP, CRM, sklep, magazyn)
- Zdarzają się błędy lub opóźnienia przez brak synchronizacji informacji
- Chcemy skalować operacje bez proporcjonalnego wzrostu zatrudnienia
- Mamy budżet lub plan budżetu na inwestycję technologiczną w 2025–2026
Dostęp do API i granice odpowiedzialności
Shoper opisuje OAuth 2.0 oraz uprawnienia dobierane do obszaru i operacji. Sprawdź aktualne opcje w instrukcji konfiguracji dostępu API. Oddziel uprawnienia aplikacji Shoper od dostępu partnera do middleware; nie zakładaj, że integracja wymaga klucza administratora z pełnymi prawami.
Przed uruchomieniem określ, jakie dane są niezbędne do przepływu, co trafia do logów i kto reaguje na błąd. Wymagania prawne i umowy zależą od konkretnego procesu i podmiotów; ten przewodnik nie zastępuje ich indywidualnej oceny.
Co uzgodnić przed wyborem wykonawcy
Poproś o diagram przepływu, listę pól i systemów źródłowych, obsługę błędów oraz kryteria testów. Ustal też, które elementy są w zakresie wykonawcy, dostawcy ERP i administratora sklepu.
Jeśli chcesz przejść od planu do oceny konkretnego procesu, zobacz usługę integracji systemów albo przeczytaj opis projektu middleware dla zamówień Shoper. Case study dokumentuje tę realizację; zakres innego sklepu wymaga osobnej analizy.