Co zmienia Odoo jako ERP w Twoich marketplace'ach Mirakl
Zgodnie z dokumentacją Mirakl każdy marketplace ma własny adres, który trzeba podmienić na adres Twojej instancji Mirakl, a API sprzedawcy uwierzytelnia się kluczem sklepu przesyłanym w nagłówku Authorization. Każdy operator, na którym sprzedajesz, ma więc własny adres i własny klucz.
W Mirakl Connector każdy operator staje się instancją Mirakl w Odoo, tworzoną z rzeczywistym bazowym adresem URL operatora, API Base URL i kluczem API. Według opisu w katalogu moduł łączy Odoo z dowolnym marketplace'em Mirakl: publikuje produkty, ceny i stany magazynowe oraz pobiera zamówienia, zwroty, rozliczenia i wiadomości. Wszystko znajduje się w jednym menu Mirakl, z pozycjami Dashboard, Operations, Catalog, Finances i Configuration.
Klucz każdego sklepu zostaje u swojego operatora: moduł wysyła go wyłącznie na API Base URL jego instancji. Jeśli ma połączyć się z innym adresem, zatrzymuje się z komunikatem: Refusing to contact …: the Mirakl API key of … only goes to its API Base URL (…). Write the endpoint as a path, such as /orders.


Operator po operatorze dziś a Mirakl w Odoo
Poniżej porównanie zadań: co robisz z każdym marketplace'em i gdzie trafia to w Odoo z konektorem.
| Zadanie | Dziś, operator po operatorze | W Odoo z Mirakl Connector |
|---|---|---|
| Połączenie każdego marketplace'u | Każdy marketplace ma własny adres, a logujesz się kluczem sklepu | Jedna instancja na operatora, z bazowym adresem URL operatora, API Base URL i kluczem API |
| Odczyt nowych zamówień | Mirakl zaleca sprawdzanie listy zamówień (OR11) co 5 minut i najwyżej raz na minutę | Zaplanowana akcja Mirakl - Sync Orders, co 10 minut; lista w Mirakl › Operations › Orders |
| Akceptacja zamówień | Pozycje w WAITING_ACCEPTANCE akceptuje się lub odrzuca przez OR21 | Zaplanowana akcja Mirakl - Accept Orders, co 10 minut |
| Oferty i stany | W każdym marketplace'ie, pod jego adresem | Mirakl › Operations › Offers; zaplanowane akcje Mirakl - Export Offers (co 5 minut), Mirakl - Export Prices (PRI01) (co 15 minut) i Mirakl - Export Stock (STO01) (co 10 minut) |
| Zwroty | W każdym marketplace'ie, pod jego adresem | Mirakl › Operations › Returns; zaplanowana akcja Mirakl - Sync Returns, co 30 minut |
| Rozliczenia operatora | W każdym marketplace'ie, pod jego adresem | Mirakl › Finances › Settlements & Invoices oraz, w tym samym menu, Financial Analysis (P&L) |
Każda zaplanowana akcja z tabeli jest aktywna zaraz po instalacji modułu. Każda działa jednak tylko w instancjach, w których zaznaczone jest jej pole, a te pola są domyślnie niezaznaczone. Dziś każdy wiersz robisz w każdym marketplace'ie, pod jego adresem; w Odoo każdy wiersz to menu albo zaplanowana akcja modułu. Co moduł dodaje do zamówienia sprzedaży w Odoo, pole po polu, opisujemy w co Mirakl Connector dodaje do Sprzedaży.
Katalog i wiadomości są poza tabelą. W Mirakl › Catalog masz Categories, Attributes, Value Lists, Category Mapping i Carrier Mapping, z zaplanowanymi akcjami Mirakl - Export Catalog (co 30 minut) i Mirakl - Sync Catalog Dictionary (co 60 minut). Wiadomości mają własne menu w Mirakl › Operations › Messages.


Cennik Mirakl Connect i czego potrzebuje konektor
Mirakl publikuje cennik swojego narzędzia dla sprzedawców, Mirakl Connect, które opisuje jako pomoc dla dziesiątek tysięcy sprzedawców w dotarciu do czołowych marketplace'ów na świecie. Ceny na jego stronie są w dolarach i zależą od miesięcznego wolumenu sprzedaży (GMV):
- Growth: 699 USD miesięcznie, do 50 000 USD GMV miesięcznie.
- Pro: 2299 USD miesięcznie, do 200 000 USD GMV miesięcznie.
- Enterprise: wycena indywidualna, dla każdego powyżej tego wolumenu, czyli przy przetwarzaniu ponad 200 tys. USD GMV miesięcznie.
Aby przenieść marketplace'y Mirakl do Odoo z Mirakl Connector, potrzebujesz:
- Odoo w wersji 17, 18, 19 lub 20.
- Zainstalowanego Mirakl Connector w tej wersji.
- Subskrypcji FlexigoTech Cloud w planie Konektor, której moduł wymaga według opisu w katalogu.
- Dla każdego operatora: jego rzeczywistego bazowego adresu URL, bazowego adresu API i klucza Twojego sklepu.
Z tymi danymi każdy operator ma w Odoo własną instancję, a klucz każdego sklepu trafia tylko na adres API swojego operatora.
Od wdrożenia Odoo do pierwszego rozliczenia Mirakl, po kolei
Jeśli nie masz jeszcze Odoo, kolejność ma znaczenie: najpierw Odoo, potem konektor, potem każdy operator.
- Wdróż Odoo. FlexigoTech wdraża Odoo 17, 18, 19 i 20; możesz zacząć od wdrożenia Odoo, zanim podłączysz jakikolwiek marketplace.
- Zainstaluj Mirakl Connector w swojej wersji i połącz go z subskrypcją FlexigoTech Cloud w planie Konektor.
- Utwórz jedną instancję Mirakl na operatora, z rzeczywistym bazowym adresem URL operatora,
API Base URLi kluczem API Twojego sklepu. WMirakl › ConfigurationznajdzieszMarketplacesiLogs. Co oznacza każde pole instancji, opisujemy w polach instancji Mirakl. - Poczekaj na pierwsze zamówienie. Zaplanowana akcja
Mirakl - Sync Ordersdziała co 10 minut, a zamówienia pojawiają się wMirakl › Operations › Orders. Akcja pobiera zamówienia tylko z instancji z zaznaczonym polemSynchronizacja zamówień włączona(Sync Orders Enabled), które domyślnie jest niezaznaczone. W Mirakl nowe pozycje, które się akceptuje lub odrzuca przez OR21, to te wWAITING_ACCEPTANCE. - Sprawdź swoje zamówienia w
Mirakl › Operations › Orders: lista pokazuje ich status i akceptację. Zaplanowana akcjaMirakl - Accept Ordersdziała co 10 minut i jest aktywna po instalacji. Akceptuje zamówienia tylko w instancjach z zaznaczonym polemAutomatycznie akceptuj zamówienia(Auto Accept Orders), które domyślnie jest niezaznaczone. - Przejrzyj swoje oferty w
Mirakl › Operations › Offers. Zaplanowane akcje eksportujące oferty, ceny i stany również są aktywne po instalacji. Eksportują jednak tylko z instancji, w których zaznaczone jest odpowiednie pole: dla ofertSynchronizacja ofert włączona(Sync Offers Enabled), dla cenAutomatyczny eksport cen włączony(Auto Export Prices Enabled), a dla stanówAutomatyczny eksport stanów magazynowych włączony(Auto Export Stock Enabled). Wszystkie trzy są domyślnie niezaznaczone. - Otwórz pierwsze rozliczenie w
Mirakl › Finances › Settlements & Invoicesi zajrzyj doFinancial Analysis (P&L)w tym samym menu.
Jeśli chcesz zobaczyć konektor przed decyzją, jego strona jest na flexigotech.com. Poza wdrażaniem Odoo FlexigoTech tworzy konektory i integracje na zamówienie, gdyby Twój sposób pracy z danym operatorem wymagał czegoś więcej.
Ile kosztuje Mirakl w Odoo: moduł i plan Konektor
Mirakl Connector kosztuje 9 € za wersję Odoo, netto (bez VAT), dla wersji 17, 18, 19 i 20. W opisie w katalogu jest informacja, że wymaga subskrypcji FlexigoTech Cloud: plan Konektor kosztuje 49 €/mies. lub 490 €/rok netto (bez VAT), z maksymalnie 3 kontami platform, a Pro kosztuje 98 €/mies. lub 980 €/rok netto (bez VAT), z maksymalnie 10. Subskrypcję można wypróbować bezpłatnie, bez karty.
Do tego dochodzi wdrożenie Odoo, które jest osobną pracą. Moduł i subskrypcja są na stronie konektora Mirakl dla Odoo.
Mirakl z Odoo jako ERP: najczęstsze pytania
Czy mogę podłączyć kilku operatorów Mirakl do tego samego Odoo?
Każdy operator trafia do własnej instancji Mirakl, z własnym bazowym adresem URL, bazowym adresem API i kluczem. Plan Konektor obejmuje do 3 kont platform, a Pro do 10.
Jak często zamówienia trafiają do Odoo?
Zaplanowana akcja Mirakl - Sync Orders działa co 10 minut i jest aktywna po instalacji. Pobiera zamówienia tylko z instancji z zaznaczonym polem Synchronizacja zamówień włączona (Sync Orders Enabled), które domyślnie jest niezaznaczone. Mirakl ze swojej strony zaleca odczyt listy zamówień co 5 minut i najwyżej raz na minutę.
Czy klucz sklepu może trafić do innego operatora?
Moduł wysyła klucz każdej instancji wyłącznie na jej API Base URL. Jeśli ma połączyć się z innym adresem, zatrzymuje się z komunikatem Refusing to contact …: the Mirakl API key of … only goes to its API Base URL (…). Write the endpoint as a path, such as /orders.
Na jakich wersjach Odoo działa?
Mirakl Connector jest opublikowany w Odoo Apps dla Odoo 17, 18, 19 i 20.
Czytaj dalej
Sprawdzone w kodzie źródłowym konektora (wersja 20.0) i w podlinkowanych źródłach
Źródła
- developer.mirakl.com/content/product/mmp/rest/seller/openapi3.md
- developer.mirakl.com/content/product/mmp/rest/seller/openapi3/orders/or11.md
- developer.mirakl.com/content/product/mmp/rest/seller/openapi3/orders/or21.md
- www.mirakl.com/products/connect/pricing/
- www.mirakl.com/
- apps.odoo.com/apps/modules/17.0/flexigobe_mirakl_connector
- apps.odoo.com/apps/modules/18.0/flexigobe_mirakl_connector
- apps.odoo.com/apps/modules/19.0/flexigobe_mirakl_connector
- apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
- Kod modułu: flexigobe_mirakl_connector 20.0 (2766034c): __manifest__.py
- Kod modułu: flexigobe_mirakl_connector 20.0 (2766034c): views/menu_views.xml
- Kod modułu: flexigobe_mirakl_connector 20.0 (2766034c): data/ir_cron_data.xml
- flexigotech.com/pl/integracja-mirakl-odoo.html
- flexigotech.com/pl/precios.html
- Kod modułu: flexigobe_mirakl_connector 20.0 (2766034c): models/mirakl_api_mixin.py
- Kod modułu: flexigobe_mirakl_connector 20.0 (2766034c): README.md
