Offer sync

Offer sync utrzymuje ceny i pola na poziomie oferty na Mirakl zgodne z Shopware. Tam gdzie catalog export tworzy produkt na Mirakl, offer sync tworzy i aktualizuje ofertę — wpis sprzedawcy z ceną, czasem realizacji, stanem (condition) itd.

Strony

Offer Mappings (Quick Start → Offers) — wszystkie powiązania produkt Shopware ↔ oferta Mirakl. Kolumny: Product, In Stock, Available, Mirakl Price, Mirakl Offer ID, Mirakl Product SKU, Catalog Status, Status, Last Synced, Connection. Listę można filtrować po Status, Connection, Name, Product number, EAN / GTIN.
Product Catalog (Quick Start → Catalog) — ten sam mechanizm zaznaczania, tylko od strony produktu. Przydatne, gdy właśnie dodałeś produkty i chcesz wykonać eksport do katalogu i utworzenie oferty za jednym zamachem.

Dodawanie ofert

Na Offer Mappings przycisk Add Offers w pasku narzędzi otwiera menu z dwoma opcjami:

Add Products — otwiera stronę Add Products to Mirakl. Wybierz połączenie i zaznacz produkty Shopware, które mają zostać dołączone jako nowe oferty. Produkty, których nie ma jeszcze w katalogu, są oznaczone tooltipem — najpierw musisz przepuścić je przez katalog.
Link Existing — otwiera stronę Mirakl Offers. Pokazuje oferty, które już istnieją po stronie operatora, i pozwala powiązać je z odpowiadającymi produktami Shopware (przydatne po migracji albo gdy oferty powstały poza tym pluginem).

Synchronizacja ręczna

Z Offer Mappings:

Menu kontekstowe wiersza → Sync Now — synchronizuje to jedno powiązanie natychmiast.
Zaznacz wiersze + pasek narzędzi → Sync Selected — synchronizuje wiele powiązań naraz. Lista pokazuje potwierdzenie, że synchronizacja została dodana do kolejki dla wybranej liczby.

Z Dashboard → Quick Actions → Sync All Offers — synchronizuje wszystkie powiązania czekające w kolejce dla wybranego połączenia.

Synchronizacja automatyczna

W codziennej pracy nie musisz nic klikać. Gdy zapisujesz produkt Shopware, plugin sprawdza, czy zmiana dotyczyła pola powiązanego z polem oferty Mirakl (cena, stan magazynowy, pole własne wpięte w pole oferty). Jeśli tak, odpowiednie powiązanie oferty zostaje oznaczone do aktualizacji i synchronizacja uruchamia się w tle w ciągu kilku sekund od zapisu.

Okresową ponowną synchronizację wszystkiego (na przykład po edycji globalnego przekształcenia wartości) wykonujesz przyciskiem Dashboard → Quick Actions → Sync All Offers.

Co oznacza kolumna Status

Kolumna Status na Offer Mappings przechodzi przez:

Pending — świeżo utworzone, czeka na pierwsze wysłanie.
Queued — wysłane do procesu w tle, czeka na uruchomienie.
Processing — wgrywanie w toku.
Synced — ostatnie wgranie zostało zaakceptowane przez Mirakl.
Retry — ostatnia próba nie powiodła się chwilowo (problem sieci, przeciążenie operatora); plugin spróbuje ponownie.
Error — ostatnia próba nie powiodła się w sposób, który wymaga Twojej uwagi.

Nieudane usunięcie ma własny stan wyświetlany w wierszu: Removing from Mirakl podczas wycofywania oferty i Removal failed, gdy wycofanie się nie udało. W takiej sytuacji dostajesz dwie akcje:

Retry removal — ponawia próbę wycofania.
Reset Mapping — czyści stan niepowodzenia i ustawia powiązanie z powrotem na Pending. Oferta nie jest usuwana z Mirakl — następna synchronizacja wyśle ją ponownie. Użyj, gdy usunięcie się nie powiodło, ale zdecydowałeś, że oferta ma jednak pozostać aktywna.

Gdzie skonfigurować

Mirakl → Settings → Sync, sekcja Sync Settings:

Offer Sync Batch Size — ile ofert trafia do jednego wgrania. Domyślnie: 50. Dozwolony zakres 1–500. Niższe wartości oszczędzają pamięć i zmniejszają ryzyko przekroczenia czasu; wyższe szybciej przetwarzają duże katalogi.

Offer sync nie ma głównego przełącznika w obecnych ustawieniach — działa automatycznie przy zapisach produktów i ręcznie z przycisków powyżej. Zmiany dotyczące wyłącznie stanu magazynowego mają własne zadanie zaplanowane (zobacz Stock sync).

Wskazówki i pułapki

Powiązane tematy

Stock sync — osobna, lżejsza ścieżka dla samych zmian stanu magazynowego
Mapping offer fields
Mapping offer states
Sync logs
Background tasks