Zum Hauptinhalt springen
Mirakl

Was Mirakl Connector am Verkaufsauftrag in Odoo ergänzt (Verkauf)

Mirakl Connector ergänzt den Verkaufsauftrag um einen Reiter Mirakl mit Instanz, Bestellung, Status, letzter Synchronisierung sowie Versand- und Kontaktdaten und ist nur sichtbar, wenn der Auftrag eine Mirakl Bestellung enthält. Außerdem ändert er, was beim Löschen des Auftrags, beim Speichern von Adressänderungen und beim Fakturieren passiert.

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 20.0 · in den Quellen am Ende
Lesezeit
4 Min.

Was das Modul im Verkauf anpasst

Das Modul erweitert den Standard-Verkaufsauftrag der Odoo-App Verkauf (Sales). Es ergänzt Felder im Formular, eines davon auch in der Auftragsliste, sowie Anpassungen des Verhaltens im Code des Auftrags. Das sollten Sie wissen, bevor Sie den ersten Auftrag aus einem Marktplatz öffnen.

Mit Code erstelltes Schema: oben die App Verkauf und darunter die Felder, die Mirakl Connector ergänzt
Aus dem Code des Moduls erzeugtes Schema, kein Odoo-Bildschirm. Die Beschriftungen sind auf Englisch, dem Originaltext aus dem Code.
Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (Video auf Englisch)

Details, die im Formular nicht sichtbar sind

Die Felder erscheinen erst, wenn der Auftrag eine Mirakl Bestellung hat

Die Felder des Moduls liegen im Verkaufsauftrag im Reiter Mirakl, aufgeteilt in zwei Gruppen: Marktplatz und Versand & Kontakt (Shipping & Contact). Alle werden ausgeblendet, solange Mirakl Bestellung (Mirakl Order) leer ist. Bei einem Auftrag ohne diesen Wert sehen Sie davon also nichts.

In der Gruppe Marktplatz finden sich Mirakl Instanz (Mirakl Instance), Mirakl Bestellung, Mirakl Bestellstatus (Mirakl Order State) und Mirakl Letzte Synchronisierung am (Mirakl Last Sync At). Alle vier sind schreibgeschützt: Sie werden nur gelesen, nicht bearbeitet.

Mit Code erstelltes Schema mit dem Text der Gruppe Marktplatz in anderen Sprachen: Marktplatz, Place de marché und Marktplaats
Aus den Übersetzungen des Moduls erzeugtes Schema, kein Odoo-Bildschirm. Mit Odoo auf Deutsch erscheint die Gruppe als Marktplatz, auf Französisch als Place de marché und auf Niederländisch als Marktplaats.

Die Kunden-E-Mail kann ein anonymisiertes Relay sein

Mirakl-Kunden-E-Mail (Mirakl Customer Email) steht in der Gruppe Versand & Kontakt und ist schreibgeschützt. Laut Feldhilfe enthält sie nicht immer die echte E-Mail-Adresse des Käufers: Wenn es ein Relay gibt, speichert sie das anonymisierte Relay, das Mirakl für jede Bestellung erstellt, und was dorthin gesendet wird, erreicht den Käufer. Gibt es kein Relay, speichert sie die E-Mail-Adresse des Kunden, die die Bestellung mitbringt.

Telefon und Kontaktperson folgen einer eigenen Logik

Telefon des Mirakl-Kunden (Mirakl Customer Phone) enthält die Telefonnummer, die der Käufer im Marktplatz angegeben hat, damit sie direkt am Auftrag griffbereit ist. Laut Feldhilfe wird sie auch im Lieferkontakt gespeichert. Das Feld ist schreibgeschützt.

Mirakl-Kontaktperson (Mirakl Contact Person) hat eine zusätzliche Bedingung. Sie ist nur sichtbar, wenn der Auftrag eine Mirakl Bestellung hat und das Feld selbst einen Wert enthält. Die Feldhilfe sagt, dass es die Person enthält, die die Bestellung aufgegeben hat, wenn der Marktplatz zusätzlich einen Firmennamen sendet, und dass in diesem Fall die Firma als Name des Lieferkontakts verwendet wird. Wenn Sie es nicht sehen, ist das Feld in diesem Auftrag leer.

Die Versandart erscheint auch in der Auftragsliste

Mirakl-Versandart (Mirakl Shipping Method) steht in Versand & Kontakt und erscheint im Gegensatz zu den übrigen Feldern auch in der Liste der Verkaufsaufträge. Laut Feldhilfe ist es die Versandart, die der Käufer im Marktplatz gewählt hat (zum Beispiel Standard oder Nächster Tag), und sie bleibt leer, wenn der Betreiber sie nicht sendet.

Ein leeres Feld ist hier also kein Fehler: So sieht es aus, wenn der Betreiber diese Angabe nicht liefert.

Wird ein Mirakl-Auftrag gelöscht, bleibt er gelöscht

Das Modul ändert, was beim Löschen eines Verkaufsauftrags passiert. Laut dem Code von Odoo 20 sucht es vor dem Löschen die mit ihm verknüpften Mirakl-Bestellungen. Hat der Verkaufsauftrag eine Mirakl Bestellung, sucht es auch die Mirakl-Bestellung mit dieser Kennung in derselben Instanz, was ein Angebot abdeckt, das nie verknüpft wurde. Nach dem Löschen markiert es diese Mirakl-Bestellungen als gelöscht.

Der Grund steht in einem Kommentar im Code selbst: Ein gelöschter Verkaufsauftrag soll gelöscht bleiben, weil die Mirakl-Bestellung sich daran erinnert und eine neue Synchronisierung ihn nicht automatisch erneut anlegt oder bestätigt.

Kunde oder Adressen in einem Mirakl-Auftrag ändern

Wenn Sie in Odoo 20 Änderungen am Kunden, an der Lieferadresse oder an der Rechnungsadresse eines Auftrags mit Mirakl Bestellung speichern, führt das Modul das Speichern anders als im Standard aus. Bei Aufträgen ohne Mirakl Bestellung ist das Speichern der Standard.

Die Rechnung kann je nach Instanz vereinfacht oder vollständig sein

Beim Vorbereiten der Rechnung aus dem Auftrag prüft das Modul die Einstellung zur spanischen Rechnungsart in der Mirakl-Instanz des Auftrags (Code von Odoo 20). Diese Einstellung liegt in der Instanz, nicht im Auftrag; sie wird in Die Felder der Mirakl-Instanz in Mirakl Connector behandelt.

  • Hat der Auftrag keine Instanz oder steht die Einstellung auf automatisch, wird die Rechnung wie in Standard-Odoo vorbereitet.
  • Ist die spanische Lokalisierung von Odoo nicht installiert (die Rechnungen haben das Feld für vereinfachte Rechnungen nicht), wird ebenfalls nichts angepasst.
  • Ist die Einstellung vereinfacht, wird die Rechnung als vereinfacht markiert. Ist sie vollständig, wird sie als nicht vereinfacht markiert.

Wie es zum Rest passt und was es kostet

Das Modul ist eine Einmalzahlung pro Version und erfordert das Abonnement von FlexigoTech Cloud: Plan Konnektor, 49 €/Monat oder 490 €/Jahr zzgl. MwSt. Die Verbindung läuft über FlexigoTech Cloud, das die Zugangsdaten verschlüsselt speichert, die Synchronisierung überwacht und bei Fehlern per E-Mail benachrichtigt. Es ist für Odoo 17, 18, 19 und 20 veröffentlicht; im Odoo App Store wird jede Version dort erworben. Mehr Details in der Odoo-Apps-Seite und auf der Seite des Moduls.

Wenn Sie möchten, dass wir prüfen, wie der Auftragsfluss in Ihrem Odoo aussieht: FlexigoTech führt Odoo 17, 18, 19 und 20 ein und entwickelt Konnektoren und maßgeschneiderte Integrationen.

Weiterlesen

Checkliste zur Mirakl-Connector-Instanz, Feld für FeldCheckliste zum Ausfüllen der Mirakl-Connector-Instanz in Odoo: Verbindung, Abrechnungskonten und Optionen, mit dem Hilfetext jedes Feldes.Felder der Mirakl-Instanz im Mirakl Connector: Bedeutung und empfohlene WerteFelder der Mirakl Instanzen im Mirakl Connector für Odoo im Vergleich: was die Hilfe sagt, welche Standardwerte gelten und was Sie eintragen sollten.
Geprüft im Quellcode des Connectors (Version 20.0) und in den verlinkten Quellen

Quellen