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
- Zarejestruj marketplace w Mirakl › Configuration › Marketplaces z adresem URL API i kluczem.
- Poczekaj na pierwszą synchronizację słownika katalogu. Zadanie powtarza się co 60 minut i zapisuje kategorie operatora w Mirakl › Catalog › Categories.
- Sprawdź w Catalog › Attributes, które atrybuty są obowiązkowe w kategoriach, których będziesz używać.
- 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.
- W Catalog › Category Mapping przypisz każdą swoją kategorię produktów do kategorii operatora.
- Jeśli wysyłasz sam, powiąż swoich przewoźników z przewoźnikami marketplace w Catalog › Carrier Mapping.
- Wyeksportuj katalog. Zadanie działa co 30 minut i możesz je też uruchomić ręcznie.
- Przed eksportem ofert sprawdź status ostatniego eksportu i walidację każdego produktu.


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.

Typowe błędy i jak je naprawić
| Komunikat | Co oznacza | Co 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. |

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