Stock sync

Stock sync to osobna, lżejsza ścieżka dla samych zmian stanu magazynowego. Tam gdzie offer sync wysyła ponownie cały rekord oferty, stock sync używa dedykowanego endpointu magazynowego Mirakl, który aktualizuje wyłącznie dostępną ilość. Zużywa mniej limitu API operatora i działa szybciej, więc zmiany stanu zwykle docierają do Mirakl w ciągu kilku sekund.

Automatyczna synchronizacja stanu

W normalnych ruchach magazynowych nie musisz nic klikać. Gdy stan produktu zmienia się w Shopware — niezależnie od tego, czy edytowałeś go ręcznie, czy obniżyło go zamówienie, czy stan wrócił przez zwrot — plugin oznacza powiązanie oferty jako wymagające wysłania stanu i wysyłka wykonuje się w tle w ciągu kilku sekund.

W praktyce: sprzedajesz sztukę, stan w Shopware spada, a Mirakl pokazuje nową ilość niemal natychmiast.

Zabezpieczenie zaplanowane

Na wypadek pominiętego zdarzenia (awaria workera, restart, zmiana konfiguracji) plugin również okresowo sprawdza kolejkę. Domyślnie sprawdzenie odbywa się co 15 minut. Wartość można zmienić na 2, 5, 10, 15, 30 lub 60 minut w polu Stock Sync Interval w Mirakl → Settings → Sync.

Synchronizacja ręczna

Z Dashboard → Quick Actions → Sync Stock Now — uruchamia pełną synchronizację stanu dla wybranego połączenia od razu (tą samą drogą co planowane sprawdzenie).

Gdzie skonfigurować

Mirakl → Settings → Sync, sekcja Sync Settings:

• Enable Stock Sync — główny przełącznik. Domyślnie: włączony.
• Stock Sync Interval — jak często budzi się planowane zabezpieczenie. Domyślnie: 15 minut.

Nie ma osobnego przełącznika per połączenie. Aby tymczasowo wyłączyć synchronizację stanu dla jednego połączenia, wstrzymaj je po stronie operatora albo zdezaktywuj jego powiązania ofert.

Gdzie widzisz wartość stanu

Wartości stanu wysyłane do Mirakl widać w kolumnie In Stock na Offer Mappings (obok Available, które dodatkowo uwzględnia jednostki już zarezerwowane). Po zmianie stanu możesz tam zweryfikować efekt synchronizacji.

Wskazówki i pułapki

Wskazówka

Nie wyłączaj synchronizacji stanu, żeby zaoszczędzić limit operatora — endpoint magazynowy jest jednym z najtańszych, a plugin i tak pomija wysyłki, gdy nic się nie zmieniło. Wyłączenie najczęściej kończy się oversellingiem.

Uwaga

Stock sync nigdy nie wysyła liczb ujemnych — ujemny stan w Shopware staje się zerem na Mirakl. Jeśli używasz ujemnego stanu jako flagi w Shopware, wyraź tę informację przez osobne mapowanie pola oferty (np. pole własne, które przekłada ujemny stan na status tekstowy), a nie przez samą wartość stanu.

Notatka

Stock sync pomija powiązania ofert, których produkt nie trafił jeszcze do katalogu Mirakl (catalog status różny od Exported). Pomija też powiązania, których produkt Shopware został usunięty — takie powiązania przechodzą na Error, żeby można je było uporządkować.

Uwaga

Stan magazynowy i pełne aktualizacje oferty są śledzone osobno. Jeśli zapis w Shopware zmienił jednocześnie cenę i stan, plugin wyśle aktualizację stanu przez stock sync oraz aktualizację oferty przez offer sync. Nie musisz wybierać — obie ścieżki działają.

Powiązane tematy

• Offer sync — pełna aktualizacja oferty (cena, czas realizacji, pola własne)
• Mapping offer fields — stan można też wysłać w ramach pełnej aktualizacji oferty przez źródło Effective Stock
• Sync logs
• Background tasks