Dlaczego stany magazynowe sklepu i ERP się rozjeżdżają?

12.11.2026 Dodane przez:

Różnica w stanach nie zawsze oznacza awarię synchronizacji. Jak prześledzić produkt od ERP do sklepu, znaleźć przyczynę rozjazdu i sprawdzić poprawkę na całym procesie.

Różny stan produktu w sklepie i ERP nie zawsze oznacza awarię synchronizacji. Systemy mogą pokazywać inne magazyny, inaczej traktować rezerwacje albo porównywać dane z różnych momentów. Diagnozę warto zacząć od jednego produktu i konkretnego zdarzenia. Dopiero wtedy można ustalić, czy problem leży w powiązaniu towaru, regule dostępności, przekazaniu zamówienia czy zapisie danych w sklepie.

W integracjach PrestaShop z ERP, WAPRO lub pośrednikiem takim jak Base sprzedawca często widzi tylko końcowy objaw: „na magazynie jest, a w sklepie nie ma” albo „sklep sprzedał produkt, którego już nie było”. Obie sytuacje mogą mieć różne przyczyny. Zwiększenie częstotliwości synchronizacji bez ich rozpoznania potrafi jedynie częściej zapisywać niewłaściwą wartość.

Najpierw ustalmy, co porównujemy

Słowo „stan” może oznaczać liczbę sztuk fizycznie na półce, ilość zarezerwowaną dla zamówień lub ilość dostępną do sprzedaży. Dochodzą do tego magazyny, kanały sprzedaży, zestawy, warianty i ewentualny zapas bezpieczeństwa. Dwie poprawne liczby mogą być różne, jeżeli opisują inne rzeczy.

Przykład obliczeniowy: magazyn ma 12 sztuk, 3 są zarezerwowane, a sprzedawca chce zachować 1 sztukę bufora. Przy takiej uzgodnionej regule sklep powinien otrzymać 8 sztuk. To przykładowa polityka sprzedaży, nie domyślna formuła każdej integracji. Jeżeli ERP przekazuje już ilość pomniejszoną o rezerwacje, ponowne odjęcie tych samych rezerwacji w integratorze zaniży dostępność.

W PrestaShop warto odróżnić ilość dostępną od pól ilości fizycznej i zarezerwowanej. Dokumentacja opisuje te relacje w Stock FAQ. Zachowanie trzeba sprawdzać dla używanej wersji sklepu, modułów i procesu zamówienia. Samo dodanie produktu do koszyka nie powinno być automatycznie utożsamiane z rezerwacją w ERP.

Jeden produkt, wariant i sklep zamiast całego katalogu

Do pierwszej analizy wybierz produkt, dla którego da się odtworzyć historię. Zapisz jego identyfikator w ERP, identyfikator w sklepie, wariant i kanał sprzedaży. Nazwa produktu jest pomocna człowiekowi, ale nie powinna być jedynym kluczem łączącym systemy.

W jednym z naszych wdrożeń integratora trzeba było jawnie powiązać identyfikator katalogowy z indeksem towaru w WAPRO. Były to różne oznaczenia pełniące inne funkcje. To ważna lekcja: jednakowy opis nie dowodzi, że synchronizacja dotyczy właściwej pozycji magazynowej.

PrestaShop udostępnia stan w kontekście produktu, kombinacji oraz sklepu lub grupy sklepów. Te pola widać w opisie zasobu stock_availables. W multistore trzeba więc ustalić nie tylko „który produkt”, ale też „dla którego sklepu i wariantu”. Sprawdź również, czy dana grupa współdzieli stany, zanim potraktujesz różnicę między sklepami jako błąd.

Kto jest źródłem dostępności?

Przydatna jest krótka mapa odpowiedzialności. Na przykład ERP ustala ilość do sprzedaży, integrator przelicza ją według zatwierdzonej reguły, a sklep publikuje wynik. Osobno można określić źródło opisów, cen oraz zdjęć. Nie wszystkie informacje muszą pochodzić z jednego systemu.

Problem zaczyna się wtedy, gdy ten sam stan zapisują dwa niezależne procesy. Ręczna korekta, importer pliku i integracja ERP mogą kolejno nadpisywać swoje wyniki. W logu będzie widać udane operacje, a na stronie wartość nadal będzie się zmieniać w niezrozumiały sposób.

W rzeczywistym wdrożeniu obsługiwaliśmy także sklep, dla którego wyłączono integrację WAPRO, ale nadal potrzebna była dostępność z innego źródła. Dodaliśmy osobną opcję pobierania stanów dostępną przy wyłączonej integracji ERP. Ten przypadek pokazuje, dlaczego wyłączenie przepływu zamówień i wybór źródła dostępności nie powinny być traktowane jako jedno ustawienie. Nie oznacza to, że wszystkie sklepy powinny korzystać z tej samej reguły.

Prześledź drogę jednej zmiany

Zbierz spójną oś czasu. Przykładowe godziny poniżej są ilustracją diagnostyki, nie wynikiem pomiaru konkretnego klienta:

  1. O 10:00 ERP zapisuje zmianę ilości dostępnej do sprzedaży.
  2. O 10:02 integrator pobiera wartość i przypisuje ją do produktu oraz sklepu.
  3. O 10:03 wysyła aktualizację, a system docelowy potwierdza jej przyjęcie.
  4. O 10:04 odczyt kontrolny sprawdza faktyczny zapis w sklepie.
  5. O 10:05 porównujemy panel, stronę produktu i możliwość zamówienia.

Jeżeli dane zatrzymują się przed pobraniem, sprawdzamy źródło, harmonogram i uprawnienia. Jeżeli integrator odczytał dobrą wartość, ale wysłał inną, analizujemy mapowanie oraz przeliczenie. Jeżeli zapis w sklepie jest poprawny, a strona pokazuje coś innego, sprawdzamy sposób prezentacji i cache. Potwierdzenie żądania API nie zastępuje odczytu kontrolnego ani testu koszyka.

W logu diagnostycznym przydają się czas i strefa czasowa, identyfikator operacji, produkt, wariant, sklep, wartość wejściowa, wynik przeliczenia oraz odpowiedź systemu docelowego. Nie trzeba w tym celu kopiować danych kupującego ani całej treści zamówienia.

Zamówienie w integratorze nie musi być zamówieniem w ERP

Przepływ zamówień wpływa na rezerwacje i dostępność, dlatego trzeba sprawdzić go równolegle. W naszym integratorze pobranie zamówienia ze sklepu oraz wysłanie go do WAPRO są odrębnymi etapami. Widoczność w pierwszym panelu nie dowodzi zakończenia drugiego etapu.

W innym potwierdzonym scenariuszu pracownik szybko zmieniał status zamówienia na wysłane. Proces pobierający nie zawsze zdążył wcześniej zobaczyć status przewidziany w konfiguracji. Rozdzieliliśmy więc wybór statusów do pobrania od decyzji, czy zmieniać status po imporcie. Dzięki temu można było pobrać także zamówienia wysłane bez cofania ich statusu. Nie jest to dowód, że każdy rozjazd stanów wynika ze statusów, lecz przykład reguły procesu wymagającej sprawdzenia.

Powtórzenia, opóźnienia i aktualizacje w złej kolejności

Przy analizie integracji warto ustalić, czy zapis oznacza „ustaw aktualną ilość na 8”, czy „zmniejsz o 2”. Ponowienie tych operacji ma inne skutki. Trzeba też sprawdzić, czy opóźniona starsza aktualizacja może nadpisać nowszy stan oraz jak identyfikowane są przetworzone zamówienia.

To scenariusze do zbadania, nie deklaracja, że wystąpiły w każdym opisywanym wdrożeniu. Sposób obsługi duplikatów, kolejności i ponowień powinien wynikać z faktycznej implementacji. Sam napis „synchronizacja dwukierunkowa” nie wyjaśnia, co stanie się po przerwanym połączeniu lub ponownym wysłaniu danych.

Dlaczego ręczna korekta pomaga tylko na chwilę?

Jeżeli automat ponownie pobierze błędne dane albo użyje niewłaściwej reguły, ręczna zmiana w sklepie zostanie nadpisana. Przed korektą warto zachować historię i ustalić, który proces ma prawo zapisywać stan. W pilnej sytuacji można uzgodnić tymczasowe ograniczenie sprzedaży konkretnej pozycji, zamiast masowo ustawiać zapas całego katalogu.

Nie zalecamy naprawiania problemu przez bezpośrednie aktualizowanie przypadkowych tabel SQL na produkcji. Można w ten sposób pominąć logikę sklepu, modułów i historię zmian. Najpierw identyfikujemy przyczynę, potem dobieramy obsługiwany sposób korekty i sprawdzamy wynik.

Jak sprawdzić poprawkę przed jej odbiorem?

  • Mapowanie: produkt prosty, wariant oraz pozycja bez powiązania nie trafiają do niewłaściwego towaru.
  • Zakres: zmiana dotyczy właściwego magazynu, sklepu i grupy współdzielenia.
  • Pełny cykl: nowe zamówienie, płatność, wysyłka i anulowanie mają uzgodniony wpływ na dostępność.
  • Ponowienie: powtórzenie tej samej operacji nie zmienia wyniku wbrew ustalonej regule.
  • Kolejność: starsze dane nie przywracają nieaktualnej ilości bez wykrycia konfliktu.
  • Wyjątki: zero, zwrot, ręczna korekta oraz wyłączenie jednego źródła mają opisane zachowanie.
  • Obserwacja: po kolejnym pełnym cyklu synchronizacji poprawna wartość nadal jest widoczna, a błąd przekazania trafia do osoby odpowiedzialnej.

Test wykonujemy na uzgodnionym środowisku i danych. Jeżeli nie ma testowego ERP, trzeba wcześniej określić, które działania nie utworzą rzeczywistych dokumentów, płatności ani wiadomości do klientów. Plan sprawdzania zmian opisujemy także w poradniku testowania sklepu przed wdrożeniem.

Co przygotować do zgłoszenia problemu?

Wystarczą na początek identyfikatory przykładowego produktu i wariantu, właściwy sklep oraz magazyn, oczekiwana i widoczna ilość, czas zdarzenia i opis ostatniej operacji. Dodaj informację o używanych wersjach oraz o tym, które moduły mogą zapisywać dostępność. Sekrety i dane klientów przekażemy wyłącznie uzgodnionym bezpiecznym kanałem, jeśli rzeczywiście będą potrzebne do diagnozy.

Zobacz realizację integratora PrestaShop i WAPRO oraz case study rozwoju integracji w Laravel. Pomagamy diagnozować istniejące połączenia w ramach wsparcia technicznego sklepów, a nietypowe procesy rozwijamy jako dedykowane aplikacje i integracje. Jeśli Twój sklep działa na PrestaShop, zobacz Support PrestaShop. Opisz, w którym miejscu dane zaczynają się różnić. Na tej podstawie ustalimy pierwszy zakres analizy.

O autorze

Leszek Iwaniec jest właścicielem Projectic. Zajmuje się wdrożeniami sklepów internetowych, aplikacjami dedykowanymi i wsparciem technicznym. Na blogu opisuje problemy oraz rozwiązania związane z PrestaShop, Laravel i integracjami systemów. Materiały opierają się na doświadczeniach z projektów zespołu.

Powrót