Przejdź do głównej treści
Mirakl

Pola zamówień Mirakl w Mirakl Connector: słownik

Co oznacza każde pole karty Mirakl Orders w Mirakl Connector według jego własnej podpowiedzi: prowizja, dostawa, zwrot, powód braku zamówienia sprzedaży i payload oraz co warto wpisać lub sprawdzić w każdym z nich.

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
4 min

Mirakl Connector jest opublikowany w Odoo Apps dla wersji 17.0, 18.0, 19.0 i 20.0. To, co poniżej, odpowiada menu i polom Mirakl Connector dla Odoo 20.0.

Gdzie są te pola

Karty otwierasz z menu Mirakl › Operations › Orders. Jeśli nie widzisz menu Mirakl, brakuje Ci uprawnienia wymaganego dla tego fragmentu menu.

Schemat wykonany w kodzie, nie ekran Odoo: menu Mirakl › Operations › Orders i karta Mirakl Order z polami prowizji, metody dostawy, terminu, payloadu, zwrotu i powodu braku zamówienia sprzedaży
Schemat (to nie zrzut ekranu Odoo) z menu i kartą zamówienia Mirakl.
Mirakl Orders
Karta i lista zamówień Mirakl. Niektóre pola są widoczne tylko na karcie, inne także na liście, a jedno widzą tylko użytkownicy z określonym uprawnieniem.
Same stock on every Mirakl marketplace, sent from Odoo
Wideo: Same stock on every Mirakl marketplace, sent from Odoo (wideo po angielsku)

Prowizja i dostawa

Amount Commission
Pole kwoty pieniężnej. Widać je na karcie Mirakl Orders oraz w widoku przestawnym tego modelu. Jego podpowiedź brzmi: «Marketplace commission charged by the operator on this order (seller cost). Read from the Mirakl payload (commission_fee / total_commission).». Co warto zrobić: traktować je jako koszt sprzedawcy podawany przez operatora, a jeśli jakaś kwota Ci się nie zgadza, porównać ją z Raw Payload (niżej).
Schemat wykonany w kodzie na podstawie opublikowanych tłumaczeń, nie ekran Odoo: podpowiedź pola Amount Commission po hiszpańsku, niemiecku, francusku, włosku i portugalsku
Schemat (to nie zrzut ekranu Odoo): podpowiedź pola Amount Commission tak, jak wygląda w zależności od języka Odoo.
Shipping Type Code
Krótki tekst widoczny na karcie, w grupie Shipping Method. Jego podpowiedź brzmi: «Mirakl shipping method code chosen by the buyer (e.g. STD, EXPRESS).». Co warto zrobić: czytać go jako klucz używany przez Mirakl; tekst przeznaczony dla ludzi jest w następnym polu.
Shipping Method
Krótki tekst widoczny na karcie, w tej samej grupie Shipping Method, a także na liście Mirakl Orders. Jego podpowiedź brzmi: «Shipping method chosen by the buyer, as shown by the marketplace (e.g. 'Standard home delivery', 'Next day').». Co warto zrobić: używać go, żeby wiedzieć, co wybrał kupujący, bez interpretowania kodu.
Ship Before
Data i godzina widoczne na karcie, w grupie Shipping Dates, a także na liście. Jego podpowiedź brzmi: «Mirakl deadline to hand the parcel to the carrier. Shipping after this date hurts your marketplace quality score.». Co warto zrobić: pamiętać o tej dacie przy przygotowaniu wysyłki, bo sama podpowiedź ostrzega, że jej przekroczenie obniża Twoją ocenę.

Zwrot

Oba pola są w grupie Refund na karcie i mają podobne nazwy, ale nie robią tego samego.

Refund Reason
Krótki tekst. Jego podpowiedź brzmi: «Internal note about the refund. What Mirakl actually requires is the operator's reason CODE below.». Co warto zrobić: wpisać go jako notatkę dla zespołu, pamiętając, że nie zastępuje kodu.
Refund Reason Code
Krótki tekst. Jego podpowiedź brzmi: «Operator-defined reason code required by the Mirakl refund API (OR28), e.g. Decathlon publishes codes like 'RET' or '11'. Use 'Fetch Refund Reasons' on the marketplace instance to list the codes your operator accepts.». Co warto zrobić: wpisać kod akceptowany przez Twojego operatora, a nie opis; podpowiedź wskazuje, gdzie je sprawdzić.

Gdy nie ma zamówienia sprzedaży

No Sales Order Because
Pole wyboru, które wyjaśnia, dlaczego konektor nie tworzy zamówienia sprzedaży dla danego zamówienia Mirakl. Pojawia się tylko wtedy, gdy zamówienie nie ma zamówienia sprzedaży, a pole ma ustawiony powód; w zwykłym zamówieniu go nie zobaczysz. Jest też na liście, tylko do odczytu. Wypełnia je moduł, nie użytkownik, i jest czyszczone, gdy zamówienie sprzedaży powstaje przyciskiem Create Sales Order. Jego podpowiedź brzmi: «Why the connector does not create a sales order for this Mirakl order. Use the 'Create Sales Order' button to create it anyway.». Co warto zrobić: przeczytać powód, zanim zdecydujesz, czy mimo to je utworzyć.

Możliwe wartości to:

Its sales order was deleted in Odoo
Zamówienie sprzedaży tego zamówienia Mirakl zostało usunięte w Odoo.
Already shipped, closed or refunded in Mirakl when imported
W chwili importu zamówienie było już w Mirakl wysłane, zamknięte lub zwrócone.
Created before 'Create Sales Orders From'
Zamówienie Mirakl zostało utworzone przed datą z pola 'Create Sales Orders From'. Jeśli to widzisz i chcesz mieć zamówienie sprzedaży, podpowiedź pola wskazuje przycisk Create Sales Order.

Dane techniczne

Raw Payload
Długi tekst w grupie Payload Raw (Technical) na karcie. Widzą go tylko użytkownicy z określonym uprawnieniem administracyjnym, tylko do odczytu. Jego podpowiedź brzmi: «The marketplace payload exactly as received, formatted for reading. This is what to attach when reporting an import problem.». Co warto zrobić: nie edytować go (jest tylko do odczytu) i skopiować w całości, gdy trzeba zgłosić błąd importu.

Jak pomaga FlexigoTech

Jeśli wdrażasz Odoo i chcesz połączyć Mirakl, FlexigoTech wdraża Odoo 17, 18, 19 i 20 oraz tworzy konektory i integracje na zamówienie. Moduł kosztuje jednorazowo za wersję i wymaga subskrypcji FlexigoTech Cloud, plan Konektor: 49 €/mies. lub 490 €/rok netto (bez VAT), z maksymalnie 3 kontami platformy. Połączenie przechodzi przez FlexigoTech Cloud, który przechowuje dane uwierzytelniające w postaci zaszyfrowanej, pilnuje synchronizacji i wysyła e-mail, jeśli się nie powiedzie. Cena modułu za wersję jest na karcie w Odoo Apps, a zakup na stronie modułu.

Jeśli dopiero łączysz konto, zanim zajmiesz się zamówieniami, przyda Ci się co robi przycisk testowania połączenia, krok po kroku.

Czytaj dalej

Mirakl Connector: «Set the Mirakl API key before testing the connection»Kiedy w Mirakl Connector dla Odoo pojawia się błąd pustego klucza API, jaki warunek go wywołuje i jak go usunąć po kliknięciu Test Connection.Mirakl Connector: «This binding has no Mirakl instance configured.»Kiedy w Mirakl Connector pojawia się komunikat o powiązaniu bez skonfigurowanej instancji Mirakl, jaki warunek go wywołuje i co zrobić, gdy się pojawi.Co robi przycisk Test Connection w Mirakl Connector, krok po krokuCo robi przycisk Test Connection w Mirakl Connector dla Odoo: kiedy się pojawia, co sprawdza, co zapisuje w karcie i jakie błędy może zwrócić.
Sprawdzone w kodzie źródłowym konektora (wersja 20.0) i w podlinkowanych źródłach

Źródła