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

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

Mit dem Synesty Studio Amazon Vendor Central Add-Onopen in new window können Sie Prozesse zwischen Amazon Vendor Central und Ihren eigenen Systemen automatisieren.

  • Aufträge (Vendor Retail Procurement Orders / Purchase Orders (POs)) aus Vendor Central abrufen und bestätigen
  • Reports abrufen

Voraussetzungen

Verbindung zwischen Synesty Studio und Amazon Vendor Central einrichten

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

  1. Registrieren Sie sich für Vendor 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:

Wählen Sie zunächst als Anwendungstyp(application_type) Vendor Central und wählen danach den Vendor Central Marktplatz(vendor_marketplace) aus, für den Sie sich registriert haben. Klicken Sie anschließend auf den "Konfiguration starten" Button. Sie automatisch zum Vendor 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.

Vorbereitung Datastores

Vendor Central Vorlage verwenden

Verwenden Sie die Vendor Central SP API Vorlageopen in new window, um die benötigten Datastores anzulegen. Zusätzlich zu diesen Datastores werden vier Beispiel-Flows angelegt, die Sie für Ihren Anwendungsfall anpassen können.

Grundlage für alle weiteren Prozesse sind zwei Datastores, die korrekt befüllt werden müssen. Nach korrekter Einrichtung müssen beide Datastores so aussehen:

Datastore Schemas anlegen

Legen Sie das erste Schema für die Bestellkopfdaten (PurchaseOrders) an unter Datastores > Schemaopen in new window > Schema erstellen.

Der Schema-Namen kann frei vergeben werden, z.B. AmazonVendorEDIPurchaseOrders-Schema Als vordefiniertes Schema müssen Sie Schema AmazonVendorCentral-SP-API-PurchaseOrder auswählen:

Legen Sie das zweite Schema für die Bestellpositionen an.

Der Schema-Namen kann frei vergeben werden, z.B. VendorCentralOrderItems-Schema. Als vordefiniertes Schema müssen Sie Schema AmazonVendorCentral-SP-API-PurchaseOrderItems auswählen:

Nachdem die Schemas erstellt sind, legen Sie zwei Datastores unter Datastoresopen in new window > Neuen Datastore erstellen an.

VendorCentralOrders

VendorCentralOrderItems

Nachdem Sie diesen Datastore angelegt haben, sollten Sie unter Datastores zwei leere Datastores haben:

Nächster Schritt?

Sie können jetzt diese Bestellungen mit einem eigenen, individuellen Flow weiterverarbeiten.

Bestätigung der bestellten Mengen

Dafür sollten Sie sich den zweiten Datastore VendorCentralOrderItems ansehen, in dem die Bestellpositionen liegen. 
Betrachten wir eine einzelne Bestellposition.

Man erkennt, dass einige Werte leer sind. Diese Werte müssen von Ihnen befüllt werden und sind die Werte, die anschließend zu Amazon zurückgemeldet werden.

FeldBeschreibung
acknowledgementAcknowledgedQuantityAmountDie Menge dieser Bestellposition, die Sie zu Amazon schicken werden und damit bestätigen.
acknowledgementBackorderedQuantityAmountDie Menge dieser Bestellposition, die Sie erste nachbestellen müssen.
acknowledgementRejectedQuantityAmountMenge der Position, die Sie abweisen, weil Sie gerade nicht liefern können.
acknowledgementRejectionReasonGeben Sie hier den Grund für die Abweisung der Artikel an:
- TemporarilyUnavailable: Aktuell nicht verfügbar
- InvalidProductIdentifier: falsche oder nicht vorhandene Produkt ID
- ObsoleteProduct: Der Artikel wird nicht mehr von Ihnen verkauft.
acknowledgementQuantityUnitOfMeasure- Eaches: Einzelne Artikel
- Cases: einzelne Artikel in einer Verpackung
acknowledgementQuantityUnitSizeAnzahl der einzelnen Artikel in eine Verpackung. Nur bei acknowledgementQuantityUnitOfMeasure = Cases
acknowledgementScheduledShipDateDatum, wann Sie die Ware bei sich losschicken. Nur wenn acknowledgementBackorderedQuantityAmount verwendet wird.
Format ISO-8601, z.B.2022-08-13T06:29:00Z
acknowledgementScheduledDeliveryDateDatum, wann die Ware bei Amazon eintreffen wird. Dieses Datum sollte immer nach dem acknowledgementScheduledShipDate liegen. Nur wenn acknowledgementBackorderedQuantityAmount verwendet wird.
Format ISO-8601, z.B.2022-08-13T06:29:00Z

Wie befülle ich die Werte im Datastore?

In der Regel werden die Werte im Datastore automatisiert per Import mit einem Flow befüllt. Dieser Teil ist immer individuell, weshalb wir diese Vorgehensweise hier nicht weiter beschreiben. Allgemeine Informationen zum Importieren von Daten in Datastores finden Sie hier. Einen Beispiel Flow für die Befüllung des Datastores finden Sie in der Vorlage (siehe 2-Bestätigte Mengen in Datastore schreiben).

Rückweg zu Amazon - Übertragung der bestätigten oder stornierten Mengen

Nachdem die Daten im Datastore mit den bestätigten oder stornierten Mengen angereichert wurden, können diese wieder zurück zu Amazon übertragen werden.

Dazu erstellen Sie einen weiteren Flow, der den VendorCentralSubmitOrderAcknowledgementopen in new window Step enthält und folgendermaßen aussehen könnte (siehe Beispiel-Flow: 3-Purchase Orders bestätigen).

Der Step holt automatisch alle Datensätze mit PROCESSING_STATUS = UNPROCESSED aus dem Datastore und bestätigt diese. Nach der Übermittlung werden die Datensätze auf PROCESSED_SUCCESS (Bestätigung erfolgreich übermittelt) oder PROCESSED_ERROR (Es ist ein Fehler bei der Bestätigung aufgetreten) gesetzt. Im Falle der erfolgreichen übermittlung wird zusätzlich die Spalte acknowledgementTransactionId am Datensatz der Bestellung gesetzt.

Diese Id kann verwendet werden, um den Status der Transaktion mithilfe des VendorCentralGetTransactionStatusopen in new window Steps abzufragen (siehe Beispiel-Flow: 4-Transaktion Status abrufen und per Email versenden). Sollte ein Fehler bei der Purchase Order Bestätigung auftreten, wird in der Spalte acknowledgementStatus die Fehlermeldung gesetzt.

Flows der Amazon Vendor SP API Vorlage

Die Amazon Vendor SP API Vorlageopen in new window enthält Beispiel Flows

  • die den Abruf der Bestellungen (Retail Procurement Orders / Purchase Orders (POs)) aus dem Amazon Vendor Central zeigen und diese in den entsprechenden Datastores speichern
  • anhand von festen Werten beispielhaft zeigen, wie die Spalten für die Bestätigung der POs im Datastore befüllt werden können
  • mithilfe des VendorCentralSubmitOrderAcknowledgementopen in new window Steps POs bestätigt werden
  • der Transaktionsstatus der Bestätigung abgerufen werden kann

Beispiel-Flow: "1-Purchase Orders abrufen"

Dieser Flow zeigt, wie Bestellungen (Retail Procurement Orders / Purchase Orders (POs)) abgerufen und in den entsprechenden Datastores gespeichert werden können. Im VendorCentralGetPurchaseOrdersopen in new window Step werden offene Bestellung von Amazon abgerufen.

Der Filter Step wird verwendet, um die Bestellkopf von den Bestellpositionen des Ergebnis-Spreadsheets zu trennen.

Im ersten DatastoreWriter Step werden die Kopfdaten in den VendorCentralOrders Datastore geschrieben. Der zweite DatastoreWriter Step speichert die zugehörigen Positionszeilen im VendorCentralOrderItems Datastore ab.

TIP

Bitte beachten Sie, dass in der Vorlage ein Limit für den Abruf der Bestellungen gesetzt ist. Testen Sie Ihre Flows mit einer geringen Anzahl Bestellungen. Anschließend können Sie die Flow-Variable limit leeren oder entfernen, um alle POs abzurufen.

Beispiel-Flow: "2-Bestätigte Mengen in Datastore schreiben"

Dieser Flow zeigt anhand von festen Beispielwerten, wie die Spalten für die Bestätigung der Bestellungen im Datastore gefüllt werden können. Bitte beachten Sie, dass dieser Flow auf Ihren Anwendungsfall angepasst werden muss. Beispielweise könnten Bestände für die Bestellpositionen aus einem ERP System abgefragt werden.

Im Beispiel werden alle Datensätze (POs) im Status UNPROCESSED aus dem Datastore geholt. Im Filter Step werden zugehörigen Bestellpositonen von der Kopfzeile getrennt. In der Konfiguration des Mapper Steps werden in den acknowledgement... Spalten Beispielwerte gesetzt. Diese Konfiguration müssen Sie auf Ihre Anforderungen anpassen. Bestände könnten z.B. aus einem anderen Datastore über die Querverweis Funktion geholt werden.

Der DatastoreWriter Step schreibt die gesetzten Werte anschließend zurück in den Datastore.

Beispiel-Flow: "3-Purchase Orders bestätigen"

Dieser Flow enthält nur den VendorCentralSubmitOrderAcknowledgementopen in new window, der die Bestätigung zu Amazon übermittelt.

Beispiel-Flow: "4-Transaktion Status abrufen und per Email versenden"

Die Verabeitung der Bestellbestätigung erfolgt asynchron. Bis die Bestätigung verarbeitet wurde und im Vendor Central sichtbar ist, kann einen Moment dauern.

Dieser Flow kann verwendet werden, um den Transaktionsstatus der Bestellbestätigung abzurufen. Im Beispiel werden im ersten Step (SearchDatastoreopen in new window) erfolgreich bestätigte (PROCESSED_SUCCESS) Bestellungen aus dem Datastore geholt und für die gesetzte acknowledgementTransactionId der Status im Step VendorCentralGetTransactionStatusopen in new window abgerufen.

Das Ergebnis des Steps wird anschließend in eine CSV Datei (CSVWriter Stepopen in new window) geschrieben und per Email(EmailSend Stepopen in new window) an versendet.