Den Betreiber anlegen
- 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.
- Gehen Sie zu Mirakl › Configuration › Marketplaces und legen Sie einen neuen Marketplace an.
- 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.
- 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.
- Vervollständigen Sie die Verbindung mit den Zugangsdaten Ihres Kontos beim Betreiber, speichern Sie und klicken Sie auf «Test Connection».

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.

Was das Profil setzt
| Kästchen | Generisches Profil | Leroy Merlin und Decathlon | Wofür es dient |
|---|---|---|---|
| Sync Orders Enabled | Nicht gesetzt | Gesetzt | Die Aufgabe «Mirakl - Sync Orders» importiert alle 10 Minuten die Bestellungen |
| Auto Accept Orders | Nicht gesetzt | Gesetzt | Die Aufgabe «Mirakl - Accept Orders» nimmt alle 10 Minuten die Bestellungen an, die Mirakl auf Ihre Annahme wartend führt |
| Accept Pending On Import | Nicht gesetzt | Gesetzt | Versucht, wartende Bestellungen direkt nach jedem Import, manuell oder geplant, anzunehmen |
| Auto Confirm Sale | Nicht gesetzt | Gesetzt | Bestätigt die importierten Verkaufsaufträge |
| Sync Returns Enabled | Nicht gesetzt | Gesetzt | Die Aufgabe «Mirakl - Sync Returns» holt die Retouren alle 30 Minuten ab |
| Returns Fallback To Orders | Gesetzt | Gesetzt | Wenn 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.

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