Przejdź do głównej treści
Mirakl

Jak zmapować kategorie i atrybuty Mirakl w Odoo krok po kroku

Aby publikować produkty na marketplace działającym na Mirakl z poziomu Odoo, wskazujesz konektorowi, do której kategorii operatora należy każdy produkt i jakie wartości wypełniają jego obowiązkowe atrybuty. Robi się to w menu Catalog, w tej kolejności: słownik, kategorie, atrybuty i listy wartości, mapowanie, eksport i sprawdzenie walidacji.

FlexigoTech · Odpowiada: Víctor Gómez · Aktualizacja: 3 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
2 min

Każdy operator Mirakl ma własne drzewo kategorii i atrybuty. To, co Leroy Merlin nazywa w jeden sposób, Decathlon opisuje inaczej. Konektor, opublikowany dla Odoo 17, 18, 19 i 20, pobiera ten słownik i pozwala raz dopasować do niego Twój katalog.

Kroki

  1. Zarejestruj marketplace w Mirakl › Configuration › Marketplaces z adresem URL API i kluczem.
  2. Poczekaj na pierwszą synchronizację słownika katalogu. Zadanie powtarza się co 60 minut i zapisuje kategorie operatora w Mirakl › Catalog › Categories.
  3. Sprawdź w Catalog › Attributes, które atrybuty są obowiązkowe w kategoriach, których będziesz używać.
  4. Otwórz Catalog › Value Lists dla atrybutów, które przyjmują tylko zamknięte wartości, na przykład kolory albo materiały. Twoja wartość w Odoo musi odpowiadać jednej z listy.
  5. W Catalog › Category Mapping przypisz każdą swoją kategorię produktów do kategorii operatora.
  6. Jeśli wysyłasz sam, powiąż swoich przewoźników z przewoźnikami marketplace w Catalog › Carrier Mapping.
  7. Wyeksportuj katalog. Zadanie działa co 30 minut i możesz je też uruchomić ręcznie.
  8. Przed eksportem ofert sprawdź status ostatniego eksportu i walidację każdego produktu.
Drzewo kategorii operatora Mirakl pobrane do Odoo
Kategorie operatora w takiej postaci, w jakiej pobiera je konektor. Zrzut ekranu Odoo z danymi Leroy Merlin pobranymi przez konektor.
Same stock on every Mirakl marketplace, sent from Odoo
Wideo: Same stock on every Mirakl marketplace, sent from Odoo (wideo po angielsku)

Statusy, które musisz umieć odczytać

Każdy eksport katalogu zostawia status: oczekujący, sukces, błąd albo nieznany. Każdy produkt ma też status walidacji: niesprawdzony, OK, ostrzeżenie albo błąd. Ostrzeżenie nadal pozwala publikować, ale zwykle oznacza pusty atrybut opcjonalny, którego operator używa w filtrach. Warto go uzupełnić.

Z ofertami jest tak samo. Ostatni eksport ofert pokazuje wynik, a każda oferta ma kod statusu Mirakl: 11 dla aktywnej i 12 dla nieaktywnej.

Lista atrybutów operatora Mirakl z typem i informacją, czy są obowiązkowe
Atrybuty operatora: typ danych i to, czy są obowiązkowe. Zrzut ekranu Odoo z danymi Leroy Merlin pobranymi przez konektor.

Typowe błędy i jak je naprawić

KomunikatCo oznaczaCo zrobić
Catalog validation failed: …Operator odrzucił jeden lub więcej produktów. To, co jest po dwukropku, mówi, który i dlaczego.Popraw wskazany atrybut i wyeksportuj ponownie.
No catalog import id found yet. Export catalog first.Poprosiłeś o wynik importu, który jeszcze nie istnieje.Wyeksportuj katalog i poczekaj, aż Mirakl zwróci numer importu.
No import id found yet. Export the offer first.To samo, dla ofert.Wyeksportuj ofertę, zanim sprawdzisz wynik.
Selected category does not belong to this wizard.W kreatorze wybrano kategorię z innego marketplace.Otwórz go ponownie z właściwego marketplace.
Mapowanie kategorii Odoo na kategorie operatora Mirakl
Mapowanie kategorii: Twoje po lewej, operatora po prawej. Zrzut ekranu Odoo z danymi Leroy Merlin pobranymi przez konektor.

Kiedy eksportować oferty

Dopiero gdy produkt przejdzie walidację. Oferty eksportują się co 5 minut, ale oferta produktu, którego operator nie zaakceptował, pozostaje nieaktywna nawet z ceną i stanem. Jeśli widzisz na liście wiele nieaktywnych ofert, problem prawie zawsze leży krok wcześniej, w katalogu.

Gdy dodajesz nowego operatora, powtórz mapowanie tylko dla jego kategorii: to, co już zmapowałeś dla innego marketplace, zostaje, bo każdy operator przechowuje własne mapowanie.

Rekordy w Configuration › Logs zapisują każde wywołanie do Mirakl. Jeśli błąd na ekranie nie ma sensu, pełna odpowiedź operatora jest właśnie tam.

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.Przykład: producent, który sprzedaje na kilku marketplace'ach Mirakl za pomocą arkuszyPrzykład producenta, który sprzedaje na kilku marketplace'ach Mirakl za pomocą arkuszy, i tego, co się zmienia, gdy wszystko przechodzi do Odoo z konektorem.
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 (83e54909): views/menu_views.xml
  • Kod modułu: flexigobe_mirakl_connector 20.0 (83e54909): data/ir_cron_data.xml
  • Kod modułu: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_catalog_binding_mixin.py
  • Kod modułu: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_offer_binding_mixin.py
  • Kod modułu: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_product_binding.py
  • Kod modułu: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_category_search_wizard.py
  • apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector