Settings
Ustawienia pluginu znajdują się na stronie Mirakl → Settings, która ma trzy zakładki:
- Connections — wiersze per marketplace (zobacz Connections dla pól per połączenie). Tutaj nieomawiane.
- Sync Settings — włączniki, interwały i wielkości partii sterujące synchronizacjami w tle.
- Options — przechowywanie i poziomy logów.
Te ustawienia pojawiają się też pod standardową stroną konfiguracji Settings → System → Plugins Shopware, ale do edycji rekomendowana jest dedykowana strona Mirakl → Settings.
Zakładka Sync Settings
Dział zatytułowany „Zakładka Sync Settings”Zakładka Sync Settings jest podzielona na trzy karty: Sync Settings, Document Sync (Mirakl → Shopware) i Invoicing & Transaction Logs Sync.
Włączniki główne
Dział zatytułowany „Włączniki główne”Każda synchronizacja ma swój własny włącznik. Gdy włącznik jest wyłączony, zaplanowane zadanie nadal odpala się w swoim interwale, ale obsługa po prostu je pomija — nie ma żadnego wywołania marketplace’u. Włączniki nie wpływają na akcje uruchamiane na żądanie z panelu.
| Etykieta UI | Klucz ustawienia | Domyślnie | Co włącza |
|---|---|---|---|
| Enable Stock Sync | stockSyncActive | Włączone | Zadanie synchronizacji stanów wysyła aktualizacje stanów. |
| Enable Order Import | orderImportActive | Włączone | Zadanie importu zamówień pobiera nowe i zaktualizowane zamówienia. |
| Enable Product Export | productExportActive | Włączone | Zadanie eksportu produktów wgrywa zakolejkowane produkty. |
| Enable Message Sync | messageSyncActive | Wyłączone | Zadanie synchronizacji wiadomości pobiera nowe wiadomości przychodzące. |
| Enable Order Document Sync (OR72) | orderDocumentSyncActive | Wyłączone | Zadanie synchronizacji dokumentów zamówień pobiera nowe dokumenty przychodzące. |
| Enable Document Requests Sync (DR11) | documentRequestSyncActive | Wyłączone | Zadanie synchronizacji żądań dokumentów pobiera nowe żądania od marketplace’u. |
| Enable Invoice Sync (IV01) | invoiceSyncActive | Wyłączone | Zadanie synchronizacji faktur pobiera nowe faktury. |
| Enable Transaction Log Sync (TL02) | transactionLogSyncActive | Wyłączone | Zadanie synchronizacji dziennika transakcji pobiera nowe wpisy. |
Interwały synchronizacji
Dział zatytułowany „Interwały synchronizacji”Każda synchronizacja ma odpowiadający jej interwał. Wartości są w sekundach; UI pokazuje je jako gotowe czasy.
| Etykieta UI | Klucz ustawienia | Domyślnie | Wartości do wyboru |
|---|---|---|---|
| Stock Sync Interval | stockSyncInterval | 15 minut | 2 min, 5 min, 10 min, 15 min, 30 min, 60 min |
| Order Import Interval | orderImportInterval | 30 minut | 2 min, 5 min, 10 min, 15 min, 30 min, 60 min |
| Product Export Interval | productExportInterval | 30 minut | 2 min, 5 min, 10 min, 15 min, 30 min, 60 min |
| Message Sync Interval | messageSyncInterval | 30 minut | 2 min, 5 min, 10 min, 15 min, 30 min, 60 min |
| Order Document Sync Interval | orderDocumentSyncInterval | 30 minut | 5 min, 10 min, 15 min, 30 min, 60 min, 6 godz., 24 godz. |
| Document Requests Sync Interval | documentRequestSyncInterval | 24 godziny | 1 godz., 6 godz., 12 godz., 24 godz. |
| Invoice Sync Interval | invoiceSyncInterval | 24 godziny | 6 godz., 12 godz., 24 godz. |
| Transaction Log Sync Interval | transactionLogSyncInterval | 24 godziny | 6 godz., 12 godz., 24 godz. |
| Transaction Log Export Poll Interval | transactionLogExportPollInterval | 1 minuta | 30 sek., 1 min, 5 min |
Ustawiony interwał to minimum — rzeczywista przerwa zależy też od tego, jak często harmonogram Shopware jest odpalany na Twoim hoście (kadencja crona). Zobacz Background tasks.
Wielkości partii
Dział zatytułowany „Wielkości partii”Te dwa ustawienia ograniczają liczbę wierszy wgrywanych w jednej partii. Niższe wartości redukują zużycie pamięci i ryzyko timeoutu; wyższe wartości przyspieszają duże katalogi.
| Etykieta UI | Klucz ustawienia | Domyślnie | Zakres |
|---|---|---|---|
| Product Export Batch Size | productExportBatchSize | 100 | 1–500 |
| Offer Sync Batch Size | offerSyncBatchSize | 50 | 1–500 |
Wielkość partii jest ustalana na początku uruchomienia — jeśli zmienisz ją w trakcie, zmiana zacznie obowiązywać przy następnym uruchomieniu.
Limity dla zamówień zamkniętych
Dział zatytułowany „Limity dla zamówień zamkniętych”Dla synchronizacji, które przeszukują zamówienia, te ustawienia ograniczają, jak daleko wstecz patrzeć na już zamknięte zamówienia. Oszczędzają budżet wywołań marketplace’u na kontach z długą historią zamówień.
| Etykieta UI | Klucz ustawienia | Domyślnie | Wartości do wyboru |
|---|---|---|---|
| Sync messages for closed orders (days) | messageSyncClosedOrderDays | 7 dni | 1, 3, 5, 7, 14, 30 |
| Sync documents for closed orders (days) | orderDocumentSyncClosedOrderDays | 30 dni | 1, 3, 5, 7, 14, 30 |
Zakładka Options
Dział zatytułowany „Zakładka Options”Karta Logs
Dział zatytułowany „Karta Logs”| Etykieta UI | Klucz ustawienia | Domyślnie | Efekt |
|---|---|---|---|
| API Log Retention (days) | apiLogRetentionDays | 30 | Jak długo przechowywać wiersze API Logs. Starsze wiersze są usuwane codziennie. |
| Sync Log Retention (days) | syncLogRetentionDays | 30 | Jak długo przechowywać wiersze Sync Logs. Starsze wiersze są usuwane codziennie. |
| Sync log levels | syncLogLevels | Info, Success, Warning, Error (Debug wyłączony) | Które poziomy ważności są zachowywane. Długo działające uruchomienia awansowane na odznaczony poziom są usuwane po zakończeniu; pojedyncze zdarzenia na odznaczonych poziomach nie są zapisywane. Odznaczenie wszystkich poziomów wyłącza logowanie synchronizacji w całości. |
Praktyczne wskazówki znajdziesz w Sync logs.
Ustawienia per połączenie (poza stroną Settings)
Dział zatytułowany „Ustawienia per połączenie (poza stroną Settings)”Kilka ustawień jest przechowywanych per połączenie — należą do połączenia, nie do globalnej konfiguracji systemu. Edytujesz je przez kreator albo menu kontekstowe wiersza na liście Connections.
| Ustawienie | Gdzie edytować |
|---|---|
| Początkowa data importu zamówień | Krok 12 kreatora. |
| Domyślny status oferty | Krok 4 kreatora albo okno Edit Connection. |
| Mapowanie statusów zamówień | Krok 9 kreatora albo menu kontekstowe → Order Status Mapping. |
| Mapowanie odwrotne statusów | Krok 10 kreatora albo menu kontekstowe → Reverse Status Mapping. |
| Auto-upload dokumentów | Krok 11 kreatora albo menu kontekstowe → Document Auto-Upload. |
| Format nazwy wariantu | Menu kontekstowe → Variant Name Format. |
Pełną listę pól per połączenie znajdziesz w Connections.
Nadpisania per produkt
Dział zatytułowany „Nadpisania per produkt”Default Offer State z połączenia można nadpisać dla poszczególnych produktów. Otwórz produkt (Catalogues → Products → wybierz produkt) i przejdź na zakładkę Specifications. W sekcji Mirakl Marketplace dla każdego skonfigurowanego połączenia jest osobne pole Offer State (nazwa połączenia). Wybierz wartość, żeby nadpisać; zostaw puste, żeby używać domyślnej z połączenia.
Powiązane tematy
Dział zatytułowany „Powiązane tematy”- Background tasks — jak interwały i włączniki sterują harmonogramem
- Sync logs — jak Sync log levels kontroluje, co się tam pojawia
- Enums — wartości przechowywane w polach statusu encji
- Connections — ustawienia per połączenie