Wprowadzenie

P2Lab Mirakl to plugin do Shopware 6, który łączy Twój sklep z marketplace’em Mirakl jako konto sprzedawcy. Mirakl to platforma, na której działa wiele dużych marketplace’ów. Interfejs dla sprzedawcy jest po stronie Mirakl ujednolicony, więc plugin działa tak samo, niezależnie od tego, na jakim marketplace sprzedajesz.

Co robi plugin

Plugin dodaje jeden wpis Mirakl w głównym menu Shopware, w grupie Catalogues. Kliknięcie go otwiera Dashboard, który jest punktem startowym dla całej reszty. Z karty Quick Start dostajesz kafelki do wszystkich podstron pluginu:

Settings — trzy zakładki: Connections (gdzie dodajesz marketplace’y i nimi zarządzasz), Sync (włączasz i wyłączasz poszczególne synchronizacje oraz dostosowujesz ich częstotliwość) i Options (ile czasu trzymać logi i jak szczegółowe mają być).
Categories, Product Attributes, Offer Fields, Offer States, Reason Codes — dane referencyjne marketplace’u, pobierane na żądanie albo przez kreator konfiguracji.
Attribute Mappings i Offer Field Mappings — tu mówisz pluginowi, jak Twoje dane z Shopware mają wypełniać pola marketplace’u. Obie strony potrafią same proponować mapowania i pozwalają zapisać lub wgrać ustawienia jako plik.
Catalog (zwany też Product Catalog) — produkty Shopware, które wybrałeś do wysłania na marketplace, każdy z własnym statusem eksportu (Pending, Queued, Processing, Exported, Retry, Error).
Offers — Twoje aktywne oferty w marketplace’ach wraz z bieżącym stanem synchronizacji.
Orders — zamówienia z Mirakl, które zostały zamienione na zamówienia Shopware. Każde ma własne zakładki Overview i Customer; wiadomości, dokumenty, faktury i logi transakcji są dostępne z osobnych stron.
Logs i API Logs — wpisy z każdej zaplanowanej synchronizacji oraz każdej wymiany z marketplace’em, ze szczegółami żądania i odpowiedzi.

W tle plugin uruchamia zestaw zaplanowanych zadań, które zajmują się rutynową pracą: wysyłają katalog produktów, przekazują aktualizacje stanów i cen, importują zamówienia, pobierają wiadomości i dokumenty oraz ściągają faktury i logi transakcji. To, które z tych zadań są aktywne i jak często się uruchamiają, ustawiasz w Mirakl → Settings → Sync.

Dla kogo jest ten plugin

Sprzedawcy wielokanałowi, którzy już prowadzą sklep w Shopware i chcą rozszerzyć działalność o marketplace Mirakl bez przepisywania katalogu od zera.
Zespoły operacyjne obsługujące zamówienia z Shopware i z jednego lub kilku marketplace’ów, które chcą wysyłać, odmawiać i pisać do klientów z jednego panelu.
Agencje wdrażające klientów do marketplace’ów Mirakl, szukające powtarzalnego procesu prowadzonego przez kreator zamiast jednorazowych importów CSV.

Plugin jest zbudowany konkretnie pod marketplace’y Mirakl — nie jest ogólnym konektorem do marketplace’ów — i zakłada, że masz już zaakceptowane konto sprzedawcy w marketplace, do którego chcesz się podłączyć.

Co musisz mieć

Shopware 6.6 — plugin jest przygotowany dla linii 6.6.
Działający proces w tle dla wiadomości (worker) — plugin używa zadań w tle dla wszystkiego, co trwa dłużej niż kilka sekund (zobacz Installation, tam są komendy).
Działający proces uruchamiający zaplanowane zadania (scheduled task runner) — bez niego cykliczne synchronizacje (stany, zamówienia itd.) nie uruchomią się same.
Konto sprzedawcy Mirakl w co najmniej jednym marketplace, razem z adresem internetowym marketplace’u, kluczem API sprzedawcy oraz numerem sklepu (Shop ID).

Co dostajesz bez dodatkowej konfiguracji

Długie zadania wznawiają się same. Wysłanie dużego katalogu albo import tysięcy zamówień historycznych jest dzielony na partie, a kolejna partia podejmowana jest automatycznie. Jeśli zadanie zostanie przerwane, przy najbliższej okazji ruszy od miejsca, w którym się zatrzymało.
Wbudowana obsługa limitów żądań. Gdy marketplace prosi plugin o zwolnienie tempa, plugin czeka tyle, ile marketplace zażądał, i próbuje ponownie — nie musisz nic ustawiać.
Każdy marketplace jest osobno. Kategorie, atrybuty i mapowania są zapisywane per Connection, więc ta sama kategoria Shopware może mapować się na zupełnie różne kategorie u różnych operatorów bez żadnego konfliktu.
Pełny zapis każdej akcji. Każda synchronizacja i każda wymiana z marketplace’em jest zalogowana z żądaniem, odpowiedzią, statusem i czasem trwania.