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-On können Sie Prozesse zwischen Amazon Vendor Cental und Ihren eigenen Systemen automatisieren.
- Aufträge (Vendor Retail Procurement Orders / Purchase Orders (POs)) aus Vendor Central abrufen und bestätigen
- Reports abrufen
Voraussetzungen
- eigener Amazon Vendor Central Account, z.B. (vendorcentral.amazon.com)
- Synesty Studio Account
Verbindung zwischen Synesty Studio und Amazon Vendor Central einrichten
Um auf Ihren Vendor Central Account zuzugreifen, müssen Sie zwei Dinge tun:
- Registrieren Sie sich für Vendor Central Account
- 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 Vorlage, 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 > Schema > 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 Datastores > 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.
| Feld | Beschreibung |
|---|---|
| acknowledgementAcknowledgedQuantityAmount | Die Menge dieser Bestellposition, die Sie zu Amazon schicken werden und damit bestätigen. |
| acknowledgementBackorderedQuantityAmount | Die Menge dieser Bestellposition, die Sie erste nachbestellen müssen. |
| acknowledgementRejectedQuantityAmount | Menge der Position, die Sie abweisen, weil Sie gerade nicht liefern können. |
| acknowledgementRejectionReason | Geben 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 |
| acknowledgementQuantityUnitSize | Anzahl der einzelnen Artikel in eine Verpackung. Nur bei acknowledgementQuantityUnitOfMeasure = Cases |
| acknowledgementScheduledShipDate | Datum, wann Sie die Ware bei sich losschicken. Nur wenn acknowledgementBackorderedQuantityAmount verwendet wird. Format ISO-8601, z.B. 2022-08-13T06:29:00Z |
| acknowledgementScheduledDeliveryDate | Datum, 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 VendorCentralSubmitOrderAcknowledgement 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 VendorCentralGetTransactionStatus 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 Vorlage 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 VendorCentralSubmitOrderAcknowledgement 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 VendorCentralGetPurchaseOrders 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 VendorCentralSubmitOrderAcknowledgement, 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 (SearchDatastore) erfolgreich bestätigte (PROCESSED_SUCCESS) Bestellungen aus dem Datastore geholt und für die gesetzte acknowledgementTransactionId der Status im Step VendorCentralGetTransactionStatus abgerufen.
Das Ergebnis des Steps wird anschließend in eine CSV Datei (CSVWriter Step) geschrieben und per Email(EmailSend Step) an versendet.