Amazon Seller Central - Selling Partner API (SP-API)

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-Onopen in new window 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 automatisch zum Seller Central Login des gewählten Martplatzes 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 "SUCCESS" 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 SellerCentralGetOrdersopen in new window 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 OrderStatusopen in new window oder das Auftragserstellungsdatumopen in new window.

TIP

  • 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 beschriebenopen in new window.

  • 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 - Angebote in Seller Central listen und aktualisieren

Um Angebote in Amazon Seller Central einzuspielen, kann der Step SellerCentralInventoryLoaderopen in new window oder SellerCentralListingLoaderopen in new window genutzt werden.

Die Steps kennen die von Amazon geforderten Spalten. D.h. Sie müssen Ihre eigenen Produktdaten noch diesen Spalten zuordnen.

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

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

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

Marktplatz-spezifische Spalten

Hinweis: Je nach Marketplace können die Spalten und die erlaubten Werte variieren. Wenn Sie z.B. USA (Amazon US) eingestellt haben, dann sehen Sie wesentlich mehr Spalten, als für Deutschland. Auch die erlaubten Werte wie z.B. für fullfilmentcenter-id sind für US anders als für DE.

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

Unterschied zwischen SellerCentralInventoryLoader, SellerCentralListingLoader und SellerCentralPriceAndQuantityUpdate

Die Steps basieren auf den Lagerbestandsdateivorlagen von Amazon Seller Central. Diese werden auf folgender Seiteopen in new window (Login in Seller Central erforderlich) beschrieben. Die folgende Tabelle zeigt, welcher Step zu welcher Vorlage gehört.

StepName der DateivorlageAnwendungsbeispielVerwendung für
SellerCentralInventoryLoaderopen in new windowLagerbestands-Assistent (Inventory Loader)Hochladen Ihres Lagerbestands durch Zuweisung Ihrer Angebote zu vorhandenen Produkten im Amazon-KatalogMedienartikel (Bücher, Musik, Video, DVD) und deren Versandeinstellungen
SellerCentralInventoryLoaderopen in new windowAngebots-Assistent (Listing Loader)Hochladen Ihres Lagerbestands durch Zuweisung Ihrer Angebote zu vorhandenen Produkten im Amazon-KatalogNicht-Medienprodukte, inkl. der Option zum Festlegen von Angebotspreisen oder Geschenkoptionen
SellerCentralPriceAndQuantityUpdateopen in new windowAktualisierung von Preisen und MengenAktualisierung der Preise und Stückzahlen von Artikeln, die bereits in Ihrem Verkäuferkonto angeboten werdenAktualisierung der Preise und Stückzahlen der Artikel in Ihrem Angebot

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 Uploadstatusopen in new window überprüfen.

Die Spalte Batch-ID entspricht der FeedSubmissionId aus dem Eventlog.

Weitere Informationen

Amazon Business - SellerCentralInventoryLoader und SellerCentralPriceAndQuantityUpdate

Zum Listen und Updaten von Angeboten auf Amazon Business müssen zusätzliche Felder in den Steps SellerCentralInventoryLoaderopen in new window und SellerCentralPriceAndQuantityUpdate](https://apps.synesty.com/registration/Amazon-Seller-Central-SellerCentralPriceAndQuantityUpdate/de-de?action=showStep&id=a1b8e66f-d1f3-11ec-a1ed-901b0ed5b6cc) hinzugefügt und konfiguriert werden.

SpaltentitelDefinition und VerwendungGültige WerteBeispielErforderlich
business-priceDer Preis, zu dem der Verkäufer das Produkt einem verifizierten Business-Kunden anbietet (Angabe in Euro). Gibt es einen Preis, so sollte der Business-Preis darunter liegen oder diesem entsprechen, da der Business-Preis einen Rabatt für Business-Kunden darstellt. Der Preis sollte größer als 0 sein. Verwenden Sie keine Tausendertrennzeichen oder Währungssymbole. Dieses Feld ist erforderlich, wenn Mengenpreise angegeben sind.Der Preis, zu dem der Verkäufer das Produkt registrierten Käufern anbietet. (Angabe in Euro)10,5Optional
national_stock_numberEin alphanumerischer 13-stelliger Code. Code, der Standardversorgungsartikel nach NATO-Definition bezeichnetEin alphanumerischer 13-stelliger Code. Code, der Standardversorgungsartikel nach NATO-Definition bezeichnet6240-00-027-2059Optional
quantity-price-typeFestpreis oder in Prozent. Wird "Festpreis" ausgewählt, so werden Mengenpreise in Euro angegeben. Wird "Prozent" ausgewählt, so werden Mengenpreise in % als Nachlass auf Business-Kundenpreis berechnet.Die Einheit, in der der Rabatt angegeben wird. Entweder Festpreis in Euro oder ReduzierungsprozentsatzFestpreisOptional
quantity-lower-bound1 - quantity-lower-bound5Mengengrenzen, Angabe in Einheiten. Business-Kunden, die mindestens diese Menge kaufen, kaufen zum entsprechenden Mengenpreis. Ist die Mengenuntergrenze 1 etwa auf 50 eingestellt, so gilt der Mengenpreis 1 bei einem Einkauf von mindestens 50 Einheiten. Verkäufer können bis zu fünf Untergrenzen angeben und müssen einen Mengen-Preis für jede Untergrenze angeben. Jede Untergrenze muss über der vorherigen liegen.Die Mindesteinkaufsmenge, die für den entsprechenden Festpreis oder Nachlass in Prozent erforderlich ist.100Optional
quantity-price1 - quantity-price5Mengenpreise, entweder in Euro (199,99 = 199,99€) oder als Nachlass in Prozent des Business-Preises (7 = 7 % Rabatt auf Business-Preis), je nach der gewählten Mengenpreis-Art. Für jeden Mengenpreis ist eine Untergrenze erforderlich. Jeder Mengenpreis muss geringer sein als der vorherige.Festpreis- oder Nachlass in Prozent, mit dem der Verkäufer das Produkt anbietet, wenn der Käufer mindestens die entsprechende Menge kauft, angegeben in Euro.10Optional
unspsc_codeEin 8-stelliger alphanumerischer Code zur Klassifizierung von Produkten gemäß den UNSPSC-System.Ein 8-stelliger alphanumerischer Code zur Klassifizierung von Produkten gemäß den UNSPSC-System.47121602Optional
pricing_actionBestimmt die erforderlichen Änderungen an den Preisattributen der SKU. Die einzige derzeit unterstützte Funktion ist die Löschung von Business-Preis (business_price).
Fügen Sie in diesem Feld delete business_price ein, wenn Sie den zuvor eingestellten Business-Preis (business_price) und Mengenrabatte löschen möchten. Wenn dieses Feld leer ist, wird keine Aktion ausgeführt und der Inhalt der Spalte wird ignoriert.
delete business_pricedelete business_priceOptional

Beispiel - Konfiguration von Businesspreis und Staffelpreisen für Amazon Business im Step SellerCentralInventoryLoader

Reports erzeugen und herunterladen mit SellerCentralRequestReport

Der Step SellerCentralRequestReportopen in new window 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 das ganze 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. Wundern Sie sich nicht, wenn das ganze mehrere Minuten dauert. Der Step fordert einen neuen Report an, der von Amazon generiert. Der Step wartet und fragt intern 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 SellerCentralDownloadReportopen in new window 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 Reportopen in new window). Diesen kann man nicht mit SellerCentralDownloadReport anfordern, sondern nur mit SellerCentralDownloadReport herunterladen.

Rechnungen automatisch hochladen mit dem SellerCentralInvoiceUpload Step

Der SellerCentralInvoiceUploadopen in new window 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.

TIP

Verwenden Sie sprechende Namen für die Accounts, um Verwechselungen 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 Forumopen in new window


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 Typeopen in new window. Sie können den SellerCentralDownloadReport Step, 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 VCSopen in new window aktiviert sein.