Die Aufgabe «Mirakl - Rechnungen synchronisieren»: was sie tut und was Sie prüfen, wenn nichts passiert

Beispiel Fiktiver Fall: Firma und Zahlen sind erfunden, um den Ablauf zu zeigen.

Taller Aralar ist ein erfundenes Unternehmen, das auf einem Mirakl-Marktplatz verkauft und gerade den Mirakl Connector in seinem Odoo installiert hat. Es vergehen Tage, und in Odoo erscheint keine einzige Rechnung des Marktplatzes. Bevor die Person, die Odoo betreut, etwas ändert, geht sie durch, was die Aufgabe Mirakl - Rechnungen synchronisieren tut und an welchen Stellen sie nichts tun kann. Diese Durchsicht folgt hier.

Was die Aufgabe bei jedem Durchlauf tut

Die Aufgabe sieht nicht auf einen bestimmten Marktplatz: Sie geht nacheinander alle durch, die die Bedingung erfüllen. In Odoo 20 tut sie beim Lauf Folgendes, in dieser Reihenfolge:

1. Sie prüft, ob die ausführende Person Administrator ist. Wenn nicht, bricht sie mit Nur ein Administrator kann diese geplante Aktion ausführen. ab und tut nichts weiter.
2. Sie sucht die Marktplätze, die aktiv sind und bei denen die Rechnungssynchronisierung aktiviert ist.
3. Von diesen lässt sie diejenigen aus, die sie nicht aufrufen kann: die über FlexigoTech Cloud ohne gespeicherten Schlüssel und, wenn die im Modul gespeicherte Berechtigung den Dienst des Moduls nicht enthält, alle auf dieser Route (diese Prüfung geht nicht ins Netz). Marktplätze mit direkter Verbindung kommen zuerst.
4. Für jeden verbleibenden Marktplatz fordert sie die Rechnungen an. Schlägt bei einem etwas fehl, versucht das Modul, den Fehler zu vermerken, und macht mit dem nächsten weiter. Die Ausnahme ist eine Pause von FlexigoTech Cloud, die den Durchlauf abbricht.

Was sie mit den Rechnungen jedes Marktplatzes macht

Wenn ein Marktplatz an der Reihe ist, geht die Aufgabe so vor:

• Sie verwendet den Rechnungs-Endpunkt, den der Marktplatz hinterlegt hat, oder, falls leer, /invoices.
• Sie fordert die Rechnungen seitenweise an, mit einer Seitengröße und einer maximalen Seitenzahl (mindestens eine). Sie hört auf, wenn eine Seite leer ankommt, wenn sie weniger Rechnungen als die Seitengröße enthält, wenn die von Mirakl gemeldete Gesamtzahl erreicht ist oder wenn die maximale Seitenzahl erreicht ist.
• Sie verarbeitet jede empfangene Rechnung. Schlägt eine fehl, vermerkt sie den Fehler mit dieser Rechnung und macht mit den übrigen weiter.

Stellt der Betreiber /invoices nicht bereit, vermerkt das Modul den Hinweis Rechnungs-Endpunkt nicht verfügbar (HTTP 404). Dieser Betreiber stellt /invoices nicht bereit., setzt den aktuellen Zeitpunkt als Datum der letzten Rechnungssynchronisierung und beendet die Arbeit mit diesem Marktplatz. Bei jedem anderen Fehler in der Anfrage vermerkt es den Fehler und liest keine weiteren Seiten dieses Marktplatzes.

Lässt FlexigoTech Cloud den Aufruf nicht durch (ohne Abonnement oder bei einer Pause des Relays), wird der Durchlauf abgebrochen: Es wird nichts markiert und nichts gelöscht, und der nächste Durchlauf macht weiter. Das Modul zählt die Pause mit ihrem Code nur im Gesundheitsbericht von FlexigoTech Cloud. Da die direkten Marktplätze zuerst kommen, bleibt keiner von ihnen wegen dieser Pause ohne Aufruf.

Wie oft sie läuft und ab wann

Die Aufgabe läuft einmal am Tag und ist nach der Installation deaktiviert: Solange niemand sie aktiviert, tut sie nichts. In Odoo 17 wiederholt sich die Aufgabe endlos. Sie ist in den veröffentlichten Zweigen 17, 18, 19 und 20 enthalten.

Die Marktplatz-Karten öffnen Sie über das Menü Mirakl › Konfiguration › Marktplätze.

Die Durchsicht von Taller Aralar, Schritt für Schritt

1. Es bestätigt, dass die Aufgabe aktiviert ist, denn sie ist nach der Installation deaktiviert.
2. Es berücksichtigt, dass die Aufgabe einmal am Tag läuft, und erwartet die Rechnungen daher nicht sofort.
3. Es stellt sicher, dass die Aufgabe von einem Administrator ausgeführt wird. Sonst bricht sie mit Nur ein Administrator kann diese geplante Aktion ausführen. ab.
4. Es beachtet, dass die Aufgabe nur aktive Marktplätze mit aktivierter Rechnungssynchronisierung nimmt: Erfüllt der eigene nicht beides, kommt er im Durchlauf nicht vor. Die Karten öffnet es über Mirakl › Konfiguration › Marktplätze.
5. Läuft der Marktplatz über FlexigoTech Cloud, beachtet es, dass er ohne gespeicherten Schlüssel nicht aufgerufen wird und dass auch kein Marktplatz dieser Route aufgerufen wird, wenn die gespeicherte Berechtigung den Dienst des Moduls nicht enthält.
6. Stellt der Betreiber /invoices nicht bereit, vermerkt das Modul den Hinweis Rechnungs-Endpunkt nicht verfügbar (HTTP 404). Dieser Betreiber stellt /invoices nicht bereit., setzt den aktuellen Zeitpunkt als Datum der letzten Rechnungssynchronisierung und beendet die Arbeit mit diesem Marktplatz.
7. Bei anderen Fehlern denkt es daran, dass das Modul versucht, eine dem Marktplatz zugeordnete Protokollzeile zu speichern, und den Fehler auch in das Serverlog schreibt.

Was der Fall zeigt

Wenn die Aufgabe nichts bringt, prüfen Sie der Reihe nach: zuerst, ob sie aktiviert ist, denn sie ist nach der Installation deaktiviert und läuft nicht, solange sie es bleibt. Danach in der Reihenfolge, in der der Code die Bedingungen anwendet: Administrator, Marktplatz, der die Bedingungen erfüllt, Route von FlexigoTech Cloud und schließlich die vermerkten Fehler.

Zu den Fehlern: Das Modul versucht, eine Protokollzeile mit Stufe, Vorgang, Methode, aufgerufener Adresse, Status der Antwort und Fehlermeldung zu schreiben. Tritt beim Anlegen der Zeile ein Fehler auf, hinterlässt es einen Hinweis im Serverlog.

Wie FlexigoTech hilft

FlexigoTech führt Odoo 17, 18, 19 und 20 ein und entwickelt Konnektoren und individuelle Integrationen. Der Mirakl Connector ist in Odoo Apps für 17, 18, 19 und 20 veröffentlicht: Sie können die Odoo-Apps-Seite oder die Modulseite ansehen.

Weiterlesen

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

Quellen

• Quellcode des Moduls: flexigobe_mirakl_connector 20.0 (aa05e537): data/ir_cron_data.xml
• Quellcode des Moduls: flexigobe_mirakl_connector 17.0 (e430de3e): data/ir_cron_data.xml
• 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