Zum Hauptinhalt springen
Mirakl

Was Mirakl Connector in Odoo-Rechnungen ergänzt: Felder, Button und wann er greift

Mirakl Connector ergänzt die Odoo-Kundenrechnung um schreibgeschützte Felder und den Button An Mirakl senden (Send to Mirakl), der das PDF der gebuchten Rechnung manuell in die zugehörige Mirakl-Bestellung hochlädt; ist die Instanz entsprechend konfiguriert, wird die Rechnung beim Validieren des Lieferscheins auch automatisch hochgeladen.

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
5 Min.

Was sich in der Rechnung nach der Installation ändert

Mirakl Connector erweitert die Rechnung der Standard-App «Invoicing» von Odoo um einen Button und mehrere Felder: den Button An Mirakl senden sowie die schreibgeschützten Felder An Mirakl gesendet am (Sent to Mirakl on) und Mirakl-Bestellung (Mirakl order). Das Modul ist in Odoo Apps für Odoo 17, 18, 19 und 20 veröffentlicht, und die Bedingung, die über die Sichtbarkeit des Buttons entscheidet, ist in allen vier Versionen dieselbe.

Mit Code erstelltes Schema, kein Odoo-Bildschirm: die Standard-App Invoicing und darunter das, was das Modul ergänzt: Send to Mirakl, Sent to Mirakl on und Mirakl order
Schema (kein Odoo-Screenshot) dessen, was Mirakl Connector in der App Invoicing ergänzt; die Beschriftungen sind englisch, wie im Code des Moduls.

Alles dreht sich um eine Idee: die Kundenrechnung, deren Positionen aus einem Verkaufsauftrag stammen, der mit einer Mirakl-Bestellung verknüpft ist. Das Modul sucht unter den Verkaufsaufträgen der Rechnungspositionen den ersten, der mit Mirakl verknüpft ist, und das nur bei Rechnungen vom Typ Kundenrechnung. Aus diesem Auftrag bezieht es die Mirakl-Instanz, mit der kommuniziert wird, und die Kennung der Bestellung in Mirakl.

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

Vergleich: automatischer Versand und Button

Die Rechnung kann automatisch beim Validieren des Lieferscheins zu Mirakl gelangen, wenn die Instanz dafür konfiguriert ist, oder manuell über den Button. Beide Wege laufen über dieselbe Upload-Routine.

Automatischer VersandButton An Mirakl senden
Wer löst ihn ausOdoo, beim Validieren eines LieferscheinsSie, aus der Rechnung heraus
Wann greift erWenn die Instanz den Rechnungsversand auf automatisch gestellt hat, der Lieferschein noch kein Rechnungsversanddatum hat und die Instanz nicht pausiert istWenn der Button sichtbar ist: Rechnung vom Typ Kundenrechnung, im Status Gebucht und als Mirakl-Rechnung markiert
Wenn bereits gesendetGreift nur, wenn der Lieferschein dieses Datum noch nicht hatPrüft das nicht: lädt die Rechnung hoch und ersetzt das vorherige Dokument der Bestellung
Was in der Rechnung zurückbleibtDie Upload-Routine füllt An Mirakl gesendet amDasselbe, zusätzlich eine Notiz in der Rechnung mit dem Ergebnis

So lesen Sie die Tabelle

Der automatische Weg hängt am Standard-Button zum Validieren des Lieferscheins, den das Modul erweitert.

Der Button lädt die Rechnung manuell hoch. Er prüft nicht, ob der Lieferschein bereits ein Versanddatum hat: Er startet den Upload und ersetzt das vorherige Dokument der Bestellung, auch wenn die Rechnung schon gesendet wurde. Dieser Austausch ist ein Versuch nach bestem Bemühen: Zuerst werden bei Mirakl die Dokumente der Bestellung desselben Typs abgefragt und gelöscht; erlaubt der Mirakl-Betreiber das Auflisten oder Löschen von Dokumenten nicht, bleibt das vorherige bestehen.

Die Felder einzeln

FeldWo es stehtWann es ausgeblendet wird
An Mirakl gesendet amRechnungsformular, schreibgeschütztWenn die Rechnung keine Mirakl-Rechnung ist
Mirakl-BestellungRechnungsformular, schreibgeschütztWenn die Rechnung keine Mirakl-Rechnung ist
Mirakl-Rechnung (Mirakl invoice)In keiner Ansicht sichtbarEntfällt: Es ist die Bedingung, von der die anderen Felder und der Button abhängen

Die Hilfe zu An Mirakl gesendet am lautet: «Datum/Uhrzeit, zu der dieses Rechnungs-PDF zuletzt auf den Mirakl-Marktplatz hochgeladen wurde.». Wird die Rechnung also erneut gesendet, zeigt das Datum den letzten Versand. Das Modul füllt es, nachdem das PDF hochgeladen wurde.

Der Button Schritt für Schritt

Der Button An Mirakl senden erscheint nur, wenn gleichzeitig diese Bedingungen erfüllt sind: Die Rechnung ist vom Typ Kundenrechnung, als Mirakl-Rechnung markiert (das nicht sichtbare Feld Mirakl-Rechnung) und ihr Status ist Gebucht. In Odoo 20.0 geschieht beim Klick der Reihe nach Folgendes:

  1. Er sucht den Mirakl-Verkaufsauftrag hinter den Rechnungspositionen und übernimmt daraus die Instanz. Gibt es keine Instanz, bricht er ab.
  2. Er erzeugt das PDF mit dem Rechnungsbericht, den die Instanz angibt, oder, falls sie keinen angibt, mit dem Standard-Rechnungsbericht von Odoo.
  3. Er fragt bei Mirakl die Dokumente der Bestellung desselben Typs ab und löscht vorhandene, um das vorherige zu ersetzen statt zu duplizieren.
  4. Er lädt das PDF in die Mirakl-Bestellung hoch, mit einem aus der Rechnungsnummer abgeleiteten Dateinamen (nur ASCII-Zeichen, endet auf .pdf) und mit dem Dokumenttyp, den die Instanz angibt; gibt sie keinen an, dem der Kundenrechnung.
  5. Er füllt An Mirakl gesendet am und hinterlässt eine Notiz in der Rechnung: Rechnung an Mirakl gesendet (…). (Invoice sent to Mirakl (…).), wobei an der Stelle der Auslassungspunkte die Kennung der Mirakl-Bestellung steht.

Mit Odoo auf Spanisch heißt der Button Enviar a Mirakl; auf Deutsch An Mirakl senden; auf Französisch Envoyer à Mirakl; auf Italienisch Invia a Mirakl; auf Portugiesisch Enviar para o Mirakl.

Mit Code aus den Übersetzungen des Moduls erstelltes Schema, kein Odoo-Bildschirm: der Text Send to Mirakl auf Spanisch, Deutsch, Französisch, Italienisch und Portugiesisch
Schema (kein Odoo-Screenshot) mit der Button-Beschriftung je nach Odoo-Sprache.

Was passiert, wenn es fehlschlägt

Findet das Modul hinter der Rechnung keine Mirakl-Instanz, bricht der Vorgang beim Klick auf An Mirakl senden mit Diese Rechnung ist nicht mit einer Mirakl-Bestellung verknüpft. (This invoice is not linked to a Mirakl order.) ab. Prüfen Sie, ob die Rechnungspositionen aus einem Verkaufsauftrag stammen, der mit einer Mirakl-Bestellung verknüpft ist.

Schlägt der Upload aus einem anderen Grund fehl, hinterlässt das Modul in der Rechnung eine Notiz Mirakl Rechnungsversand fehlgeschlagen: … (Mirakl invoice send failed: …), wobei an der Stelle der Auslassungspunkte der Grund steht, und zeigt den Fehler erneut an. Lässt FlexigoTech Cloud den Aufruf nicht durch (weil kein Abonnement besteht oder der Dienst pausiert ist), wird der Fehler ebenfalls erneut angezeigt, in diesem Fall wird jedoch nichts markiert.

Kosten und Hilfe

Das Modul ist eine Einmalzahlung pro Odoo-Version und benötigt das Abonnement von FlexigoTech Cloud, Plan Conector: 49 €/Monat oder 490 €/Jahr zzgl. MwSt. Ohne Abonnement oder bei ausgesetztem Dienst stoppt, was das Abonnement liefert, und die Daten bleiben in Ihrem Odoo. Sie finden das Modul auf seiner Seite oder im Eintrag in Odoo Apps.

Wenn Sie Odoo einführen und möchten, dass die Rechnungen Ihrer Mirakl-Bestellungen mit dem Bericht und dem Ablauf erstellt werden, den Sie nutzen, führt FlexigoTech Odoo 17, 18, 19 und 20 ein und entwickelt Konnektoren und individuelle 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