Przejdź do głównej treści
Mirakl

Jak dodać Leroy Merlin lub Decathlon do konektora Mirakl

Leroy Merlin i Decathlon sprzedają przez Mirakl, a w Odoo każdy z nich dodaje się jako kolejny marketplace konektora Mirakl. Zmienia się profil operatora: po zainstalowaniu modułu Leroy Merlin lub Decathlon wybierasz profil w polu „Provider Code”, a Odoo zaznacza potrzebne pola zamówień i zwrotów, uzupełnia adres operatora i przy zatwierdzaniu dostawy wysyła śledzenie do Mirakl, bez klikania czegokolwiek.

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 17.0, 18.0, 19.0 i 20.0
Czas czytania
4 min

Dodaj operatora

  1. Zainstaluj konektor Mirakl oraz moduł operatora: „Leroy Merlin for Mirakl” lub „Decathlon for Mirakl”. Bez tego modułu „Provider Code” oferuje tylko „Generic Mirakl”.
  2. Wejdź w Mirakl › Configuration › Marketplaces i utwórz nowy marketplace.
  3. W polu „Provider Code” wybierz Leroy Merlin lub Decathlon. Odoo w tym momencie uzupełnia odznaczone pola profilu i puste pola.
  4. Sprawdź adres. Dla Leroy Merlin to https://adeo-marketplace.mirakl.net, z API pod https://adeo-marketplace.mirakl.net/api; dla Decathlon marketplace-decathlon-eu.mirakl.net.
  5. Uzupełnij połączenie danymi Twojego konta u operatora, zapisz i kliknij „Test Connection”.
Lista marketplace'ów Mirakl w Odoo, po jednym na operatora, z kodem dostawcy i ostatnim testem połączenia
Jeden marketplace na operatora w Mirakl › Configuration › Marketplaces. W tej bazie demonstracyjnej moduły operatorów nie są zainstalowane, więc wszystkie trzy używają „Generic Mirakl”. Zrzut ekranu Odoo z danymi demonstracyjnymi.

Jeśli zaczniesz od profilu generycznego i wpiszesz adres operatora, Odoo rozpozna go po hoście: adeo-marketplace lub leroymerlin dla Leroy Merlin; marketplace-decathlon, marketplace.decathlon, seller.decathlon, partner.decathlon, .decathlon.net lub .decathlon.com dla Decathlon. Jeśli przełączysz się z jednego operatora na drugiego, adres poprzedniego zostanie zastąpiony adresem nowego. Adres wpisany ręcznie, który nie należy do żadnego znanego operatora, pozostaje bez zmian.

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

Co zaznacza profil

PoleProfil generycznyLeroy Merlin i DecathlonDo czego służy
Sync Orders EnabledOdznaczoneZaznaczoneZadanie „Mirakl - Sync Orders” importuje ich zamówienia co 10 minut
Auto Accept OrdersOdznaczoneZaznaczoneZadanie „Mirakl - Accept Orders” akceptuje co 10 minut zamówienia, na które Mirakl czeka na Twoją akceptację
Accept Pending On ImportOdznaczoneZaznaczonePróbuje zaakceptować oczekujące zamówienia zaraz po każdym imporcie, ręcznym lub zaplanowanym
Auto Confirm SaleOdznaczoneZaznaczonePotwierdza zaimportowane zamówienia sprzedaży
Sync Returns EnabledOdznaczoneZaznaczoneZadanie „Mirakl - Sync Returns” pobiera zwroty co 30 minut
Returns Fallback To OrdersZaznaczoneZaznaczoneJeśli operator nie udostępnia zwrotów przez API, tworzy je na podstawie zwrotów środków znalezionych w zamówieniach

Profil uzupełnia tylko to, co jest puste lub odznaczone. Wartość, którą już ustawiłeś, zostaje. Ma to znaczenie dla „Offer Price Tax Mode”: profil zawiera „Include Sales Taxes”, ale pole już jest ustawione na „As Computed”, więc wybór profilu w formularzu tego nie zmienia. Zdecyduj, jak podajesz ceny w ofertach, i ustaw to przed eksportem.

Leroy Merlin: katalog i oferty w formacie operatora

Profil Leroy Merlin zaznacza jeszcze dwa pola, które domyślnie są odznaczone i których profil Decathlon nie rusza:

  • Eksport katalogu w formacie operatora. Pomoc pola mówi: When enabled, catalog export defaults to Mirakl operator-format multipart CSV instead of raw JSON.
  • Eksport ofert z importem plików OF01 w formacie operatora: When enabled, offer export defaults to Mirakl OF01 operator-format multipart file import.

Jeśli eksportujesz z marketplace'u bez profilu Leroy Merlin, sprawdź te dwa pola, zanim obwinisz katalog.

Przesyłka wychodzi przy zatwierdzaniu dostawy

Przy tych dwóch profilach zatwierdzenie w Odoo dostawy zamówienia z Mirakl wystarcza, by poinformować marketplace, nawet przy odznaczonym polu „Send Tracking to Mirakl on Validation”, czyli tak, jak jest domyślnie. W profilu generycznym decyduje właśnie to pole.

Przed zatwierdzeniem Odoo aktualizuje zamówienie sprzedaży na podstawie zamówienia z Mirakl i wpisuje na dokumencie dostawy kontakt dostawy kupującego. Jeśli w tym kontakcie brakuje ulicy, miasta, kodu pocztowego lub telefonu, ponownie pobiera zamówienie z Mirakl i odbudowuje je.

Następnie przesyłka idzie w dwóch krokach. Najpierw śledzenie (OR23). Jeśli Mirakl jeszcze nie pokazuje zamówienia jako wysłanego, Odoo oznacza je jako wysłane (OR24). Jeśli operator odrzuci pierwszy krok, na przykład błędem 404 albo dlatego, że nie rozpoznaje kodu przewoźnika, Odoo przechodzi od razu do drugiego. A gdy Twój przewoźnik w Odoo tłumaczy się tylko jako OTHER, używa przewoźnika podanego w zamówieniu z Mirakl.

Zatwierdzona dostawa zamówienia z Mirakl z przyciskiem Push Mirakl Tracking i śledzeniem w stanie Synced
Zatwierdzona dostawa: przycisk „Push Mirakl Tracking”, stan śledzenia Synced, ostatnie żądanie wysłane do Mirakl oraz w historii „Mirakl tracking pushed successfully.” Zrzut ekranu Odoo z danymi demonstracyjnymi.

Jeśli dostawa nie ma numeru śledzenia

Nic nie zostaje wysłane. Odoo zapisuje to na dokumencie: Shipment not sent to Mirakl: this transfer has no tracking reference. Add the carrier's tracking number to the delivery and click Push Mirakl Tracking to notify the marketplace. Wpisz numer przewoźnika i kliknij „Push Mirakl Tracking”, co wysyła śledzenie ręcznie.

Jeśli brakuje pozycji zamówienia

Przy tych dwóch profilach przesyłka wymaga pozycji zamówienia z Mirakl. Jeśli Odoo ich nie znajdzie ani w zamówieniu z Mirakl, ani w zamówieniu sprzedaży, zatrzyma się z komunikatem Missing Mirakl order lines to push tracking.

Czy mogę mieć Leroy Merlin i Decathlon w jednym Odoo?

Tak. Każdy operator to osobny marketplace w Mirakl › Configuration › Marketplaces, z własnym profilem, kluczem i sklepem.

A jeśli nie chcę, by zamówienia były akceptowane automatycznie?

Odznacz „Auto Accept Orders” i „Accept Pending On Import” po wyborze profilu i zapisz: to, co ustawisz ręcznie, ma pierwszeństwo przed profilem. Jeśli później ponownie wybierzesz profil w „Provider Code”, zaznaczy je znowu.

Czytaj dalej

Zamówienie z Mirakl w Odoo, od zakupu do wypłatyOś czasu zamówienia z marketplace na Mirakl w Odoo 17, 18, 19 i 20: akceptacja, wysyłka, numer śledzenia, zwrot, faktura i rozliczenie.Jak zmapować kategorie i atrybuty Mirakl w Odoo krok po krokuJak przygotować w Odoo katalog dla marketplace na Mirakl: słownik kategorii, atrybuty, listy wartości, mapowanie i eksport, wraz z typowymi błędami.Uruchomienie Leroy Merlin Connector w Odoo: pytania i odpowiedziJakie pola wypełnić w Leroy Merlin Connector dla Odoo, przez jakie stany przechodzi śledzenie i co sprawdzić w pierwszym tygodniu po podłączeniu.
Sprawdzone w kodzie źródłowym konektora (wersja 17.0, 18.0, 19.0 i 20.0)

Źródła

  • Kod modułu: flexigobe_mirakl_connector · 17.0 f10058e · 18.0 0d42567 · 19.0 9939dcd · 20.0 5c53911: models/mirakl_instance.py (_onchange_provider_code, _apply_provider_defaults_to_record, _should_apply_provider_default), views/menu_views.xml, views/mirakl_instance_views.xml; flexigobe_mirakl_provider_leroy_merlin · 17.0 e4e5b5d · 18.0 01707b8 · 19.0 6e605bb · 20.0 f3f10df y flexigobe_mirakl_provider_decathlon · 17.0 d6944fe · 18.0 8b78e2d · 19.0 c0c6021 · 20.0 80e11d3: models/mirakl_instance.py (_mirakl_provider_default_values)
  • Kod modułu: flexigobe_mirakl_connector · 17.0 f10058e · 18.0 0d42567 · 19.0 9939dcd · 20.0 5c53911: models/mirakl_instance.py (cron_sync_orders, cron_accept_orders, cron_sync_returns), data/ir_cron_data.xml
  • Kod modułu: flexigobe_mirakl_connector · 17.0 f10058e · 18.0 0d42567 · 19.0 9939dcd · 20.0 5c53911: models/mirakl_instance.py (_mirakl_provider_known_hosts, _onchange_connection_urls, _mirakl_detect_provider_from_urls); proveedores Leroy Merlin y Decathlon (mismos commits que mir.prov.perfil): _mirakl_provider_detection_signatures
  • Kod modułu: flexigobe_mirakl_provider_leroy_merlin · 17.0 e4e5b5d · 18.0 01707b8 · 19.0 6e605bb · 20.0 f3f10df: models/mirakl_instance.py; flexigobe_mirakl_provider_decathlon (commits de mir.prov.perfil): models/mirakl_instance.py; flexigobe_mirakl_connector (commits de mir.prov.perfil): models/mirakl_marketplace_profile_mixin.py
  • Kod modułu: flexigobe_mirakl_connector · 17.0 f10058e · 18.0 0d42567 · 19.0 9939dcd · 20.0 5c53911: models/stock_picking.py (button_validate, _mirakl_sync_sale_shipping_contacts, action_mirakl_push_tracking), models/mirakl_instance.py (_mirakl_auto_push_tracking_on_validate), views/stock_picking_views.xml; proveedores Leroy Merlin y Decathlon: _mirakl_auto_push_tracking_on_validate y _mirakl_repair_shipping_before_validate devuelven True
  • Kod modułu: flexigobe_mirakl_connector · 17.0 f10058e · 18.0 0d42567 · 19.0 9939dcd · 20.0 5c53911: models/mirakl_instance.py (push de seguimiento con _mirakl_supports_advanced_tracking_flow)