Die häufigste Verwechslung bei Mirakl: es wie Amazon zu behandeln. Das ist es nicht. Mirakl ist die Plattform, mit der Decathlon, Leroy Merlin, Bricodepot, GACD und Dutzende weitere Ketten ihren eigenen Marktplatz für externe Verkäufer öffnen. Für Sie hat das eine sehr gute und eine mittelmäßige Folge.
Die gute: Die API ist für alle dieselbe. Eine sauber umgesetzte Mirakl-Integration reicht für den ersten Betreiber ebenso wie für den fünften, Sie ändern nur die URL des Betreibers und den API-Schlüssel. Die mittelmäßige: Auf dieser gemeinsamen Basis setzt jeder Betreiber eigene Regeln (seinen Kategorienbaum, seine Pflichtattribute, seine Fristen, seine Strafen und sogar, welche Teile der API er freigibt), und diese gelten nicht übergreifend.
Was alle gemeinsam haben
Der Ablauf ist immer derselbe: Sie veröffentlichen Angebote (Produkt, Preis, Bestand, Lieferzeit), der Betreiber schickt Ihnen Bestellungen, Sie nehmen sie an oder lehnen sie ab, Sie versenden mit Sendungsverfolgung und werden per Abrechnung bezahlt. Der Mirakl-Konnektor überführt diesen Ablauf in normale Odoo-Belege in 17, 18 und 19: Er veröffentlicht Angebote mit Preis, Bestand und Versandfrist, importiert die Bestellungen als Verkaufsaufträge, nimmt sie an (von Hand oder automatisch, wenn Sie das aktivieren), übermittelt Zusteller und Sendungsverfolgungsnummer des Lieferscheins an Mirakl und importiert die Abrechnungen, um sie in der Buchhaltung zu verbuchen.
Ein Detail, das überrascht: In Mirakl können Sie Positionen einer Bestellung ablehnen. Das ist kein Fehler, sondern Teil des Protokolls. Unser Konnektor lehnt keine einzelnen Positionen ab: Er nimmt die gesamte Bestellung an. Wenn Sie eine Position nicht liefern können, lehnen Sie sie im Mirakl-Backoffice ab, bevor Sie annehmen, und beachten Sie, dass die automatische Annahme, die standardmäßig deaktiviert ist, alles annimmt, was eingeht.
Was sich je Betreiber ändert
Der Kategorienbaum und die Pflichtattribute, die sich zwischen einer Sportkette und einer Baumarktkette nicht ähneln. Die Annahmefrist, die bei manchen Betreibern in Stunden gemessen wird. Und die Anforderungen an die Produktdaten: Manche Betreiber lehnen ein Angebot ab, wenn die EAN fehlt, andere verlangen zusätzlich ein vollständiges Datenblatt.
Deshalb haben wir neben der Seite zum Konnektor je eine Seite pro Betreiber: Decathlon, Leroy Merlin, Brico Depot und GACD. Der Basis-Konnektor ist derselbe, und jeder Betreiber ist eine weitere Instanz mit eigener URL und eigenem Schlüssel; für manche Betreiber gibt es zusätzlich ein Ergänzungsprofil, das die URL und deren Standardwerte voreinstellt. Was sich wirklich unterscheidet, ist die Vorbereitung des Katalogs.
Was Sie vor dem Antrag auf Zulassung vorbereiten sollten
Drei Dinge, und keines ist technisch. Eine EAN für jede Referenz, die Sie veröffentlichen: Manche Betreiber nehmen das Angebot ohne sie nicht an. Eine Bearbeitungsfrist, die Sie wirklich einhalten können, nicht die, die Sie sich wünschen; 24 Stunden zu versprechen und in 72 zu liefern, bezahlen Sie auf Ihrem Konto. Und Fotos, die ihre Vorgaben erfüllen, die meist strenger sind als die Ihrer eigenen Website.
Und eine Warnung aus eigener Erfahrung
Wir haben unseren eigenen Mirakl-Konnektor auditiert, als seine Testsuite in Odoo 19, 18 und 17 grün durchlief, und 18 bestätigte Fehler gefunden, darunter ein Aufrufprotokoll, das nie etwas schrieb, und eine Synchronisierung, die das falsche Datum ansah. Die ganze Geschichte erzählen wir in Audit eines geerbten Konnektors. Wenn man Ihnen eine Mirakl-Integration verkaufen will, fragen Sie, was passiert, wenn die API einen Fehler zurückgibt, nicht, wie viele Tests es gibt.
Häufig gestellte Fragen
Öffnet mir eine Zulassung bei Mirakl alle Betreiber?
Nein. Jeder Betreiber nimmt Sie separat an oder nicht, mit eigenem kaufmännischem Verfahren. Wiederverwendet wird die technische Integration, nicht die Geschäftsbeziehung.
Kann ich je Betreiber unterschiedliche Preise haben?
Ja, und das sollten Sie: Die Provisionen sind nicht gleich. Im Konnektor ist jeder Betreiber eine Instanz, und jede Instanz berechnet ihren Preis mit ihrer eigenen Strategie: Verkaufspreis des Produkts, eine Odoo-Preisliste oder Kosten plus Marge.
Was passiert mit den Abrechnungen?
Sie kommen pro Betreiber und müssen mit den Verkäufen abgestimmt werden, abzüglich Provision. Das ist der am meisten vernachlässigte Teil, und hier geht am meisten Geld verloren, ohne dass es jemand bemerkt.
Nützliche Links bei FlexigoTech
Was wir dazu tun
Wurden Sie auf einem Mirakl-Marktplatz zugelassen?
Sagen Sie uns, welcher Betreiber es ist und wie viele Referenzen Sie veröffentlichen möchten. Wir prüfen, ob Ihr Katalog erfüllt, was man von Ihnen verlangen wird, bevor er abgelehnt wird. Schreiben Sie an comercial@flexigobe.com oder vereinbaren Sie ein Gespräch.

