Mirakl-Instanz-Felder im Mirakl Connector: Glossar mit Empfehlungen für die Einstellung

Im Formular Mirakl Instanzen (Mirakl Instances) entscheiden mehrere Felder, was der Mirakl-Connector aus Mirakl nach Odoo holt und wann. Das Formular öffnen Sie über Mirakl › Konfiguration › Marktplätze (Mirakl › Configuration › Marketplaces). Die Felder und ihre Standardwerte stammen aus dem Code von Odoo 20; das Modul ist für Odoo 17, 18, 19 und 20 veröffentlicht.

Die Felder verteilen sich auf zwei Reiter: Bestellungen und Retouren (Orders and Returns) und Rechnungen und Nachrichten (Invoices and Messages).

Offene Bestellungen: erneut lesen, was schon in Odoo ist

Status offener Bestellungen aktualisieren (Refresh Status of Open Orders)

Kontrollkästchen im Reiter Bestellungen und Retouren, Gruppe Windows. Es ist standardmäßig nicht aktiviert. Laut Hilfe liest es nach jedem Import jede Bestellung, die bereits in Odoo liegt und noch nicht abgeschlossen ist (nicht erhalten, geschlossen, abgelehnt oder storniert), erneut in Mirakl und aktualisiert ihren Status, auch wenn die Bestellung älter als das Importfenster ist. Ohne diese Option bleibt eine Bestellung, deren Status sich im Marktplatz lange nach der Erstellung ändert, in Odoo mit dem alten Status stehen. Empfehlung: Aktivieren Sie es, wenn Ihnen wichtig ist, dass solche späten Änderungen in Odoo ankommen.

Offene Bestellungen pro Lauf aktualisiert (Open Orders Refreshed per Run)

Ganzzahl in derselben Gruppe Windows. Sie erscheint nur, wenn das vorige Kontrollkästchen aktiviert ist, mit den Standardwerten sehen Sie sie also nicht. Der Standardwert ist 100. Laut Hilfe ist es die maximale Anzahl offener Bestellungen, die pro Lauf in Mirakl erneut gelesen werden, und zwar zuerst die, die am längsten nicht aktualisiert wurden, sodass alles Ausstehende in aufeinanderfolgenden Läufen abgedeckt wird. Empfehlung: Sie können mit dem voreingestellten Wert beginnen; die Hilfe selbst weist darauf hin, dass das Ausstehende nicht in einen einzigen Lauf passen muss.

Retouren: Schalter, Fallback und Hinweis

Retourensynchronisation aktiviert (Sync Returns Enabled)

Kontrollkästchen in der Gruppe Synchronisationsrichtlinie (Sync Policy), Reiter Bestellungen und Retouren; es erscheint auch in der Liste Mirakl Instanzen. Es ist standardmäßig nicht aktiviert. Die Hilfe: den generischen geplanten Import von Mirakl-Retouren für diese Instanz aktivieren. Die geplante Aufgabe Mirakl - Retouren synchronisieren (Mirakl - Sync Returns) läuft alle 30 Minuten und ist bei der Installation aktiv. Empfehlung: Aktivieren Sie es bei den Instanzen, von denen Sie Retouren geplant abrufen möchten.

Retouren-Fallback auf Bestellungen (Returns Fallback To Orders)

Kontrollkästchen derselben Gruppe; anders als die vorherigen ist es standardmäßig aktiviert. Die Hilfe sagt: Wenn /returns nicht verfügbar ist, werden generische Retourendatensätze aus den in den Payloads der Bestellungen gefundenen Rückerstattungen aufgebaut. Empfehlung: Lassen Sie es so, wie es kommt, wenn Sie diesen Fallback wollen; deaktivieren Sie es nur, wenn Sie ihn nicht wollen.

Retouren-Endpunkt nicht verfügbar (Returns Endpoint Unavailable)

Schreibgeschütztes Kontrollkästchen in derselben Gruppe: Sie füllen es nicht selbst aus. Die Hilfe sagt, dass es automatisch gesetzt wird, wenn /returns den Fehler 404 liefert, damit die geplante Synchronisation den Endpunkt überspringt, bis er manuell erneut versucht wird. Zurückgesetzt wird es vom Code der Retourensynchronisation, den Sie über die Schaltfläche Retouren importieren (Import Returns) und über die geplante Aufgabe erreichen. Worauf Sie achten sollten: Ist es aktiviert, überspringt die geplante Synchronisation diesen Endpunkt.

Bestellungen annehmen und bestätigen

Die drei folgenden Felder stehen in Synchronisationsrichtlinie und sind standardmäßig nicht aktiviert. Ihre Hilfetexte beschreiben unterschiedliche Dinge, daher lohnt es sich, sie einzeln zu lesen.

Bestellungen automatisch annehmen (Auto Accept Orders)

Die Hilfe: importierte Bestellungen, die in Mirakl die Annahme durch den Verkäufer erfordern, automatisch annehmen. Empfehlung: Aktivieren Sie es, wenn diese Annahme automatisch erfolgen soll.

Ausstehende beim Import annehmen (Accept Pending On Import)

Die Hilfe: versuchen, wartende Bestellungen direkt nach jedem Bestellimport anzunehmen, ob manuell oder geplant.

Verkauf automatisch bestätigen (Auto Confirm Sale)

Die Hilfe: importierte Verkaufsaufträge nach der Synchronisation automatisch bestätigen. Empfehlung: Aktivieren Sie es nur, wenn diese Verkaufsaufträge ohne Eingreifen einer Person bestätigt werden sollen.

Rechnungen (Abrechnungen)

Sie stehen im Reiter Rechnungen und Nachrichten, Gruppe Rechnungen (Abrechnungen) (Invoices (Settlements)).

Rechnungssynchronisation aktiviert (Sync Invoices Enabled)

Standardmäßig nicht aktiviert. Die Hilfe: die geplante Rechnungssynchronisation für diese Instanz aktivieren. Die Aufgabe Mirakl - Rechnungen synchronisieren (Mirakl - Sync Invoices) läuft einmal täglich und ist bei der Installation deaktiviert.

Initiale Rechnungssynchronisierungstage (Initial Invoice Sync Days)

Ganzzahl mit dem Standardwert 90. Die Hilfe definiert sie als historisches Zeitfenster in Tagen für die manuelle Rechnungssynchronisation. Empfehlung: so viele Tage Verlauf, wie Sie beim manuellen Start abrufen möchten.

Rechnungs-Endpunkt nicht verfügbar (Invoices Endpoint Unavailable)

Schreibgeschütztes Kontrollkästchen. Es wird automatisch gesetzt, wenn /invoices den Fehler 404 liefert, damit die geplante Synchronisation den Endpunkt überspringt, bis er manuell erneut versucht wird. Zurückgesetzt wird es vom Code der Rechnungssynchronisation, den Sie über die Schaltfläche Rechnungen importieren (Import Invoices) und über die geplante Aufgabe erreichen.

Nachrichten

Im selben Reiter, Gruppe Nachrichten (Messages).

Nachrichtensynchronisation aktiviert (Sync Messages Enabled)

Standardmäßig nicht aktiviert. Die Hilfe: die geplante Nachrichtensynchronisation für diese Instanz aktivieren. Die Aufgabe Mirakl - Nachrichten synchronisieren (Mirakl - Sync Messages) läuft alle 30 Minuten und ist bei der Installation deaktiviert.

Initiale Nachrichtensynchronisierungstage (Initial Message Sync Days)

Ganzzahl mit dem Standardwert 30. Laut Hilfe ist es das historische Zeitfenster in Tagen für die manuelle Nachrichtensynchronisation.

Nachrichten-Endpunkt nicht verfügbar (Messages Endpoint Unavailable)

Schreibgeschütztes Kontrollkästchen. Es wird automatisch gesetzt, wenn /messages den Fehler 410 Gone oder 404 liefert (von diesem Betreiber nicht bereitgestellt), und die geplante Synchronisation überspringt den Endpunkt, bis er manuell erneut versucht wird. Zurückgesetzt wird es vom Code der Nachrichtensynchronisation, den Sie über die Schaltfläche Nachrichten importieren (Import Messages) und über die geplante Aufgabe erreichen.

Wie das zu FlexigoTech passt

Die Verbindung zu Mirakl läuft über FlexigoTech Cloud: Der Dienst speichert die Zugangsdaten verschlüsselt, überwacht die Synchronisation und warnt per E-Mail, wenn sie fehlschlägt. Das Modul benötigt dieses Abonnement, Plan Connector: 49 €/Monat oder 490 €/Jahr, zzgl. MwSt. Ohne Abonnement oder bei ausgesetztem Dienst steht still, was das Abonnement liefert, und die Daten bleiben in Ihrem Odoo. Das Modul finden Sie auf seiner Odoo-Apps-Seite und auf der FlexigoTech-Seite.

Wenn Sie Odoo einführen und mit Unterstützung entscheiden möchten, welche Synchronisationsrichtlinie zu welchem Marktplatz passt: FlexigoTech führt Odoo 17, 18, 19 und 20 ein und entwickelt individuelle Konnektoren und Integrationen.

Weiterlesen

Geprüft im Quellcode des Connectors (Version 20.0) und in den verlinkten Quellen

Quellen

• Quellcode des Moduls: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_instance.py
• Quellcode des Moduls: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_ai.py
• apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html