Integracja sklepu Shoper z ERP, CRM i magazynem — przewodnik dla właścicieli sklepów
Ręczne przepisywanie zamówień między Shoper a ERP to pułapka, w której tkwi większość sklepów B2B. Przewodnik pokazuje, jak zautomatyzować cały przepływ — od złożenia zamówienia przez fakturowanie (KSeF) po aktualizację magazynu — bez zakłóceń w działalności.
Jak wdrożyć integrację Shoper krok po kroku
Dlaczego integracja Shoper z ERP to punkt zwrotny dla firm B2B
Prowadzenie sklepu na Shoper daje przewagę na starcie — szybkie wdrożenie, gotowa platforma, stabilna infrastruktura. Problem pojawia się, gdy firma zaczyna rosnąć: każde zamówienie wymaga sprawdzenia stanów w magazynie, wystawienia faktury w ERP, aktualizacji karty klienta w CRM i wysyłki statusu do WMS. Bez integracji te czynności pochłaniają godziny pracy dziennie i generują błędy, które wychodzą przy reklamacjach — nie przy złożeniu zamówienia.
Dla firm B2B problem jest podwójny — obsługują indywidualne cenniki, rabaty grupowe i zamówienia hurtowe, które w Shoper i w ERP mają różne reprezentacje. Handlowiec widzi ofertę w CRM, magazyn widzi stan w WMS, księgowość widzi fakturę w ERP i żaden z tych systemów nie wie, co dzieje się w pozostałych. W dobie obowiązkowego KSeF integracja przestaje być opcją: automatyczne wystawianie faktur zgodnych z Krajowym Systemem e-Faktur wymaga spójności danych na poziomie systemu, nie arkusza.
Dobrze zaprojektowana integracja Shoper z ERP eliminuje ręczne przepisywanie danych, synchronizuje stany magazynowe w czasie rzeczywistym i pozwala firmie skalować sprzedaż bez proporcjonalnego wzrostu obciążenia operacyjnego. Zamiast ośmiu osób obsługujących 200 zamówień dziennie — cztery osoby obsługują 400.
Automatyczna synchronizacja zamówień Shoper z ERP (Comarch, Subiekt) — zero ręcznego przepisywania danych między systemami
Jak działa API Shoper — co i jak synchronizować
Shoper udostępnia REST API, przez które można odczytywać i zapisywać dane zamówień, produktów, stanów magazynowych, cenników, klientów i faktur. To API jest podstawą każdej automatyzacji — integrator odpytuje je przy zdarzeniach (nowe zamówienie, zmiana statusu, zwrot) lub w cyklach czasowych dla danych wolnozmiennych (katalog produktów, cenniki grupowe dla B2B).
Typowe mapowanie pól wygląda tak: numer zamówienia Shoper → numer dokumentu w ERP; adres klienta → karta kontrahenta; lista pozycji z cenami → pozycje faktury; status wysyłki → aktualizacja dokumentu WZ. Każde z tych powiązań wymaga decyzji projektowej — co jest master record, co się dzieje przy konflikcie, jak obsługiwane są zwroty i korekty. Błędy w tej fazie kosztują wielokrotnie więcej niż czas poświęcony na analizę przed startem.
W praktyce stosuje się warstwę middleware, która buforuje zdarzenia, waliduje dane i dystrybuuje je do właściwych systemów. Dzięki temu awaria jednego systemu nie zatrzymuje całego przepływu, a każde przekazanie danych jest logowane z kontekstem biznesowym — wiadomo, które zamówienie, o której godzinie i z jakim wynikiem przeszło przez integrację.
Integracja Shoper z Comarch Optima, Subiektem i SAP — czego się spodziewać
Najpopularniejszymi ERP w polskich sklepach B2B są Comarch Optima, Subiekt GT/nexo i Microsoft Dynamics. Każdy ma własne API o różnym stopniu dokumentacji i kompletności. Comarch Optima w starszych wersjach wymaga komunikacji przez SOAP lub dedykowane SDK — REST API pojawia się dopiero w nowszych wersjach i z pewnymi ograniczeniami. Subiekt GT eksportuje dane przez własny mechanizm COM/SDK, co wymaga specjalizowanego adaptera po stronie integracji.
SAP i Microsoft Dynamics mają dobrze udokumentowane API, ale skomplikowaną logikę biznesową po stronie ERP — mapowanie wymaga znajomości struktury modułów finansowych i sprzedażowych danej organizacji. W każdym przypadku przed wdrożeniem weryfikujemy wersję systemu, dostępność API i ograniczenia licencyjne, bo te determinują architekturę bardziej niż jakikolwiek requirement funkcjonalny.
Praktyczny wynik: dla klienta z Shoper i Comarch Optima zbudowaliśmy warstwę integracyjną przetwarzającą 2400+ zamówień miesięcznie z dokładnością synchronizacji 99,8%. Czas od złożenia zamówienia do gotowości wysyłki skrócił się z 12 godzin do 15 minut. Szczegóły w case study projektu.
Najczęstsze wyzwania przy integracji Shoper i jak je rozwiązać
Pierwszym wyzwaniem jest spójność danych. Jeśli w Shoper i ERP różnie definiujesz produkty — inne jednostki miary, różne kody SKU, brak odwzorowania jeden-do-jednego między wariantami — integracja będzie generować błędy przy każdej niezgodności. Rozwiązaniem jest ujednolicenie słowników przed wdrożeniem i ustalenie, który system jest źródłem prawdy dla produktów i cen.
Obsługa zwrotów i reklamacji to drugi typowy problem. W Shoper zwrot generuje nowy dokument, który musi być poprawnie zmapowany w ERP jako korekta — z odwrotnym znakiem dla stanów magazynowych i przychodu. Integracja musi obsługiwać pełny cykl życia zamówienia: złożenie, potwierdzenie, wysyłka, zwrot, korekta faktury. Systemy obsługujące tylko ścieżkę happy path zawodzą przy pierwszej partii zwrotów.
Wydajność przy dużych sklepach to trzeci front: API Shoper ma limity zapytań, które przy setkach zamówień dziennie wymagają kolejkowania i asynchronicznej komunikacji. Warstwa middleware rozwiązuje ten problem, buforując zdarzenia i przetwarzając je w tempie akceptowanym przez API bez throttlingu i błędów 429.
- Spójność słowników: kody SKU, jednostki miary i nazwy kategorii ujednolicone przed wdrożeniem
- Pełny cykl zamówienia: złożenie, wysyłka, zwrot, korekta faktury — każda ścieżka przetestowana
- Obsługa limitów API: kolejkowanie zdarzeń, mechanizm retry z backoffem, monitoring throttlingu
- Testy na danych syntetycznych: zero uruchomienia produkcyjnego bez zakończonych testów akceptacyjnych
- 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
Bezpieczeństwo i RODO w integracji Shoper — minimum przed startem
Integracja Shoper z ERP i CRM oznacza przepływ danych osobowych klientów — imion, adresów, historii zakupów, numerów NIP dla B2B. Każdy przepływ musi mieć podstawę prawną, a dane osobowe powinny być przekazywane w zakresie minimalnym — nie kopiujemy do ERP wszystkiego, co widzi Shoper, tylko to, co jest potrzebne do realizacji zamówienia i wystawienia faktury.
Na poziomie technicznym: HTTPS z TLS 1.3 dla wszystkich połączeń, tokeny API poza kodem źródłowym i repozytorium, zakresy dostępu ograniczone do minimum. Logi integracji powinny mieć określony czas retencji i nie zawierać pełnych danych osobowych przy każdym wpisie — wystarczy ID zamówienia i status przepływu.
Przy dostawcy zewnętrznym wymagana jest umowa powierzenia przetwarzania danych. Sprawdź, czy integrator ma udokumentowane procedury bezpieczeństwa i czy testy prowadzone były na danych syntetycznych, nie produkcyjnych. Więcej o tym w poradniku o bezpiecznej integracji systemów i RODO.
Co konkretnie zyskuje sklep po wdrożeniu integracji
Efekty są mierzalne już w pierwszych tygodniach. Automatyczna synchronizacja zamówień eliminuje ręczne przepisywanie — zamiast kilku godzin pracy operacyjnej dziennie, jeden przepływ danych obsługuje to w minutach. Stany magazynowe w sklepie odpowiadają rzeczywistości, co redukuje sytuacje, w których klient kupuje produkt niedostępny na stanie — jedne z największych kosztów obsługi w e-commerce B2B.
KSeF przestaje być problemem: faktury wystawiane są automatycznie przy każdym zamówieniu, zgodnie z danymi z ERP, i przesyłane do systemu rządowego bez ręcznego eksportu. CRM dostaje automatyczne wpisy o każdym zamówieniu — handlowiec widzi historię zakupów klienta bez pytania operacji o raport. Firma może skalować wolumen zamówień bez proporcjonalnego wzrostu kosztów operacyjnych.
Jeśli prowadzisz sklep Shoper i chcesz ocenić, które procesy warto zautomatyzować najpierw — zacznij od audytu przepływów dla e-commerce lub przejrzyj naszą checklistę oceny integratora systemów, żeby wiedzieć, czego wymagać od dostawcy wdrożenia.