# Integracja WMS z platformami e-commerce - Allegro, BaseLinker, Shoper

> Integracja WMS z platformami e-commerce - podział ról, punkty integracji, BaseLinker przez API, unikanie nadsprzedaży i duplikatów zamówień.

Adres strony: https://magazyn.softwarestudio.com.pl/integracja-wms-e-commerce/

---

Integracja WMS z e-commerce ujednolica stany magazynowe dla sklepu sprzedającego przez kilka kanałów jednocześnie. Bez niej rozbieżności między platformą a magazynem kończą się anulowanym zamówieniem lub nadsprzedażą. Wyjaśniamy podział ról, punkty integracji i najczęstsze pułapki techniczne.
Handel elektroniczny rzadko prowadzony jest dziś przez jeden kanał. Ten sam towar bywa wystawiony na Allegro, w sklepie na platformie Shoper oraz na kolejnych marketplace, a wszystkie te kanały muszą widzieć ten sam, aktualny stan magazynowy. Integracja systemu WMS z platformą sprzedażową porządkuje ten przepływ danych i chroni przed sytuacją, w której dwóch klientów kupuje ostatnią sztukę towaru.

## Architektura integracji czyli kto tu rządzi

Wymiana danych między systemami w handlu elektronicznym wymaga jasnego podziału ról. W poprawnie zaprojektowanym środowisku integracja WMS z e-commerce opiera się na rozdzieleniu odpowiedzialności - WMS jest nadrzędnym źródłem wiedzy o stanach (master stanów), natomiast platforma sprzedażowa lub system ERP odpowiada za agregację i zarządzanie zamówieniami (master zamówień).

Dlaczego taki układ decyduje o powodzeniu operacji? System WMS operuje na rzeczywistości fizycznej - zna informacje o uszkodzeniach towaru podczas zbiórki, rezerwacjach na stanowiskach pakowania czy chwilowym zablokowaniu partii przez dział kontroli jakości. Platforma sprzedażowa skupia się natomiast na interakcji z klientem, marketingu i procesie płatności. Próba zarządzania stanami bezpośrednio z poziomu panelu sklepu przy dużym wolumenie wysyłek zawsze prowadzi do błędów. Dokładność samych stanów i poziomy ich widoczności opisuje strona o [stanach magazynowych](/stany-magazynowe/).

### Podział ról w architekturze systemowej

| Funkcja w procesie logistycznym | Platforma e-commerce / integrator | System klasy WMS |
| --- | --- | --- |
| Zarządzanie zamówieniami | Master - przyjmuje wpłaty, agreguje koszyki z różnych kanałów | Slave - pobiera gotowe zlecenia do realizacji fizycznej |
| Stany magazynowe | Slave - prezentuje stany dla klientów w celach zakupowych | Master - zna dokładną fizyczną i logiczną dostępność towaru |
| Logistyka i wysyłka | Przekazuje wybrane przez klienta formy dostawy | Generuje paczki, mapuje kurierów, weryfikuje wagę gabarytową |

WMS jako master stanów

System zna rzeczywistą dostępność towaru i odsyła ją do platformy, dzięki czemu wszystkie kanały sprzedaży prezentują spójny stan.

## Podstawowe punkty integracji w procesie omnichannel

Płynny przepływ informacji wymaga automatyzacji wymiany danych między systemami. Zamiast opisywać kolejność operacji, warto wskazać, jakie kategorie danych krążą między WMS a platformą sprzedażową - to one definiują zakres integracji. Jednolitą identyfikację jednostek wysyłkowych, po której partnerzy rozpoznają nośnik w wymianie danych, opisuje [standard SSCC organizacji GS1](https://gs1pl.org/standardy/sscc/).

- Kartoteki i identyfikatory SKU - wspólny słownik towarów, po którym oba systemy uzgadniają, którego produktu dotyczy zamówienie i stan.
- Zamówienia klientów - dane koszyka, adres dostawy oraz wybrana forma wysyłki przekazywane z platformy do WMS.
- Stany magazynowe - dostępność towaru wyliczana przez WMS i odsyłana do wszystkich kanałów sprzedaży.
- Dane wysyłkowe i statusy - numery przesyłek, etykiety przewoźników oraz statusy realizacji wracające do platformy.
- Zwroty i korekty - informacje o przyjętych zwrotach, które uruchamiają korektę faktury i aktualizację stanu.

Szczegółowy, operacyjny przebieg pojedynczego zamówienia opisuje sekcja instrukcji w dalszej części artykułu.

Sam dokument wydania, jego przygotowanie i kontrola wagi to temat strony o [wydaniu magazynowym](/wydanie-magazynowe/), a proces pobierania pozycji opisuje strona o [kompletacji towaru](/kompletacja-towaru-na-magazynie/). Zamówienia składane przez klienta przez Internet porządkuje z kolei strona o [składaniu zamówień online](/webordering/).

Import zamówienia jako WZ

Zamówienie z platformy trafia do WMS jako dokument wydania, z którego system buduje listę zbiórki i przygotowuje wysyłkę.

## Specyfika integracji z systemem BaseLinker przez API

BaseLinker pełni w polskim e-commerce rolę centralnego węzła komunikacyjnego, łączącego dziesiątki kont Allegro, sklepów Shoper, Erli czy Amazon. Integracja systemu WMS bezpośrednio z API BaseLinkera to najbardziej efektywne rozwiązanie, ponieważ eliminuje potrzebę budowania osobnych wtyczek dla każdego marketplace z osobna.

Komunikacja odbywa się zwykle dwukierunkowo, przy użyciu webhooków oraz cyklicznych zapytań API. WMS nie musi nieustannie pytać serwerów BaseLinkera o nowe zamówienia, co mogłoby przeciążyć architekturę sieciową. Zamiast tego BaseLinker wysyła natychmiastowe powiadomienie, czyli webhook, w momencie gdy zamówienie zmieni status na zdefiniowany jako gotowy do realizacji, na przykład do pakowania.

W drugą stronę WMS przesyła do BaseLinkera aktualne stany w odniesieniu do unikalnych identyfikatorów SKU. BaseLinker działa wtedy jako przekaźnik, który dystrybuuje te dane dalej - podnosi lub obniża zapas na powiązanych aukcjach Allegro i w sklepach Shoper, dbając o spójność danych w całym ekosystemie. Podstawy działania samego systemu opisuje strona o [systemie WMS](/system-wms/), a model obsługi wielu nadawców i odbiorców - strona o [logistyce 3PL](/3pl-co-to/).

## Najczęstsze pułapki techniczne i jak ich unikać

Mimo zaawansowanej technologii i stabilnych interfejsów API integracja systemów niesie ryzyka operacyjne, które mogą zakłócić pracę magazynu w okresach szczytów sprzedażowych.

### Duplikaty zamówień

Zjawisko to występuje najczęściej, gdy serwer platformy ma opóźnienie w odpowiedzi (API timeout). WMS wysyła zapytanie o pobranie paczki danych, nie otrzymuje potwierdzenia w wyznaczonym czasie, na przykład 30 sekund, i ponawia próbę. Jeśli systemy nie mają mechanizmów weryfikacji unikalności, w bazie WMS mogą pojawić się dwa identyczne zamówienia, co doprowadzi do podwójnej zbiórki i wysyłki tego samego towaru.

> Rozwiązanie. WMS musi bezwzględnie weryfikować unikalność każdego importowanego dokumentu na podstawie zewnętrznego identyfikatora zamówienia, na przykład order_id z systemu BaseLinker. Jeśli identyfikator już istnieje w bazie, system powinien odrzucić duplikat.

### Opóźnienia synchronizacji i wyścigi danych

W okresach takich jak Black Friday opóźnienia w odświeżaniu danych przez API mogą wynosić od kilku do kilkunastu minut. Jeśli na magazynie fizycznie znajduje się ostatnia sztuka popularnego produktu, a w tym samym momencie zamówienie na nią złoży klient na Allegro oraz klient w sklepie Shoper, powstaje konflikt. Zanim WMS przetworzy pierwsze zamówienie i odeśle zaktualizowany stan zerowy, drugi klient zdąży dokonać zakupu.

Aby ograniczyć ryzyko nadsprzedaży, stosuje się bufory bezpieczeństwa w konfiguracji WMS. Dla towarów o niskiej dostępności system celowo raportuje do kanałów internetowych stan pomniejszony o określoną wartość. Jeśli na magazynie są 2 sztuki, do Allegro wysyłana jest informacja o 0 sztuk, dzięki czemu opóźnienie synchronizacji nie prowadzi do sprzedaży tej samej sztuki dwóm klientom.

### Obsługa błędów walidacyjnych

Klienci sklepów internetowych często popełniają błędy podczas wprowadzania danych adresowych - wpisują zbyt długie nazwy firm, pomijają cyfry w numerach telefonów lub błędnie formatują kody pocztowe. Jeśli system e-commerce przepuści takie zamówienie, może ono zablokować proces importu do WMS lub uniemożliwić automatyczne wygenerowanie listu przewozowego u kuriera.

Prawidłowo zaprojektowana integracja nie może przerywać działania całej kolejki importu z powodu jednego błędnego rekordu. Zamówienia niespełniające walidacji powinny być automatycznie oznaczane flagą i kierowane do cyfrowej strefy kwarantanny w WMS. Pozwala to pracownikom biura obsługi klienta na szybką, ręczną korektę danych bez wstrzymywania pracy operacyjnej magazynu.

Strefa kwarantanny zamówień

Zamówienia z błędnymi danymi trafiają do osobnej kolejki, gdzie biuro obsługi koryguje je ręcznie, nie blokując importu pozostałych zleceń.

## Jak przebiega obsługa zamówienia e-commerce w integracji z WMS

Poniższa instrukcja porządkuje pełny cykl obsługi zamówienia złożonego przez Internet - od importu do systemu, po obsługę ewentualnego zwrotu. Każdy krok jest zautomatyzowany i potwierdzany danymi w systemie.

1. Import zamówienia do WMSPo weryfikacji płatności zamówienie z platformy e-commerce trafia automatycznie do WMS jako dokument wydania zewnętrznego WZ.
2. Aktualizacja stanów w kanałachPo zbiórce lub spakowaniu paczki WMS odsyła do platformy zaktualizowany stan, który zmniejsza dostępność we wszystkich kanałach sprzedaży.
3. Generowanie listu przewozowegoPo zważeniu paczki WMS komunikuje się z przewoźnikiem, generuje etykietę i odsyła numer śledzenia do systemu e-commerce.
4. Powiadomienie klienta o wysyłcePlatforma e-commerce na podstawie numeru śledzenia automatycznie powiadamia klienta o nadaniu przesyłki.
5. Obsługa zwrotuOdesłany towar po weryfikacji jakościowej jest przyjmowany do WMS, a sygnał do platformy uruchamia korektę faktury i zwrot środków.

Tak zautomatyzowany przepływ sprawia, że obsługa zamówień omnichannel nie zależy od ręcznego przepisywania danych między panelami. System pilnuje unikalności importów, spójności stanów oraz statusów wysyłki, a pracownik magazynu skupia się na fizycznej realizacji zleceń. Zewnętrzne poziomy referencyjne dla miar takich jak dokładność realizacji zamówień publikuje [badanie DC Measures prowadzone przez WERC](https://werc.org/page/ASSESS-DC_Measures).

## Pytania o integrację WMS z e-commerce

## Baza wiedzy - pojęcia integracji e-commerce

Terminy, które pojawiają się przy łączeniu systemu WMS z platformami sprzedażowymi.