Was die Schaltfläche „FBA-Ledger-Details synchronisieren“ in Odoo tut

Was Odoo von selbst tut, ohne dass Sie etwas drücken

Die geplante Aktion Amazon SP-API - FBA-Ledger-Detailbericht synchronisieren (Opt-in) läuft einmal am Tag und ist ab der Installation des Moduls aktiv. Sie behandelt nur die aktiven Konten, bei denen die Synchronisierung der Details aktiviert ist, und startet für jedes dieselbe Synchronisierung wie die Schaltfläche.

Es gibt Unterschiede zur manuellen Ausführung: Die Zusammenfassung nennt als Ursprung die geplante Aktion statt manuell, sie wird nicht im Chatter des Kontos veröffentlicht und, wenn ein Konto fehlschlägt, hinterlässt die Aktion eine Warnung im Serverprotokoll und macht mit dem nächsten weiter. Die Schaltfläche trifft diese Kontoauswahl nicht: Sie arbeitet mit dem Konto, in dem Sie sie drücken.

Die Schaltfläche gibt es in den Zweigen von Odoo 17, 18, 19 und 20 und sie ist im Bildschirm Konten immer sichtbar, ohne jede Bedingung.

Der Fall Casa Olivar: vom Menü zur Zusammenfassung

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

Casa Olivar ist ein erfundener Shop, der Öl und Konserven mit FBA verkauft und den Konnektor in Odoo 20 nutzt. Marta aus der Verwaltung hat die Berechtigung Manager und möchte den Ereignisverlauf eines Kontos prüfen, ohne auf die Tagesaktion zu warten.

1. Sie öffnet Amazon › Konfiguration › Konten und dann das Konto.
2. Im Reiter FBA-Berichte (Opt-in) befindet sich in der Gruppe Erstattungsanspruchs-Prüfung (finden Sie Geld, das Amazon Ihnen schuldet) das Kontrollkästchen FBA-Erstattungsprüfung, standardmäßig deaktiviert. Marta möchte, dass die Synchronisierung auch die Anspruchsprüfung des Kontos durchläuft, also aktiviert sie es.
3. Sie drückt FBA-Ledger-Details synchronisieren. Die Aktion fragt bei Amazon nach, mit einer Pause zwischen den Abfragen, bis der Bericht fertig ist, fehlschlägt oder die Versuche aufgebraucht sind.
4. Wenn sie mit einer Zusammenfassung endet, speichert das Konto das Datum und den Text der Ausführung und veröffentlicht diese Zusammenfassung in seinem Chatter.
5. Wenn der in der Zusammenfassung genannte Berichtsstatus nicht DONE ist, wird aus dieser Ausführung nichts importiert und Marta kann sie später erneut starten. Wenn er DONE ist, Amazon das Berichtsdokument aber nicht liefert, weist die Zusammenfassung darauf hin und es wird ebenfalls nichts importiert. Wenn es ein Dokument gibt, ergänzt die Zusammenfassung, wie viele Zeilen der Bericht enthielt und wie viele erfasst, aktualisiert oder übersprungen wurden.

Ihr Kollege Íñigo hat nur die Berechtigung Betrachter: Er sieht die Menüabschnitte Konfiguration und Konten nicht und gelangt daher nicht zu diesem Bildschirm.

Am nächsten Tag macht die geplante Aktion dasselbe noch einmal, ohne dass jemand etwas drückt, aber nur bei den aktiven Konten, bei denen die Synchronisierung der Details aktiviert ist.

Was vor dem Aufruf bei Amazon geprüft wird

Der Pfad Amazon › Konfiguration › Konten hat Berechtigungen pro Abschnitt: Amazon verlangt Betrachter, sowohl Konfiguration als auch Konten verlangen Manager. Ohne diese Berechtigung sehen Sie diese Abschnitte nicht.

Beim Drücken der Schaltfläche erfolgt zuerst eine Prüfung auf dem Server: Wenn Sie kein Superuser sind, müssen Sie die Berechtigung Manager des Konnektors oder die für Einstellungen haben. Danach wird geprüft, ob Sie in dieses Konto schreiben dürfen. Der Superuser umgeht die Gruppenprüfung, und die geplante Aktion durchläuft sie ebenfalls nicht, weil sie die Synchronisierung direkt aufruft.

Was intern abläuft, der Reihe nach

1. Es prüft die Berechtigungen, wie eben beschrieben.
2. Es arbeitet mit genau einem Konto.
3. Es fordert bei Amazon an, den FBA-Ledger-Detailbericht zu erstellen. Wenn Amazon die Berichtskennung nicht zurückgibt, bricht die Aktion ab.
4. Es fragt den Berichtsstatus ab, bis er DONE, CANCELLED oder FATAL ist oder die Versuche aufgebraucht sind. Die Zahl der Versuche und die Sekunden dazwischen entnimmt es dem Konto; ist kein Wert gesetzt, verwendet der Code zwölf Versuche mit zehn Sekunden Pause.
5. Wenn der Bericht nicht auf DONE landet, speichert es das Datum und die Zusammenfassung mit dem erreichten Status, veröffentlicht sie im Chatter und endet, ohne etwas zu importieren.
6. Wenn er auf DONE steht, Amazon aber kein Berichtsdokument liefert, passiert dasselbe: Zusammenfassung gespeichert, nichts importiert und keine Zeilenzahlen.
7. Wenn es ein Dokument gibt, lädt es dieses herunter und übergibt es an den Import des Ledger-Ereignisverlaufs des Kontos.
8. Wenn FBA-Erstattungsprüfung aktiviert ist, durchläuft die Synchronisierung auch die Anspruchsprüfung des Kontos.
9. Es speichert das Datum und die Zusammenfassung und veröffentlicht die Zusammenfassung im Chatter.

Die Zusammenfassung enthält das Konto, den Ursprung (manuell, wenn Sie sie starten), die Kennung und den Status des Berichts und, falls importiert wird, die Zeilenzahl sowie die erfassten, aktualisierten und übersprungenen Zeilen.

Was sich in Ihrem Odoo ändert und was nicht

• Der Ledger-Ereignisverlauf des Kontos wird fortgeschrieben.
• Das Konto speichert das Datum und die Zusammenfassung der letzten Ausführung, und der Chatter erhält eine Notiz mit der Zusammenfassung.
• Bei aktivierter FBA-Erstattungsprüfung durchläuft die Synchronisierung auch die Anspruchsprüfung. Die Hilfe des Feldes sagt, dass die Synchronisierung bei Aktivierung zusätzlich Ereignisse für verloren, beschädigt und gefunden sammelt und dass die Prüfung diese mit den Erstattungen der Abrechnungen abgleicht, um die Einheiten zu ermitteln, die Amazon noch schuldet, mit geschätztem Wert und Frist für den Anspruch. Es ist eine reine Leseanalyse.
• Laut Code ist es eine eigenständige Synchronisierung, die den FBA-Bestand nicht anfasst: Sie sammelt nur den Verlauf pro Ereignis für die Erstattungsprüfung.

Die Warnung, die die Aktion stoppen kann

Beim Drücken von FBA-Ledger-Details synchronisieren kann diese Warnung erscheinen: You need Amazon Seller Connector Manager (or Settings) access for this action. Ask a manager to grant Manager access.

Sie erscheint, wenn Sie kein Superuser sind und weder die Berechtigung Manager des Konnektors noch die für Einstellungen haben. Die Lösung steht im Text selbst: Bitten Sie einen Verantwortlichen, Ihnen den Zugriff als Manager zu erteilen.

Was der Fall lehrt

• Die Tagesaktion synchronisiert die aktiven Konten, bei denen die Synchronisierung der Details aktiviert ist; die Schaltfläche dient dazu, sie von Hand für das gerade geöffnete Konto zu starten.
• Die Berechtigung wird beim Drücken geprüft, zusätzlich zur Einschränkung des Menüs.
• Der Berichtsstatus in der Zusammenfassung sagt Ihnen, ob importiert wurde.
• Das Kontrollkästchen FBA-Erstattungsprüfung entscheidet, ob die Synchronisierung auch die Anspruchsprüfung durchläuft.

Wie FlexigoTech Ihnen hilft

FlexigoTech führt Odoo 17, 18, 19 und 20 ein und entwickelt Konnektoren und Integrationen nach Maß. Die Modulseite und die Seite in Odoo Apps enthalten die Kaufdetails. Das Modul ist eine Einmalzahlung pro Version und benötigt das Abonnement von FlexigoTech Cloud, Plan Konnektor (49 €/Monat oder 490 €/Jahr, zzgl. MwSt.). Die Verbindung läuft über FlexigoTech Cloud, das die Zugangsdaten verschlüsselt speichert, die Synchronisierung überwacht und per E-Mail warnt, wenn sie fehlschlägt.

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