Zum Hauptinhalt springen
Mirakl

Eine Mirakl-Bestellung in Odoo, vom Kauf bis zur Auszahlung

Eine Bestellung von einem Marktplatz, der auf Mirakl läuft, durchläuft in Odoo sieben Stationen: Sie kommt an, wird angenommen, vorbereitet, mit Sendungsnummer versandt, abgerechnet, in der Abrechnung bezahlt und kommt manchmal als Retoure zurück. Dieser Zeitstrahl zeigt, was der Connector an jeder Station tut und wie oft.

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

Das Wichtigste

Modul
Mirakl
Versionen
Odoo 17, 18, 19 und 20
Geprüft
im Quellcode des Connectors, Version 20.0 · in den Quellen am Ende
Lesezeit
3 Min.

Leroy Merlin, Decathlon oder Bricodepot laufen im Hintergrund auf Mirakl. Für Odoo spielt der Betreiber keine Rolle: Der Connector, veröffentlicht für Odoo 17, 18, 19 und 20, spricht mit der Mirakl-API jedes Marktplatzes, den Sie einrichten, und folgt immer demselben Takt.

Der Weg

  1. Wenn der Kunde kauft Die Bestellung entsteht auf dem Marktplatz und wartet auf Annahme. Odoo weiß noch nichts davon.
  2. Innerhalb der nächsten 10 Minuten Die Aufgabe Mirakl - Sync Orders holt sie nach Odoo. Sie erscheint unter Mirakl › Operations › Orders mit dem Annahmestatus ausstehend.
  3. Beim nächsten Annahmelauf Mirakl - Accept Orders läuft ebenfalls alle 10 Minuten und nimmt an, was Sie zur automatischen Annahme eingestellt haben. Verlangt der Marktplatz keine Annahme, wechselt der Status zu nicht erforderlich; scheitert etwas, zu Fehler, gut sichtbar.
  4. Bei der Annahme Der Odoo-Verkaufsauftrag wird mit seinen Positionen und dem Kunden angelegt. Der Bestand ist damit für die anderen Kanäle gebunden.
  5. Wenn die Lieferung vorbereitet und validiert wird Die Sendungsnummer des Zustellers geht an den Marktplatz. Der Sendungsstatus der Bestellung wechselt von ausstehend zu synchronisiert, oder zu Fehler, wenn Mirakl sie ablehnt.
  6. Bei der Rechnungsstellung Die Kundenrechnung wird in Odoo gebucht und dann an Mirakl gesendet. Die Reihenfolge zählt: Eine Rechnung im Entwurf wird nicht gesendet.
  7. Wenn die Abrechnung kommt Settlements & Invoices sammelt die Zahlungen des Betreibers mit ihrem Status: ausstehend, in Bearbeitung, überwiesen oder bezahlt. Jedes Dokument trägt außerdem seinen Buchungsstatus: nicht gebucht, gebucht oder abgestimmt.
  8. Bei einer Retoure Retouren werden alle 30 Minuten synchronisiert und erscheinen unter Operations › Returns. Die Erstattung hat ihren eigenen Status: ausstehend, teilweise, erstattet oder Fehler.
Liste der Mirakl-Bestellungen in Odoo mit Annahme- und Versandstatus
Bestellungen eines Mirakl-Marktplatzes in Odoo, jede mit ihrem Status. Screenshot aus Odoo mit Demodaten.
Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (Video auf Englisch)

Währenddessen: Bestand und Preis

Während die Bestellung vorankommt, halten drei weitere Aufgaben das Schaufenster aktuell. Angebote gehen alle 5 Minuten raus. Der Bestand läuft alle 10 Minuten über den Ablauf STO01, Preise alle 15 über PRI01. Wenn also eine angenommene Bestellung Einheiten reserviert, sehen die anderen Marktplätze es innerhalb von Minuten.

Odoo-Verkaufsauftrag aus einer Mirakl-Bestellung
Der Verkaufsauftrag, den der Connector bei der Annahme anlegt. Von hier aus geht alles weiter: Lieferung, Rechnung und Retoure. Screenshot aus Odoo mit Demodaten.

Die zwei Warnungen, die Sie am häufigsten sehen

Zwei Meldungen können beim Senden der Rechnung erscheinen. Post the invoice before sending it to Mirakl. bedeutet, dass die Rechnung noch ein Entwurf ist: Buchen Sie sie und senden Sie erneut. This invoice is not linked to a Mirakl order. erscheint, wenn die Rechnung nicht aus einer Marktplatzbestellung stammt, etwa weil Sie sie von Hand angelegt haben. Die Lösung ist, aus dem Verkaufsauftrag selbst abzurechnen.

Validierte Lieferung einer Mirakl-Bestellung mit bereits gesendeter Sendungsnummer
Validierte Lieferung: Die Sendungsnummer ist schon beim Marktplatz. Screenshot aus Odoo mit Demodaten.

Was nicht von selbst läuft

Die Rechnungssynchronisierung aus Mirakl, die einmal täglich läuft, ist nach der Installation ausgeschaltet: Sie schalten sie ein, wenn Ihr Betreiber sie nutzt. Auch Kundennachrichten werden nicht automatisch aktiviert. So landen in Odoo keine Informationen, die niemand ansieht.

Video auf YouTube ansehen
Demovideo des Mirakl-Connectors in Odoo, mit simulierter Mirakl-API.

Wenn Sie wissen wollen, warum eine Bestellung hängt, schauen Sie zuerst in der Liste auf ihren Annahmestatus und ihren Sendungsstatus. Fast immer steht einer der beiden auf Fehler, und die Meldung sagt, warum.

Weiterlesen

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.Beispiel: ein Hersteller, der mit Tabellen auf mehreren Mirakl-Marktplätzen verkauftBeispielfall eines Herstellers, der mit Tabellen auf mehreren Mirakl-Marktplätzen verkauft, und was sich ändert, wenn alles mit dem Connector in Odoo läuft.
Geprüft im Quellcode des Connectors (Version 20.0) und in den verlinkten Quellen

Quellen

  • Quellcode des Moduls: flexigobe_mirakl_connector 20.0 (83e54909): data/ir_cron_data.xml
  • Quellcode des Moduls: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_finance.py
  • Quellcode des Moduls: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_invoice.py
  • Quellcode des Moduls: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_order.py
  • Quellcode des Moduls: flexigobe_mirakl_connector 20.0 (83e54909): models/stock_picking.py
  • Quellcode des Moduls: flexigobe_mirakl_connector 20.0 (83e54909): models/account_move.py
  • Quellcode des Moduls: flexigobe_mirakl_connector 20.0 (83e54909): views/menu_views.xml
  • apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
  • youtube.com/shorts/nbJU8l2bbCM