SP-API steht für Selling Partner API: die Schnittstelle, über die Amazon einem externen Programm erlaubt, Ihr Seller-Central-Konto zu lesen und zu beschreiben. Sie hat MWS abgelöst und dabei deutlich mehr verändert als nur den Namen. Aus Sicht von Odoo ist die API selbst der einfache Teil – HTTP-Anfragen mit JSON. Ob die Anbindung einen November übersteht, entscheiden drei Dinge, die in der Dokumentation eines einzelnen Endpunkts nicht stehen: wie autorisiert wird, wie viele Aufrufe Sie machen dürfen und welche Daten konstruktionsbedingt verspätet eintreffen.
Die Autorisierung erfolgt in Seller Central, nicht in Odoo
Der Ablauf ist immer derselbe: Es gibt eine Anwendung, die unter einem Entwicklerprofil registriert ist, und Sie als Verkäufer autorisieren sie aus Ihrem eigenen Konto heraus. Aus dieser Autorisierung entsteht ein langlebiger Refresh Token, den Odoo speichert; damit holt sich Odoo bei Bedarf ein Access Token, das etwa eine Stunde gültig ist. Wenn jemand nach Ihrem Seller-Central-Passwort fragt, um „das einzurichten“, stimmt etwas nicht: Dafür braucht niemand Ihr Passwort. Und wenn Sie die Autorisierung entziehen, steht die Anbindung sofort still – genau so soll es sein.
Käuferdaten gibt es nur über einen gesonderten Zugang
Name, Adresse und Telefonnummer des Käufers sind personenbezogene Daten, und Amazon behandelt sie auch so: Sie stehen nicht in der normalen Antwort einer Bestellung. Für diese Abfrage ist ein eingeschränktes Token nötig, und die Berechtigung dafür wird über Rollen vergeben, nicht standardmäßig. Praktische Folge in Odoo: Bestellungen können einwandfrei importiert werden, während sich Lieferungen nicht versenden lassen, weil die Adresse fehlt. Das ist kein Fehler des Connectors, sondern eine fehlende Freigabe.
Aufruflimits sind ein Kontingent, kein Tempolimit
Jede SP-API-Operation hat ihr eigenes Limit, und es funktioniert wie ein Kontingent, das sich in fester Rate wieder auffüllt und kurze Lastspitzen zulässt. Solange Guthaben da ist, geht es schnell; ist es aufgebraucht, antwortet Amazon mit 429 und Sie warten. Für Odoo heißt das ganz konkret: Sie können nicht 4.000 Artikel einzeln abfragen, „weil das einfacher ist“. Sie bündeln, Sie werten den Rate-Limit-Header aus, den die API selbst zurückgibt, und Sie wiederholen mit wachsender Wartezeit. Und manuelle Synchronisation und geplante Aufgabe müssen dieselbe Bremse teilen, denn das Budget gehört dem Konto, nicht dem einzelnen Prozess.
Berichte statt Live-Aufrufe: Warum Ihr Bestand immer hinterherhinkt
Die SP-API liefert Daten auf zwei Wegen. Der eine ist der direkte Aufruf: Sie fragen Bestellungen ab einem Datum ab und erhalten sofort Antwort. Der andere ist das Berichtssystem, und das ist asynchron: Sie fordern einen Bericht an, Amazon erstellt ihn, wenn es passt, Sie fragen nach, ob er fertig ist, und laden dann eine komprimierte Datei herunter. FBA-Bestand und Abrechnungen laufen über diesen Weg. Der Bestand, den Sie in Odoo sehen, ist also der Stand des letzten Downloads und nicht der dieser Sekunde – und keine Cron-Frequenz ändert daran etwas. Die richtige Antwort lautet nicht, häufiger abzufragen, sondern den an Amazon gemeldeten Bestand mit einem Sicherheitspuffer zu versehen und den Zeitversatz einzuplanen.
Die SP-API-Sandbox liefert feste, von Amazon vorbereitete Antworten. Sie eignet sich, um zu prüfen, ob Sie Anfragen korrekt signieren – und kaum für mehr: Alle Operationen teilen sich dort ein einziges Limit, die Limits der einzelnen Operationen im Live-Betrieb bildet sie also nicht ab. Eine offene Bestellung ohne Adresse liefert sie nicht, und ein Token, das mitten in einer langen Synchronisation abläuft, erleben Sie dort auch nicht. Ein Connector, der in der Sandbox grün ist, ist nicht getestet. Mehr dazu (auf Englisch): grüne Tests, Ausfall im Live-Betrieb.
Die Fehler, die erst im Live-Betrieb auftreten
Es sind immer dieselben, und keiner davon zeigt sich am ersten Tag. Offene Bestellungen, die ohne Beträge und ohne Adresse eintreffen und später erneut gelesen werden müssen. Paginierung: Die erste Seite kommt an, der Rest geht verloren, wenn niemand dem Fortsetzungstoken folgt. Zeitfenster, die wegen der Zeitzone falsch berechnet sind und genau am Tageswechsel eine Lücke lassen. Tokens, die mitten in einer langen Synchronisation ablaufen und unterwegs erneuert werden müssen. Und die falsche Region: Die Anwendung ist global, das Verkäuferkonto nicht. Wer deutsche Bestellungen am nordamerikanischen Endpunkt abfragt, liest nicht „falsche Region“, sondern „Access to requested resource is denied“. Das sieht nach fehlenden Berechtigungen aus – also werden Zugangsdaten neu erzeugt, die völlig in Ordnung waren, während der Fehler in der URL steckt.
Wo das in Odoo hingehört
Ein Amazon-Aufruf darf nicht an der Validierung eines Lieferscheins hängen. Ist die API langsam, starrt die Anwenderin auf einen Ladekreis; schlägt sie fehl, ist die Arbeit verloren. Diese Aufrufe gehören in eine geplante Aktion oder eine Job-Warteschlange – mit Wiederholung, mit einem Protokoll darüber, was angefragt und was geantwortet wurde, und mit idempotenten Operationen: Eine wiederholte Synchronisation darf die Bestellung nicht zweimal anlegen. Genau dieses Protokoll erlaubt es Ihnen später, mit dem Amazon-Support über Daten zu sprechen statt über Eindrücke. Wie das beim Import der Bestellungen konkret aussieht, lesen Sie unter Amazon-Bestellungen nach Odoo importieren.
Wann Sie gar nichts bauen müssen
Wenn Sie auf einem einzigen Marktplatz verkaufen, wenige Artikel führen und nur möchten, dass Bestellungen ankommen, kann der Amazon-Connector genügen, der in Odoo Enterprise enthalten ist. Probieren Sie ihn aus, bevor Sie für irgendetwas bezahlen. Anders sieht es aus, sobald mehrere Länder mit eigener Besteuerung, kanalübergreifender Bestand, abzugleichende Abrechnungen oder fristgebundene Versandmeldungen im Spiel sind. Genau dort arbeitet unser Amazon-Connector für Odoo: SP-API mit Limitsteuerung, Berichte, FBA und FBM, unter Odoo 17, 18 und 19 – und unter Odoo 20 am Tag der Veröffentlichung.
Häufige Fragen
Brauche ich ein Amazon-Entwicklerkonto, um die SP-API zu nutzen?
Die Anwendung muss unter einem Entwicklerprofil registriert sein, autorisiert wird sie aber von Ihnen aus Ihrem eigenen Seller Central. Die Autorisierung gehört Ihnen und kann jederzeit widerrufen werden.
Lässt sich der Amazon-Bestand in Echtzeit abfragen?
Nicht so, wie man es sich vorstellt. Der Bestand kommt überwiegend per Bericht, und der ist asynchron – es bleibt immer ein Versatz von Minuten. Deshalb zählt ein Sicherheitspuffer mehr als die Synchronisationsfrequenz.
Was passiert, wenn Amazon mitten in der Hochsaison mit 429 antwortet?
Nichts Schlimmes, wenn die Anbindung mit wachsender Wartezeit neue Versuche startet und Offenes in die Warteschlange stellt. Schlimm wird es, wenn der Prozess stirbt und es niemand merkt, bis Bestellungen fehlen: Deshalb zählen Protokoll und Alarm so viel wie der Aufruf selbst.
Nützliche Links bei FlexigoTech
Lo que hacemos sobre esto
Ihre SP-API-Anbindung hakt und Sie wissen nicht, wo?
Sagen Sie uns, auf welchen Marktplätzen Sie verkaufen, ob Sie FBA, FBM oder beides nutzen, und welchen Fehler Sie konkret im Protokoll sehen. Wir prüfen, ob es an der Autorisierung, an den Aufruflimits oder an einem falsch berechneten Zeitfenster liegt. Schreiben Sie an comercial@flexigobe.com.