Skip to content
Synesty | No Code - Low Code Integration & Automation

Amazon Seller Central

Amazon Seller Central ist das Händler-Backend, in dem Sie als Amazon Verkäufer Ihr Sortiment verwalten. 

Mit dem Synesty Studio Amazon Seller Central Add-On können Sie Prozesse zwischen Amazon Seller Central und Ihren eigenen Systemen automatisieren. 

  • Angebote an Endkunden und Geschäftskunden (Amazon Business) in Seller Central importieren und aktualisieren
  • Aufträge aus Seller Central exportieren
  • Reports aus Seller Central exportieren
  • Feeds importieren und Rechnungen hochladen
  • Suche von Amazon-Katalogartikeln und zugehörigen Informationen
  • Abruf von Finanzereignissen für Bestellungen

Voraussetzungen

Verbindung zwischen Synesty Studio und Amazon Seller Central einrichten

Um auf Ihren Seller Central Account zuzugreifen, müssen Sie zwei Dinge tun:

  1. Registrieren Sie sich für Seller Central Account
  2. Synesty Studio mit den SP API Zugangsdaten einrichten

Synesty Studio Verbindung einrichten

Gehen Sie in Ihre Verbindungen und dann auf Amazon Selling Partner API.

Legen Sie dort einen neuen Account an:

Stellen Sie zunächst sicher, dass der Anwendungstyp(application_type) “Seller Central” ausgewählt ist und wählen danach den Seller Central Marktplatz aus, für den Sie sich registriert haben. Klicken Sie anschließend auf den “Konfiguration starten” Button. Sie werden automatisch zum Seller Central Login des gewählten Marktplatzes weitergeleitet.

Nachdem Sie sich erfolgreich eingeloggt haben, müssen die benötigten Berechtigungen bestätigt werden:

Nach der Bestätigung werden Sie automatisch zurück zur angelegten Verbindung in Synesty Studio geleitet. Alle benötigten Authentifizierungsdaten werden automatisch befüllt.

Verbindung in Synesty Studio testen

Sie können die Zugangsdaten über den Button “Verbindung testen” ausprobieren. Wenn Sie eine Meldung mit “Verbindungstest war erfolgreich” sehen, sind die Zugangsdaten korrekt:

Vorlagen

Das Amazon Seller Central Add-On beinhaltet einige Vorlagen, die den Einstieg in das Add-On vereinfachen. Diese Vorlagen können Sie installieren und einfach auf Ihre Bedürfnisse anpassen. Es existieren u.a. Vorlagen zum Listing von Angeboten, Preis- und Bestandsupdates sowie zum Export von Bestellungen.

Beispiel - Bestellungen exportieren

Viele Händler haben Ihre Angebote bereits bei Amazon Seller Central eingestellt. Der erste Zeitpunkt, wann über eine Automatisierung nachgedacht wird, ist dann der Export von Bestellungen zur Warenwirtschaft. 

Zum Abruf von Auftragsdaten steht der Step SellerCentralGetOrders zur Verfügung. 

Step Konfiguration

Der Step stellt einige Konfigurationsoptionen zur Verfügung. Damit können Sie eingrenzen, welche Aufträge Sie von Amazon Seller Central abrufen wollen. Typische Parameter sind OrderStatus oder das Auftragserstellungsdatum.

  • Es muss mindestens ein Marktplatz (marketplace) ausgewählt und eines der beiden Datumsfilter CreatedAfter oder LastUpdatedAfter gefüllt werden. Sie können z.B. die prop_lastruntime Laufzeit Eigenschaft verwenden, um geänderte Aufträge seit der letzten automatischen Ausführung abzurufen.

  • Die verschiedenen OrderStatus sind hier beschrieben.

  • Um Bestellpositionen und/oder die Adressen abzurufen, aktivieren Sie bitte die erweiterte Einstellung enableOrderItems bzw. enableAddresses. Wenn die Bestellpositionen aktiviert sind, können zusätzlich die Käuferinformationen für individuelle Bestellungen und Geschenkinformationen (enableOrderItemsBuyerInfo) abgerufen werden. Bitte beachten Sie, dass der Abruf von Bestellpositionen, Adressen und Käuferinformationen zusätzliche API Calls benötigt und ggf. die Laufzeit des Steps deutlich erhöht. Aktivieren Sie diese Optionen nur, wenn Sie diese Daten benötigen.

Beispiel - Listings anlegen und aktualisieren

Unterschied zwischen SellerCentralInventoryLoader und SellerCentralListingLoader

Beide Steps basieren auf dem JSON_LISTING_FEED von Amazon Seller Central. Der SellerCentralListingLoader v2 Step hat einige Einstellungen fest hinterlegt, um die Aktualisierung und Erstellung von Verkaufsangeboten zu vereinfachen. Verwenden Sie diesen Step immer dann, wenn Sie Aktualisierungen an Ihren vorhandenen Listing - Angeboten vornehmen (z.B. Preis- oder Bestandsupdate) oder neue Verkaufsangebote für vorhandene Listings anlegen wollen.

Der SellerCentralInventoryLoader v2 stellt einige weitere Optionen zur Verfügung, die es ermöglichen neue Listings für einen bestimmten Amazon Produkttyp anzulegen.

Beispiel - Listing Angebote in Seller Central aktualisieren (SellerCentralListingLoader)

Wählen Sie in der Step Konfiguration zunächst eine Seller Central Verbindung, den Marktplatz und ein Spreadsheet mit den Input Daten aus.

Listing Loader Step Configuration

Anhand dieser Daten kann der Step die von Amazon geforderten Spalten erzeugen. D.h. Sie müssen Ihre eigenen Produktdaten noch diesen Spalten zuordnen.

Für die Zuordnung der Zielspalten öffnen Sie die Einstellungen des SellerCentralListingLoader Steps und klicken Sie auf den Konfigurieren Button.

Danach können Sie jeder Zielspalte die entsprechende Quellspalte Ihrer eigenen Produktdaten zuordnen.

Zielspalten

In den meisten Fällen werden nur wenige der Zielspalten benötigt. Sie können zunächst alle Spalten aus dem Mapping entfernen und anschließend nur die für Ihren Anwendungsfall benötigten Spalten (sku und operation-type sind Pflichtfelder) hinzufügen:

Zielspalten entfernen

Ziehlspalten hinzufügen

Ziehlspalten hinzufügen Auswahl

Sollten einige Zeilen in der Vorschau rot hinterlegt werden, dann stimmt das Datenformat nicht. z.B. erwartet die Spalte eine Zahl mit Punkt als Dezimaltrenner. D.h. Sie müssen evtl. noch Komma durch Punkt mithilfe der Suchen-Ersetzen-Funktion ersetzen.

Marktplatz-spezifische Spalten

Hinweis: Je nach Marketplace können die Spalten und die erlaubten Werte variieren. Beachten Sie, dass die Spalten jedoch nur beim erstmaligen Aufruf geladen werden. D.h. wenn Sie den Marketplace am Account z.B. von Deutschland auf USA wechseln, dann sehen Sie die Änderungen nicht. Um die Änderung dennoch zu sehen, müssen Sie die mappingdefinition leeren, um wieder zum Initialzustand zu kommen (Achtung: Dadurch geht Ihr aktuelles Mapping komplett verloren).

Um die mappingdefinition zu leeren, gehen Sie wie folgt vor:

  • Klicken Sie auf den Button mit den drei Punkten neben der mappingdefinition
  • Klicken Sie anschließend auf Zurücksetzen

Prüfen des Feed-Upload Status in Amazon Seller Central

Bei der Ausführung eines Flows wird der Feed zu Amazon Seller Central zur Verarbeitung übermittelt. Als Ergebnis der Übermittlung erhalten Sie eine eindeutige Nummer, die im Eventlog als FeedSubmissionId ausgegeben wird. 

Den Fortschritt der Verarbeitung im Seller Central können Sie im Seller Central unter Lagerbestand / mehrere Artikel hochladen / Prüfen Sie den Uploadstatus überprüfen.

Reports erzeugen und herunterladen mit SellerCentralRequestReport

Der Step SellerCentralRequestReport fordert die Erzeugung eines Reports in Amazon Seller Central an. Daraufhin beginnt Amazon damit, den Report neu zu erzeugen. Der Step wartet auch eine Weile und versucht den Report gleich herunterzuladen. Das Ergebnis des Steps ist der Report als FILE. 

Beispiel-Konfiguration:

Durch die Step-Vorschau können Sie den Abruf des Reports ausprobieren. Wenn Sie in der Vorschau eine CSV, XML oder JSON Datei erhalten, hat es funktioniert. Sollte die CSV-Datei leer sein, prüfen Sie die Datumsfilter startDate und endDate.

Ausführungsdauer

Hinweis: Der SellerCentralRequestReport Step kann eine sehr lange Laufzeit aufweisen. Die Erzeugung und der Abruf des Reports kann mehrere Minuten dauern. Der Step fordert einen neuen Report an, der von Amazon generiert wird. Anschließend wartet der Step und fragt mehrere Male nach, ob der Report fertig erstellt wurde. Erst dann startet der Download. Die Dauer hängt von der Auslastung bei Amazon an und kann von Synesty nicht beeinflusst werden.

SellerCentralDownloadReport

Der Step SellerCentralDownloadReport lädt einen zuvor erstellten Report herunter. Diesen Step braucht man nur selten bzw. für bestimmte Reports. Zum Beispiel gibt es bei Amazon Seller Central Reports, die nicht angefragt (requested) werden, sondern von Amazon periodisch erzeugt werden (z.B. der Settlement Report oder Monthly Transactions Report). Diesen kann man nicht mit SellerCentralDownloadReport anfordern, sondern nur mit SellerCentralDownloadReport herunterladen.

Rechnungen automatisch hochladen mit dem SellerCentralInvoiceUpload Step

Der SellerCentralInvoiceUpload Step ermöglicht es, Rechnungen oder Gutschriften über SP-API in Ihr Amazon Seller Central hochzuladen.

Die Auswahl mode ermöglicht es Ihnen, eine Quelle für die Rechnungsdateien auszuwählen: 

  • ‘Datei von URL hochladen’ - Die Rechnungsdatei wird von der angegebenen ‘DocumentURL’ während der Ausführung des Steps abgerufen
  • ‘Datei aus FILELIST hochladen’ - Die Rechnungsdatei wird aus der Liste ‘inputFiles’ entnommen. Diese muss mit dem Output (Filelist) eines vorherigen Steps (z.B. FTPDownload) verknüpft werden. Wenn Sie diesen Modus verwenden, muss der ‘DocumentFilename’ in der Zielspalte mit dem Dateinamen in der ‘inputFiles’- Liste übereinstimmen.

Das Feld “invoiceSpreadsheet” muss mit einem Spreadsheet verbunden werden, dass mindestens die (Amazon) OrderId und ihre Rechnungsnummer enthält.

Eine Konfiguration für den Modus “Datei von URL hochladen” könnte z.B. wie folgt aussehen:

Eine Konfiguration für den Modus “Datei aus FILELIST hochladen” könnte z.B. wie folgt aussehen:

FAQ, Troubleshooting

Frage: Wir haben mehrere, separate Amazon-Konten. Können verschiedene Konten in Synesty Studio verwendet werden?

Antwort: Ja, das ist möglich. Legen Sie für jedes Amazon-Konto eine eigene Amazon SP API Verbindung an.

Verwenden Sie sprechende Namen für die Accounts, um Verwechslungen bei der Auswahl des Accounts zu vermeiden.

Frage: Ich rufe Bestellungen mit dem SellerCentralGetOrders Step ab und habe die erweiterte Einstellung enableAddresses aktiviert, um die Adressen zu erhalten. Die Daten der Lieferadresse sind leider unvollständig. Warum?

Antwort: Bei FBA Bestellungen (FulfillmentChannel = AFN) sind die persönlichen Daten nicht in der API Antwort enthalten. Diese Daten können nicht abgerufen werden, siehe auch Amazon SP-API Forum

Frage: Ich versuche einen der Bestellberichte (Order Report, z.B. GET_ORDER_REPORT_DATA_INVOICING) der Abrechnungsberichte (Settlement Reports, z.B. GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE) mit dem SellerCentralRequestReport Step zu erzeugen und erhalte den Fehler: “Request for report type … is not allowed at this time”.

Antwort: Nicht alle Reports können über die Amazon SP-API neu erzeugt werden. Einige der Berichte werden zeitgesteuert (scheduled) von Amazon erstellt. Diese Report-Typen können nicht mit dem SellerCentralRequestReport abgerufen werden. Bitte beachten Sie dazu die Amazon Dokumentation zu den Report Type. Sie können den SellerCentralDownloadReport Step verwenden, um Reports herunterzuladen, die nicht angefordert werden können.

Frage: Beim Abruf von Steuer-Berichten (GET_FLAT_FILE_ORDER_REPORT_DATA_TAX oder GET_AMAZON_FULFILLED_SHIPMENTS_DATA_TAX) erhalte ich einen Fehler. Andere Reports können ohne Probleme abgerufen werden.

Antwort: Um diese Berichte abrufen zu können, muss der Umsatzsteuer-Berechnungsservice von Amazon (VAT Calculation Service, kurz VCS) aktiviert sein.

Steps im Amazon Seller Central Add-On

Weitere Informationen

Impressum | Datenschutzhinweise
© Synesty GmbH, 2025 - No Code - Low Code Integration Platform - Schnittstellen & API-Anbindungen