Przejdź do głównej treści

Mirakl

Pola instancji Mirakl w Mirakl Connector: co znaczą i co wpisać

Karta Mirakl Instances rozkłada pola na kilka zakładek, a każde ma własną pomoc. Tutaj je porównujemy: co mówi pomoc, jaką wartość mają domyślnie i co się zmienia, gdy zostawisz je puste albo wypełnisz.

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

Gdzie są te pola

Karty otwierasz z menu Mirakl › Configuration › Marketplaces. Na karcie Mirakl Instances pola z tego przewodnika są rozłożone na trzech zakładkach: Carriers, Orders and Returns i Manual Operations.

Schemat wykonany kodem: menu Mirakl, Configuration, Marketplaces oraz karta Mirakl Instance z polami porównywanymi w tym artykule — Schemat wykonany kodem na podstawie opublikowanego kodu modułu, nie jest zrzutem ekranu z Odoo: menu i pola karty z ich oryginalnymi etykietami.

Same stock on every Mirakl marketplace, sent from Odoo — Wideo: Same stock on every Mirakl marketplace, sent from Odoo (wideo po angielsku)

Okna importu i limity

Te pola zawężają to, co jest importowane, analizowane lub odpytywane. Wszystkie mają w kodzie wartość domyślną.

Pole	Gdzie jest	Co mówi pomoc	Domyślnie
`Initial Order Sync Days`	`Orders and Returns`, grupa `Windows`	«Historical window used when there is no previous order sync. Manual import also uses this range.»	30
`Initial Return Sync Days`	`Orders and Returns`, grupa `Windows`	«Historical window used when there is no previous return sync. Manual import also uses this range.»	30
`Max Sync Pages`	`Orders and Returns`, grupa `Windows`	«Safety limit for paginated order/return imports.»	40
`Offer Binding Generate Limit`	`Manual Operations`, grupa `Offers`	«Maximum products scanned when auto-generating missing offer bindings.»	500
`Endpoint Shipping Carriers`	`Carriers`, grupa `Carrier Sync`	«Mirakl SH21 endpoint used to retrieve available shipping carriers when supported by the operator.»	`/shipping/carriers`

Dwa pola z liczbą dni wyznaczają okno używane wtedy, gdy nie ma jeszcze wcześniejszej synchronizacji zamówień lub zwrotów, a pomoc dodaje, że import ręczny korzysta z tego samego zakresu. Max Sync Pages jest według swojej pomocy zabezpieczeniem dla importów stronicowanych.

Klient zamówienia: dwa tryby i dwa pola wyboru

Pole Order Customer Mode znajduje się w Orders and Returns, w grupie Customer & Privacy. Ma dwie wartości: One customer per shopper (standard), ustawioną domyślnie, oraz Single default customer with delivery child contacts.

Pole	Kiedy jest widoczne	Domyślnie
`Order Customer Mode`	W grupie `Customer & Privacy`	`One customer per shopper (standard)`
`Default Marketplace Customer`	Tylko w trybie jednego klienta; przy wartościach domyślnych go nie widać	Ukryte w trybie standardowym
`Delivery Contacts as Companies`	Tylko w trybie jednego klienta; przy wartościach domyślnych go nie widać	Wyłączone
`Use Mirakl Notification Email`	W grupie `Customer & Privacy`	Wyłączone

Co mówi pomoc przy każdej opcji:

Tryb standardowy: każdy kupujący staje się w Odoo osobnym klientem.
Jeden klient domyślny: wszystkie zamówienia z marketplace'u są przypisywane do stałego klienta, którego wybierasz w Default Marketplace Customer. Adres dostawy kupującego jest zapisywany jako jego kontakt podrzędny (typ Dostawa, oznaczony jako kupujący z marketplace'u), dzięki czemu dane osobowe są ograniczone i można je ukryć regułą rekordu. Faktury są wystawiane na klienta domyślnego i nie zawierają danych kupującego.
Kontakty dostawy jako firmy: tylko przy jednym kkkliencie. Każdy adres dostawy staje się własnym kontaktem firmowym, a nie kontaktem podrzędnym klienta domyślnego, więc zamówienie sprzedaży, dostawa i dokument dostawy pokazują firmę klienta końcowego, a nigdy nazwę klienta domyślnego. Pomoc wskazuje, że osoba trafia do Osoby kontaktowej oraz że e-mail klienta, który wysyła Mirakl, nie jest zapisywany: w marketplace'ach, w których operator kupuje od ciebie (np. GACD), jest to adres operatora, a nie klienta.
E-mail powiadomień: Mirakl anonimizuje kupującego za adresem przekaźnikowym tworzonym osobno dla każdego zamówienia i zmieniającym się przy każdym zamówieniu. Przy włączonym polu przekaźnik jest używany jako e-mail kontaktu dostawy w zamówieniu (nigdy na stałej karcie klienta), dzięki czemu odpowiedzi docierają do kupującego przez Mirakl. W trybie jednego klienta kontakt podrzędny kupującego zawsze dostaje przekaźnik, gdy Mirakl go udostępnia. Wartość z każdego zamówienia jest zapisywana także w zamówieniu sprzedaży.

Most sprzedaży: puste czy wypełnione

Na zakładce Orders and Returns grupa Sales Bridge zawiera pola, których pomoc mówi, co się stanie, gdy zostawisz je puste.

Pole	Jeśli zostawisz puste	Jeśli wypełnisz
`Shipping Product`. Na ekranie jest bez etykiety: widać tylko jego zawartość	Do zamówienia sprzedaży nie jest dodawana linia dostawy	Ten produkt typu usługa jest używany do linii kosztów dostawy
`Create Sales Orders From`	Bez limitu	Zamówienia Mirakl utworzone przed tą datą są importowane, ale nigdy nie stają się zamówieniami sprzedaży
`Salesperson on Orders`	Decyduje Odoo: sprzedawca klienta lub, jeśli go nie ma, użytkownik, który zaimportował zamówienie (OdooBot przy imporcie automatycznym)	Ten sprzedawca jest wpisywany w każde zamówienie sprzedaży zaimportowane z tego marketplace'u
`Shipping Method on Orders`	Zamówienia sprzedaży nie mają metody dostawy	Ta metoda jest wpisywana w każde zamówienie sprzedaży, a wraz z nim w jego dostawę

Dwie uwagi z pomocy. Przy Create Sales Orders From powodem jest to, aby zamówienia obsłużone przed użyciem konektora nie były wysyłane ponownie. Przy Shipping Method on Orders pomoc prosi o przypisanie jej w Mirakl > Catálogo > Asignación de transportistas, aby numer przesyłki trafił do Mirakl z właściwym przewoźnikiem.

Wysyłanie śledzenia przy zatwierdzeniu

Pole wyboru Send Tracking to Mirakl on Validation jest domyślnie wyłączone. Po włączeniu, przy zatwierdzeniu dostawy w Odoo wysyłka jest przekazywana do Mirakl (numer przesyłki, przewoźnik i potwierdzenie wysyłki), aby marketplace oznaczył zamówienie jako wysłane, a kupujący widział śledzenie. Pomoc stawia dwa wymagania: dostawa musi mieć numer przesyłki, a jej przewoźnik powinien być zmapowany na zakładce Carriers. Jeśli numeru brakuje, dokument dostawy nie jest ruszany, a notatka wyjaśnia dlaczego. Niektóre profile marketplace'ów, jak Leroy Merlin, wysyłają to zawsze, bo operator tego wymaga.

Pole endpointu przewoźników

Pomoc pola Endpoint Shipping Carriers brzmi: «Mirakl SH21 endpoint used to retrieve available shipping carriers when supported by the operator.». Schemat pokazuje ten sam tekst po niemiecku, francusku, włosku i portugalsku.

Schemat z pomocą pola Endpoint Shipping Carriers po hiszpańsku, niemiecku, francusku, włosku i portugalsku — Schemat wykonany kodem na podstawie opublikowanych tłumaczeń modułu, nie jest zrzutem ekranu z Odoo.

Co wpisać w twoim przypadku

Sprzedawałeś na marketplace'ie przed instalacją konektora: wypełnij Create Sales Orders From; według pomocy wcześniejsze zamówienia są importowane, ale nie stają się zamówieniami sprzedaży.
Nie chcesz osobnego klienta w Odoo dla każdego kupującego: wybierz tryb jednego klienta i wskaż Default Marketplace Customer; pomoc sugeruje ogólny kontakt dla każdego marketplace'u.
Chcesz, by kupujący widział śledzenie po zatwierdzeniu: włącz Send Tracking to Mirakl on Validation i sprawdź przewoźnika na zakładce Carriers.
Nie chcesz linii kosztów dostawy: zostaw Shipping Product puste.
Nie masz stałego sprzedawcy dla tych zamówień: zostaw Salesperson on Orders puste, a zdecyduje Odoo zgodnie ze swoją pomocą.

Koszt i pomoc FlexigoTech

Mirakl Connector to moduł z jednorazową opłatą za wersję Odoo (opublikowany w Odoo Apps dla wersji 17, 18, 19 i 20) i wymaga subskrypcji FlexigoTech Cloud: plan Konektor, 49 €/mies. lub 490 €/rok netto (bez VAT), do 3 kont platformy. Połączenie przechodzi przez FlexigoTech Cloud, który przechowuje dane dostępowe w formie zaszyfrowanej, nadzoruje synchronizację i wysyła e-mail, gdy coś zawiedzie. Masz kartę w Odoo Apps i stronę modułu. Jeśli wolisz, żeby ktoś skonfigurował instancję razem z tobą, 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 Odoo: co oznacza każde z nich i co wpisaćPrzewodnik po polach instancji Mirakl Connector dla Odoo: dostawa, rabat, prowizja, język, faktury i synchronizacja, zgodnie z ich pomocą.

Sprawdzone w kodzie źródłowym konektora (wersja 20.0) i w podlinkowanych źródłach

Źródła

Kod modułu: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_instance.py
Kod modułu: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_ai.py
apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
flexigotech.com/en/services.html
flexigotech.com/precios.html