Schaltfläche «USt-Berechnung synchronisieren» im Amazon Connector für Odoo: Checkliste

Die Schaltfläche gibt es in den Odoo-Versionen 17.0, 18.0, 19.0 und 20.0, und in allen ist sie im Bildschirm Konten immer sichtbar.

Zuerst: Was Odoo ohne Ihr Zutun erledigt

Die Synchronisierung des USt-Berechnungsberichts hat einen automatischen Weg, und das ist der Normalfall. Die geplante Aktion Amazon SP-API - USt-Berechnungsbericht synchronisieren (Opt-in) (Amazon SP-API - Sync VAT Calculation report (opt-in)) läuft einmal am Tag und ist nach der Installation des Moduls aktiv.

Die Aktion durchläuft die aktiven Konten, bei denen die Synchronisierung des USt-Berichts aktiviert ist, und synchronisiert jedes mit der Quelle CRON. Auf diesem Weg wird die Zusammenfassung nicht als Nachricht im Konto veröffentlicht. Wenn ein Konto einen Fehler meldet, bricht die Aktion nicht ab und macht mit dem nächsten weiter.

Die Schaltfläche ist die Ausnahme: Mit ihr starten Sie dieselbe Synchronisierung von Hand, für ein bestimmtes Konto und genau dann, wenn Sie es möchten.

Vor dem Klick

• Sie erreichen den Bildschirm über das Menü Amazon › Konfiguration › Konten (Amazon › Configuration › Accounts). Die Menüebenen Konfiguration (Configuration) und Konten verlangen die Berechtigung Manager; die Ebene Amazon verlangt Betrachter (Viewer). Fehlt Ihnen eine dieser Berechtigungen, sehen Sie die jeweilige Menüebene nicht.

• Ihr Benutzer ist Manager des Amazon-Konnektors oder hat Zugriff auf die Einstellungen. Das prüft die Schaltfläche als Erstes, und wenn es nicht erfüllt ist, bricht die Aktion mit dieser Meldung ab: You need Amazon Seller Connector Manager (or Settings) access for this action. Ask a manager to grant Manager access.

• Zusätzlich zu diesen Gruppen prüft die Schaltfläche, ob Sie in diesem Konto schreiben dürfen.

• Das Amazon-Konto, das Sie synchronisieren möchten, ist geöffnet. Die Schaltfläche wirkt jeweils nur auf ein Konto.

• Das Abonnement für FlexigoTech Cloud ist aktiv (weiter unten der Tarif).

Beim Klick auf USt-Berechnung synchronisieren

In Odoo 20.0 laufen diese Schritte der Reihe nach ab:

• Ihre Berechtigungen werden geprüft, wie oben beschrieben. Schlägt das fehl, passiert nichts weiter.

• Amazon wird gebeten, den USt-Berechnungsbericht für das Konto zu erstellen.

• Der Status des Berichts wird mehrmals abgefragt, mit einer Pause zwischen den Abfragen, bis Amazon ihn als abgeschlossen (DONE), abgebrochen (CANCELLED) oder fehlgeschlagen (FATAL) meldet oder bis die Versuche aufgebraucht sind.

• Ist der Bericht fertig (DONE) und enthält ein Dokument, wird es mit dem Marketplace des Kontos und mit einer Obergrenze an Zeilen pro Lauf verarbeitet, und die Zusammenfassung enthält zusätzlich die Zeilenzähler.

• Das Ergebnis wird im Konto gespeichert und, wenn der Lauf über die Schaltfläche gestartet wurde, die Zusammenfassung zusätzlich als Nachricht im Konto selbst veröffentlicht (die tägliche Aktion veröffentlicht sie nicht).

Was gespeichert wird und welche Zusammenfassung entsteht

• Das Konto speichert Datum und Uhrzeit der letzten Ausführung und den Ergebnistext. Das geschieht sowohl, wenn der Bericht verarbeitet wird, als auch, wenn Amazon keinen verwendbaren liefert.

• Lesen Sie die Zusammenfassung. Sie beginnt immer mit diesen Zeilen:

• Synchronisierung des USt-Berechnungsberichts abgeschlossen. (Amazon VAT Calculation report sync finished.)
• Konto: … (Account: …)
• Quelle: … (Source: …), die angibt, ob die Synchronisierung manuell oder durch die geplante Aktion erfolgte.

Wird der Bericht abgefragt, ergänzt die Zusammenfassung außerdem:

• Berichts-ID: … (Report ID: …)
• Berichtsstatus: … (Report status: …)

Wird der Bericht verarbeitet, kommen auch diese Zähler hinzu:

• Berichtszeilen: … (Report rows: …)
• Verarbeitete Zeilen: … (Processed rows: …)
• Erstellt: … (Created: …)
• Aktualisiert: … (Updated: …)
• Übersprungen: … (Skipped: …)
• Mit Fehler: … (With error: …)

Wenn Amazon den Bericht nicht liefert

In diesen Fällen verarbeitet die Schaltfläche keine Zeile, speichert aber die Zusammenfassung im Konto und veröffentlicht sie, wenn der Lauf über die Schaltfläche gestartet wurde, ebenfalls als Nachricht:

• Der Berichtsstatus ist CANCELLED oder FATAL: Die Zusammenfassung ergänzt Amazon hat keinen verwendbaren USt-Berechnungsbericht erzeugt. (Amazon did not generate a usable VAT Calculation report.)

• Der Bericht erreicht nach den Abfragen keinen Endstatus: Die Zusammenfassung ergänzt Zeitüberschreitung beim Abrufen des Berichts. Versuchen Sie es in einigen Minuten erneut. (Report polling timed out. Try again in a few minutes.) Warten Sie einige Minuten und klicken Sie die Schaltfläche erneut.

• Der Bericht erreicht DONE, aber ohne Dokument: Die Zusammenfassung ergänzt DONE-Bericht ohne reportDocumentId. (DONE report without reportDocumentId.) und die Synchronisierung endet damit.

Wie die Schaltfläche je nach Sprache heißt

Die Beschriftung hängt von der Sprache Ihres Odoo ab. Mit Odoo auf Deutsch heißt sie USt-Berechnung synchronisieren, und das Modul bringt die Beschriftung in weiteren Sprachen übersetzt mit.

Nach der Synchronisierung

• Öffnen Sie die im Konto veröffentlichte Nachricht und sehen Sie sich die Zeile Berichtsstatus: … an, um zu erkennen, in welchem Status der Bericht geblieben ist.

• Prüfen Sie die Zähler Berichtszeilen: …, Verarbeitete Zeilen: … und Mit Fehler: … und notieren Sie sie, um sie mit dem nächsten Lauf zu vergleichen.

• Denken Sie daran, dass die tägliche Aktion die Synchronisierung weiterhin selbstständig in den Konten startet, bei denen sie aktiviert ist. Die Schaltfläche ist zum manuellen Start da.

• Erscheint die Berechtigungsmeldung, bitten Sie einen Manager, Ihnen Manager-Zugriff zu geben, wie es der Text selbst angibt.

Kosten und Hilfe

Das Modul ist eine Einmalzahlung pro Odoo-Version und benötigt das Abonnement für FlexigoTech Cloud. Der Tarif Konnektor kostet 49 €/Monat oder 490 €/Jahr zzgl. MwSt., mit bis zu 3 Konten der Plattform. Ohne Abonnement oder bei ausgesetztem Dienst steht das still, was das Abonnement liefert, und die Daten bleiben in Ihrem Odoo. Hier finden Sie den Eintrag in Odoo Apps und die Seite des Moduls.

Wenn Sie Odoo einführen und prüfen möchten, wie diese Synchronisierung zu Ihrer Buchhaltung passt: FlexigoTech führt Odoo 17, 18, 19 und 20 ein und entwickelt Konnektoren und maßgeschneiderte Integrationen.

Weiterlesen

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

Quellen

• Quellcode des Moduls: flexigobe_amazon_seller_connector 20.0 (8576afa5): views/amazon_spapi_account_views.xml
• Quellcode des Moduls: flexigobe_amazon_seller_connector 20.0 (8576afa5): models/amazon_spapi_account.py
• apps.odoo.com/apps/modules/20.0/flexigobe_amazon_seller_connector
• flexigotech.com/precios.html
• flexigotech.com/en/services.html