Przejdź do głównej treści
Mirakl

Pola instancji Mirakl w Mirakl Connector: słownik z tym, co warto ustawić

Pola otwartych zamówień, zwrotów, faktur, wiadomości i akceptacji są domyślnie odznaczone; z tych pól tylko Returns Fallback To Orders jest domyślnie zaznaczone.

FlexigoTech · Odpowiada: Víctor Gómez · Aktualizacja: 5 listopada 2026

Najważniejsze

Moduł
Mirakl
Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym konektora, wersja 20.0 · w źródłach podanych na końcu
Czas czytania
5 min

Na karcie Mirakl Instances kilka pól decyduje o tym, co konektor Mirakl pobiera do Odoo i kiedy. Kartę otworzysz z menu Mirakl › Configuration › Marketplaces. Pola i ich wartości domyślne pochodzą z kodu Odoo 20; moduł jest opublikowany dla Odoo 17, 18, 19 i 20.

Schemat menu dostępu i karty instancji Mirakl wraz z jej polami
Schemat wykonany kodem na podstawie opublikowanego kodu modułu (to nie jest zrzut ekranu Odoo): menu dostępu i karta z polami, z oryginalnymi etykietami z kodu.

Pola są rozmieszczone na dwóch zakładkach: Orders and Returns i Invoices and Messages.

Otwarte zamówienia: ponowne odczytanie tego, co już jest w Odoo

Refresh Status of Open Orders
Pole wyboru na zakładce Orders and Returns, w grupie Windows. Domyślnie odznaczone. Według jego pomocy po każdym imporcie ponownie odczytuje w Mirakl każde zamówienie, które jest już w Odoo i jeszcze się nie zakończyło (nieodebrane, zamknięte, odrzucone ani anulowane), i aktualizuje jego status, nawet jeśli zamówienie jest starsze niż okno importu. Bez niego zamówienie, którego status zmienia się w marketplace długo po utworzeniu, zostaje w Odoo ze starym statusem. Co ustawić: zaznacz je, jeśli zależy ci na tym, żeby takie późne zmiany trafiały do Odoo.
Open Orders Refreshed per Run
Liczba całkowita w tej samej grupie Windows. Pojawia się tylko wtedy, gdy poprzednie pole jest zaznaczone, więc przy wartościach domyślnych go nie widzisz. Wartość domyślna to 100. Jego pomoc mówi, że to maksymalna liczba otwartych zamówień ponownie odczytywanych w Mirakl w jednym przebiegu oraz że najpierw czytane są te, które najdłużej nie były aktualizowane, dzięki czemu wszystko, co oczekuje, zostaje objęte w kolejnych przebiegach. Co ustawić: możesz zacząć od wartości domyślnej; sama pomoc wskazuje, że to, co oczekuje, nie musi zmieścić się w jednym przebiegu.
Schemat z pomocą pola Refresh Status of Open Orders w takiej postaci, w jakiej widzi ją użytkownik, zależnie od języka jego Odoo
Schemat wykonany kodem na podstawie opublikowanych tłumaczeń modułu (to nie jest zrzut ekranu Odoo): ta sama pomoc po hiszpańsku, niemiecku, francusku, włosku i portugalsku.
Same stock on every Mirakl marketplace, sent from Odoo
Wideo: Same stock on every Mirakl marketplace, sent from Odoo (wideo po angielsku)

Zwroty: przełącznik, zapasowe źródło i ostrzeżenie

Sync Returns Enabled
Pole wyboru w grupie Sync Policy, zakładka Orders and Returns; widać je także na liście Mirakl Instances. Domyślnie odznaczone. Jego pomoc: włącza ogólny, zaplanowany import zwrotów z Mirakl dla tej instancji. Zaplanowane zadanie Mirakl - Sync Returns uruchamia się co 30 minut i jest aktywne po instalacji. Co ustawić: zaznacz je w instancjach, z których chcesz pobierać zwroty w sposób zaplanowany.
Returns Fallback To Orders
Pole wyboru w tej samej grupie; w odróżnieniu od poprzednich jest domyślnie zaznaczone. Jego pomoc mówi: jeśli /returns jest niedostępny, buduje ogólne rekordy zwrotów na podstawie zwrotów środków znalezionych w payloadach zamówień. Co ustawić: zostaw tak, jak jest, jeśli chcesz mieć to zabezpieczenie; odznacz tylko wtedy, gdy go nie chcesz.
Returns Endpoint Unavailable
Pole wyboru tylko do odczytu w tej samej grupie: nie wypełniasz go ty. Jego pomoc mówi, że jest ustawiane automatycznie, gdy /returns zwraca 404, aby zaplanowana synchronizacja pomijała ten endpoint do czasu ręcznej ponownej próby. Opróżnia je kod synchronizacji zwrotów, do którego dochodzi się z przycisku Import Returns oraz z zaplanowanego zadania. Na co patrzeć: jeśli jest zaznaczone, zaplanowana synchronizacja pomija ten endpoint.

Akceptowanie i potwierdzanie zamówień

Trzy kolejne pola znajdują się w grupie Sync Policy i są domyślnie odznaczone. Ich pomoce opisują różne rzeczy, więc warto czytać je po kolei.

Auto Accept Orders
Jego pomoc: automatycznie akceptuje zaimportowane zamówienia, które w Mirakl wymagają akceptacji sprzedawcy. Co ustawić: zaznacz je, jeśli chcesz, żeby ta akceptacja odbywała się sama.
Accept Pending On Import
Jego pomoc: próbuje zaakceptować oczekujące zamówienia zaraz po każdym imporcie zamówień, ręcznym lub zaplanowanym.
Auto Confirm Sale
Jego pomoc: automatycznie potwierdza zaimportowane zamówienia sprzedaży po synchronizacji. Co ustawić: zaznacz je tylko wtedy, gdy chcesz, żeby te zamówienia sprzedaży były potwierdzane bez udziału człowieka.

Faktury (rozliczenia)

Znajdują się na zakładce Invoices and Messages, w grupie Invoices (Settlements).

Sync Invoices Enabled
Domyślnie odznaczone. Jego pomoc: włącza zaplanowaną synchronizację faktur dla tej instancji. Zadanie Mirakl - Sync Invoices uruchamia się raz dziennie i po instalacji jest wyłączone.
Initial Invoice Sync Days
Liczba całkowita z wartością domyślną 90. Jego pomoc definiuje ją jako okno historyczne, w dniach, dla ręcznej synchronizacji faktur. Co ustawić: tyle dni historii, ile chcesz pobrać, gdy uruchamiasz ją ręcznie.
Invoices Endpoint Unavailable
Pole wyboru tylko do odczytu. Jest ustawiane automatycznie, gdy /invoices zwraca 404, aby zaplanowana synchronizacja pomijała ten endpoint do czasu ręcznej ponownej próby. Opróżnia je kod synchronizacji faktur, do którego dochodzi się z przycisku Import Invoices oraz z zaplanowanego zadania.

Wiadomości

Na tej samej zakładce, w grupie Messages.

Sync Messages Enabled
Domyślnie odznaczone. Jego pomoc: włącza zaplanowaną synchronizację wiadomości dla tej instancji. Zadanie Mirakl - Sync Messages uruchamia się co 30 minut i po instalacji jest wyłączone.
Initial Message Sync Days
Liczba całkowita z wartością domyślną 30. Według jego pomocy to okno historyczne, w dniach, dla ręcznej synchronizacji wiadomości.
Messages Endpoint Unavailable
Pole wyboru tylko do odczytu. Jest ustawiane automatycznie, gdy /messages zwraca 410 Gone lub 404 (nieudostępniony przez tego operatora), a zaplanowana synchronizacja pomija ten endpoint do czasu ręcznej ponownej próby. Opróżnia je kod synchronizacji wiadomości, do którego dochodzi się z przycisku Import Messages oraz z zaplanowanego zadania.

Jak to się łączy z FlexigoTech

Połączenie z Mirakl przechodzi przez FlexigoTech Cloud: przechowuje zaszyfrowane dane dostępowe, pilnuje synchronizacji i wysyła e-mail, jeśli coś zawiedzie. Moduł wymaga tej subskrypcji, planu Conector: 49 €/mies. lub 490 € rocznie, netto (bez VAT). Bez subskrypcji lub przy zawieszonej usłudze zatrzymuje się to, co daje subskrypcja, a dane zostają w twoim Odoo. Moduł zobaczysz na jego karcie w Odoo Apps oraz na stronie FlexigoTech.

Jeśli wdrażasz Odoo i chcesz przy wsparciu zdecydować, jaka polityka synchronizacji pasuje do każdego marketplace, FlexigoTech wdraża Odoo 17, 18, 19 i 20 oraz tworzy konektory i integracje na zamówienie.

Czytaj dalej

Lista kontrolna instancji Mirakl Connector, pole po poluLista kontrolna do wypełnienia instancji Mirakl Connector w Odoo: połączenie, konta rozliczeń i opcje, z tym, co mówi pomoc każdego pola.Pola instancji Mirakl w Mirakl Connector: co znaczą i co wpisaćPorównanie pól karty Mirakl Instances w Mirakl Connector dla Odoo: co mówi pomoc przy każdym polu, jaka jest wartość domyślna i co wpisać w praktyce.
Sprawdzone w kodzie źródłowym konektora (wersja 20.0) i w podlinkowanych źródłach

Źródła