Allgemein:
Voraussetzung für den Abruf der Abrechnungsberichte über die Amazon API ist, dass der Händler die Amazon-App Nexus autorisiert.
Die Autorisierung erfolgt dabei über die unten genannte URL, eine Installation der App ist dabei nicht notwendig.
Das Ergebnis dieser Autorisierung ist ein Token (Refresh-Token), der im Konverter Nexus für den API-Abruf eingetragen werden muss.
In dieser Dokumentation wird die Einrichtung, d.h. die Autorisierung erklärt.
Eine Anleitung für die Einrichtung bzw. den Abruf im Konverter selbst finden Sie im Nexus-Benutzerhandbuch.
Wichtige Hinweise:
•Die Autorisierung (d.h. die Erzeugung des Tokens) muss pro Region (nicht pro Land/Marktplatz) und pro Konto durchgeführt werden.
Eine genaue Erläuterung finden Sie weiter unten in dieser Dokumentation.
•Öffnen Sie die u.g. URL bitte nur mit dem Browser Google Chrome!
•Über die API können die Daten rückwirkend bis max. 90 Tage abgerufen werden.
Vorgehensweise für die Autorisierung:
Öffnen Sie in Ihrem Google Chrome Browser folgende URL: https://amazonoauthlogin.azurewebsites.net/api/StartAuthentication
Sie gelangen damit auf unsere Webseite, die wir für die Autorisierung unserer dekodi-App bei Amazon bereitstellen.
Klicken Sie hier auf "Bei Amazon anmelden":
Abb. Nexus Amazon Ameldung
Sie gelangen auf die Anmeldeseite für das Amazon Seller Central.
Melden Sie sich hier mit Ihren Amazon Zugangsdaten an:
Abb. Amazon Anmeldung
1. Kontoauswahl
Wählen Sie nun das Konto aus, für das Sie den API-Abruf freigeben möchten.
Falls Sie die Autorisierung für mehrere Konten durchführen möchten, müssen die u.g. Schritte pro Konto wiederholt werden.
Abb. Amazon Kontoauswahl
2. Auswahl der Region(en):
Wählen Sie bitte auch die Region aus, für die Sie den API-Abruf freigeben möchten. Die Autorisierung darf pro Region nur einmal durchgeführt werden und nicht pro Land/Marktplatz.
Falls Sie die Autorisierung für mehrere Regionen durchführen möchten, müssen die u.g. Schritte pro Region wiederholt werden.
--> Wenn Sie also in allen drei Regionen aktiv sind, erhalten Sie insgesamt nur drei unterschiedliche Token!
Folgende Regionen können je nach Aktivität ausgewählt werden:
•EU-West-1: Europa + VAE (vereinigte Arabische Emirate)
•US-East-1: USA, Kanada, Mexico
•US-West-2: Japan, Australien, Singapur
Auf dem nachfolgenden Screenshot sehen Sie das Konto eines Händlers, der in allen drei Regionen aktiv ist (siehe Kästchen in rot, grün und blau):
Abb. Amazon Regionauswahl
•Um den Abruf aller europäischen Marktplätze (EU-West-1) zu autorisieren, wählen Sie bitte nur ein Land (z.B. Deutschland) aus und klicken Sie auf "Konto auswählen".
•Um den Abruf der Marktplätze USA, Kanada und Mexiko (US-East-1) zu autorisieren, wählen Sie bitte nur ein Land (z.B. Kanada) aus und klicken Sie auf "Konto auswählen".
Autorisieren Sie Nexus zum Zugriff auf Ihre Berichte, indem Sie unten das Häkchen setzen und auf "Jetzt bei Nexus anmelden" klicken:
Abb. Nexus autorisieren
Nachdem Sie die Autorisierung erteilt haben, gelangen Sie wieder auf unsere Webseite. Klicken Sie hier auf "Refreshtoken generieren":
Abb. Nach der Autorisierung in Amazon
Amazon erzeugt nun ein Refresh-Token für den Zugriff von Nexus auf Ihre Berichtsdaten aller europäischen Marktplätze (bzw. für die Region, die Sie ausgewählt haben). Nach kurzer Berechnungszeit wird dieses Token im Browser angezeigt.
Bitte kopieren Sie dieses Token und fügen es im Nexus bei den API-Zugangsdaten für Ihre Amazon-Plattform ein, bzw. geben es weiter an Ihren Steuerberater, damit er es im Nexus eintragen kann:
Abb. Refresh Token
Die Angabe der Verkäufer-ID ist nicht mehr notwendig, da diese im Token verschlüsselt ist.
Hinweis:
Aktuell erzeugt Amazon Tokens, die für ein Jahr gültig sind. Bitte denken Sie daran, das Ablaufdatum des Tokens zu beachten, und rechtzeitig das Token zu verlängern:
Abb. Ablauf der Autorisierung