Details zur Amazon Marketplace-Verbindung

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 21.0.8662 des Connectors.

Erste Schritte

Unterstützung der Amazon Marketplace Version

Der Connector nutzt die Amazon Marketplace API, um einen bidirektionalen Zugriff auf Amazon Marketplace zu ermöglichen.

Herstellen einer Verbindung

Mit Amazon Marketplace verbinden

Amazon MWS API vs. Selling Partner API

Die Amazon MWS (Marketplace Web Services) API ist die ältere API für den Amazon Marketplace, während die Selling Partner (SP) API eine Reihe von Verbesserungen gegenüber der MWS API bietet, darunter JSON-basierte REST API Designstandards und OAuth 2.0. Die SP- API umfasst alle in der Amazon MWS API verfügbaren Funktionen.

Sie können angeben, mit welcher API eine Verbindung hergestellt werden soll, indem Sie festlegen Schema. Bitte beachten Sie, dass für jede API unterschiedliche Verbindungsoptionen verfügbar sind, wie unten beschrieben.

Mit der Verkaufspartner-API verbinden

Wenn Sie die Amazon Selling Partner API zur Verbindung mit dem Amazon Marketplace verwenden, sind die folgenden Eigenschaften erforderlich:

• Schema: Setzen Sie dies auf SellingPartner.
• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH.
• Marketplace: Legen Sie dies auf die Marketplace-Region fest, in der Sie für den Verkauf registriert sind.

Sie können auch verwenden SellingPartner Eigenschaft zur Auswahl Seller oder Vendor Authentifizierung.

Stellen Sie eine Verbindung zur MWS- API her

Wenn Sie die Amazon MWS API zur Verbindung mit dem Amazon Marketplace verwenden, SellerId, Marketplace, Marketplace sind erforderliche Verbindungseigenschaften. Set Schema Zu Marketplace.

Zugriff auf Amazon Marketplace konfigurieren

Um eine Verbindung zu Amazon Marketplace herzustellen, autorisieren Sie zunächst den Entwickler. Führen Sie dazu die folgenden Schritte aus:

• Verwenden Sie die MWS- Entwickler-ID: 195280669143.
• Gehe zu Manage your apps-Seite in Seller Central und melden Sie sich als Hauptkontoinhaber bei Ihrem Amazon-Verkäuferkonto an.
• Klicken Sie auf die Authorize new developer-Schaltfläche und befolgt den Workflow unter Verwendung der vom Connector bereitgestellten Entwickler-ID.

Oder gehen Sie zu Amazon Marketplace Driver und klicken Sie auf Authorize Now im rechten Bereich.

Erhalten Sie das MWS-Authentifizierungstoken

Um das MWS-Authentifizierungstoken zu erhalten, befolgen Sie die nachstehenden Schritte:

• Gehen Sie zu Manage your apps Seite in Seller Central und melden Sie sich als Hauptkontoinhaber bei Ihrem Amazon-Verkäuferkonto an.
• Suchen Sie die App.
• Klicken Sie unter der Spalte „MWS Auth Token“ auf View.

Erhalten Sie die Verkäufer-ID

Um die Verkäufer-ID zu erhalten, folgen Sie den folgenden Schritten:

• Melden Sie sich bei Ihrem Verkäuferkonto an.
• Wählen Sie Settings, Dann Account Info oben rechts auf dem Bildschirm.
• Unter Business Information Wählen Sie „Ihr Händler-Token“.

Authentifizieren eines Amazon Marketplace-Kontos

Legen Sie zum Herstellen der Verbindung die folgenden Verbindungseigenschaften fest:

• SellerId: Legen Sie die Verkäufer-ID der Webdiensteinstellungen des Amazon-Marktplatzes fest.
• Marketplace: Legen Sie den Standort des Amazon-Marktplatzes fest (USA, Kanada, Japan usw.).
• Schema: Schema festlegen auf Marketplace.

Authentifizieren mit OAuth-Authentifizierung

Amazon Marketplace verwendet den OAuth-Authentifizierungsstandard.

Um sich mit OAuth zu authentifizieren, müssen Sie entweder die Embedded Credentials verwenden oder erstellen Sie eine neue benutzerdefinierte OAuth-App (siehe Erstellen einer benutzerdefinierten OAuth-App).

Richtlinie zur Datenaufbewahrung bei Amazon Marketplace

Aus Sicherheitsgründen beschränkt Amazon Marketplace den Zugriff auf PII (persönlich identifizierbare Informationen). Sie können PII nur 30 Tage nach der Lieferung der Bestellung und nur für den Zweck und so lange aufbewahren, wie dies erforderlich ist, um

• Bestellungen ausführen
• Steuern berechnen und abführen
• Steuerrechnungen erstellen
• gesetzliche Anforderungen, einschließlich steuerlicher oder behördlicher Anforderungen, erfüllen.

Wenn Sie gesetzlich dazu verpflichtet sind, Archivkopien von PII aus Steuer- oder anderen behördlichen Gründen aufzubewahren, müssen Sie PII als „kaltes“ oder offline verschlüsseltes Backup speichern (d. h. nicht für die sofortige oder interaktive Verwendung verfügbar).

Dies bedeutet beispielsweise, dass der Amazon Marketplace Treiber nach 30 Tagen keine Versandadressinformationen des Kunden mehr anzeigt. Weitere Informationen finden Sie in der Amazon-Dokumentation:

Datenschutzrichtlinie von Amazon Marketplace

OAuth-Authentifizierung verwenden

Verwenden Sie den OAuth-Authentifizierungsstandard, um eine Verbindung mit Amazon Marketplace herzustellen. Sie können sich mit einem Benutzerkonto oder einem Dienstkonto authentifizieren. Der Connector ermöglicht dies wie unten beschrieben.

Verwenden Sie ein Benutzerkonto zur Authentifizierung bei Amazon Marketplace

Der Benutzerkontofluss erfordert, dass der authentifizierende Benutzer über den Browser mit Amazon Marketplace interagiert.

Eingebettete Anmeldeinformationen

Siehe Eingebettete Anmeldeinformationen, um eine Verbindung mit den eingebetteten Anmeldeinformationen des Connectors herzustellen und das Erstellen einer benutzerdefinierten OAuth-App zu überspringen.

Benutzerdefinierte Anmeldeinformationen

Anstatt die Verbindung mit den eingebetteten Anmeldeinformationen des Connectors herzustellen, können Sie eine App registrieren, um die OAuthClientId Und OAuthClientSecret. Sie können auch die OAuthAppStatus Eigenschaft zur Auswahl draft oder published Status. Sie müssen diese Eigenschaft angeben, wenn Sie benutzerdefinierte Anmeldeinformationen verwenden.

Wann sollte eine benutzerdefinierte OAuth-App erstellt werden?

Das Erstellen einer benutzerdefinierten OAuth-App ist optional, da der Connector bereits bei Amazon Marketplace registriert ist und Sie sich mit seinen eingebetteten Anmeldeinformationen verbinden können. Möglicherweise möchten Sie eine benutzerdefinierte OAuth-App erstellen, um die angezeigten Informationen zu ändern, wenn sich Benutzer beim OAuth-Endpoint von Amazon Marketplace anmelden, um dem Connector Berechtigungen zu erteilen.

Erstellen einer benutzerdefinierten OAuth-App

Siehe Erstellen einer benutzerdefinierten OAuth-App für ein Verfahren.

Eingebettete Anmeldeinformationen

Authentifizieren Sie sich mit den eingebetteten OAuth-Anmeldeinformationen

Desktop-Authentifizierung mit der eingebetteten OAuth-App

Sie können eine Verbindung herstellen, ohne Verbindungseigenschaften für Ihre Benutzeranmeldeinformationen festzulegen. Nachdem Sie Folgendes festgelegt haben, können Sie eine Verbindung herstellen:

• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Setzen von zu vermeiden OAuthAccessToken.
• Marketplace: Legen Sie dies auf die Marketplace-Region fest, in der Sie für den Verkauf registriert sind.
• Schema: Setzen Sie dies auf „SellingPartner“, um eine Verbindung zur SP- API herzustellen.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen. Der Connector schließt dann den OAuth-Prozess ab.

1. Extrahiert das Zugriffstoken aus der Rückruf URL und authentifiziert Anfragen.
2. Erhält einen neuen Zugriffstoken, wenn der alte abläuft.
3. Speichert OAuth-Werte in OAuthSettingsLocation soll über Verbindungen hinweg bestehen bleiben.

Benutzerdefinierte Anmeldeinformationen

Sie können eine benutzerdefinierte OAuth-App verwenden, um sich mit einem Dienstkonto oder einem Benutzerkonto zu authentifizieren. Siehe OAuth-Authentifizierung verwenden für weitere Informationen.

Authentifizieren mit einem Benutzerkonto

Desktop-Authentifizierung mit einer benutzerdefinierten OAuth-App

Befolgen Sie die nachstehenden Schritte, um sich mit den Anmeldeinformationen für eine benutzerdefinierte OAuth-App zu authentifizieren. Siehe Erstellen einer benutzerdefinierten OAuth-App.

OAuth-Zugriffstoken abrufen und aktualisieren

Nachdem Sie Folgendes festgelegt haben, können Sie eine Verbindung herstellen:

• OAuthClientId: Legen Sie hier die Client-ID fest, die Ihnen bei der Registrierung Ihrer App zugewiesen wurde.
• OAuthClientSecret: Setzen Sie dies auf das Client-Geheimnis, das Ihnen bei der Registrierung Ihrer App zugewiesen wurde.
• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Setzen von zu vermeiden OAuthAccessToken.
• Marketplace: Legen Sie dies auf die Marketplace-Region fest, in der Sie für den Verkauf registriert sind.
• AppId: Anwendungs-ID für die von Ihnen erstellte Verkaufspartner-App.
• Schema: Setzen Sie dies auf „SellingPartner“, um eine Verbindung zur SP- API herzustellen.
• AWSAccessKey: Dies ist der Zugriffsschlüssel, der an den AWS-Benutzer gebunden ist, der mit dem verknüpft ist OAuthClientId.
• AWSSecretKey: Dies ist der geheime Schlüssel, der an den AWS-Benutzer gebunden ist, der mit dem verknüpft ist OAuthClientId.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen. Der Connector schließt dann den OAuth-Prozess ab:

1. Extrahiert das Zugriffstoken aus der Rückruf URL und authentifiziert Anfragen.
2. Aktualisiert den Zugriffstoken, wenn er abläuft.
3. Speichert OAuth-Werte in OAuthSettingsLocation soll über Verbindungen hinweg bestehen bleiben.

Kopflose Maschinen

Verwenden von OAuth auf einer Headless-Maschine

Die folgenden Abschnitte zeigen, wie Sie einen Headless-Server oder eine andere Maschine authentifizieren, auf der der Connector keinen Browser öffnen kann. Sie können sich mit einem Benutzerkonto oder einem Dienstkonto authentifizieren.

Authentifizieren mit einem Benutzerkonto

Um sich mit einem Benutzerkonto zu authentifizieren, müssen Sie sich von einem anderen Computer aus authentifizieren. Die Authentifizierung erfolgt in zwei Schritten.

1. Anstatt den Connector auf einem anderen Computer zu installieren, können Sie die folgenden Schritte ausführen, um den OAuthVerifier-Wert. Oder Sie können den Connector auf einem anderen Computer installieren und die OAuth-Authentifizierungswerte übertragen, nachdem Sie sich über den üblichen browserbasierten Ablauf authentifiziert haben.
2. Anschließend können Sie den Connector so konfigurieren, dass das Zugriffstoken vom Headless-Computer automatisch aktualisiert wird.

Sie können dem Headless-OAuth-Authentifizierungsablauf mit den eingebetteten OAuth-Anmeldeinformationen des Connectors oder mit den OAuth-Anmeldeinformationen für Ihre benutzerdefinierte OAuth-App folgen.

Verwenden der eingebetteten OAuth-Anmeldeinformationen

Erhalten Sie einen Verifizierungscode

Folgen Sie den nachstehenden Schritten, um sich von einem anderen Computer aus zu authentifizieren und den zu erhalten OAuthVerifier Verbindungseigenschaft:

1. Klicken Sie auf den folgenden Link, um den Amazon Marketplace OAuth-Endpoint zu öffnen in Ihrem Browser.
2. Melden Sie sich an und erteilen Sie dem Connector die entsprechenden Berechtigungen. Sie werden dann zur Callback-URL weitergeleitet, die den Prüfcode als Wert für „spapi_oauth_code“ enthält.
3. Speichern Sie den Wert des Prüfcodes. Sie setzen diesen in OAuthVerifier Verbindungseigenschaft.

Legen Sie auf der Headless-Maschine die folgenden Verbindungseigenschaften fest, um die OAuth-Authentifizierungswerte abzurufen.

• OAuthVerifier: Setzen Sie dies auf den Prüfcode.
• InitiateOAuth: Stellen Sie dies auf REFRESH ein.
• OAuthSettingsLocation: Legen Sie dies fest, um die verschlüsselten OAuth-Authentifizierungswerte in der angegebenen Datei zu speichern.

Nachdem die OAuth-Einstellungsdatei generiert wurde, legen Sie die folgenden Eigenschaften fest, um eine Verbindung zu den Daten herzustellen:

• OAuthSettingsLocation: Legen Sie dies auf die Datei fest, die die verschlüsselten OAuth-Authentifizierungswerte enthält. Stellen Sie sicher, dass diese Datei dem Connector Lese- und Schreibberechtigungen erteilt, um die automatische Aktualisierung des Zugriffstokens zu ermöglichen.
• InitiateOAuth: Stellen Sie dies auf REFRESH ein.
• Marketplace: Legen Sie dies auf die Marketplace-Region fest, in der Sie für den Verkauf registriert sind.
• Schema: Setzen Sie dies auf „SellingPartner“, um eine Verbindung zur SP- API herzustellen.
• AppId: Anwendungs-ID für die von Ihnen erstellte Verkaufspartner-App.
• AWSAccessKey: Dies ist der Zugriffsschlüssel, der an den AWS-Benutzer gebunden ist, der mit dem verknüpft ist OAuthClientId.
• AWSSecretKey: Dies ist der geheime Schlüssel, der an den AWS-Benutzer gebunden ist, der mit dem verknüpft ist OAuthClientId.

OAuth-Einstellungen übertragen

Befolgen Sie die nachstehenden Schritte, um den Connector auf einem anderen Computer zu installieren, zu authentifizieren und dann die resultierenden OAuth-Werte zu übertragen.

Installieren Sie den Connector auf einem zweiten Computer und stellen Sie eine Verbindung mit den folgenden festgelegten Eigenschaften her:

• OAuthSettingsLocation: Legen Sie dies auf eine beschreibbare Textdatei fest.
• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH.

Testen Sie die Verbindung, um sich im Browser zu authentifizieren. Die resultierenden Authentifizierungswerte werden verschlüsselt in den durch angegebenen Pfad geschrieben OAuthSettingsLocation. Nachdem Sie die Verbindung erfolgreich getestet haben, kopieren Sie die OAuth-Einstellungsdatei auf Ihren Headless-Rechner.

Legen Sie auf dem Headless-Rechner die folgenden Verbindungseigenschaften fest, um eine Verbindung zu Daten herzustellen:

• OAuthSettingsLocation: Legen Sie hier den Pfad zu Ihrer OAuth-Einstellungsdatei fest. Stellen Sie sicher, dass diese Datei dem Connector Lese- und Schreibberechtigungen erteilt, um die automatische Aktualisierung des Zugriffstokens zu ermöglichen.
• Marketplace: Legen Sie dies auf die Marketplace-Region fest, in der Sie für den Verkauf registriert sind.
• Schema: Setzen Sie dies auf „SellingPartner“, um eine Verbindung zur SP- API herzustellen.
• AppId: Anwendungs-ID für die von Ihnen erstellte Verkaufspartner-App.
• AWSAccessKey: Dies ist der Zugriffsschlüssel, der an den AWS-Benutzer gebunden ist, der mit dem verknüpft ist OAuthClientId.
• AWSSecretKey: Dies ist der geheime Schlüssel, der an den AWS-Benutzer gebunden ist, der mit dem verknüpft ist OAuthClientId.

Verwenden der Anmeldeinformationen für eine benutzerdefinierte OAuth-App

Erstellen Sie eine benutzerdefinierte OAuth-App

Das Erstellen einer benutzerdefinierten OAuth-App ist im Headless-OAuth-Flow optional. Sie können das Erstellen einer App überspringen, indem Sie eine Verbindung mit den eingebetteten OAuth-Anmeldeinformationen des Connectors herstellen. Möglicherweise möchten Sie eine benutzerdefinierte OAuth-App erstellen, um die angezeigten Informationen zu ändern, wenn sich Benutzer bei Amazon Marketplace anmelden, um dem Connector Berechtigungen zu erteilen.

Siehe Erstellen einer benutzerdefinierten OAuth-App für ein Verfahren. Sie können dann die folgenden Verfahren befolgen, um sich zu authentifizieren und eine Verbindung zu Daten herzustellen.

Besorgen Sie sich einen Prüfcode

Legen Sie die folgenden Eigenschaften auf der Headless-Maschine fest:

• InitiateOAuth: Stellen Sie dies auf AUS.
• OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die Client-ID fest.
• OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das Client-Geheimnis fest.

Sie können dann die folgenden Schritte ausführen, um sich von einem anderen Computer aus zu authentifizieren und das zu erhalten OAuthVerifier Verbindungseigenschaft.

1. Rufen Sie die gespeicherte Prozedur GetOAuthAuthorizationURL auf, wobei der Eingabeparameter CallbackURL auf die genaue Umleitungs-URI eingestellt sein muss, die Sie in Ihren App-Einstellungen angegeben haben.
2. Öffnen Sie die zurückgegebene URL in einem Browser. Melden Sie sich an und erteilen Sie dem Connector Berechtigungen. Sie werden dann zur Callback-URL weitergeleitet, die den Prüfcode als Wert für „spapi_oauth_code“ enthält.
3. Speichern Sie den Wert des Prüfcodes. Sie setzen diesen in OAuthVerifier Verbindungseigenschaft.

Legen Sie auf der Headless-Maschine die folgenden Verbindungseigenschaften fest, um die OAuth-Authentifizierungswerte zu erhalten:

• OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf den Consumer-Schlüssel fest.
• OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das Verbrauchergeheimnis fest.
• OAuthVerifier: Setzen Sie dies auf den Prüfcode.
• OAuthSettingsLocation: Legen Sie dies fest, um die verschlüsselten OAuth-Authentifizierungswerte in der angegebenen Datei zu speichern.
• InitiateOAuth: Setzen Sie dies auf REFRESH.

Nachdem die OAuth-Einstellungsdatei generiert wurde, legen Sie die folgenden Eigenschaften fest, um eine Verbindung zu Daten herzustellen:

• OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf den Consumer-Schlüssel fest.
• OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das Verbrauchergeheimnis fest.
• OAuthSettingsLocation: Legen Sie dies auf die Datei fest, die die verschlüsselten OAuth-Authentifizierungswerte enthält. Stellen Sie sicher, dass diese Datei dem Anbieter Lese- und Schreibberechtigungen erteilt, um die automatische Aktualisierung des Zugriffstokens zu ermöglichen.
• InitiateOAuth: Stellen Sie dies auf REFRESH ein.
• Marketplace: Legen Sie dies auf die Marketplace-Region fest, in der Sie für den Verkauf registriert sind.
• Schema: Setzen Sie dies auf „SellingPartner“, um eine Verbindung zur SP- API herzustellen.
• AppId: Anwendungs-ID für die von Ihnen erstellte Verkaufspartner-App.
• AWSAccessKey: Dies ist der Zugriffsschlüssel, der an den AWS-Benutzer gebunden ist, der mit dem verknüpft ist OAuthClientId.
• AWSSecretKey: Dies ist der geheime Schlüssel, der an den AWS-Benutzer gebunden ist, der mit dem verknüpft ist OAuthClientId.

OAuth-Einstellungen übertragen

Befolgen Sie die nachstehenden Schritte, um den Connector auf einem anderen Computer zu installieren, zu authentifizieren und dann die resultierenden OAuth-Werte zu übertragen.

Installieren Sie den Connector auf einem zweiten Computer und stellen Sie eine Verbindung mit den folgenden festgelegten Eigenschaften her:

• OAuthSettingsLocation: Legen Sie dies auf eine beschreibbare Textdatei fest.
• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH.
• OAuthClientId: Legen Sie hier die Client-ID fest, die Ihnen bei der Registrierung Ihrer App zugewiesen wurde.
• OAuthClientSecret: Setzen Sie dies auf das Client-Geheimnis, das Ihnen bei der Registrierung Ihrer App zugewiesen wurde.

Testen Sie die Verbindung zur Authentifizierung. Die resultierenden Authentifizierungswerte werden verschlüsselt in den durch angegebenen Pfad geschrieben OAuthSettingsLocation. Nachdem Sie die Verbindung erfolgreich getestet haben, kopieren Sie die OAuth-Einstellungsdatei auf Ihren Headless-Rechner. Legen Sie auf dem Headless-Rechner die folgenden Verbindungseigenschaften fest, um eine Verbindung zu Daten herzustellen:

• InitiateOAuth: Stellen Sie dies auf REFRESH ein.
• OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf den Consumer-Schlüssel fest.
• OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das Verbrauchergeheimnis fest.
• OAuthSettingsLocation: Legen Sie hier den Pfad zu Ihrer OAuth-Einstellungsdatei fest. Stellen Sie sicher, dass diese Datei dem Connector Lese- und Schreibberechtigungen erteilt, um die automatische Aktualisierung des Zugriffstokens zu ermöglichen.
• Marketplace: Legen Sie dies auf die Marketplace-Region fest, in der Sie für den Verkauf registriert sind.
• Schema: Setzen Sie dies auf „SellingPartner“, um eine Verbindung zur SP- API herzustellen.
• AppId: Anwendungs-ID für die von Ihnen erstellte Verkaufspartner-App.
• AWSAccessKey: Dies ist der Zugriffsschlüssel, der an den AWS-Benutzer gebunden ist, der mit dem verknüpft ist OAuthClientId.
• AWSSecretKey: Dies ist der geheime Schlüssel, der an den AWS-Benutzer gebunden ist, der mit dem verknüpft ist OAuthClientId.

Erstellen einer benutzerdefinierten OAuth-App

Sie können eine benutzerdefinierte OAuth-App verwenden, um ein Dienstkonto oder ein Benutzerkonto zu authentifizieren. Siehe OAuth-Authentifizierung verwenden für weitere Informationen.

Erstellen einer OAuth-App zur Benutzerkonto-Authentifizierung

Befolgen Sie die nachstehenden Schritte, um eine App zu registrieren und die OAuthClientId Und OAuthClientSecret.

Erstellen einer benutzerdefinierten OAuth-App

1. Melden Sie sich bei der Selling Partner Console an und öffnen Sie Develop Apps from Apps & Services.

2. Klicken Sie auf Add new app client.

3. Geben Sie einen Namen für die App ein und wählen Sie SP-API als API Typ.

4. Geben Sie die IAM ARN für das AWS-Konto und ausgewählte Verkäufer an.

5. Geben Sie die Werte für OAuth-Anmelde-URI und OAuth-Umleitungs-URI an. Nach dem Erstellen der App wird der OAuthClientId Und OAuthClientSecret werden unter angezeigt LWA credentials.

Ausführlichere Informationen zum Erstellen einer benutzerdefinierten OAuth-App und zum Konfigurieren der IAM- Rolle finden Sie im Amazon Selling Partner Guide.

Wichtige Hinweise

Konfigurationsdateien und ihre Pfade

• Alle Verweise auf das Hinzufügen von Konfigurationsdateien und deren Pfaden beziehen sich auf Dateien und Speicherorte auf dem Jitterbit-Agenten, auf dem der Connector installiert ist. Diese Pfade sind je nach Agent und Operationssystem entsprechend anzupassen. Wenn mehrere Agenten in einer Agentengruppe verwendet werden, werden auf jedem Agenten identische Dateien benötigt.

Erweiterte Funktionen

In diesem Abschnitt wird eine Auswahl erweiterter Funktionen des Amazon Marketplace Connectors beschrieben.

Benutzerdefinierte Ansichten

Der Connector ermöglicht Ihnen die Definition virtueller Tabellen, sogenannter benutzerdefinierter Ansichten, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese Ansichten sind nützlich, wenn Sie die an die Treiber gesendeten Abfragen nicht direkt steuern können. Siehe Benutzerdefinierte Ansichten für einen Überblick über das Erstellen und Konfigurieren benutzerdefinierter Ansichten.

SSL-Konfiguration

Verwenden Sie SSL-Konfiguration, um anzupassen, wie der Connector TLS/SSL-Zertifikatsverhandlungen handhabt. Sie können aus verschiedenen Zertifikatsformaten wählen; siehe SSLServerCert-Eigenschaft unter „Verbindungszeichenfolgenoptionen“ für weitere Informationen.

Proxy

So konfigurieren Sie den Connector mit privaten Agent-Proxy-Einstellungen, wählen Sie die Use Proxy Settings Kontrollkästchen auf dem Verbindungskonfigurationsbildschirm.

Benutzerdefinierte Ansichten

Mit dem Amazon Marketplace Connector können Sie eine virtuelle Tabelle definieren, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese werden als benutzerdefinierte Ansichten bezeichnet und sind in Situationen nützlich, in denen Sie die an den Treiber gesendete Abfrage nicht direkt steuern können, z. B. wenn Sie den Treiber von Jitterbit verwenden. Die benutzerdefinierten Ansichten können verwendet werden, um Prädikate zu definieren, die immer angewendet werden. Wenn Sie in der Abfrage an die Ansicht zusätzliche Prädikate angeben, werden diese mit der bereits als Teil der Ansicht definierten Abfrage kombiniert.

Es gibt zwei Möglichkeiten, benutzerdefinierte Ansichten zu erstellen:

• Erstellen Sie eine Konfigurationsdatei im JSON-Format, die die gewünschten Ansichten definiert.
• DDL-Anweisungen.

Definieren von Ansichten mithilfe einer Konfigurationsdatei

Benutzerdefinierte Ansichten werden in einer JSON-formatierten Konfigurationsdatei namens UserDefinedViews.json. Der Connector erkennt die in dieser Datei angegebenen Ansichten automatisch.

Sie können auch mehrere Ansichtsdefinitionen haben und diese mit steuern UserDefinedViews Verbindungseigenschaft. Wenn Sie diese Eigenschaft verwenden, werden vom Connector nur die angegebenen Ansichten angezeigt.

Diese Konfigurationsdatei für benutzerdefinierte Ansichten ist wie folgt formatiert:

• Jedes Stammelement definiert den Namen einer Ansicht.
• Jedes Stammelement enthält ein untergeordnetes Element namens query, das die benutzerdefinierte SQL- Abfrage für die Ansicht enthält.

Zum Beispiel:

{
    "MyView": {
        "query": "SELECT * FROM Orders WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Verwenden Sie UserDefinedViews Verbindungseigenschaft, um den Speicherort Ihrer JSON-Konfigurationsdatei anzugeben. Beispiel:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Schema für benutzerdefinierte Ansichten

Benutzerdefinierte Ansichten werden im angezeigt UserViews Schema standardmäßig. Dies geschieht, um zu vermeiden, dass der Name der Ansicht mit einer tatsächlichen Entität im Datenmodell kollidiert. Sie können den Namen des für UserViews verwendeten Schema ändern, indem Sie festlegen UserViewsSchemaName Eigentum.

Arbeiten mit benutzerdefinierten Ansichten

Beispielsweise eine SQL-Anweisung mit einer benutzerdefinierten Ansicht namens UserViews.RCustomers listet nur Kunden in Raleigh auf:

SELECT * FROM Customers WHERE City = 'Raleigh';

Ein Beispiel für eine Abfrage an den Treiber:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Daraus ergibt sich die effektive Abfrage an die Quelle:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Dies ist ein sehr einfaches Beispiel für eine Abfrage an eine benutzerdefinierte Ansicht, die tatsächlich eine Kombination aus der Abfrage und der Ansichtsdefinition ist. Es ist möglich, diese Abfragen in viel komplexeren Mustern zusammenzustellen. Alle SQL-Operationen sind in beiden Abfragen zulässig und werden bei Bedarf kombiniert.

SSL-Konfiguration

Anpassen der SSL-Konfiguration

Standardmäßig versucht der Connector, SSL/TLS auszuhandeln, indem er das Zertifikat des Servers mit dem vertrauenswürdigen Zertifikatspeicher des Systems vergleicht.

Um ein anderes Zertifikat anzugeben, siehe SSLServerCert Eigenschaft für die verfügbaren Formate, um dies zu tun.

Datenmodell

Der Amazon Marketplace Connector modelliert Amazon Marketplace Objekte als relationale Tabellen und Ansichten. Ein Amazon Marketplace Objekt hat Beziehungen zu anderen Objekten; in den Tabellen werden diese Beziehungen durch Fremdschlüssel ausgedrückt. Die folgenden Abschnitte zeigen die verfügbaren API Objekte und bieten weitere Informationen zum Ausführen von SQL für Amazon Marketplace APIs.

Schemas für die meisten Datenbankobjekte werden in einfachen, textbasierten Konfigurationsdateien definiert.

Der Connector verlagert so viel wie möglich von der Verarbeitung der SELECT-Anweisung auf die Amazon Marketplace APIs und verarbeitet dann den Rest der Abfrage im Speicher. Siehe SupportEnhancedSQL für weitere Informationen dazu, wie der Connector API Einschränkungen durch die clientseitige In-Memory-Verarbeitung umgeht.

Verwenden der Marketplace API

Siehe Marketplace Datenmodell für die verfügbaren Entitäten in der Marketplace API.

Verwendung der SellingPartner API

Siehe Verkaufspartner-Datenmodell für die verfügbaren Entitäten in der Selling Partner API.

Marketplace Datenmodell

Der Amazon Marketplace Connector modelliert die Amazon Marketplace API als relationale Ansichten und gespeicherte Prozeduren.

Um das Marketplace Datenmodell zu verwenden, setzen Sie einfach Schema zum Marketplace.

Ansichten

Ansichten sind Tabellen, die nicht geändert werden können, wie z. B. Bestellungen, Produkte. Normalerweise werden Modelldaten, die schreibgeschützt sind und nicht aktualisiert werden können, als Ansichten angezeigt.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen zur Datenquelle. Sie können zum Suchen, Aktualisieren und Ändern von Informationen

in der Datenquelle verwendet werden.

Verwenden von Berichten

Erstellte Berichte können als Ansichten angezeigt werden, indem gesetzt wird IncludeReports Verbindungseigenschaft auf true. Berichte können mit der gespeicherten Prozedur RequestReport erstellt werden.

Nachdem ein Bericht erstellt und die Verarbeitung mit dem Status _DONE_ abgeschlossen wurde, wird er als Ansicht mit dem Namen „Report{ReportType}{ReportID}“ angezeigt.

Nur tabulatorgetrennte Berichte können als Ansichten verwendet werden. Eine vollständige Liste der Berichte finden Sie hier: Berichtstypen.

Um eine API drosselung zu vermeiden, wird empfohlen, zum Erstellen von Berichtstabellenschemata die gespeicherte Prozedur CreateSchema zu verwenden.

Ansichten

Ansichten bestehen aus Spalten und Pseudospalten. Ansichten ähneln Tabellen in der Art und Weise, wie Daten dargestellt werden; Ansichten unterstützen jedoch keine Aktualisierungen. Entitäten, die als Ansichten dargestellt werden, sind normalerweise schreibgeschützte Entitäten. Oft ist eine gespeicherte Prozedur verfügbar, um die Daten zu aktualisieren, wenn eine solche Funktionalität auf die Datenquelle anwendbar ist.

Abfragen können für eine Ansicht ausgeführt werden, als wäre sie eine normale Tabelle, und die zurückgegebenen Daten sind in dieser Hinsicht ähnlich. Um mehr über Tabellen und gespeicherte Prozeduren zu erfahren, navigieren Sie bitte zu den entsprechenden Einträgen in diesem Hilfedokument.

Amazon Marketplace Connector-Ansichten

FeedSubmissionList

Der Operation „GetFeedSubmissionList“ gibt eine Liste mit Feed-Einreichungen zurück.

Wählen

Der Connector verwendet die Amazon Marketplace API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM FeedSubmissionList WHERE FeedSubmissionId = '50377017868'

SELECT * FROM FeedSubmissionList WHERE FeedType = '_POST_PRODUCT_DATA_

SELECT * FROM FeedSubmissionList WHERE SubmittedDate = '2018-12-03T09:42:06'

SELECT * FROM FeedSubmissionList WHERE FeedProcessingStatus = '_DONE_'

Spalten

FeedSubmissionResult

Der Operation „GetFeedSubmissionResult“ gibt den Feed-Verarbeitungsbericht für einen bestimmten Feed zurück.

Wählen

Der Connector verwendet die Amazon Marketplace API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM FeedSubmissionResult WHERE FeedSubmissionId = '50377017868'

Spalten

Eingehende Sendungen

Gibt eine Liste der Artikel in einer angegebenen eingehenden Lieferung zurück.

Wählen

Der Connector verwendet die Amazon Marketplace API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM InboundShipments WHERE ShipmentId = '503-9993250-1405404'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Eingehende Sendungen

Gibt eine Liste eingehender Sendungen basierend auf den von Ihnen angegebenen Kriterien zurück.

Wählen

Der Connector verwendet die Amazon Marketplace API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM InboundShipments WHERE ShipmentStatus = 'Working'

SELECT * FROM InboundShipments WHERE ShipmentStatus IN ('Working','SHIPPED','IN_TRANSIT')

SELECT * FROM InboundShipments WHERE ShipmentId = '503-9993250-1405404'

SELECT * FROM InboundShipments WHERE LastUpdatedDate >= '2016-12-12'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Inventarversorgung

Gibt Informationen zur Verfügbarkeit des Lagerbestands zurück, den ein Verkäufer im Fulfillment-Netzwerk von Amazon und in aktuellen eingehenden Lieferungen hat. Sie können den aktuellen Verfügbarkeitsstatus für Ihren Fulfillment by Amazon-Lagerbestand überprüfen und feststellen, wann sich der Verfügbarkeitsstatus ändert.

Wählen

Der Connector verwendet die Amazon Marketplace API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM InventorySupply WHERE SellerSKU = 'Stest'

SELECT * FROM InventorySupply WHERE  QueryStartDateTime = '2016-03-16'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Bestellartikel

Gibt Bestellartikel basierend auf der von Ihnen angegebenen Amazon-Bestellnummer zurück.

Wählen

Der Connector verwendet die Amazon Marketplace API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Die Tabelle OrderItems unterstützt serverseitiges Filtern mit =- und IN-Operatoren für das Feld AmazonOrderId. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM OrderItems WHERE AmazonOrderId = '503-9993250-1405404'

SELECT * FROM OrderItems WHERE AmazonOrderId IN ('503-9993250-1405404', '503-9993250-1405404')

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Bestellungen

Gibt Bestellungen zurück, die innerhalb eines von Ihnen angegebenen Zeitraums erstellt oder aktualisiert wurden.

Wählen

Der Connector verwendet die Amazon Marketplace API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM Orders WHERE AmazonOrderId = '249-7638334-8161403'

SELECT * FROM Orders WHERE LastUpdateDate >= '2016-12-12'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND OrderStatus = 'Canceled'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND FulfillmentChannel = 'MFN'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND BuyerEmail = 'example@example.com'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND PaymentMethod = 'Other'

Spalten

Produkte

Mithilfe der Produkttabelle erhalten Sie Informationen zum Abgleichen Ihrer Produkte mit vorhandenen Produktlisten auf den Amazon Marketplace-Websites.

Wählen

Der Connector verwendet die Amazon Marketplace API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM Products WHERE SearchTerms = '249-7638334-8161403'

SELECT * FROM Products WHERE idType = 'SellerSKU' AND idlist = '{SellerSku code}'

SELECT * FROM Products WHERE idType = 'ASIN' AND idlist = '{ASIN code}'

SELECT * FROM Products WHERE idType = 'GCID' AND idlist = '{GCID code}'

SELECT * FROM Products WHERE idType = 'UPC' AND idlist = '{UPC code}'

SELECT * FROM Products WHERE idType = 'EAN' AND idlist = '{EAN code}'

SELECT * FROM Products WHERE idType = 'ISBN' AND idlist = '{ISBN code}'

SELECT * FROM Products WHERE idType = 'JAN' AND idlist = '{JAN code}'

SELECT * FROM Products WHERE idType = 'JAN' AND idlist IN ('{JAN code}', '{ISBN code}', '{GCID code}')

Spalten

Berichtsliste

Nutzungsinformationen für die Operation ReportList.rsd.

Wählen

Der Connector verwendet die Amazon Marketplace API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM ReportList WHERE ReportType IN '_GET_MERCHANT_LISTINGS_INACTIVE_DATA_'

SELECT * FROM ReportList WHERE ReportRequestId = '50566018029'

SELECT * FROM ReportList WHERE ReportRequestId IN ('50566018029', '50564018026')

SELECT * FROM ReportList WHERE AvailableDate > '2016-12-12' AND AvailableDate< '2018-11-12 12:00:00'

SELECT * FROM ReportList WHERE AvailableDate >= '2016-12-12' AND Acknowledged = 'true'

Spalten

BerichtAnfrageListe

Nutzungsinformationen für die Operation ReportRequestList.rsd.

Wählen

Der Connector verwendet die Amazon Marketplace API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM ReportRequestList WHERE ReportType = '_GET_MERCHANT_LISTINGS_INACTIVE_DATA_'

SELECT * FROM ReportRequestList WHERE ReportType IN ('_GET_MERCHANT_LISTINGS_INACTIVE_DATA_', '_GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE_')

SELECT * FROM ReportRequestList WHERE ReportRequestId = '50566018029'

SELECT * FROM ReportRequestList WHERE ReportRequestId IN ('50566018029', '50564018026')

SELECT * FROM ReportRequestList WHERE RequestedDate > '2016-12-12'

SELECT * FROM ReportRequestList WHERE RequestedDate > '2016-12-12' and RequestedDate > '2018-12-12 13:00'

SELECT * FROM ReportRequestList WHERE RequestedDate <= '2016-12-12' AND ReportProcessingStatus = '_DONE_'

SELECT * FROM ReportRequestList WHERE ReportProcessingStatus IN ('_DONE_', '_SUBMITTED_', '_CANCELLED_')

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Gespeicherte Prozeduren

Gespeicherte Prozeduren stehen zur Ergänzung der im Datenmodell verfügbaren Daten zur Verfügung. Es kann erforderlich sein, die in einer Ansicht verfügbaren Daten mithilfe einer gespeicherten Prozedur zu aktualisieren, da die Daten keine direkten, tabellenartigen, bidirektionalen Aktualisierungen ermöglichen. In diesen Situationen erfolgt der Abruf der Daten mithilfe der entsprechenden Ansicht oder Tabelle, während die Aktualisierung durch Aufruf einer gespeicherten Prozedur erfolgt. Gespeicherte Prozeduren verwenden eine Liste von Parametern und geben einen Datensatz zurück, der die Sammlung von Tupeln enthält, die die Antwort bilden.

Gespeicherte Prozeduren für den Amazon Marketplace Connector

AbbrechenFeed

CancelFeed bricht eine oder mehrere Feedeinreichungen ab und gibt die Anzahl der abgebrochenen Feedeinreichungen und die Feedeinreichungsinformationen zurück. Beachten Sie, dass alle Feedeinreichungen abgebrochen werden, wenn Sie keine FeedSubmmissionId angeben.

Eingang

Ergebnissatzspalten

AbbrechenBerichtAnfragen

Der Operation „CancelReportRequests“ bricht eine oder mehrere Berichtsanforderungen ab und gibt die Anzahl der stornierten Berichtsanforderungen sowie Informationen zur Berichtsanforderung zurück.

Eingang

Ergebnissatzspalten

Schema erstellen

Erstellt eine Schema für die angegebene Tabelle oder Ansicht.

Eingang

Ergebnissatzspalten

Bericht abrufen

Erstellt und/oder gibt Daten für einen bestimmten Bericht zurück.

Ausführen

Wir können die gespeicherte Prozedur GetReport auf zwei Arten verwenden:
Um einen Bericht zu erstellen und herunterzuladen. In diesem Fall müssen Sie mindestens die Attribute ReportType, StartDate und DownloadPath festlegen. Die gespeicherte Prozedur wartet, bis der Bericht serverseitig verarbeitet wird.

EXEC GetReport
@ReportType = '_GET_FLAT_FILE_ORDERS_DATA_',
@StartDate = '08-27-2020',
@DownloadPath = 'C:\Tests\AmazonMarketplaceTest'

Um einen vorhandenen Bericht herunterzuladen, müssen Sie in diesem Fall mindestens die Attribute ReportID und DownloadPath festlegen, z. B.:

EXEC GetReport
@ReportID = '50815018501',
@DownloadPath = 'C:\Tests\AmazonMarketplaceTest'

Indizierte Parameter erleichtern die Bereitstellung mehrerer Instanzen eines einzelnen Parameters als Eingaben für die Prozedur.

Angenommen, es gibt einen Eingabeparameter mit dem Namen Param#. Geben Sie mehrere Instanzen eines indizierten Parameters wie folgt ein:

EXEC ProcedureName Param#1 = "value1", Param#2 = "value2", Param#3 = "value3"

Eingabe

Ergebnissatzspalten

AnfrageBericht

Der Operation „RequestReport“ erstellt eine Berichtsanforderung.

Indizierte Parameter erleichtern die Bereitstellung mehrerer Instanzen eines einzelnen Parameters als Eingaben für die Prozedur.

Angenommen, es gibt einen Eingabeparameter mit dem Namen Param#. Geben Sie mehrere Instanzen eines indizierten Parameters wie folgt ein:

EXEC ProcedureName Param#1 = "value1", Param#2 = "value2", Param#3 = "value3"

Eingang

Ergebnissatzspalten

Bildfeed senden

Der Bild-Feed ermöglicht es Ihnen, verschiedene Bilder für ein Produkt hochzuladen. Amazon kann für jedes Produkt mehrere Bilder anzeigen.

Ausführen

Der Treiber verwendet #TEMP-Tabellen als Felder für die eingegebenen aggregierten Informationen

Ihre Abfrage muss Folgendes enthalten:

INSERT INTO ImageFeedAggregate#TEMP (SKU,ImageType,ImageLocation,OperationType) VALUES ('15700','Main','https://www.cdata.com/ui/img/home/adapters.png','Update')

Anschließend führen Sie die Prozedur aus, indem Sie den Wert von ImageFeedAggregate mit dem Namen der verwendeten #TEMP-Tabelle ImageFeedAggregate#TEMP angeben.

EXEC SubmitImageFeed ProductImageFeedAggregate = 'ImageFeedAggregate#TEMP'

Eingabe

Spalten des Ergebnissatzes

Inventar-Feed übermitteln

Mit dem Inventar-Feed können Sie die Inventarmengen (Lagerbestände) Ihrer Artikel aktualisieren.

Ausführen

Der Treiber verwendet #TEMP-Tabellen als Felder für eingegebene aggregierte Informationen.

Ihre Abfrage muss Folgendes enthalten:

INSERT INTO InventoryFeed#TEMP (SKU,Quantity,FulfillmentLatency) VALUES ('15700',11 ,'2')

INSERT INTO InventoryFeed#TEMP (SKU,Quantity,FulfillmentLatency) VALUES ('99987867',10 ,'2')

Anschließend führen Sie das Verfahren aus, indem Sie den Wert von InventoryFeedAggregate mit dem Namen der verwendeten #TEMP-Tabelle InventoryFeed#TEMP angeben.

EXEC SubmitInventoryFeed InventoryFeedAggregate='InventoryFeed#TEMP'

Eingabe

Spalten des Ergebnissatzes

Bestellbestätigungs-Feed senden

Mit dem Feed zur Auftragsbestätigung können Sie bestätigen, ob eine Bestellung erfolgreich heruntergeladen wurde oder nicht.

Ausführen

Der Treiber verwendet #TEMP-Tabellen als Felder für eingegebene aggregierte Informationen.

Ihre Abfrage muss Folgendes enthalten:

INSERT INTO OrderAcknowledgementFeedAggregate#TEMP (AmazonOrderId,StatusCode,AmazonOrderItemCode,CancelReason) VALUES ('249-6070298-2783041','Failure','25959136016214','NoInventory')

Anschließend führen Sie die Prozedur aus, indem Sie den Wert von OrderAcknowledgementFeedAggregate mit dem Namen der verwendeten #TEMP-Tabelle OrderAcknowledgementFeedAggregate#TEMP angeben.

EXEC SubmitOrderAcknowledgementFeed OrderAcknowledgementFeedAggregate = 'OrderAcknowledgementFeedAggregate#TEMP'

Die aggregierten Informationen können eingegeben werden, indem sie in diesem XML-Format angegeben werden

<Row>
    <AmazonOrderId>249-6070298-2783041</AmazonOrderId>
    <StatusCode>Failure</StatusCode>
    <AmazonOrderItemCode>25959136016214</AmazonOrderItemCode>
    <CancelReason>NoInventory</CancelReason>
</Row>

EXEC SubmitOrderAcknowledgementFeed OrderAcknowledgementFeedAggregate='<Row>
    <AmazonOrderId>249-6070298-2783041</AmazonOrderId>
    <StatusCode>Failure</StatusCode>
    <AmazonOrderItemCode>25959136016214</AmazonOrderItemCode>
    <CancelReason>NoInventory</CancelReason>
</Row>'

Eingabe

Spalten des Ergebnissatzes

BestellanpassenFeed absenden

Mit dem Feed „Bestellanpassung“ können Sie eine Rückerstattung (Anpassung) für eine Bestellung vornehmen. Sie müssen einen Grund für die Anpassung angeben, z. B. Kundenrückgabe, und den Anpassungsbetrag, aufgeschlüsselt nach Preiskomponenten (Hauptbetrag, Versand, Steuern usw.).

Ausführen

Der Treiber verwendet #TEMP-Tabellen als Felder für die eingegebenen aggregierten Informationen

Ihre Abfrage muss Folgendes enthalten:

INSERT INTO ItemPriceAdjustmentsAggregate#TEMP (ItemPriceAdjustmentsComponentType,ItemPriceAdjustmentsComponentAmount,ItemPriceAdjustmentsComponentAmountCurrency) VALUES ('Shipping','150','JPY')

INSERT INTO AdjustedItemAggregate#TEMP (AdjustedItemAmazonOrderItemCode,AdjustedItemAdjustmentReason,ItemPriceAdjustmentsAggregate) VALUES ('25959136016214','CustomerReturn','ItemPriceAdjustmentsAggregate#TEMP')

INSERT INTO OrderAdjustmentFeedAggregate#TEMP (AmazonOrderID,OperationType,AdjustedItemAggregate) VALUES ('249-6070298-2783041','Update','AdjustedItemAggregate#TEMP')

Anschließend führen Sie das Verfahren aus, indem Sie den Wert von OrderAdjustmentFeedAggregate mit dem Namen der verwendeten Tabelle #TEMP OrderAdjustmentFeedAggregate#TEMP angeben.

EXEC SubmitOrderAdjustmentFeed OrderAdjustmentFeedAggregate = 'OrderAdjustmentFeedAggregate#TEMP'

Eingabe

Ergebnissatzspalten

Bestellerfüllungsfeed übermitteln

Mit dem Auftragserfüllungs-Feed kann Ihr System das System von Amazon mit Auftragserfüllungsinformationen aktualisieren.

Ausführen

Der Treiber verwendet #TEMP-Tabellen als Felder für die eingegebenen aggregierten Informationen

Ihre Abfrage muss Folgendes enthalten:

INSERT INTO ItemAggregate#TEMP (ItemAmazonOrderItemCode,ItemQuantity) VALUES ('25959136016214','1');

INSERT INTO OrderFulfillmentFeedAggregate#TEMP (AmazonOrderID,FulfillmentDate,FulfillmentDataCarrierName,FulfillmentDataShippingMethod,FulfillmentDataShipperTrackingNumber,ItemAggregate) VALUES ('249-6070298-2783041','2017-02-01T00:00:00Z',' Delivery Company','Normal Delivery','1223525345234','ItemAggregate#TEMP')

Anschließend führen Sie das Verfahren aus, indem Sie den Wert von OrderFulfillmentFeedAggregate mit dem Namen der verwendeten Tabelle #TEMP OrderFulfillmentFeedAggregate#TEMP angeben.

EXEC SubmitOrderFulfillmentFeed OrderFulfillmentFeedAggregate = 'OrderFulfillmentFeedAggregate#TEMP'

Eingabe

Spalten des Ergebnissatzes

SendenOverrideFeed

Mit dem Override-Feed können Sie für ein einzelnes Produkt (SKU) eine Ausnahme von Ihren Versandeinstellungen auf Kontoebene festlegen.

Ausführen

Der Treiber verwendet #TEMP-Tabellen als Felder für die eingegebenen aggregierten Informationen

Ihre Abfrage muss Folgendes enthalten:

INSERT INTO ShippingOverrideAggregate#TEMP (ShipOption,IsShippingRestricted) VALUES ('Std JP Kanto8','true')

INSERT INTO ShippingOverrideAggregate#TEMP (ShipOption,Type,ShipAmount,ShipAmountCurrency) VALUES ('Std JP Kantoa8','Exclusive','400.0','JPY')

INSERT INTO OverrideFeedAggregate#TEMP (SKU,OperationType,ShippingOverrideAggregate) VALUES ('15700','Update','ShippingOverrideAggregate#TEMP')

Anschließend führen Sie die Prozedur aus, indem Sie den Wert von OverrideFeedAggregate mit dem Namen der verwendeten #TEMP-Tabelle OverrideFeedAggregate#TEMP angeben.

EXEC SubmitOverrideFeed OverrideFeedAggregate = 'OverrideFeedAggregate#TEMP'

Eingabe

Spalten des Ergebnissatzes

PreisFeed einreichen

Über den Preis-Feed können Sie den aktuellen Preis und den Verkaufspreis (sofern zutreffend) für einen Artikel festlegen.

Ausführen

Der Treiber verwendet #TEMP-Tabellen als Felder für die eingegebenen aggregierten Informationen

Ihre Abfrage muss Folgendes enthalten:

INSERT INTO PriceFeedAggregate#TEMP (SKU,StandardPrice,StandardPriceCurrency,MAP,MAPCurrency,SalePrice,SalePriceCurrency,SaleStartDate,SaleEndDate) VALUES ('15700','134','JPY','100','JPY','150','JPY','2017-02-01T00:00:00Z','2020-02-01T00:00:00Z')

INSERT INTO PriceFeedAggregate#TEMP (SKU,StandardPrice,StandardPriceCurrency,MAP,MAPCurrency,SalePrice,SalePriceCurrency,SaleStartDate,SaleEndDate) VALUES ('99987867','134','JPY','100','JPY','150','JPY','2017-02-01T00:00:00Z','2020-02-01T00:00:00Z')

Anschließend führen Sie die Prozedur aus, indem Sie den Wert von PriceFeedAggregate mit dem Namen der verwendeten #TEMP-Tabelle PriceFeedAggregate#TEMP angeben.

EXEC SubmitPriceFeed PriceFeedAggregate = 'PriceFeedAggregate#TEMP'

Eingabe

Ergebnissatzspalten

Produktfeed übermitteln

Der Produkt-Feed enthält beschreibende Informationen zu den Produkten in Ihrem Katalog. Diese Informationen ermöglichen es Amazon, einen Datensatz zu erstellen und jedem Produkt eine eindeutige Kennung, eine sogenannte ASIN (Amazon Standard Item Number), zuzuweisen.

Ausführen

Der Treiber verwendet #TEMP-Tabellen als Felder für eingegebene aggregierte Informationen.

SubmitProductFeed hat zwei Hauptaggregate, die eingegeben werden müssen.

• ProduktbeschreibungDatenaggregat
• ProduktDatenAggregat

Ihre Abfrage muss Folgendes enthalten:

ProductDescriptionDataAggregate-Informationen müssen mithilfe der temporären Tabelle ProductDescriptionDataAggregate#TEMP eingegeben werden.

INSERT INTO ProductDescriptionDataAggregate#TEMP (Title,Brand,Description,BulletPoint,Manufacturer) VALUES ('test Title','test Brand','test Description','test BulletPoint','test Manufacturer')

ProductDataAggregate-Informationen variieren je nach verwendeter Kategorie. Die Liste aller von Amazon bereitgestellten XSDs finden Sie hier https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/Product.xsd

In diesem Beispiel wird die Kategorie „Sport“ verwendet https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/Sports.xsd

Um gültige Produktdaten hinzuzufügen, muss Sports.xsd genau befolgt und das XML-Aggregat korrekt erstellt werden. Dieses Beispiel hat die folgenden Produktdaten:

• Produkttyp = Sportartikel
• Herkunft = Übergeordnet
• Variationsthema = Größe (Basierend auf dem ausgewählten Produkttyp sind einige der Variationsthemen ungültig. In diesem Beispiel ist die Designvariante ungültig.)
• Größe = S
• Materialzusammensetzung = Metall

Wenn Sie der Reihenfolge der Sports.xsd-XSD-Datei folgen, lautet das Aggregat:

<Sports>
    <ProductType>SportingGoods</ProductType>
    <VariationData>
        <Parentage>parent</Parentage>
        <VariationTheme>Size</VariationTheme>
        <Size>S</Size>
    </VariationData>
    <MaterialComposition>Metal</MaterialComposition>
</Sports>

Dieses Aggregat ist der Wert von ProductDataAggregate.

INSERT INTO ProductFeedAggregate#TEMP(SKU,ProductDescriptionDataAggregate,ProductDataAggregate) VALUES ('test SKU','ProductDescriptionDataAggregate#TEMP','<Sports>
    <ProductType>SportingGoods</ProductType>
    <VariationData>
        <Parentage>parent</Parentage>
        <VariationTheme>Size</VariationTheme>
        <Size>S</Size>
    </VariationData>
    <MaterialComposition>Metal</MaterialComposition>
</Sports>')

Anschließend führen Sie das Verfahren aus, indem Sie den Wert von ProductFeedAggregate mit dem Namen der verwendeten #TEMP-Tabelle ProductFeedAggregate#TEMP angeben.

EXEC SubmitProductFeed ProductFeedAggregate = 'ProductFeedAggregate#TEMP'

Eingabe

Spalten des Ergebnissatzes

SendenBeziehungsFeed

Mit dem Beziehungs-Feed können Sie optionale Beziehungen zwischen Artikeln in Ihrem Katalog einrichten.

Ausführen

Der Treiber verwendet #TEMP-Tabellen als Felder für die eingegebenen aggregierten Informationen

Ihre Abfrage muss Folgendes enthalten:

INSERT INTO RelationAggregate#TEMP (Type,SKU) VALUES ('Variation','99987867')

INSERT INTO RelationAggregate#TEMP (Type,SKU) VALUES ('Variation','99987867')

INSERT INTO RelationshipFeedAggregate#TEMP(ParentSKU,RelationAggregate) VALUES ('15700','RelationAggregate#TEMP')

Anschließend führen Sie die Prozedur aus, indem Sie den Wert von RelationshipFeedAggregate mit dem Namen der verwendeten #TEMP-Tabelle RelationshipFeedAggregate#TEMP angeben.

EXEC SubmitRelationshipFeed RelationshipFeedAggregate = 'RelationshipFeedAggregate#TEMP'

Eingabe

Ergebnissatzspalten

SendenSourcingOnDemandFeed

Nutzungsinformationen für die Operation SubmitSourcingOnDemandFeed.rsb.

Ausführen

Der Treiber verwendet #TEMP-Tabellen als Felder für die eingegebenen aggregierten Informationen

Ihre Abfrage muss Folgendes enthalten:

INSERT INTO OrderSourcingOnDemandFeedAggregate#TEMP (AmazonOrderID,SKU,EstimatedShipDate) VALUES ('250-4747727-9303810','15700','2018-12-08T00:00:00Z');

Anschließend führen Sie das Verfahren aus, indem Sie den Wert von OrderSourcingOnDemandFeedAggregate mit dem Namen der verwendeten #TEMP-Tabelle OrderSourcingOnDemandFeedAggregate#TEMP angeben.

EXEC SubmitSourcingOnDemandFeed OrderSourcingOnDemandFeedAggregate = 'OrderSourcingOnDemandFeedAggregate#TEMP'

Eingabe

Spalten des Ergebnissatzes

Datenmodell für Verkaufspartner

Der Amazon Marketplace Connector modelliert die Selling Partner-API als relationale Ansichten und gespeicherte Prozeduren.

Um das Amazon Selling Partner Data Model zu verwenden, setzen Sie einfach Schema an Verkaufspartner.

Ansichten

Ansichten sind Tabellen, die nicht geändert werden können, wie z. B. Bestellungen, Produkte. Normalerweise werden Daten, die schreibgeschützt sind und nicht aktualisiert werden können, als Ansichten angezeigt.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen zur Datenquelle. Sie können zum Suchen, Aktualisieren und Ändern von Informationen

in der Datenquelle verwendet werden.

Verwenden von Berichten

Berichte können als Ansichten angezeigt werden, indem gesetzt wird IncludeReports Verbindungseigenschaft auf true. Für jeden in angegebenen Berichtstyp wird eine Ansicht angezeigt ReportTypes Verbindungseigenschaft. Um mehrere Berichte einzuschließen, können Sie auch eine Berichtstypkategorie angeben, die aus der Ansicht „ReportTypes“ abgerufen werden kann.

Diese Ansichten können dann mithilfe der optionalen Datums-/Uhrzeitparameter „DataStartTime“ und „DataEndTime“ abgefragt werden. Wenn beide Datums-/Uhrzeitparameter angegeben sind, sucht der Treiber automatisch nach einem vorhandenen Bericht, der dem angegebenen Intervall entspricht. Wenn dieser nicht gefunden wird, wird ein neuer Bericht erstellt. Berichte können manuell mit der gespeicherten Prozedur „RequestReport“ erstellt werden. Sie können auch die JSON-Aggregat-Pseudospalte „ReportOptions“ verwenden, um zusätzliche Felder anzugeben, die je nach Berichtstyp erforderlich sein können. Weitere Einzelheiten zu Berichtsoptionen finden Sie in der Amazon Selling-Partner API Dokumentation

Nachdem ein Bericht erstellt und in den Ergebnissatz übertragen wurde, wird bei der nächsten Abfrage dieses Berichtstyps mit den gleichen Filtern „DataStartTime“ und „DataEndTime“ der zuvor erstellte Bericht heruntergeladen, anstatt einen neuen Bericht zu erstellen.

Tabellen

Der Connector modelliert die Daten im Amazon Marketplace in einer Liste von Tabellen, die mit Standard-SQL-Anweisungen abgefragt werden können.

Im Allgemeinen ist das Abfragen von Amazon Marketplace Tabellen dasselbe wie das Abfragen einer Tabelle in einer relationalen Datenbank. Manchmal gibt es Sonderfälle, beispielsweise kann das Einfügen einer bestimmten Spalte in die WHERE-Klausel erforderlich sein, um Daten für bestimmte Spalten in der Tabelle abzurufen. Dies ist normalerweise in Situationen erforderlich, in denen für jede Zeile eine separate Abfrage erfolgen muss, um bestimmte Spalten abzurufen. Diese Arten von Situationen sind oben auf der unten verlinkten Tabellenseite klar dokumentiert.

Amazon Marketplace Connector-Tabellen

AngeboteArtikel

Gibt Details zu einem Listing-Artikel für einen Verkaufspartner zurück.

Die folgenden Filter sind erforderlich:

• SKU
• SellerId: Sie können SellerId entweder als Pseudospaltenbedingung in WHERE-Filtern oder in der Verbindungszeichenfolge angeben.

Einige Beispielabfragen:

SELECT * FROM ListingsItems WHERE SKU = '12345' AND SellerId='XXXXXXXXXXXXXX'

INSERT INTO ListingsItems(ProductType, Requirements, Attributes, SKU, SellerId)
VALUES ('product_type', 'LISTING', '{\"AttributeName\": \"test_attribute\", \"AttributeValue\": \"value\"}', '12345', 'XXXXXXXXXXXXXX')

DELETE FROM ListingsItems WHERE SKU = '12345' AND SellerId='XXXXXXXXXXXXXX'

Beim Einfügen können Sie auch temporäre Tabellen verwenden, um mehrere Attribute einzufügen, wie im folgenden Beispiel gezeigt:

INSERT INTO Attributes#temp(AttributeName, AttributeValue) VALUES ('attr1','val1')
INSERT INTO Attributes#temp(AttributeName, AttributeValue) VALUES ('attr2','val2')
INSERT INTO Attributes#temp(AttributeName, AttributeValue) VALUES ('attr3','val3')

INSERT INTO ListingsItems(ProductType, Requirements, Attributes, SKU, SellerId)
VALUES ('product_type', 'LISTING', 'Attributes#temp', '12345', 'XXXXXXXXXXXXXX')

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

AuflistungenArtikelAttribute

Der Operation „GetFeedSubmissionList“ gibt eine Liste mit Feed-Einreichungen zurück.

Folgende Filter sind erforderlich:

• SKU
• SellerId: Sie können SellerId entweder als Pseudospaltenbedingung in WHERE-Filtern oder in der Verbindungszeichenfolge angeben.

Einige Beispielabfragen:

SELECT * FROM ListingsItemsAttributes WHERE SKU = '12345' AND SellerId='XXXXXXXXXXXXXX'
UPDATE ListingsItemsAttributes SET AttributeValue = 'test_value', ProductType = 'LUGGAGE'
WHERE SKU = '12345' AND AttributeName = 'item_name_value'

Sie können alle SKU-Felder auch aus einer anderen Unterabfrage abrufen, zum Beispiel:

SELECT * FROM ListingsItems WHERE SellerId='XXXXXXXXXXXXXX' AND SKU IN (
        SELECT DISTINCT(SKUIdentifierSellerSKU) FROM CatalogItems WHERE MarketplaceId = 'XXXXXXXXXXXXXX' AND Query = 'test' AND SkuIdentifierSellerSku IS NOT NULL
)

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Ansichten

Ansichten bestehen aus Spalten und Pseudospalten. Ansichten ähneln Tabellen in der Art und Weise, wie Daten dargestellt werden; Ansichten unterstützen jedoch keine Aktualisierungen. Entitäten, die als Ansichten dargestellt werden, sind normalerweise schreibgeschützte Entitäten. Oft ist eine gespeicherte Prozedur verfügbar, um die Daten zu aktualisieren, wenn eine solche Funktionalität auf die Datenquelle anwendbar ist.

Abfragen können für eine Ansicht ausgeführt werden, als wäre sie eine normale Tabelle, und die zurückgegebenen Daten sind in dieser Hinsicht ähnlich. Um mehr über Tabellen und gespeicherte Prozeduren zu erfahren, navigieren Sie bitte zu den entsprechenden Einträgen in diesem Hilfedokument.

Amazon Marketplace Connector-Ansichten

Katalogartikel

Die Tabelle „Katalogartikel“ hilft Ihnen beim Abrufen von Artikeldetails für Artikel im Katalog.

Die folgenden Filter sind erforderlich:

• MarketplaceId
• Einer der folgenden: Query, SellerSKU, UPC, EAN, ISBN, JAN

Beispiel:

SELECT * FROM CatalogItems WHERE MarketplaceID = 'XXXXXXXXXXXXX' AND ISBN = 'XXXXXXXXXXXXX'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

ContainerIdentificationIntern

Nutzungsinformationen für die Operation ContainerIdentificationInternal.rsd.

Spalten

ContainerItemIntern

Verwendungsinformationen für den Operation ContainerItemInternal.rsd.

Spalten

Feeds

Der Operation „GetFeedSubmissionList“ gibt eine Liste mit Feed-Einreichungen zurück.

Wählen

Der Connector verwendet die Amazon Marketplace API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

Hinweis: Das Attribut „FeedType“ ist erforderlich, um die Ansicht Abfrage. Sie können die verfügbaren Werte für „FeedType“ hier anzeigen.

• FeedId unterstützt den '='-Vergleich.
• FeedType unterstützt die Vergleiche '=' und 'IN'.
• MarketplaceIds unterstützt die Vergleiche '=' und 'IN'.
• ProcessingStatus unterstützt die Vergleiche '=' und 'IN'.
• CreatedTime unterstützt die Vergleiche '=', '<', '>', '<=' und '>='.

Nachfolgend sind Beispielabfragen aufgeführt, die serverseitig verarbeitet werden:

SELECT * FROM Feeds WHERE FeedId = '50950018754'

SELECT * FROM Feeds WHERE FeedType = 'POST_PRODUCT_PRICING_DATA'

SELECT * FROM Feeds WHERE FeedType IN ( 'POST_PRODUCT_PRICING_DATA', 'POST_INVENTORY_AVAILABILITY_DATA' )

SELECT * FROM Feeds WHERE FeedType = 'POST_PRODUCT_PRICING_DATA' AND MarketplaceIds = 'A1VC38T7YXB528'

SELECT * FROM Feeds WHERE FeedType = 'POST_PRODUCT_PRICING_DATA' AND ProcessingStatus = 'DONE'

SELECT * FROM Feeds WHERE FeedType = 'POST_PRODUCT_PRICING_DATA' AND CreatedTime > '2021-06-20' AND CreatedTime < '2021-08-01 12:00:00'

Spalten

Eingehende Sendungen

Gibt eine Liste der Artikel in einer angegebenen eingehenden Lieferung zurück.

Wählen

Der Connector verwendet die Amazon Marketplace API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• MarketplaceId unterstützt den '='-Vergleich.
• LastUpdatedDate unterstützt die Vergleiche '=', '<', '>', '<=', '>='.

Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM InboundShipmentItems  WHERE MarketplaceId = 'ATVPDKIKX0DER'

SELECT * FROM InboundShipmentItems  WHERE LastUpdatedDate > '2020-01-01'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Eingehende Sendungen

Gibt eine Liste eingehender Sendungen basierend auf den von Ihnen angegebenen Kriterien zurück.

Wählen

Der Connector verwendet die Amazon Marketplace API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• ShipmentId unterstützt die Vergleiche '=' und 'IN'.
• ShipmentStatus unterstützt die Vergleiche '=' und 'IN'.
• MarketplaceId unterstützt den '='-Vergleich.
• LastUpdatedDate unterstützt die Vergleiche '=', '<', '>', '<=', '>='.

Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM InboundShipments WHERE ShipmentStatus = 'Working'

SELECT * FROM InboundShipments WHERE ShipmentStatus IN ('Working','SHIPPED','IN_TRANSIT')

SELECT * FROM InboundShipments WHERE ShipmentId = '503-9993250-1405404'

SELECT * FROM InboundShipments WHERE MarketplaceId = 'ATVPDKIKX0DER'

SELECT * FROM InboundShipments WHERE LastUpdatedDate >= '2016-12-12'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Inventarversorgung

Gibt Informationen zur Verfügbarkeit des Lagerbestands zurück, den ein Verkäufer im Fulfillment-Netzwerk von Amazon und in aktuellen eingehenden Lieferungen hat. Sie können den aktuellen Verfügbarkeitsstatus für Ihren Fulfillment by Amazon-Lagerbestand überprüfen und feststellen, wann sich der Verfügbarkeitsstatus ändert.

Wählen

Der Connector verwendet die Amazon Marketplace API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• SellerSKU unterstützt die Vergleiche '=', 'IN'.
• GranularityType unterstützt den '='-Vergleich.
• GranularityId unterstützt den '='-Vergleich.
• MarketplaceId unterstützt den '='-Vergleich.
• StartDateTime unterstützt die Vergleiche '=', '<', '>', '<=', '>='.

Nachfolgend sind Beispielabfragen aufgeführt, die serverseitig verarbeitet werden:

SELECT * FROM InventorySupply WHERE GranularityType = 'marketplace' AND GranularityId = 'ATVPDKIKX0DER' AND SellerSKU = '123'

SELECT * FROM InventorySupply WHERE GranularityType = 'marketplace' AND GranularityId = 'ATVPDKIKX0DER' AND StartDateTime > '2020-01-01'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

AngeboteArtikelProbleme

Der Operation „GetFeedSubmissionList“ gibt eine Liste mit Feed-Einreichungen zurück.

Folgende Filter sind erforderlich:

• SKU
• SellerId: Sie können SellerId entweder als Pseudospaltenbedingung in WHERE-Filtern oder in der Verbindungszeichenfolge angeben.

Einige Beispielabfragen:

SELECT * FROM ListingsItemsIssues WHERE SKU = '12345' AND SellerId='XXXXXXXXXXXXXX'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

AngeboteArtikelAngebote

Der Operation „GetFeedSubmissionList“ gibt eine Liste mit Feed-Einreichungen zurück.

Folgende Filter sind erforderlich:

• SKU
• SellerId: Sie können SellerId entweder als Pseudospaltenbedingung in WHERE-Filtern oder in der Verbindungszeichenfolge angeben.

Einige Beispielabfragen:

SELECT * FROM ListingsItemsOffers WHERE SKU = '12345' AND SellerId='XXXXXXXXXXXXXX'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

AuflistungenArtikelZusammenfassungen

Der Operation „GetFeedSubmissionList“ gibt eine Liste mit Feed-Einreichungen zurück.

Folgende Filter sind erforderlich:

• SKU
• SellerId: Sie können SellerId entweder als Pseudospaltenbedingung in WHERE-Filtern oder in der Verbindungszeichenfolge angeben.

Einige Beispielabfragen:

SELECT * FROM ListingsItemsSummaries WHERE SKU = '12345' AND SellerId='XXXXXXXXXXXXXX'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Interne Bestellbestätigung

Nutzungsinformationen für die Operation OrderAckInternal.rsd.

Spalten

BestellartikelbestätigungIntern

Verwendungsinformationen für die Operation OrderItemAckInternal.rsd.

Spalten

Bestellartikel

Gibt Bestellartikel basierend auf der von Ihnen angegebenen Amazon-Bestellnummer zurück.

Wählen

Der Connector verwendet die Amazon Marketplace API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Die OrderItems-Tabelle unterstützt serverseitiges Filtern mit =- und IN-Operatoren für das Feld AmazonOrderId.

• AmazonOrderId unterstützt den '='-Vergleich.

Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM OrderItems WHERE AmazonOrderId = '503-9993250-1405404'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Bestellungen

Gibt Bestellungen zurück, die innerhalb eines von Ihnen angegebenen Zeitraums erstellt oder aktualisiert wurden.

Wählen

Der Connector verwendet die Amazon Marketplace API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• AmazonOrderId unterstützt den '='-Vergleich.
• SellerOrderId unterstützt den '='-Vergleich.
• PurchaseDate unterstützt den Vergleich '=', '<', '>', '<=', '>='.
• LastUpdateDate unterstützt den Vergleich '=', '<', '>', '<=', '>='.
• OrderStatus unterstützt den Vergleich '=', 'IN'.
• FulfillmentChannel unterstützt den Vergleich '=', 'IN'.
• PaymentMethod unterstützt den Vergleich '=', 'IN'.
• MarketplaceId unterstützt den '='-Vergleich.
• BuyerEmail unterstützt den '='-Vergleich.
• IsISPU unterstützt den '='-Vergleich.

Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM Orders WHERE AmazonOrderId = '249-7638334-8161403'

SELECT * FROM Orders WHERE SellerOrderId = '249-7638334' AND purchasedate > '2010-01-01'

SELECT * FROM Orders WHERE LastUpdateDate >= '2016-12-12'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12'

SELECT * FROM Orders WHERE MarketplaceId = 'ATVPDKIKX0DER'

SELECT * FROM Orders WHERE BuyerEmail = 'random@gmail.com'

SELECT * FROM Orders WHERE IsISPU = false

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND OrderStatus = 'Canceled'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND FulfillmentChannel = 'MFN'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND BuyerEmail = 'example@example.com'

SELECT * FROM Orders WHERE PurchaseDate >= '2016-12-12' AND PaymentMethod = 'Other'

Spalten

Berichtsliste

Gibt Berichtsdetails für die Berichte zurück, die den von Ihnen angegebenen Filtern entsprechen.

Wählen

Der Connector verwendet die Amazon Marketplace API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• ReportId unterstützt den '='-Vergleich.
• ReportType unterstützt die Vergleiche '=', 'IN'.
• MarketplaceIds unterstützt die Vergleiche '=', 'IN'.
• ProcessingStatus unterstützt die Vergleiche '=', 'IN'.
• CreatedTime unterstützt die Vergleiche '=', '<', '>', '<=', '>='.

Nachfolgend sind Beispielabfragen aufgeführt, die serverseitig verarbeitet werden:

SELECT * FROM ReportList WHERE ReportId = '51013018828'

SELECT * FROM ReportList WHERE ReportType = 'GET_FLAT_FILE_OPEN_LISTINGS_DATA'

SELECT * FROM ReportList WHERE ReportType = 'GET_FLAT_FILE_OPEN_LISTINGS_DATA' AND CreatedTime > '2021-06-12' AND CreatedTime< '2021-08-01 12:00:00'

SELECT * FROM ReportList WHERE ReportType = 'GET_FLAT_FILE_OPEN_LISTINGS_DATA' AND MarketplaceIds = 'A1VC38T7YXB528'

SELECT * FROM ReportList WHERE ReportType = 'GET_FLAT_FILE_OPEN_LISTINGS_DATA' AND ProcessingStatus = 'DONE'

Hinweis: Beim Filtern mit „CreatedTime“ werden Werte, die älter als 90 Tage sind, nicht akzeptiert.

Spalten

Berichtstypen

Gibt Berichtsdetails für die Berichte zurück, die den von Ihnen angegebenen Filtern entsprechen.

Wählen

Diese Ansicht listet alle verfügbaren Berichtstypen der Selling Partner API und ihr jeweiliges Format (JSON, XML, CSV, TSV, PDF, XLSX) auf.

SELECT * FROM ReportTypes

Spalten

ShipmentAddressInternal

Nutzungsinformationen für die Operation ShipmentAddressInternal.rsd.

Spalten