Przejdź do głównej treści
Mirakl

Zamówienie z Mirakl w Odoo, od zakupu do wypłaty

Zamówienie z marketplace działającego na Mirakl przechodzi w Odoo przez siedem przystanków: przychodzi, zostaje zaakceptowane, przygotowane, wysłane z numerem śledzenia, zafakturowane, opłacone w rozliczeniu, a czasem wraca jako zwrot. Ta oś czasu mówi, co konektor robi na każdym przystanku i jak często.

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

Leroy Merlin, Decathlon czy Bricodepot działają pod spodem na Mirakl. Dla Odoo operator nie ma znaczenia: konektor, opublikowany dla Odoo 17, 18, 19 i 20, rozmawia z API Mirakl każdego marketplace, który skonfigurujesz, i zawsze trzyma się tego samego kalendarza.

Droga zamówienia

  1. Gdy klient kupuje Zamówienie powstaje na marketplace i czeka na akceptację. Odoo jeszcze nic o nim nie wie.
  2. W ciągu kolejnych 10 minut Zadanie Mirakl - Sync Orders pobiera je do Odoo. Pojawia się w Mirakl › Operations › Orders ze statusem akceptacji oczekującym.
  3. Przy kolejnym przebiegu akceptacji Mirakl - Accept Orders też działa co 10 minut i akceptuje to, co ustawiłeś do automatycznej akceptacji. Jeśli marketplace nie wymaga akceptacji, status zmienia się na niewymagana; jeśli coś się nie uda, na błąd, na widoku.
  4. Przy akceptacji Powstaje zamówienie sprzedaży w Odoo z pozycjami i klientem. Stan zostaje zarezerwowany dla pozostałych kanałów.
  5. Gdy dostawa jest przygotowana i zatwierdzona Numer śledzenia przewoźnika trafia na marketplace. Status śledzenia zamówienia zmienia się z oczekującego na zsynchronizowany albo na błąd, jeśli Mirakl go odrzuci.
  6. Przy fakturowaniu Faktura sprzedaży zostaje zaksięgowana w Odoo, a potem wysłana do Mirakl. Kolejność ma znaczenie: faktura w szkicu nie zostanie wysłana.
  7. Gdy przychodzi rozliczenie Settlements & Invoices zbiera płatności operatora z ich statusem: oczekująca, w realizacji, przelana albo opłacona. Każdy dokument ma też status księgowy: niezaksięgowany, zaksięgowany albo uzgodniony.
  8. Jeśli jest zwrot Zwroty synchronizują się co 30 minut i pojawiają się w Operations › Returns. Zwrot pieniędzy ma własny status: oczekujący, częściowy, zwrócony albo błąd.
Lista zamówień Mirakl w Odoo ze statusem akceptacji i wysyłki
Zamówienia z marketplace Mirakl w Odoo, każde ze swoim statusem. Zrzut ekranu Odoo z danymi demonstracyjnymi.
Same stock on every Mirakl marketplace, sent from Odoo
Wideo: Same stock on every Mirakl marketplace, sent from Odoo (wideo po angielsku)

W międzyczasie: stany i ceny

Gdy zamówienie posuwa się naprzód, trzy inne zadania utrzymują witrynę na bieżąco. Oferty wychodzą co 5 minut. Stany idą przepływem STO01 co 10 minut, a ceny przez PRI01 co 15. Dzięki temu, gdy zaakceptowane zamówienie rezerwuje sztuki, pozostałe marketplace'y widzą to w ciągu kilku minut.

Zamówienie sprzedaży w Odoo utworzone z zamówienia Mirakl
Zamówienie sprzedaży, które konektor tworzy przy akceptacji. Tu zaczyna się cała reszta: dostawa, faktura i zwrot. Zrzut ekranu Odoo z danymi demonstracyjnymi.

Dwa ostrzeżenia, które widać najczęściej

Przy wysyłaniu faktury mogą pojawić się dwa komunikaty. Post the invoice before sending it to Mirakl. oznacza, że faktura jest jeszcze szkicem: zaksięguj ją i wyślij ponownie. This invoice is not linked to a Mirakl order. pojawia się, gdy faktura nie pochodzi z zamówienia z marketplace, na przykład gdy utworzyłeś ją ręcznie. Rozwiązaniem jest fakturowanie z samego zamówienia sprzedaży.

Zatwierdzona dostawa zamówienia Mirakl z wysłanym już numerem śledzenia
Zatwierdzona dostawa: numer śledzenia trafił już na marketplace. Zrzut ekranu Odoo z danymi demonstracyjnymi.

Co nie działa samo

Synchronizacja faktur z Mirakl, działająca raz dziennie, jest po instalacji wyłączona: włączasz ją, jeśli Twój operator z niej korzysta. Wiadomości od klientów też nie włączają się automatycznie. Dzięki temu do Odoo nie trafiają informacje, na które nikt nie będzie patrzył.

Obejrzyj film na YouTube
Film demonstracyjny konektora Mirakl w Odoo, z symulowanym API Mirakl.

Jeśli zastanawiasz się, dlaczego zamówienie utknęło, najpierw spójrz na liście na jego status akceptacji i status śledzenia. Prawie zawsze jeden z nich jest w błędzie, a komunikat mówi dlaczego.

Czytaj dalej

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.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): data/ir_cron_data.xml
  • Kod modułu: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_finance.py
  • Kod modułu: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_invoice.py
  • Kod modułu: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_order.py
  • Kod modułu: flexigobe_mirakl_connector 20.0 (83e54909): models/stock_picking.py
  • Kod modułu: flexigobe_mirakl_connector 20.0 (83e54909): models/account_move.py
  • Kod modułu: flexigobe_mirakl_connector 20.0 (83e54909): views/menu_views.xml
  • apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
  • youtube.com/shorts/nbJU8l2bbCM