Zum Hauptinhalt springen
Mirakl

Die Aufgabe „Mirakl - Retouren synchronisieren“ im Mirakl Connector: Ablauf und Prüfpunkte

Die geplante Aufgabe Mirakl - Retouren synchronisieren (Mirakl - Sync Returns) läuft alle 30 Minuten und ist nach der Installation aktiv: Bei jedem Durchlauf fragt sie Seite für Seite die Retouren bei den aktiven Marktplätzen ab, bei denen diese Synchronisierung eingeschaltet ist. Wenn sie nichts zu tun scheint, prüfen Sie, welche Marktplätze aus dem Durchlauf herausfallen, ob FlexigoTech Cloud pausiert hat und ob der Marktplatz bei den Retouren mit einem 404 geantwortet hat.

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

Was die Aufgabe bei jedem Durchlauf tut

Die geplante Aufgabe Mirakl - Retouren synchronisieren gibt es in allen veröffentlichten Versionen des Mirakl Connector (Odoo 17, 18, 19 und 20), sie läuft alle 30 Minuten und ist nach der Installation aktiv.

In Odoo 20.0 prüft die Aufgabe bei jedem Durchlauf, dass der ausführende Benutzer Administrator ist, sucht die aktiven Marktplätze mit eingeschalteter Retouren-Synchronisierung, behält diejenigen, die sie aufrufen kann, und fragt für jeden davon seine Retouren seitenweise beim Marktplatz ab und verarbeitet die eintreffenden einzeln. Die Karteikarten der Marktplätze öffnen Sie über das Menü Mirakl › Konfiguration › Marktplätze; um das Menü Mirakl zu sehen, genügt es, interner Odoo-Benutzer zu sein.

Mit Code erstelltes Schema: die geplante Retouren-Aufgabe, die alle 30 Minuten läuft, und das Menü der Marktplätze
Mit Code erstelltes Schema auf Grundlage des veröffentlichten Modulcodes, kein Odoo-Screenshot: die Aufgabe, die alle 30 Minuten läuft und nach der Installation aktiv ist (Odoo 17.0, 18.0, 19.0 und 20.0), und das Menü der Marktplätze.

Mit Odoo auf Spanisch heißt die Aufgabe Mirakl - Sincronizar devoluciones nicht so; das folgende Schema zeigt ihren Namen in den verschiedenen Sprachen.

Schema mit dem Namen der Aufgabe auf Spanisch, Deutsch, Französisch, Italienisch und Portugiesisch
Mit Code erstelltes Schema auf Grundlage der veröffentlichten Modulübersetzungen, kein Odoo-Screenshot: der Name der Aufgabe je nach Odoo-Sprache.
Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (Video auf Englisch)

Wie sich die Aufgabe verhält

Sie läuft alle 30 Minuten und verlangt einen Administrator

Die Frequenz beträgt alle 30 Minuten. In Odoo 17.0 wiederholt sich die Aufgabe unbegrenzt. In Odoo 20.0 prüft jeder Durchlauf als Erstes den Benutzer: Wird die Aufgabe mit jemandem gestartet, der kein Administrator ist, bricht sie mit Nur ein Administrator kann diese geplante Aktion ausführen. (Only an administrator can run this scheduled action.) ab und es wird kein Marktplatz verarbeitet.

Nicht alle Marktplätze kommen in den Durchlauf

In Odoo 20.0 geht die Suche von den aktiven Marktplätzen mit eingeschalteter Retouren-Synchronisierung aus; alle anderen werden nicht angefasst. Danach filtert das Modul diejenigen, die es aufrufen kann: zuerst die mit direkter Verbindung, dann die über FlexigoTech Cloud, und von diesen nur die mit gespeichertem Schlüssel. Außerdem gilt: Enthält die gespeicherte Berechtigung den Dienst des Moduls nicht (das wird geprüft, ohne ins Netz zu gehen), wird in diesem Durchlauf keiner der FlexigoTech-Cloud-Marktplätze aufgerufen. Die mit direkter Verbindung laufen normal weiter.

Eine Pause von FlexigoTech Cloud beendet den Rest des Durchlaufs

Lässt FlexigoTech Cloud die Anfrage nicht durch (weil kein Abonnement besteht oder der Dienst pausiert), wird nichts markiert und nichts gelöscht, und der Durchlauf endet an dieser Stelle: Die übrigen Marktplätze warten auf den nächsten Durchlauf, der normal weiterläuft. Deshalb kommen die mit direkter Verbindung zuerst: Eine Pause lässt keinen von ihnen unbearbeitet. Die Pause zählt nur für den Gesundheitsbericht von FlexigoTech Cloud, mit Codes und nie mit Text. Ohne Abonnement oder bei ausgesetztem Dienst stoppt, was das Abonnement liefert; die Daten bleiben in Ihrem Odoo.

Ein Fehler bei einem Marktplatz bremst die anderen nicht

Jeder andere Fehler bei einem Marktplatz wird im Odoo-Serverprotokoll vermerkt, und das Modul versucht, eine Protokollzeile vom Typ Fehler mit dem Fehlertext anzulegen; danach geht es zum nächsten Marktplatz. Lässt sich nicht einmal diese Zeile schreiben, hinterlässt das Modul einen Hinweis im Serverprotokoll, und dieser Protokollfehler ersetzt den ursprünglichen Fehler nicht.

Wenn der Marktplatz bei den Retouren mit einem 404 antwortet

Antwortet der Marktplatz auf die Retouren-Anfrage mit einem 404 (HTTP 404), legt das Modul eine Protokollzeile vom Typ Hinweis mit dem Text Retouren-Endpunkt nicht verfügbar (HTTP 404). (Returns endpoint not available (HTTP 404).) an. Ist beim Marktplatz die Absicherung über Bestellungen aktiviert, wechselt das Modul danach zu einer anderen Synchronisierungsmethode; andernfalls zieht es die Markierung der letzten Retouren-Synchronisierung auf diesen Zeitpunkt vor und endet, ohne etwas zu verarbeiten.

Eine Antwort, die der Connector nicht erkennt, ist keine leere Seite

Kommt eine Seite ohne Retouren, endet der Durchlauf für diesen Marktplatz. Hat die Antwort aber eine Form, die der Connector nicht erkennt, legt das Modul eine Protokollzeile vom Typ Fehler an und zieht das Synchronisierungsfenster nicht vor, um keine Retouren zu überspringen, die es nicht gelesen hat.

Seiten, Obergrenze und wann sie stoppt

Die Aufgabe fragt Seiten einer festgelegten Größe ab, verarbeitet jede Retoure und zählt sie. Sie stoppt, wenn eine Seite weniger Retouren enthält als die Seitengröße, wenn sie die vom Marktplatz angekündigte Gesamtzahl gelesen hat oder wenn sie die Obergrenze der Seiten pro Durchlauf erreicht (mindestens eine Seite).

Was Sie prüfen, wenn sie nichts zu tun scheint

  • Die Aufgabe erscheint unter den geplanten Aktionen von Odoo mit dem Namen Mirakl - Retouren synchronisieren und ist aktiv.
  • Der Marktplatz ist aktiv und die Retouren-Synchronisierung eingeschaltet; sonst kommt er nicht in die Suche (seine Karteikarten öffnen Sie über Mirakl › Konfiguration › Marktplätze).
  • Bei Verbindung über FlexigoTech Cloud ist ein Schlüssel gespeichert und der Dienst gültig. FlexigoTech Cloud überwacht die Synchronisierung und warnt per E-Mail, wenn sie fehlschlägt.
  • Hat ein anderer Marktplatz im selben Durchlauf eine Pause von FlexigoTech Cloud ausgelöst, wurde der Durchlauf abgebrochen und die übrigen warten auf den nächsten.
  • Hat der Marktplatz mit einem 404 geantwortet, suchen Sie eine Protokollzeile vom Typ Hinweis mit dem Text Retouren-Endpunkt nicht verfügbar (HTTP 404).
  • Gibt es eine Protokollzeile vom Typ Fehler, lesen Sie ihren Text: Er ist der Fehler dieses Marktplatzes.

So hilft FlexigoTech

FlexigoTech führt Odoo 17, 18, 19 und 20 ein und entwickelt Connectoren und maßgeschneiderte Integrationen. Der Mirakl Connector ist ein Modul mit Einmalzahlung pro Version und benötigt das Abonnement von FlexigoTech Cloud (Plan Connector: 49 €/Monat oder 490 €/Jahr, zzgl. MwSt.). Das Modul finden Sie auf der Produktseite oder auf der Odoo-Apps-Seite.

Weiterlesen

Der Fehler «Buchen Sie die Rechnung, bevor Sie sie an Mirakl senden.» im Mirakl ConnectorWann der Fehler «Buchen Sie die Rechnung, bevor Sie sie an Mirakl senden.» im Mirakl Connector für Odoo erscheint, was der Code prüft und wie Sie ihn beheben.Die Aufgabe «Mirakl - Bestellungen annehmen», Lauf für LaufWas die geplante Aktion Mirakl - Bestellungen annehmen des Mirakl Connectors für Odoo bei jedem Lauf tut, wie oft sie läuft und was Sie prüfen.Was der Button «In Mirakl stornieren» im Mirakl Connector macht, Schritt für SchrittWas der Button In Mirakl stornieren im Mirakl Connector für Odoo macht: wann er erscheint, was er prüft, was sich an der Bestellung ändert und welche Fehler…
Geprüft im Quellcode des Connectors (Version 17.0 und 20.0) und in den verlinkten Quellen

Quellen