Shipping Mappings

Gdy wysyłasz zamówienie Mirakl z Shopware, operator oczekuje kodu przewoźnika obok numeru śledzenia — “DHL”, “GLS”, “DPD” lub jakkolwiek lista po stronie operatora to nazywa. Shopware natywnie nie zna listy przewoźników Mirakla, więc wtyczka potrzebuje mapowania: ta metoda wysyłki Shopware → ten kod przewoźnika Mirakl.

Ta strona to miejsce, gdzie definiujesz te mapowania.

Gdzie to znaleźć

Na Dashboard otwórz kartę Quick Start i kliknij kafelek Shipping Mappings. Otworzy to stronę Shipping Mappings.

Co widzisz

Tabela zawiera każde zdefiniowane mapowanie. Kolumny:

Kolumna	Znaczenie
Shipping method	Metoda wysyłki Shopware, do której odnosi się mapowanie.
Scope	Albo Global (all connections), albo Per-connection z konkretnym wybranym połączeniem Mirakl.
Countries	Jeśli mapowanie jest ograniczone do konkretnych krajów, pojawiają się tu.
Default	Czy jest to domyślny fallback dla metod wysyłki bez konkretnego mapowania.
Created	Kiedy mapowanie zostało dodane.

Pasek boczny ma filtry:

• Shipping method — tekst.
• Default — pokaż tylko domyślne fallbacki.
• Scope — filtruj Global vs Per-connection.
• Connections — filtruj po połączeniu Mirakl.
• Countries — filtruj po kraju docelowym.

Jak działa dopasowywanie

Gdy wtyczka musi zgłosić wysyłkę do Mirakla, przechodzi mapowania w tej kolejności:

1. Per-connection pasujące do tego połączenia, tej metody wysyłki i kraju docelowego zamówienia.
2. Per-connection pasujące do tego połączenia i tej metody wysyłki (dowolny kraj).
3. Global pasujące do tej metody wysyłki.
4. Default fallback — mapowanie z ustawioną flagą Default.

Pierwsze dopasowanie wygrywa. Jeśli nic nie pasuje i nie zdefiniowano fallbacku, wtyczka nie może wypchnąć potwierdzenia wysyłki — utwórz Default fallback, żeby tego uniknąć.

Akcje per wiersz

• Edit — modyfikuje mapowanie (metoda wysyłki, scope, kraje, kod przewoźnika).
• Delete — potwierdzenie: “Are you sure you want to delete this mapping?”

Przycisk Create na pasku narzędzi otwiera pusty formularz mapowania.

Wskazówki i pułapki

Wskazówka

Najpierw dodaj mapowanie Default fallback — pojedynczy globalny wiersz oznaczony Default z przewoźnikiem, którym wysyłasz najczęściej. Potem dodawaj overrides per konkretne metody wysyłki lub kraje w razie potrzeby.

Uwaga

Kody przewoźników muszą dokładnie odpowiadać liście operatora. Różni operatorzy Mirakl publikują nieco różne listy — sprawdź dokumentację operatora lub dane referencyjne Carriers w jego panelu przed zapisaniem mapowania.

Notatka

Ustawienie Scope na Per-connection jest przydatne, gdy różni operatorzy na różnych połączeniach Mirakl oczekują różnych kodów przewoźników dla tej samej metody wysyłki Shopware (np. operator A chce “DHL”, operator B chce “DHL_EXPRESS”).

Powiązane

• Order state sync — kiedy potwierdzenia wysyłki docierają do operatora
• Order import — zamówienia przychodzą z wybraną przez operatora strefą wysyłki
• Connections — ustawienia per połączenie