Order import

Order import to strona przychodząca integracji. Sprawdza u operatora nowe i zmienione zamówienia, tworzy je jako zamówienia Shopware, a podczas pierwszego uruchomienia pobiera również wszystko, co jest z tymi zamówieniami powiązane (wiadomości, dokumenty, faktury, logi transakcji).

Import zaplanowany (domyślny)

W codziennej pracy nie musisz nic robić. Domyślnie plugin sprawdza każde aktywne połączenie pod kątem nowych zamówień co 30 minut (do wyboru: 2, 5, 10, 15, 30 lub 60 minut w Order Import Interval w Mirakl → Settings → Sync).

Przy każdym uruchomieniu, dla każdego połączenia z włączonym importem zamówień:

1. Plugin pyta operatora o zamówienia, które zmieniły się od ostatniego pomyślnego sprawdzenia.
2. Każde zwrócone zamówienie Mirakl staje się zamówieniem Shopware:
   • Jeśli pasujące zamówienie Shopware jeszcze nie istnieje, jest tworzone w kanale sprzedaży połączenia.
   • Jeśli już istnieje, jego status Mirakl i zapisane dane są odświeżane.
3. Następne sprawdzenie zaczyna od miejsca, w którym poprzednie skończyło, więc te same zamówienia nie są przetwarzane ponownie.

Pełny import ręczny

Z Dashboard → Quick Actions → Import Orders Now — uruchamia jednorazowy import dla wybranego połączenia od razu. Przydatne, gdy właśnie zmieniłeś mapowania i chcesz zweryfikować wynik, albo gdy cofnąłeś datę początkową importu.

Pierwsze uruchomienie: pobierane są również dane powiązane

Przy pierwszym imporcie zamówień plugin uruchamia łańcuchowo cztery dodatkowe importy:

• Wiadomości zamówień — wszystkie wątki wiadomości dla zaimportowanych zamówień.
• Dokumenty zamówień — wszystkie dokumenty dołączone do tych zamówień.
• Faktury — wszystkie faktury operatora w zakresie.
• Logi transakcji — wszystkie zapisy transakcji.

Każdy z tych importów uruchamia się w tle z własnym postępem. Po tym pierwszym przejściu każdy z tematów obsługuje własne zadanie zaplanowane (zobacz Order messages, Order documents, Invoices, Transaction logs).

Jak daleko wstecz importować — data początkowa importu

Decydujesz per połączenie, jak daleko ma sięgać pierwszy import zamówień:

• Kreator konfiguracji, krok 12 (Import Orders) — wybierz Import all historical orders (bez filtra daty) albo Import orders from a specific date z polem daty. Kliknięcie Next zapisuje wybór na połączeniu i od razu uruchamia pierwszy import.
• Trzeba zmienić to później? Otwórz kreator z Mirakl → Settings → Connections → menu kontekstowe wiersza → Run Setup Wizard, a następnie przeskocz do kroku Import Orders.

Najbezpieczniejszy wybór to dzień przed startem Twojego konta u operatora. Wcześniejsze daty mogą wyciągnąć lata historycznych zamówień, które operator mógł zostawić w stanie roboczym — takie zamówienia zwykle nie tworzą się czysto, bo produkty, do których się odwołują, już do niczego nie pasują w Twoim sklepie.

Gdzie skonfigurować

Mirakl → Settings → Sync, sekcja Sync Settings:

• Enable Order Import — główny przełącznik. Domyślnie: włączony.
• Order Import Interval — jak często działa sprawdzenie zaplanowane. Domyślnie: 30 minut.

Jak wygląda zaimportowane zamówienie Shopware

• Pozycje zamówienia pochodzą z danych Mirakl, dopasowane do produktów Shopware przez referencje operatora.
• Adres dostawy i rozliczeniowy są kopiowane jeden do jednego z zamówienia Mirakl.
• Status zamówienia odpowiada statusowi u operatora, przetłumaczony przez Order Status Mapping skonfigurowane na połączeniu (krok 9 kreatora lub menu kontekstowe wiersza → Order Status Mapping). Gdy później zmienisz status zamówienia Shopware, zmiany wracają do Mirakl przez Reverse Status Mapping (krok 10 kreatora) — zobacz Order state sync.

Zaimportowane zamówienia Mirakl widzisz w Dashboard → Quick Start → Orders (lista Imported Orders).

Wskazówki i pułapki

Wskazówka

Ustaw datę początkową importu na dzień przed startem Twojego konta u operatora. Wcześniejsze daty wyciągają historyczne zamówienia, które operator mógł zostawić w stanie roboczym przez lata — takie zamówienia zwykle nie tworzą się czysto, bo ich referencje do produktów już do niczego nie pasują.

Uwaga

Jeśli usuniesz połączenie, znikają rekordy łączące jego zamówienia Mirakl z Shopware. Same zamówienia Shopware pozostają, ale tracą powiązanie z Mirakl — zmiany statusów nie będą już wracać do operatora. Gdy połączenie zaimportowało już zamówienia, wstrzymaj je lub zmień nazwę zamiast usuwać.

Notatka

Początkowe importy łańcuchowe (wiadomości, dokumenty, faktury, logi transakcji) działają sekwencyjnie per połączenie, nie równolegle — każdy odpytuje własny endpoint operatora. Na połączeniu z długą historią może to trwać długo. Importy działają w tle, więc kreator można zamknąć zaraz po ostatnim kroku.

Uwaga

Jeśli operator ogranicza Cię limitem zapytań, bieżące uruchomienie kończy się wcześniej z notatką w logach (“Rate limited, will resume on next scheduled run”). Następne zaplanowane sprawdzenie podejmuje pracę tam, gdzie poprzednie się zatrzymało — bez Twojej interwencji.

Powiązane tematy

• Order state sync — wysyłaj wysyłkę / odrzucenie / tracking / akceptację z Shopware do Mirakl
• Order messages — pobierane automatycznie przy pierwszym imporcie
• Order documents — pobierane automatycznie przy pierwszym imporcie
• Invoices — pobierane automatycznie przy pierwszym imporcie
• Transaction logs — pobierane automatycznie przy pierwszym imporcie
• Order refresh — odśwież pojedyncze zamówienie na żądanie
• Background tasks — jak zaplanowane sprawdzenia decydują, co uruchomić