Pierwsza synchronizacja

Na tym etapie powinieneś mieć połączenie ze statusem Connected i odświeżone dane referencyjne — kategorie, atrybuty produktów, pola oferty, statusy oferty i kody powodów. Ta strona przeprowadzi Cię przez minimalny przepływ end-to-end: zmapuj kilka kategorii, zmapuj wymagane atrybuty, wyślij na marketplace małą partię produktów i włącz synchronizację stanów oraz import zamówień.

Wszystkie wymienione strony otwiera się z Dashboard (strony, na której lądujesz po kliknięciu Mirakl w grupie Catalogues w głównym menu). Karta Quick Start na Dashboardzie ma kafelek do każdej strony — w każdym kroku podajemy konkretny kafelek.

Krok 1 — Zmapuj co najmniej jedną kategorię

Marketplace odrzuca oferty w kategoriach, których nie zmapowałeś do kategorii Shopware, więc to pierwszy twardy wymóg.

1. Z karty Quick Start na Dashboardzie kliknij kafelek Categories. Otworzy się Mirakl → Mirakl Categories. Lista pokazuje drzewo kategorii marketplace’u (kolumny: Code, Name, Full Path, Level, Parent Code, Active, Connections).
2. Znajdź kategorię marketplace’u, w której chcesz sprzedawać (przefiltruj po Name albo użyj filtra Filter by Connection w panelu bocznym). Kliknij wiersz, żeby otworzyć stronę Category Details.
3. Przełącz się na zakładkę Mapping.
4. W liście Connection wybierz odpowiedni marketplace (jest wybrany automatycznie, jeśli masz tylko jedno połączenie).
5. Kliknij Add Category. W oknie Add Category Mapping, które się otworzy, wybierz pasującą Shopware Category i zapisz. Mapowanie jest zapisywane od razu i obowiązuje dla każdego produktu, który należy do tej kategorii Shopware.

Mapowanie jest skierowane od strony marketplace’u: jedną kategorię marketplace’u możesz powiązać z kilkoma kategoriami Shopware — wszystko z tej samej strony detalu kategorii marketplace’u. Kolejne kategorie możesz mapować później — plugin nie zgłosi braku mapowania, dopóki nie spróbujesz wysłać produktu, który do takiej kategorii należy.

Wskazówka

Na dużych marketplace’ach (dziesiątki tysięcy kategorii) użyj przycisku Bulk Edit na liście Mirakl Categories, żeby dezaktywować kategorie, w których nigdy nie będziesz sprzedawać. Dezaktywowane kategorie znikają z list wyboru kategorii Shopware w innych miejscach pluginu, dzięki czemu wybór właściwej idzie znacznie szybciej.

Krok 2 — Zmapuj wymagane atrybuty

Każda kategoria marketplace’u ma zestaw atrybutów oznaczonych przez marketplace jako wymagane. Plugin wyróżnia je na stronie mapowań atrybutów.

1. Z karty Quick Start na Dashboardzie kliknij kafelek Attribute Mappings. Otworzy się Mirakl → Attribute Mappings.
2. Kliknij Auto Map. Zadanie w tle próbuje dopasować atrybuty produktu marketplace’u do pól Shopware, pól niestandardowych, grup właściwości i kategorii, porównując nazwy. Postęp pokazuje okno modalne.
3. Przejrzyj zaproponowane mapowania. Wymagane atrybuty, których auto-map nie potrafił rozwiązać, musisz zmapować ręcznie — w przeciwnym razie marketplace odrzuci te produkty.
4. Jeśli Twoje wartości w Shopware nie pokrywają się 1:1 z wartościami akceptowanymi przez marketplace, skonfiguruj Transformation w danym wierszu (zobacz Mapping → Attributes po szczegóły).

Auto Map możesz uruchamiać wielokrotnie — pomija atrybuty, które mają już mapowanie dla wybranego połączenia, więc nie nadpisuje niczego, co edytowałeś ręcznie.

Krok 3 — Wyślij małą partię produktów

Nie wypychaj całego katalogu pierwszego dnia. Wybierz 5–10 reprezentatywnych produktów i zobacz, jak wygląda cały obieg.

1. Z karty Quick Start na Dashboardzie kliknij kafelek Catalog. Otworzy się Mirakl → Product Catalog.
2. Użyj filtrów w panelu bocznym (Status, Connection, Name, Product number, EAN / GTIN), żeby zawęzić listę do garstki produktów z kategorii zmapowanej w kroku 1.
3. Zaznacz checkbox przy każdym wierszu, który chcesz wysłać, a następnie kliknij Export Selected w pasku narzędzi.
4. Jeśli masz więcej niż jedno połączenie, okno Select Connection zapyta, do którego marketplace’u idzie ta partia. Wybierz połączenie i kliknij Continue.
5. Okno postępu pokazuje zadanie w tle. Każdy wybrany produkt trafia do kolejki, a jego Export Status przechodzi przez Pending → Queued → Processing → Exported (albo kończy w Retry lub Error, jeśli coś poszło nie tak).

Marketplace przetwarza partię po swojej stronie; ewentualne błędy per produkt pojawią się w kolumnie Export Status odpowiedniego wiersza, gdy tylko marketplace skończy sprawdzać upload.

Dla produktów odrzuconych przez marketplace popraw przyczynę (zwykle brak wymaganego atrybutu albo kategoria, w której marketplace nie akceptuje takiego typu produktu) i uruchom eksport ponownie.

Krok 4 — Włącz synchronizację stanów

Gdy produkty są już aktywne na marketplace, chcesz, żeby każda zmiana stanu w Shopware była tam automatycznie przekazywana.

1. Otwórz Mirakl → Settings → Sync Settings.
2. Upewnij się, że synchronizacja stanów jest aktywna (domyślnie jest włączona).
3. Przy ustawieniach domyślnych plugin co 15 minut sprawdza, czy któreś produkty miały zmianę stanu, i wysyła nową wartość do marketplace’u.

Nie musisz czekać pełnych 15 minut na jednorazową zmianę — plugin wychwytuje zmianę stanu w momencie, w którym zachodzi w Shopware, i oznacza odpowiednią ofertę, więc najbliższy zaplanowany przebieg ją zabierze.

Krok 5 — Włącz import zamówień

Żeby zamówienia z marketplace’u trafiały do Shopware, włącz import zamówień dla połączenia.

1. Najwcześniejsza data, od której zamówienia są ściągane, jest zapisana w połączeniu — to wartość, którą wybrałeś w kroku 12 kreatora konfiguracji, i możesz ją później zmienić w oknie Edit Connection. Importowane są tylko zamówienia nowsze niż ta data (żeby nie ściągać lat historii).
2. Upewnij się, że import zamówień jest aktywny w Mirakl → Settings → Sync Settings (domyślnie włączony).
3. Przy ustawieniach domyślnych plugin co 30 minut sprawdza marketplace pod kątem nowych zamówień, tworzy dla każdego zamówienie Shopware i wyświetla je na stronie Orders (z karty Quick Start na Dashboardzie → Orders).
4. Z poziomu zamówienia Shopware możesz wysłać, odmówić i napisać do klienta w Shopware — odpowiadające im zmiany statusu Shopware są automatycznie przekazywane z powrotem do marketplace’u (zobacz krok 10 kreatora konfiguracji — Reverse Status Mapping).

Przy pierwszym uruchomieniu importu zamówień dla danego połączenia plugin wystartuje też automatyczne importy wątków wiadomości, dokumentów, faktur i logów transakcji dla tego marketplace’u — szczegóły są w odpowiednich stronach per funkcja.

Co dalej

• Catalog Export — wygeneruj jednorazowy CSV dla kreatora mapowania Mirakla (tylko przy pierwszej konfiguracji).
• Catalog — bieżące zarządzanie katalogiem (Add to Catalog, Export Selected, śledzenie statusów).
• Order import — łańcuchowe importy wiadomości, dokumentów i faktur.
• Sync logs — gdzie zaglądać, gdy coś poszło nie tak.
• Troubleshooting — typowe błędy i sposoby ich rozwiązania.