Zum Hauptinhalt springen
Mirakl

So richten Sie Leroy Merlin oder Decathlon im Mirakl-Konnektor ein

Leroy Merlin und Decathlon verkaufen über Mirakl, und in Odoo wird jeder von beiden als weiterer Marketplace des Mirakl-Konnektors angelegt. Was sich ändert, ist das Betreiberprofil: Mit dem installierten Modul für Leroy Merlin oder Decathlon wählen Sie das Profil unter «Provider Code», Odoo setzt die Kästchen für Bestellungen und Retouren, die Sie brauchen, trägt die Adresse des Betreibers ein und sendet bei der Validierung eines Lieferscheins die Sendungsverfolgung an Mirakl, ohne dass Sie etwas anklicken müssen.

FlexigoTech · Verantwortlich: Víctor Gómez · Aktualisiert am 5. November 2026

Das Wichtigste

Modul
Mirakl
Versionen
Odoo 17, 18, 19 und 20
Geprüft
im Quellcode des Connectors, Version 17.0, 18.0, 19.0 und 20.0
Lesezeit
4 Min.

Den Betreiber anlegen

  1. Installieren Sie den Mirakl-Konnektor und das Betreibermodul: «Leroy Merlin for Mirakl» oder «Decathlon for Mirakl». Ohne dieses Modul bietet «Provider Code» nur «Generic Mirakl» an.
  2. Gehen Sie zu Mirakl › Configuration › Marketplaces und legen Sie einen neuen Marketplace an.
  3. Wählen Sie unter «Provider Code» Leroy Merlin oder Decathlon. Odoo füllt dann die noch nicht gesetzten Kästchen des Profils und die leeren Felder aus.
  4. Prüfen Sie die Adresse. Für Leroy Merlin lautet sie https://adeo-marketplace.mirakl.net, mit der API unter https://adeo-marketplace.mirakl.net/api; für Decathlon marketplace-decathlon-eu.mirakl.net.
  5. Vervollständigen Sie die Verbindung mit den Zugangsdaten Ihres Kontos beim Betreiber, speichern Sie und klicken Sie auf «Test Connection».
Liste der Mirakl-Marketplaces in Odoo, einer pro Betreiber, mit ihrem Provider Code und dem letzten Verbindungstest
Ein Marketplace pro Betreiber unter Mirakl › Configuration › Marketplaces. In dieser Demodatenbank sind die Betreibermodule nicht installiert, deshalb verwenden alle drei «Generic Mirakl». Screenshot aus Odoo mit Demodaten.

Wenn Sie mit dem generischen Profil beginnen und die Adresse des Betreibers eintippen, erkennt Odoo sie am Host: adeo-marketplace oder leroymerlin für Leroy Merlin; marketplace-decathlon, marketplace.decathlon, seller.decathlon, partner.decathlon, .decathlon.net oder .decathlon.com für Decathlon. Und wechseln Sie von einem Betreiber zum anderen, wird die alte Adresse durch die neue ersetzt. Eine von Hand eingegebene Adresse, die zu keinem bekannten Betreiber gehört, bleibt unverändert.

Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (Video auf Englisch)

Was das Profil setzt

KästchenGenerisches ProfilLeroy Merlin und DecathlonWofür es dient
Sync Orders EnabledNicht gesetztGesetztDie Aufgabe «Mirakl - Sync Orders» importiert alle 10 Minuten die Bestellungen
Auto Accept OrdersNicht gesetztGesetztDie Aufgabe «Mirakl - Accept Orders» nimmt alle 10 Minuten die Bestellungen an, die Mirakl auf Ihre Annahme wartend führt
Accept Pending On ImportNicht gesetztGesetztVersucht, wartende Bestellungen direkt nach jedem Import, manuell oder geplant, anzunehmen
Auto Confirm SaleNicht gesetztGesetztBestätigt die importierten Verkaufsaufträge
Sync Returns EnabledNicht gesetztGesetztDie Aufgabe «Mirakl - Sync Returns» holt die Retouren alle 30 Minuten ab
Returns Fallback To OrdersGesetztGesetztWenn der Betreiber über die API keine Retouren anbietet, werden sie aus den Erstattungen in den Bestellungen erstellt

Das Profil füllt nur aus, was leer oder nicht gesetzt ist. Einen Wert, den Sie bereits eingetragen haben, behält es. Das betrifft «Offer Price Tax Mode»: Das Profil enthält «Include Sales Taxes», aber das Feld steht bereits auf «As Computed», daher ändert sich beim Wählen des Profils im Formular nichts. Entscheiden Sie selbst, wie Sie Ihre Angebotspreise angeben, und legen Sie das vor dem Export fest.

Leroy Merlin: Katalog und Angebote im Format des Betreibers

Das Profil von Leroy Merlin setzt zwei weitere Kästchen, die standardmäßig nicht gesetzt sind und die das Profil von Decathlon nicht anfasst:

  • Den Katalog im Format des Betreibers exportieren. Die Hilfe des Feldes lautet: When enabled, catalog export defaults to Mirakl operator-format multipart CSV instead of raw JSON.
  • Die Angebote mit dem OF01-Dateiimport im Format des Betreibers exportieren: When enabled, offer export defaults to Mirakl OF01 operator-format multipart file import.

Wenn Sie von einem Marketplace ohne das Profil von Leroy Merlin exportieren, prüfen Sie diese beiden Kästchen, bevor Sie dem Katalog die Schuld geben.

Der Versand geht bei der Validierung des Lieferscheins raus

Mit diesen beiden Profilen genügt es, in Odoo die Lieferung einer Mirakl-Bestellung zu validieren, um den Marketplace zu benachrichtigen, auch wenn das Kästchen «Send Tracking to Mirakl on Validation» nicht gesetzt ist, wie es standardmäßig der Fall ist. Im generischen Profil entscheidet genau dieses Kästchen.

Vor der Validierung aktualisiert Odoo den Verkaufsauftrag mit der Mirakl-Bestellung und trägt den Lieferkontakt des Käufers in die Überweisung ein. Fehlt diesem Kontakt die Straße, die Stadt, die Postleitzahl oder die Telefonnummer, fragt Odoo die Bestellung erneut bei Mirakl ab und baut sie neu auf.

Danach läuft der Versand in zwei Schritten. Zuerst die Sendungsverfolgung (OR23). Wenn Mirakl die Bestellung noch nicht als versendet führt, markiert Odoo sie als versendet (OR24). Lehnt der Betreiber den ersten Schritt ab, zum Beispiel mit einem 404 oder weil er den Code des Versanddienstleisters nicht erkennt, geht Odoo direkt zum zweiten. Und wenn Ihr Versanddienstleister in Odoo nur auf OTHER abgebildet wird, verwendet Odoo den Versanddienstleister aus der Mirakl-Bestellung.

Validierter Lieferschein einer Mirakl-Bestellung mit der Schaltfläche Push Mirakl Tracking und der Sendungsverfolgung im Status Synced
Ein validierter Lieferschein: die Schaltfläche «Push Mirakl Tracking», der Status der Sendungsverfolgung auf Synced, die letzte an Mirakl gesendete Anfrage und im Verlauf «Mirakl tracking pushed successfully.» Screenshot aus Odoo mit Demodaten.

Wenn der Lieferschein keine Sendungsnummer hat

Es wird nichts gesendet. Odoo vermerkt das im Lieferschein: 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. Tragen Sie die Sendungsnummer des Versanddienstleisters ein und klicken Sie auf «Push Mirakl Tracking», das die Sendungsverfolgung manuell sendet.

Wenn die Auftragspositionen fehlen

Mit diesen beiden Profilen braucht der Versand die Auftragspositionen der Mirakl-Bestellung. Findet Odoo sie weder in der Mirakl-Bestellung noch im Verkaufsauftrag, bricht es mit Missing Mirakl order lines to push tracking. ab.

Kann ich Leroy Merlin und Decathlon im selben Odoo haben?

Ja. Jeder Betreiber ist ein eigener Marketplace unter Mirakl › Configuration › Marketplaces, mit eigenem Profil, eigenem Schlüssel und eigenem Shop.

Und wenn ich nicht will, dass Bestellungen automatisch angenommen werden?

Entfernen Sie nach der Wahl des Profils die Markierung bei «Auto Accept Orders» und «Accept Pending On Import» und speichern Sie: Was Sie von Hand einstellen, hat Vorrang vor dem Profil. Wählen Sie das Profil später unter «Provider Code» erneut, werden diese Kästchen wieder gesetzt.

Weiterlesen

Eine Mirakl-Bestellung in Odoo, vom Kauf bis zur AuszahlungZeitstrahl einer Bestellung von einem Mirakl-Marktplatz in Odoo 17, 18, 19 und 20: Annahme, Versand, Sendungsverfolgung, Retoure, Rechnung und Abrechnung.Mirakl-Kategorien und Attribute in Odoo zuordnen, Schritt für SchrittSo bereiten Sie den Katalog eines Mirakl-Marktplatzes in Odoo vor: Kategorienverzeichnis, Attribute, Wertelisten, Zuordnung und Export, mit den üblichen Fehlern.Leroy Merlin Connector in Odoo einrichten: Fragen und AntwortenWelche Felder Sie im Leroy Merlin Connector für Odoo ausfüllen, welche Status die Synchronisierung kennt und was Sie in der ersten Woche prüfen sollten.
Geprüft im Quellcode des Connectors (Version 17.0, 18.0, 19.0 und 20.0)

Quellen

  • Quellcode des Moduls: 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)
  • Quellcode des Moduls: 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
  • Quellcode des Moduls: 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
  • Quellcode des Moduls: 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
  • Quellcode des Moduls: 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
  • Quellcode des Moduls: 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)