Dodaj operatora
- Zainstaluj konektor Mirakl oraz moduł operatora: „Leroy Merlin for Mirakl” lub „Decathlon for Mirakl”. Bez tego modułu „Provider Code” oferuje tylko „Generic Mirakl”.
- Wejdź w Mirakl › Configuration › Marketplaces i utwórz nowy marketplace.
- W polu „Provider Code” wybierz Leroy Merlin lub Decathlon. Odoo w tym momencie uzupełnia odznaczone pola profilu i puste pola.
- 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.
- Uzupełnij połączenie danymi Twojego konta u operatora, zapisz i kliknij „Test Connection”.

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.

Co zaznacza profil
| Pole | Profil generyczny | Leroy Merlin i Decathlon | Do czego służy |
|---|---|---|---|
| Sync Orders Enabled | Odznaczone | Zaznaczone | Zadanie „Mirakl - Sync Orders” importuje ich zamówienia co 10 minut |
| Auto Accept Orders | Odznaczone | Zaznaczone | Zadanie „Mirakl - Accept Orders” akceptuje co 10 minut zamówienia, na które Mirakl czeka na Twoją akceptację |
| Accept Pending On Import | Odznaczone | Zaznaczone | Próbuje zaakceptować oczekujące zamówienia zaraz po każdym imporcie, ręcznym lub zaplanowanym |
| Auto Confirm Sale | Odznaczone | Zaznaczone | Potwierdza zaimportowane zamówienia sprzedaży |
| Sync Returns Enabled | Odznaczone | Zaznaczone | Zadanie „Mirakl - Sync Returns” pobiera zwroty co 30 minut |
| Returns Fallback To Orders | Zaznaczone | Zaznaczone | Jeś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.

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
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)
