Dokumentation
Entwickler-HubAPI-StatusUnterstützung

Werte für den Benachrichtigungstyp

Abonnieren Sie die Benachrichtigungen für Vertriebspartner.

Sie können Werte für den Benachrichtigungstyp verwenden, um Benachrichtigungen über die Vertriebspartner-API zu abonnieren. Legen Sie fest, welche Benachrichtigungen Sie erhalten möchten, und wählen Sie die Werte für den Benachrichtigungstyp aus.

Das Folgende notificationType und payloadVersion Werte geben den Benachrichtigungstyp mit unterstützter Payload-Version an:

ACCOUNT_STATUS_CHANGED

Verkäufer können diese Benachrichtigung abonnieren.

Die ACCOUNT_STATUS_CHANGED-Benachrichtigung wird jedes Mal gesendet, wenn sich der Kontostatus für die vom Entwickler abonnierten Verkaufspartner-/Online-Marktplatz-Paare ändert. Eine Benachrichtigung wird veröffentlicht, wenn sich der Kontostatus des Verkaufspartners zwischen NORMAL, AT_RISK und DEACTIVATED ändert.

Nutzladeschema: Version 2021-01-01

Arbeitsablauf: Amazon Simple Queue Service-Arbeitsablauf

Die folgende Tabelle zeigt die Eigenschaften des accountStatusChangeNotification-Objekts an:

Name Beschreibung
previousAccountStatus Der Kontostatus des Verkäufers vor dieser Aktualisierung.

Erforderlich.

Typ: Zeichenfolge

Mögliche Werte: NORMAL, AT_RISK, DEACTIVATED

currentAccountStatus Der neue Kontostatus des Verkäufers.

Erforderlich.

Typ: Zeichenfolge

Mögliche Werte: NORMAL, AT_RISK, DEACTIVATED

Benachrichtigungsschema: AccountStatusChangedNotification.json

Beispiel für eine Benachrichtigung:

{ "notificationVersion": "1.0", "notificationType": "ACCOUNT_STATUS_CHANGED", "payloadVersion": "2021-01-01", "eventTime": "2020-12-11T19:42:04.284Z", "payload": { "accountStatusChangeNotification": { "previousAccountStatus" : "NORMAL", "currentAccountStatus" : "AT_RISK" } }, "notificationMetadata": { "applicationId": "amzn1.sellerapps.app.aacccfff-44aa-4b7c-b42b-ed4ec98dd746", "subscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746", "publishTime": "2020-12-11T19:45:04.284Z", "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746" } }

ANY_OFFER_CHANGED

Verkäufer können diese Benachrichtigung abonnieren.

Diese Benachrichtigung unterstützt folgende eventFilter-Werte: aggregationSettings, marketplaceIds. Um diese Filter verwenden zu können, müssen Sie außerdem folgende
eventFilterType angeben: "eventFilterType": "ANY_OFFER_CHANGED".

Weitere Informationen finden Sie unter Verarbeitungsrichtlinien.

Die ANY_OFFER_CHANGED-Benachrichtigung wird immer dann gesendet, wenn sich eines der Top-20-Angebote, sortiert nach Zustand (neu oder gebraucht) ändert oder wenn sich der externe Preis (der Preis von anderen Einzelhändlern) für einen Artikel ändert, den Sie verkaufen, oder wenn sich das Angebot ändert, das die BuyBox gewinnt, oder wenn sich der BuyBox-Preis ändert. Die 20 besten Angebote richten sich nach dem Endpreis, also dem Preis zuzüglich Versand abzüglich {{1}}. Wenn mehrere Verkäufer denselben Preis berechnen, werden die Ergebnisse in zufälliger Reihenfolge zurückgegeben.

Sie erhalten nur ANY_OFFER_CHANGED-Benachrichtigungen für Artikel, für die Sie aktive Angebote haben. Sie können keine Benachrichtigungen für Artikel abonnieren, für die Sie keine aktiven Angebote haben.

Nutzladeschema: Version 1.0

Arbeitsablauf: Amazon Simple Queue Service-Arbeitsablauf

Die folgende Tabelle zeigt die Objekte und Eigenschaften des AnyOfferChangedNotification-Objekts:

Name Beschreibung
SellerId Die Verkäufer-ID für das Angebot.

Erforderlich.

Typ: Zeichenfolge

OfferChangeTrigger Das Ereignis, das dazu geführt hat, dass die Benachrichtigung gesendet wurde.

Erforderlich.

Typ: OfferChangeTrigger

Summary Informationen über das Produkt, für das das Angebot geändert wurde. Die Informationen in dieser Zusammenfassung gelten für alle Bedingungen des Produkts.

Erforderlich.

Typ: Summary

Offers Die 20 wettbewerbsfähigsten Angebote für den Artikel und den Zustand, der die Benachrichtigung ausgelöst hat.

Erforderlich.

Typ: Reihe von Offer

BuyBoxPrice

Die folgende Tabelle zeigt die Objekte und Eigenschaften des BuyBoxPrice-Objekts:

Name Beschreibung
LandedPrice ListingPrice + Shipping - Points.

Erforderlich.

Typ: MoneyType

ListingPrice Der Preis des Artikels.

Erforderlich.

Typ: MoneyType

Shipping Die Versandkosten.

Erforderlich.

Typ: MoneyType

Points Die Anzahl der Amazon-Punkte, die beim Kauf eines Artikels angeboten werden.

Optional.

Hinweis: Das Points-Objekt wird nur in Japan (JP) zurückgegeben.

Typ: Points

Condition Zeigt den Zustand des Artikels an. Zum Beispiel: New, Used, Collectible, Refurbished oder Club.

Erforderlich.

Typ: Zeichenfolge

LowestPrice

Die folgende Tabelle zeigt die Objekte und Eigenschaften des LowestPrice-Objekts:

Name Beschreibung
LandedPrice

ListingPrice + Shipping - Points.

Erforderlich.

Typ: MoneyType

ListingPrice

Der Preis des Artikels.

Erforderlich.

Typ: MoneyType

Shipping

Die Versandkosten.

Erforderlich.

Typ: MoneyType

Points

Die Anzahl der Amazon-Punkte, die beim Kauf eines Artikels angeboten werden.

Optional.

Hinweis: Das Points-Objekt wird nur in Japan (JP) zurückgegeben.

Typ: Points

Condition

Zeigt den Zustand des Artikels an. Zum Beispiel: New, Used, Collectible, Refurbished oder Club.

Erforderlich.

Typ: Zeichenfolge

FulfillmentChannel

Gibt an, ob der Artikel von Amazon oder vom Verkäufer versendet wird.

Erforderlich.

Typ: FulfillmentChannelType

Offer

Die folgende Tabelle zeigt die Objekte und Eigenschaften des Offer-Objekts:

Name Beschreibung
SellerId

Die Verkäufer-ID für das Angebot.

Erforderlich.

Typ: Zeichenfolge

SubCondition

Der Unterzustand des Artikels. Zum Beispiel: New, Mint, Very Good, Good, Acceptable, Poor, Club, Ocode, Warranty, Refurbished Warranty, Refurbished, Open Box oder Other.

Erforderlich.

Typ: Zeichenfolge

SellerFeedbackRating

Informationen über die Verkäuferbewertung, einschließlich des Prozentsatzes der positiven Bewertungen und der Gesamtzahl der erhaltenen Bewertungen.

Optional.

Typ: SellerFeedbackRating

ShippingTime

Die Mindest- und Höchstdauer (in Stunden), innerhalb derer der Artikel voraussichtlich versendet wird, nachdem die Bestellung aufgegeben wurde.

Erforderlich.

Typ: ShippingTime

ListingPrice

Der Preis des Artikels.

Erforderlich.

Typ: MoneyType

Points

Die Anzahl der Amazon-Punkte, die beim Kauf eines Artikels angeboten werden.

Optional.

Hinweis: Das Points-Objekt wird nur in Japan (JP) zurückgegeben.

Typ: Points

Shipping

Die Versandkosten.

Erforderlich.

Typ: MoneyType

ShipsFrom

Das Bundesland und das Land, aus dem der Artikel versendet wird.

Optional.

Typ: ShipsFrom

IsFulfilledByAmazon

Gibt an, ob das Angebot von Amazon versendet wird.

Erforderlich.

Typ: boolean

IsBuyBoxWinner

Zeigt an, ob das Angebot derzeit im {{0}} ist. Es kann bis zu zwei {{1}} Gewinner gleichzeitig pro ASIN geben, einer für Prime und einer, der nicht für Prime berechtigt ist.

Optional.

Typ: boolean

ConditionNotes

Informationen über den Zustand des Artikels.

Optional.

Typ: Zeichenfolge

PrimeInformation

Amazon Prime-Informationen.

Optional.

Typ: PrimeInformation

IsExpeditedShippingAvailable

Gibt an, ob Expressversand verfügbar ist.

Optional.

Typ: boolean

IsFeaturedMerchant

Gibt an, ob der Verkäufer des Artikels für {{0}} berechtigt ist.

Optional.

Typ: boolean

ShipsDomestically

Gibt an, ob der Artikel im Inland versendet wird.

Optional.

Typ: boolean

OfferChangeTrigger

Die folgende Tabelle zeigt die Eigenschaften des OfferChangeTrigger-Objekts an:

Name Beschreibung
MarketplaceId

Die Online-Marktplatz-ID des Artikels, für den eine Angebotsänderung vorgenommen wurde.

Erforderlich.

Typ: Zeichenfolge

ASIN

Die ASIN für den Artikel, für den eine Angebotsänderung vorgenommen wurde.

Erforderlich.

Typ: Zeichenfolge

ItemCondition

Der Zustand des Artikels, für den eine Angebotsänderung vorgenommen wurde. Wenn sich beispielsweise ein gebrauchtes Angebot ändert, ändert sich das Angebots-Array im Offers-Objekt in nur gebrauchte Artikel. Das Summary-Objekt bietet eine Zusammenfassung der anderen Zustände, die für die Neubewertung verwendet werden können.

Erforderlich.

Typ: Zeichenfolge

TimeOfOfferChange

Die Aktualisierungszeit für das Angebot, das diese Benachrichtigung verursacht hat, im ISO 8601-Format.

Erforderlich.

Typ: Zeichenfolge

OfferChangeType

Die Art des Angebots, das sich geändert hat und das diese Benachrichtigung ausgelöst hat.

OfferChangeType Werte:

External – Der CompetitivePriceThreshold im Summary-Objekt hat sich geändert, ausgelöst durch ein neues Angebot eines Nicht-Amazon-Verkäufers.

Internal - Der Preis eines Angebots auf der Einzelhandels-Website von Amazon hat sich geändert.

Featured Offer - Der Buy-Box-Gewinner oder der Buy-Box-Preis hat sich geändert.

Erforderlich.

Typ: Zeichenfolge

OfferCount

Die folgende Tabelle zeigt die Objekte und Eigenschaften des OfferCount-Objekts:

Name Beschreibung
Condition

Zeigt den Zustand des Artikels an. Zum Beispiel: New, Used, Collectible, Refurbished oder Club.

Erforderlich.

Typ: Zeichenfolge

FulfillmentChannel

Gibt an, ob der Artikel von Amazon oder vom Verkäufer versendet wird.

Erforderlich.

Typ: FulfillmentChannelType

OfferCount

Die Gesamtzahl der Angebote für den angegebenen Zustand und den angegebenen Versandkanal.

Erforderlich.

Typ: Ganzzahl

Points

Die folgende Tabelle zeigt die Eigenschaften des Points-Objekts an:

Name Beschreibung
PointsNumber

Die Anzahl der Amazon-Punkte, die beim Kauf eines Artikels angeboten werden.

Erforderlich.

Typ: Ganzzahl

PrimeInformation

Die folgende Tabelle zeigt die Objekte und Eigenschaften des PrimeInformation-Objekts:

Name Beschreibung
IsOfferNationalPrime

Gibt an, ob es sich bei dem Angebot um ein Amazon Prime-Angebot auf dem gesamten Online-Marktplatz handelt, auf dem es gelistet ist.

Erforderlich.

Typ: boolean

IsOfferPrime

Gibt an, ob es sich bei dem Angebot um ein Amazon Prime-Angebot handelt.

Erforderlich.

Typ: boolean

SalesRank

Die folgende Tabelle zeigt die Eigenschaften des SalesRank-Objekts an:

Name Beschreibung
ProductCategoryId

Die Produktkategorie-ID des Artikels.

Erforderlich.

Typ: Zeichenfolge

Rank

Der Verkaufsrang des Artikels in der angegebenen Produktkategorie.

Erforderlich.

Typ: Ganzzahl

SellerFeedbackRating

Die folgende Tabelle zeigt die Objekte und Eigenschaften des SellerFeedbackRating-Objekts:

Name Beschreibung
SellerPositiveFeedbackRating

Der Prozentsatz positiver Bewertungen für den Verkäufer in den letzten 365 Tagen.

Optional.

Typ: doppelt

FeedbackCount

Die Anzahl der über den Verkäufer eingegangenen Bewertungen.

Erforderlich.

Typ: lang

ShippingTime

Die folgende Tabelle zeigt die Eigenschaften des ShippingTime-Objekts an:

Name Beschreibung
MinimumHours

Die Mindestzeit (in Stunden), in der der Artikel wahrscheinlich versendet wird, nachdem die Bestellung aufgegeben wurde.

Optional.

Typ: kurz

MaximumHours

Die maximale Zeit in Stunden, in der der Artikel wahrscheinlich versendet wird, nachdem die Bestellung aufgegeben wurde.

Optional.

Typ: kurz

AvailableDate

Das Datum, an dem der Artikel für den Versand verfügbar sein wird. Wird nur für Artikel angezeigt, die derzeit nicht für den Versand verfügbar sind.

Optional.

Typ: Zeichenfolge

AvailabilityType

Gibt an, ob der Artikel jetzt oder an einem bekannten oder einem unbekannten Datum in der Zukunft für den Versand verfügbar ist. Falls bekannt, gibt das availableDate-Attribut das Datum an, an dem der Artikel für den Versand verfügbar sein wird.

Optional.

Typ: Zeichenfolge

ShipsFrom

Die folgende Tabelle zeigt die Objekte und Eigenschaften des ShipsFrom-Objekts:

Name Beschreibung
State

Das Bundesland, aus dem der Artikel versendet wird.

Optional.

Typ: Zeichenfolge

Country

Das Land, aus dem der Artikel versendet wird.

Optional.

Typ: Zeichenfolge

IsFulfilledByAmazon

Gibt an, ob das Angebot von Amazon versendet wird.

Erforderlich.

Typ: boolean

Summary

Die folgende Tabelle zeigt die Objekte und Eigenschaften des Summary-Objekts:

Name Beschreibung
NumberOfOffers

Eine Liste, die die Gesamtzahl der Angebote für den Artikel für die angegebenen Bedingungen und Versandkanäle enthält.

Erforderlich.

Typ: Reihe von OfferCount

LowestPrices

Eine Liste, die die niedrigsten Preise des Artikels für die angegebenen Bedingungen und Versandkanäle enthält.

Erforderlich.

Typ: Reihe von LowestPrice

BuyBoxPrices

Eine Liste, die den {{0}}-Preis des Artikels für die angegebenen Zustände enthält.

Optional.

Typ: Reihe von BuyBoxPrice

ListPrice

Der vom Hersteller vorgeschlagene Listenpreis des Artikels.

Optional.

Typ: MoneyType

SuggestedLowerPricePlusShipping

Der empfohlene niedrigere Preis des Artikels, einschließlich Versand (minus {{0}}). Der vorgeschlagene niedrigere Preis basiert auf einer Reihe von Faktoren, darunter historische Verkaufspreise und aktuelle {{1}}-förderfähige Preise und Feedback von Kunden zu Ihren Produkten.

Optional.

Typ: MoneyType

SalesRankings

Eine Liste, die den Verkaufsrang des Artikels in den angegebenen Produktkategorien enthält.

Optional.

Typ: Reihe von SalesRank

NumberOfBuyBoxEligibleOffers

Eine Liste, die die Gesamtzahl der Angebote enthält, die für den {{0}} für die angegebenen Zustände und Versandkanäle berechtigt sind.

Erforderlich.

Typ: Reihe von OfferCount

CompetitivePriceThreshold

Dieser Preis basiert auf wettbewerbsfähigen Preisen von anderen Einzelhändlern (außer anderen Amazon-Verkäufern). Ihr Angebot ist möglicherweise nicht für price berechtigt, wenn Ihr shipping + {{2}} höher ist als dieser wettbewerbsfähige Preis.

Optional.

Typ: MoneyType

Benachrichtigungsschema: AnyOfferChangedNotification.json

Beispiel für eine Benachrichtigung:

{ "NotificationVersion": "1.0", "NotificationType": "ANY_OFFER_CHANGED", "PayloadVersion": "1.0", "EventTime": "2020-01-11T00:09:53.109Z", "NotificationMetadata": { "ApplicationId": "amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5", "SubscriptionId": "7d78cc50-95c8-4641-add7-10af4b1fedc9", "PublishTime": "2020-01-11T00:02:50.501Z", "NotificationId": " 2012e8e5-b365-4cb1-9fd8-be9dfc6d5eaf" }, "Payload": { "AnyOfferChangedNotification": { "SellerId": "merchantId", "OfferChangeTrigger": { "MarketplaceId": "marketplaceId", "ASIN": "ysp2k4cziG", "ItemCondition": "Collectible", "TimeOfOfferChange": "2020-01-11T00:02:50.501Z", "OfferChangeType": "" }, "Summary": { "NumberOfOffers": [ { "Condition": "new", "FulfillmentChannel": "Merchant", "OfferCount": 28 } ], "LowestPrices": [ { "Condition": "new", "FulfillmentChannel": "Merchant", "LandedPrice": { "Amount": 28.59, "CurrencyCode": "USD" }, "ListingPrice": { "Amount": 28.59, "CurrencyCode": "USD" }, "Shipping": { "Amount": 0, "CurrencyCode": "USD" } } ], "BuyBoxPrices": [ { "Condition": "new", "LandedPrice": { "Amount": 14, "CurrencyCode": "USD" }, "ListingPrice": { "Amount": 12, "CurrencyCode": "USD" }, "Shipping": { "Amount": 2, "CurrencyCode": "USD" } } ], "ListPrice": { "Amount": 14, "CurrencyCode": "USD" }, "SalesRankings": [ { "ProductCategoryId": "lawn_and_garden_display_on_website", "Rank": 4013 }, { "ProductCategoryId": "home_garden_display_on_website", "Rank": 17316 } ], "NumberOfBuyBoxEligibleOffers": [ { "Condition": "new", "FulfillmentChannel": "Merchant", "OfferCount": 10 } ] }, "Offers": [ { "SellerId": "AQNACJEM8PUJ1", "SubCondition": "new", "SellerFeedbackRating": { "FeedbackCount": 78786, "SellerPositiveFeedbackRating": 92 }, "ShippingTime": { "MinimumHours": 24, "MaximumHours": 48, "AvailabilityType": "", "AvailableDate": "" }, "ListingPrice": { "Amount": 28.59, "CurrencyCode": "USD" }, "Shipping": { "Amount": 0, "CurrencyCode": "USD" }, "ShipsFrom": { "Country": "", "State": "" }, "IsFulfilledByAmazon": false }, { "SellerId": "A28SS3BS1DBQ92", "SubCondition": "new", "SellerFeedbackRating": { "FeedbackCount": 6532, "SellerPositiveFeedbackRating": 99 }, "ShippingTime": { "MinimumHours": 24, "MaximumHours": 48, "AvailabilityType": "", "AvailableDate": "" }, "ListingPrice": { "Amount": 28.69, "CurrencyCode": "USD" }, "Shipping": { "Amount": 0, "CurrencyCode": "USD" }, "ShipsFrom": { "Country": "", "State": "" }, "IsFulfilledByAmazon": false } ] } } }

B2B_ANY_OFFER_CHANGED

Verkäufer können diese Benachrichtigung abonnieren.

Die B2B_ANY_OFFER_CHANGED-Benachrichtigung wird bei jeder Änderung eines der 20 wichtigsten B2B-Angebote für Amazon Business in Form einer Preisänderung (für einzelne Einheiten und sieben vordefinierte Mengenrabattstufen: 2, 3, 5, 10, 20, 30 und 50) für einen vom Verkäufer angebotenen Artikel gesendet. Die 20 besten B2B-Angebote richten sich nach dem Endpreis für eine einzelne Einheit, also dem Preis zuzüglich Versand. Wenn mehrere Verkäufer denselben Angebotspreis berechnen, werden die Ergebnisse in zufälliger Reihenfolge zurückgegeben.

Sie erhalten nur B2B_ANY_OFFER_CHANGED-Benachrichtigungen für Artikel, für die der Verkäufer aktive Angebote hat. Sie können keine Benachrichtigungen für Artikel abonnieren, für die der Verkäufer keine aktiven Angebote hat.

Nutzladeschema: Version 1.0

Arbeitsablauf: Amazon Simple Queue Service-Arbeitsablauf

Die folgende Tabelle zeigt die Objekte und Eigenschaften des B2B AnyOfferChangedNotification-Objekts:

Name Beschreibung
OfferChangeTrigger

Das Ereignis, das dazu geführt hat, dass die Benachrichtigung gesendet wurde.

Erforderlich.

Typ: OfferChangeTrigger

Summary

Informationen über das Produkt, für das das Angebot geändert wurde. Die Informationen in dieser Zusammenfassung gelten für alle Bedingungen des Produkts.

Erforderlich.

Typ: Summary

Offers

Die 20 wettbewerbsfähigsten B2B-Angebote für den Artikel und den Zustand, der die Benachrichtigung ausgelöst hat.

Erforderlich.

Typ: Reihe von Offer

SellerId

Die Verkäufer-ID für das Angebot.

Erforderlich.

Typ: Zeichenfolge

BuyBoxPrice

Die folgende Tabelle zeigt die Objekte und Eigenschaften des BuyBoxPrice-Objekts.

Name Beschreibung
landedPrice

listingPrice + shipping.

Optional.

Typ: MoneyType

listingPrice

Der Preis des Artikels.

Erforderlich.

Typ: MoneyType

shipping

Die Versandkosten.

Optional.

Typ: MoneyType

offerType

Gibt an, ob es sich bei dem Angebot um ein B2B-Angebot oder ein B2C-Angebot handelt. Wenn es sich bei dem Angebot um einen Mengenrabatt vom Typ B2C handelt, gewinnt der Verkäufer {{0}}, weil andere keinen Lagerbestand in dieser Menge haben, nicht weil sie einen Mengenrabatt auf die ASIN haben.

Erforderlich.

Typ: Zeichenfolge

quantityTier

Die Mengenstufe für das Angebot.

Erforderlich.

Typ: Ganzzahl

discountType

Gibt an, ob die Mengenstufe für Mengenrabatt oder progressiven Rabatt gilt.

Optional.

Typ: Zeichenfolge

condition

Zeigt den Zustand des Artikels an. Zum Beispiel: New, Used, Collectible, Refurbished oder Club.

Erforderlich.

Typ: Zeichenfolge

sellerId

Die Verkäufer-ID für das Angebot.

Optional.

Typ: Zeichenfolge

LowestPrice

Die folgende Tabelle zeigt die Objekte und Eigenschaften des LowestPrice-Typs unter Summary-Objekt:

Name Beschreibung
LandedPrice

ListingPrice + Shipping.

Optional.

Typ: MoneyType

ListingPrice

Der Preis des Artikels.

Erforderlich.

Typ: MoneyType

Shipping

Die Versandkosten.

Optional.

Typ: MoneyType

OfferType

Gibt an, ob es sich bei dem Angebot um ein B2B-Angebot oder ein B2C-Angebot handelt

Erforderlich.

Typ: Zeichenfolge

QuantityTier

Die Mengenstufe für das Angebot

Erforderlich.

Typ: Ganzzahl

DiscountType

Gibt an, ob die Mengenstufe für Mengenrabatt oder progressiven Rabatt gilt.

Optional.

Typ: Zeichenfolge

Condition

Zeigt den Zustand des Artikels an. Zum Beispiel: New, Used, Collectible, Refurbished oder Club.

Erforderlich.

Typ: Zeichenfolge

FulfillmentChannel

Gibt an, ob der Artikel von Amazon oder vom Verkäufer versendet wird.

Erforderlich.

Typ: FulfillmentChannelType

Offer

Die folgende Tabelle zeigt die Objekte und Eigenschaften des Offer-Objekts:

Name Beschreibung
SellerId

Die Verkäufer-ID für das Angebot.

Erforderlich.

Typ: Zeichenfolge

SubCondition

Der Unterzustand des Artikels. Zum Beispiel: New, Mint, Very Good, Good, Acceptable, Poor, Club, Ocode, Warranty, Refurbished Warranty, Refurbished, Open Box oder Other.

Erforderlich.

Typ: Zeichenfolge

SellerFeedbackRating

Informationen über die Verkäuferbewertung, einschließlich des Prozentsatzes der positiven Bewertungen und der Gesamtzahl der erhaltenen Bewertungen.

Optional.

Typ: SellerFeedbackRating

ShippingTime

Die Mindest- und Höchstdauer (in Stunden), innerhalb derer der Artikel voraussichtlich versendet wird, nachdem die Bestellung aufgegeben wurde.

Erforderlich.

Typ: ShippingTime

ListingPrice

Der Preis des Artikels.

Erforderlich.

Typ: MoneyType

Shipping

Die Versandkosten.

Erforderlich.

Typ: MoneyType

ShipsFrom

Das Land, aus dem der Artikel versendet wird.

Optional.

Typ: ShipsFrom

IsFulfilledByAmazon

Gibt an, ob das Angebot von Amazon versendet wird.

Erforderlich.

Typ: boolean

IsBuyBoxWinner

Zeigt an, ob das Angebot derzeit im {{0}} ist. Es kann bis zu zwei {{1}} Gewinner gleichzeitig pro ASIN geben, einer für Prime und einer, der nicht für Prime berechtigt ist.

Optional.

Typ: boolean

ConditionNotes

Informationen über den Zustand des Artikels.

Optional.

Typ: Zeichenfolge

PrimeInformation

Amazon Prime-Informationen.

Optional.

Typ: PrimeInformation

IsFeaturedMerchant

Gibt an, ob der Verkäufer des Artikels für {{0}} berechtigt ist.

Optional.

Typ: boolean

OfferChangeTrigger

Die folgende Tabelle zeigt die Eigenschaften des OfferChangeTrigger-Objekts an:

Name Beschreibung
MarketplaceId

Die Online-Marktplatz-ID des Artikels, für den eine Angebotsänderung vorgenommen wurde.

Erforderlich.

Typ: Zeichenfolge

ASIN

Die ASIN für den Artikel, für den eine Angebotsänderung vorgenommen wurde.

Erforderlich.

Typ: Zeichenfolge

ItemCondition

Der Zustand des Artikels, für den eine Angebotsänderung vorgenommen wurde. Wenn sich beispielsweise ein gebrauchtes Angebot ändert, ändert sich das Angebots-Array im Offers-Objekt in nur gebrauchte Artikel. Das Summary-Objekt bietet eine Zusammenfassung der anderen Zustände, die für die Neubewertung verwendet werden können.

Erforderlich.

Typ: Zeichenfolge

TimeOfOfferChange

Die Aktualisierungszeit für das Angebot, das diese Benachrichtigung verursacht hat.

Erforderlich.

Typ: Zeichenfolge

OfferCount

Die folgende Tabelle zeigt die Objekte und Eigenschaften des OfferCount-Typs:

Name Beschreibung
Condition

Zeigt den Zustand des Artikels an. Zum Beispiel: New, Used, Collectible, Refurbished oder Club.

Erforderlich.

Typ: Zeichenfolge

FulfillmentChannel

Gibt an, ob der Artikel von Amazon oder vom Verkäufer versendet wird.

Erforderlich.

Typ: FulfillmentChannelType

OfferCount

Die Gesamtzahl der Angebote für den angegebenen Zustand und den angegebenen Versandkanal.

Typ: Ganzzahl

PrimeInformation

Die folgende Tabelle zeigt die Eigenschaften des PrimeInformation-Objekts an:

Name Beschreibung
IsOfferNationalPrime

Gibt an, ob es sich bei dem Angebot um ein Amazon Prime-Angebot auf dem gesamten Online-Marktplatz handelt, auf dem es gelistet ist.

Erforderlich.

Typ: boolean

IsOfferPrime

Gibt an, ob es sich bei dem Angebot um ein Amazon Prime-Angebot handelt.

Erforderlich.

Typ: boolean

SellerFeedbackRating

Die folgende Tabelle zeigt die Eigenschaften des SellerFeedbackRating-Objekts an:

Name Beschreibung
SellerPositiveFeedbackRating

Der Prozentsatz positiver Bewertungen für den Verkäufer in den letzten 365 Tagen.

Optional.

Typ: Ganzzahl

FeedbackCount

Die Anzahl der über den Verkäufer eingegangenen Bewertungen.

Erforderlich.

Typ: Ganzzahl

ShippingTime

Die folgende Tabelle zeigt die Eigenschaften des ShippingTime-Objekts an:

Name Beschreibung
MinimumHours

Die Mindestzeit (in Stunden), in der der Artikel wahrscheinlich versendet wird, nachdem die Bestellung aufgegeben wurde.

Optional.

Typ: Ganzzahl

MaximumHours

Die maximale Zeit in Stunden, in der der Artikel wahrscheinlich versendet wird, nachdem die Bestellung aufgegeben wurde.

Optional.

Typ: Ganzzahl

AvailableDate

Das Datum, an dem der Artikel für den Versand verfügbar sein wird. Wird nur für Artikel angezeigt, die derzeit nicht für den Versand verfügbar sind.

Optional.

Typ: Zeichenfolge

AvailabilityType

Gibt an, ob der Artikel jetzt oder an einem bekannten oder einem unbekannten Datum in der Zukunft für den Versand verfügbar ist. Falls bekannt, gibt die availableDate-Property das Datum an, an dem der Artikel für den Versand verfügbar sein wird.

Optional.

Typ: Zeichenfolge

ShipsFrom

Die folgende Tabelle zeigt die Eigenschaften des ShipsFrom-Objekts an:

Name Beschreibung
Country

Das Land, aus dem der Artikel versendet wird.

Optional.

Typ: Zeichenfolge

Summary

Die folgende Tabelle zeigt die Objekte und Eigenschaften des Summary-Objekts:

Name Beschreibung
NumberOfOffers

Eine Liste, die die Gesamtzahl der B2B-Angebote für den Artikel für die angegebenen Bedingungen und Versandkanäle enthält.

Erforderlich.

Typ: Reihe von OfferCount

LowestPrices

Eine Liste, die die niedrigsten Preise des Artikels für die angegebenen Bedingungen, Versandkanäle, Mengenstufen und Rabattarten enthält.

Die sieben vordefinierten Mengenstufen für den Rabatttyp „Mengenrabatte“ sind 2, 3, 5, 10, 20, 30 und 50.

Erforderlich.

Typ: Reihe von LowestPrice

BuyBoxPrices

Eine Liste, die den {{0}}-Preis des Artikels für die angegebenen Zustände, Mengenstufen und Rabattarten enthält.

Es werden maximal die ersten 50 Mengenstufen angezeigt.

Optional.

Typ: Reihe von BuyBoxPrice

BuyBoxEligibleOffers

Eine Liste, die die Gesamtzahl der B2B-Angebote enthält, die für den {{0}} für die angegebenen Zustände und Versandkanäle berechtigt sind.

Erforderlich.

Typ: Reihe von OfferCount

Benachrichtigungsschema: B2bAnyOfferChangedNotification.json

Beispiel für eine Benachrichtigung

{ "notificationVersion": "1.0", "notificationType": "B2B_ANY_OFFER_CHANGED", "payloadVersion": "1.0", "eventTime": "2020-09-23T21:30:13.713Z", "notificationMetadata": { "applicationId": "amzn1.sellerapps.app.1da85d14-a68d-4ff3-9ff0-df6429e00d9a", "subscriptionId": "e3a059ca-677a-442a-8d39-05b2848971b6", "publishTime": "2020-09-23T21:30:16.903Z", "notificationId": "23ae41cd-3537-4676-af46-6ee9abf8802e" }, "payload": { "b2bAnyOfferChangedNotification": { "sellerId": "A3EZFOFNDPFB8R", "offerChangeTrigger": { "marketplaceId": "ATVPDKIKX0DER", "asin": "B007IBIWZY", "itemCondition": "new", "timeOfOfferChange": "2020-09-23T21:30:13.409Z" }, "summary": { "numberOfOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant", "offerCount": 3 } ], "buyBoxEligibleOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant", "offerCount": 3 } ], "lowestPrices": [ { "condition": "new", "fulfillmentChannel": "Merchant", "offerType": "B2B", "quantityTier": 1, "listingPrice": { "amount": 8184.23, "currencyCode": "USD" }, "shipping": { "amount": 4.49, "currencyCode": "USD" }, "landedPrice": { "amount": 8188.72, "currencyCode": "USD" } }, { "condition": "new", "fulfillmentChannel": "Merchant", "offerType": "B2B", "quantityTier": 20, "listingPrice": { "amount": 7500, "currencyCode": "USD" } }, { "condition": "new", "fulfillmentChannel": "Merchant", "offerType": "B2B", "quantityTier": 30, "discountType": "QUANTITY_DISCOUNT", "listingPrice": { "amount": 6975, "currencyCode": "USD" } } ], "buyBoxPrices": [ { "condition": "new", "offerType": "B2B", "quantityTier": 1, "listingPrice": { "amount": 8184.23, "currencyCode": "USD" }, "shipping": { "amount": 4.49, "currencyCode": "USD" }, "landedPrice": { "amount": 8188.72, "currencyCode": "USD" } }, { "condition": "new", "offerType": "B2B", "quantityTier": 20, "discountType": "QUANTITY_DISCOUNT", "listingPrice": { "amount": 8000, "currencyCode": "USD" } }, { "condition": "new", "offerType": "B2B", "quantityTier": 30, "discountType": "QUANTITY_DISCOUNT", "listingPrice": { "amount": 7800, "currencyCode": "USD" } } ] }, "offers": [ { "sellerId": "A2VUIDM8BZ902A", "subCondition": "new", "sellerFeedbackRating": { "feedbackCount": 1, "sellerPositiveFeedbackRating": 0 }, "shippingTime": { "minimumHours": 24, "maximumHours": 48, "availabilityType": "available", "availableDate": "2020-07-13T19:42:04.284Z" }, "listingPrice": { "amount": 8184.23, "currencyCode": "USD" }, "shipping": { "amount": 4.49, "currencyCode": "USD" }, "shipsFrom": { "country": "US" }, "isFulfilledByAmazon": false, "isBuyBoxWinner": true, "conditionNotes": "New in box", "primeInformation": { "isPrime": true, "isNationalPrime": true }, "isFeaturedMerchant": true } ] } } }

BRANDED_ITEM_CONTENT_CHANGE

Verkäufer können diese Benachrichtigung abonnieren.

Amazon sendet die Benachrichtigung BRANDED_ITEM_CONTENT_CHANGE, wenn sich Name, Beschreibung, Bullet Points oder Abbildungen für jede ASIN ändert, zu der der Verkaufspartner eine Markenbeziehung unterhält. Ein Verkaufspartner unterhält eine Markenbeziehung zu einer ASIN, wie im Amazon-Programm für registrierte Marken definiert, wenn er ein verifizierter Markeninhaber ist. Der Verkaufspartner ist die Partei, die eine Anwendung autorisiert, in seinem Namen die Benachrichtigungs-API aufzurufen, um Benachrichtigungsabonnements zu erstellen und zu verwalten. Amazon sendet BRANDED_ITEM_CONTENT_CHANGE-Benachrichtigungen für Artikel, die auf einem Amazon-Online-Marktplatz angeboten werden.

Nutzladeschema: Version 1.0

Arbeitsablauf: Amazon EventBridge-Arbeitsablauf

Die Benachrichtigung BRANDED_ITEM_CONTENT_CHANGE mit PayloadVersion=1.0 enthält die folgenden Eigenschaften im Objekt Payload.

Name Beschreibung Erforderlich
MarketplaceId Der Online-Marktplatz, bei dem der Artikel angeboten wird.

Typ: Zeichenfolge

Ja
BrandName Der Markenname des Artikels.

Typ: Zeichenfolge

Ja
Asin Die ASIN des Artikels.

Typ: Zeichenfolge

Ja
AttributesChanged Das Array der Artikelattribute, die sich geändert haben. Attributnamen, Beschreibungen und Anforderungen sind verfügbar, indem Sie die Product Type Definitions API aufrufen. Weitere Informationen finden Sie auf der API-Anwendungsfallleitfaden für Produkttypdefinitionen.

Typ: Array mit einer Zeichenfolge

Mögliche Werte:
bullet_point
item_name
product_description
... und alle Produktbildattribute (main_product_image_locator, other_product_image_locator_1usw.). Beziehen Sie sich auf die images Immobiliengruppe davon Beispiel für eine JSON-Antwort im Anwendungsfallleitfaden zur API für Produkttypdefinitionen finden Sie eine vollständige Liste der Bildattribute.

HINWEIS: Das Vorhandensein eines oder mehrerer der oben genannten Werte, die das Wort enthalten image (zum Beispiel main_product_image_locator, other_product_image_locator_1, und so weiter) zeigt an, dass mindestens einer Das Bild wurde auf der Produktdetailseite geändert. Die Anzahl der Werte, die das Wort Bild enthalten nicht unbedingt entspricht der Anzahl der Bilder, die auf der Produktdetailseite geändert wurden.
Ja

Benachrichtigungsschema: BrandedItemContentChangeNotification.json

Beispiel für eine Benachrichtigung:

{ "NotificationVersion": "1.0", "NotificationType": "BRANDED_ITEM_CONTENT_CHANGE", "PayloadVersion": "1.0", "EventTime": "2019-03-20T18:59:30.194Z", "Payload": { "MarketplaceId": "ATVPDKIKX0DER", "BrandName": "Great Brand", "Asin": "B1234567", "AttributesChanged": [ "bullet_point", "item_name", "product_description", "main_product_image_locator", "other_product_image_locator_1", "other_product_image_locator_2", "other_product_image_locator_3", "other_product_image_locator_4", "other_product_image_locator_5", "other_product_image_locator_6", "other_product_image_locator_7", "other_product_image_locator_8", "swatch_product_image_locator" ] }, "NotificationMetadata": { "ApplicationId": "amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5", "SubscriptionId": "93b098e1-c42-2f45-93a1-78910a6a8369", "PublishTime": "2019-03-20T18:59:48.768Z", "NotificationId": "8e009934-da2c-4f9c-9bc7-93f23b7e1f60" } }

DETAIL_PAGE_TRAFFIC_EVENT

Verkäufer und Anbieter können diese Benachrichtigung abonnieren.

Die Benachrichtigung DETAIL_PAGE_TRAFFIC_EVENT wird fünf Minuten nach Beginn jeder Stunde gesendet. Diese Benachrichtigung gibt Traffic-Daten auf ASIN-Ebene weiter und umfasst Daten für die Stunde vor der vorherigen Stunde sowie alle verspäteten Daten von bis zu 24 Stunden zuvor. ASINs mit Glance Views sind enthalten. Jede Benachrichtigung kann mehrere ASINs enthalten und ein Verkaufspartner kann damit rechnen, jede Stunde mehrere Benachrichtigungen zu erhalten.

Nutzladeschema: Version 1.0

Arbeitsablauf: Amazon Simple Queue Service-Arbeitsablauf

DetailPageTrafficEventNotifications

Die folgende Tabelle zeigt die Objekte und Eigenschaften des DetailPageTrafficEventNotifications-Objekts:

NameBeschreibungErforderlichType
detailPageTrafficEventNotificationsEine Liste der stündlichen detaillierten Traffic-Metriken nach ASIN.JaArray von DetailPageTrafficEventNotification

DetailPageTrafficEventNotification

NameBeschreibungErforderlichType
accountIdDie Händler-Kunden- oder Anbietergruppen-ID des Verkaufspartnerkontos, für das die Benachrichtigung übermittelt wurde.JaZeichenfolge
marketplaceIdDie Online-Marktplatz-ID der Traffic-Daten.JaZeichenfolge
startTimeDer Beginn des Datums-/Uhrzeitbereichs der Traffic-Daten im ISO 8601-Format in UTC-Zeit.JaZeichenfolge
endTimeDas Ende des Datums-/Uhrzeitbereichs der Traffic-Daten im ISO 8601-Format in UTC-Zeit.JaZeichenfolge
asinDie Amazon Standard Identification Number (ASIN) des Produkts.JaZeichenfolge
glanceViewsDie Anzahl der Kundenaufrufe der Produktdetailseite für diese ASIN.JaGanzzahl

Benachrichtigungsschema: DetailPageTrafficEventNotification

Beispiel für eine Benachrichtigung:

{ "notificationVersion": "2020-09-04", "notificationType": "DETAIL_PAGE_TRAFFIC_EVENT", "payloadVersion": "2020-09-04", "eventTime": "2023-02-07T16:05:32.378Z", "payload": { "detailPageTrafficEventNotifications": [ { "accountId": "amzn1.merchant.o.A21CXK3C4ERTY8", "marketplaceId": "ATVPDKIKX0DER", "startTime": "2023-02-07T15:00:00Z", "endTime": "2023-02-07T16:00:00Z", "asin": "B00032HE0O", "glanceViews": 42 }, { "accountId": "amzn1.merchant.o.A21CXK3C4ERTY8", "marketplaceId": "ATVPDKIKX0DER", "startTime": "2023-02-07T15:00:00Z", "endTime": "2023-02-07T16:00:00Z", "asin": "B00094A20U", "glanceViews": 69 } ] }, "notificationMetadata": { "applicationId": "amzn1.sellerapps.app.aacccfff-4455-4b7c-4422-664ecacdd336", "subscriptionId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746", "publishTime": "2023-02-07T16:45:32.378Z", "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746" } }

FBA_INVENTORY_AVAILABILITY_CHANGES

Verkäufer können diese Benachrichtigung abonnieren.

Die FBA_INVENTORY_AVAILABILITY_CHANGES-Benachrichtigung wird gesendet, wenn sich die Bestandsmengen von Versand durch Amazon (FBA) ändern. Diese Benachrichtigung enthält eine Momentaufnahme des FBA-Lagerbestands auf allen berechtigten Online-Marktplätzen in einer bestimmten Region.

Nutzladeschema: Version 1.0

Arbeitsablauf: Amazon Simple Queue Service-Arbeitsablauf

FBAInventoryAvailabilityChangeNotification

Die folgende Tabelle zeigt die Objekte und Eigenschaften des FBAInventoryAvailabilityChangeNotification-Objekts:

Name Beschreibung
SellerId

Die Verkäufer-ID.

Typ: Zeichenfolge

FNSKU

Die Versandnetzwerk-SKU des betroffenen Lagerbestandsartikels

Typ: Zeichenfolge

ASIN

Die Amazon-Standard-Identifikationsnummer des betroffenen Lagerbestandsartikels.

Typ: Zeichenfolge

SKU

Die Verkäufer-SKU des betroffenen Lagerbestandsartikels.

Typ: Zeichenfolge

FulfillmentInventoryByMarketplace

Eine Liste mit Details zum Lagerbestand für jeden Online-Marktplatz.

Typ: Reihe von FulfillmentInventoryDetails

FulfillmentInventoryDetails

Die folgende Tabelle beschreibt die Objekte und Eigenschaften eines FulfillmentInventoryDetails-Objekts:

Name Beschreibung
MarketplaceId

Die Online-Marktplatz-ID für das Ziel, an dem der betroffene Lagerbestand zum Versand der Bestellung verwendet werden kann.

Typ: Zeichenfolge

ItemName

Der Produkttitel des betroffenen Lagerbestandsartikels.

Typ: Zeichenfolge

FulfillmentInventory

Detail der Lagerbestandsverfügbarkeit des betroffenen Artikels.

Typ: FulfillmentInventory

Stores

A list of seller-enrolled stores that apply to this seller SKU.

Typ: Array mit einer Zeichenfolge

FulfillmentInventory

Die folgende Tabelle beschreibt die Objekte und Eigenschaften eines FulfillmentInventory-Objekts:

Name Beschreibung
InboundQuantityBreakdown

Details zu den eingehenden Einheiten des betroffenen Artikels, die entweder noch im Status WORKING oder auf dem Weg zur Annahme in Amazon-Lagerhäusern sind.

Typ: InboundQuantityBreakdown

Fulfillable

Die Anzahl der Einheiten des betroffenen Artikels, die zur Erfüllung von Bestellungen beim angegebenen Online-Marktplatz verwendet werden können.

Typ: int

Unfulfillable

Die Anzahl der Einheiten des betroffenen Artikels, die aufgrund des aktuellen Zustands des Artikels nicht zum Versand von Bestellungen verwendet werden können.

Typ: int

Researching

Anzahl der Einheiten des betroffenen Artikels, die derzeit aufgrund von Anpassungen untersucht werden.

Typ: int

ReservedQuantityBreakdown

Einzelheiten des Lagerbestands, der vorübergehend internen Prozessen unterzogen wird.

Typ: ReservedQuantityBreakdown

FutureSupplyBuyable

Die Anzahl der Einheiten, die Kunden finden und kaufen können, während der Lagerbestand über In-Stock Head Start auf dem Weg zu einem Amazon-Versandzentrum ist.

Typ: int

PendingCustomerOrderInTransit

Die Anzahl der Einheiten, die Kunden gekauft haben, während der Lagerbestand über In-Stock Head Start auf dem Weg zu einem Amazon-Versandzentrum ist.

Typ: int

InboundQuantityBreakdown

Die folgende Tabelle beschreibt die Objekte und Eigenschaften eines InboundQuantityBreakdown-Objekts:

Name Beschreibung
Working

Die Anzahl der Einheiten des betroffenen Artikels, die sich derzeit in einem WORKING-Lieferstatus befinden.

Typ: int

Shipped

Die Anzahl der Einheiten des betroffenen Artikels, die sich derzeit im Lieferstatus SHIPPED, IN_TRANSIT, DELIVERED oder CHECKED_IN befinden.

Typ: int

Receiving

Die Anzahl der Einheiten des betroffenen Artikels, die in Amazon-Lagerhäusern eingetroffen sind und derzeit in Bearbeitung sind.

Typ: int

ReservedQuantityBreakdown

Die folgende Tabelle beschreibt die Objekte und Eigenschaften eines ReservedQuantityBreakdown-Objekts:

Name Beschreibung
WarehouseProcessing

Die Anzahl der Einheiten des betroffenen Artikels, die vorübergehend zur internen Bearbeitung außer Acht gelassen wurden.

Typ: int

WarehouseTransfer

Die Anzahl der Einheiten des betroffenen Artikels, die derzeit an einen anderen Amazon-Lagerstandort umgeladen werden.

Typ: int

PendingCustomerOrder

Die Anzahl der Einheiten des betroffenen Artikels, die demnächst als Kundenbestellung versendet werden.

Typ: int

Benachrichtigungsschema: FBAInventoryAvailabilityChangeNotification.json

Beispiel für eine Benachrichtigung

{ "NotificationVersion": "1.0", "NotificationType": "FBA_INVENTORY_AVAILABILITY_CHANGES", "PayloadVersion": "1.0", "EventTime": "2020-07-13T19:42:04.284Z", "Payload": { "SellerId": "A3TH9S8BH6GOGM", "FNSKU": "X001ABCDEF", "ASIN": "B00001ABCD", "SKU": "SELLERSKU-1", "FulfillmentInventoryByMarketplace":[ { "MarketplaceId": "ATVPDKIKX0DER", "ItemName": "Product Title", "FulfillmentInventory": { "InboundQuantityBreakdown":{ "Working": 0, "Shipped": 5, "Receiving": 10 }, "Fulfillable": 50, "Unfulfillable":0, "Researching": 0, "ReservedQuantityBreakdown": { "WarehouseProcessing": 5, "WarehouseTransfer": 15, "PendingCustomerOrder": 10 }, "FutureSupplyBuyable":10, "PendingCustomerOrderInTransit":0 }, "Stores": [ "Low-Cost Store" ] }, { "MarketplaceId": "A2EUQ1WTGCTBG2", "ItemName": "Product Title", "FulfillmentInventory": { "InboundQuantityBreakdown":{ "Working": 1, "Shipped": 2, "Receiving": 3 }, "Fulfillable": 40, "Unfulfillable":0, "Researching": 0, "ReservedQuantityBreakdown": { "WarehouseProcessing": 5, "WarehouseTransfer": 15, "PendingCustomerOrder": 10 }, "FutureSupplyBuyable":0, "PendingCustomerOrderInTransit":0 }, "Stores": [ "Low-Cost Store" ] } ] }, "NotificationMetadata": { "ApplicationId": "app-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746", "SubscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746", "PublishTime": "2020-07-13T19:42:04.284Z", "NotificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746" } }

FBA_OUTBOUND_SHIPMENT_STATUS

Verkäufer können diese Benachrichtigung abonnieren.

Die FBA_OUTBOUND_SHIPMENT_STATUS-Benachrichtigung wird immer dann gesendet, wenn Amazon einen Versand durch Amazon -Versand für einen Verkäufer erstellt oder storniert. Diese Benachrichtigung gilt nur für Lieferungen vor Ort durch FBA. Diese Benachrichtigung ist nur auf dem brasilianischen Online-Marktplatz verfügbar.

Nutzladeschema: Version 1.0

Arbeitsablauf: Amazon Simple Queue Service-Arbeitsablauf

FBAOutboundShipmentStatusNotification

Die folgende Tabelle zeigt die Objekte und Eigenschaften des FBAOutboundShipmentStatusNotification-Objekts:

Name Beschreibung
SellerId

Die Verkäufer-ID.

Typ: Zeichenfolge

AmazonOrderId

Die von Amazon definierte Bestellungs-ID.

Typ: Zeichenfolge

AmazonShipmentId

Die von Amazon definierte Sendungsnummer.

Typ: Zeichenfolge

ShipmentStatus

Der Versandstatus. ShipmentStatus-Werte: Created, Cancelled.

Typ: Zeichenfolge

Benachrichtigungsschema: FBAOutboundShipmentStatusNotification.json

Beispiel für eine Benachrichtigung

{ "NotificationVersion": "1.0", "NotificationType": "FBA_OUTBOUND_SHIPMENT_STATUS", "PayloadVersion": "1.0", "EventTime": "2020-01-11T00:09:53.109Z", "Payload": { "FBAOutboundShipmentStatusNotification": { "SellerId": "merchantId", "AmazonOrderId": "113-2646096-4474645", "AmazonShipmentId": "DrLqQwqvb", "ShipmentStatus": "Created" } }, "NotificationMetadata": { "ApplicationId": "appId", "SubscriptionId": "subId", "PublishTime": "2020-01-11T00:02:50.501Z", "NotificationId": "requestId" } }

FEE_PROMOTION

Verkäufer können diese Benachrichtigung abonnieren.

Verkäufer, die die Verkaufspartner-API verwenden, können von zeitlich begrenzten, gebührenpflichtigen Rabattaktionen für Verkaufsgebühren profitieren. Um Benachrichtigungen über verfügbare kostenpflichtige Rabattaktionen für Verkaufsgebühren zu erhalten, müssen Verkäufer die FEE_PROMOTION-Benachrichtigung abonnieren. Wenn sich der Verkäufer zum ersten Mal für das Abonnement anmeldet und isEnabled auf true eingestellt ist, erhält der Verkäufer alle derzeit aktiven Aktionen. Jede Aktion wird als eine einzelne Nachricht gesendet. Nachfolgende Aktionsbenachrichtigungen werden gesendet, sobald die Aktion aktiv wird.

Die FEE_PROMOTION-Benachrichtigung besteht aus einer Reihe von Datenfeldern, in denen die Einzelheiten dieser Aktion beschrieben werden. Alle Qualifikationskriterien für jede Aktion werden in diesen Datenfeldern beschrieben.

Hinweis: Die geschätzten Gebühren, die von dieser API zurückgegeben werden, sind nicht garantiert. Die tatsächlichen Gebühren können variieren. Weitere Informationen zu Gebühren finden Sie unter Gebührenordnung für das Verkaufen bei Amazon und FBA-Funktionen und Gebühren auf Seller Central.

Nutzladeschema: Version 1.0

Arbeitsablauf: Amazon Simple Queue Service-Arbeitsablauf

FeeDetail

Die folgende Tabelle zeigt die Objekte und Eigenschaften des FeeDetail-Objekts:

Name Beschreibung Erforderlich Wert
FeeType Die Art der erhobenen Gebühren. Ja

Zulässige Gebührenarten: ReferralFee, VariableClosingFee, PerItemFee, FBAFees, FBAPickAndPack, FBAWeightHandling, FBAOrderHandling, FBADeliveryServicesFee.

Typ: Zeichenfolge

FeeAmount Der Gebührenbetrag, der der Gebührenart entspricht. Ja Typ: MoneyType
FeePromotion Der Betrag der Werbegebühr, der der Gebührenart entspricht. Nein Typ: MoneyType
TaxAmount Die Steuer, die über die Gebühr berechnet wird, die dem Verkäufer in Rechnung gestellt würde. Nein Typ: MoneyType
FinalFee Die endgültige Gebühr, die dem Verkäufer in Rechnung gestellt würde. Ja

FeeAmount abzüglich FeePromotion.

Typ: MoneyType

IncludedFees Eine strukturierte Liste von FeeDetail mit der Aufschlüsselung einer bestimmten Gebührenart. Nein Typ: Reihe von FeeDetail

FeesEstimate

Die folgende Tabelle zeigt die Objekte und Eigenschaften des FeesEstimate-Objekts:

NameBeschreibungErforderlichWert
TimeOfFeesEstimatedDas Datum, an dem die Gebühren geschätzt wurden.JaTyp: Zeichenfolge
TotalFeesEstimateDer Gesamtbetrag der Gebühren, wenn der Preis auf oder unter den Preisschwellenwert gesenkt wird.JaTyp: MoneyType
FeeDetailsEine Aufzählung von TotalFeesEstimate).JaTyp: Reihe von FeeDetail

FeePromotionNotification

Jedes FeePromotionNotification-Objekt besteht aus den folgenden Datenobjekten:

Name Beschreibung Erforderlich Wert
FeePromotionType Die Art der Werbeaktion. Ja

Werte: Pricing, SelectionASIN oder SelectionCategory. In Zukunft könnten weitere Typen verfügbar sein.

Typ: Zeichenfolge

FeePromotionTypeDescription Enthält weitere Informationen zum Zweck einer Werbeaktion. Nein

Eine freundliche, lokalisierte String-Beschreibung. Nützlich für Integratoren zur Anzeige auf einer Benutzeroberfläche.

Typ: Zeichenfolge

MarketplaceId Die Werbeaktion gilt für diese marketplaceId. Ja Typ: Zeichenfolge
MerchantId Die Werbeaktion gilt für diese merchantId. Ja Typ: Zeichenfolge
Identifiers Eine Liste der Artikel, für die diese Werbeaktion gilt. Ja Typ: Reihe von Identifier
PromotionActiveTimeRange Der Zeitraum, in dem diese Werbeaktion aktiv ist. Ja Typ: PromotionActiveTimeRange
PromotionInformation Ein Objekt, das zusätzliche Informationen über die Werbeaktion enthält. Falls zutreffend, ist eine Gebührenschätzung enthalten. Ja Typ: PromotionInformation

Identifier

In der folgenden Tabelle werden die Objekte und Eigenschaften eines Objekts aus dem Identifiers-Array:

Name Beschreibung Erforderlich Wert
IdentifierType Der Identifikationstyp des Verkaufspartners (Händlers), für den diese Werbeaktion gilt. Ja

Zum Beispiel: ASIN, SKU, Suchknoten, Marke.

Typ: Zeichenfolge

IdentifierValues Der benutzerfreundliche Name des ID-Werts. Ja

Zum Beispiel: die tatsächlichen ASINs oder SKUs des Verkaufspartners, eine tatsächliche Liste von Marken (wie Nike), eine tatsächliche Liste von Suchknoten.

Typ: Reihe von IndentifierValue

IdentifierValue

Eine Beschreibung der Identifikationswerte, für die diese Werbeaktion gilt.

Name Beschreibung Erforderlich Wert
IdentifierValueId Die tatsächliche Suchknoten-ID, die tatsächliche ASIN/SKU oder der Markenwert. Ja Typ: Zeichenfolge
IdentifierValueFriendlyName Die Identifikationswerte des Verkaufspartners (Händlers), für die diese Werbeaktion gilt. Nein Nur relevant/gefüllt für Dinge wie Suchknoten. Dies wäre beispielsweise der benutzerfreundliche Name eines Suchknotens.

Typ: Zeichenfolge

PromotionInformation

Die folgende Tabelle zeigt die Objekte und Eigenschaften des PromotionInformation-Objekts:

Name Beschreibung Erforderlich Wert
FeeType Die Gebührenart, die im Rahmen dieser Werbeaktion ermäßigt wird. Ja

Zulässige Gebührenarten: ReferralFee, VariableClosingFee, PerItemFee, FBAFees, FBAPickAndPack, FBAWeightHandling, FBAOrderHandling, FBADeliveryServicesFee.

Typ: Zeichenfolge

FeeDiscountType Die Art der Werbeaktion, die Sie für Ihre Gebühren erhalten. Ja

Entweder Fest, Rabatt oder Prozentpunktabzug.

Typ: Zeichenfolge

PriceThreshold Der qualifizierende Schwellenwert-Angebotspreis oder weniger, der erfüllt sein muss, damit die Werbeaktion gilt. Nein Typ: MoneyType
FeeDiscountMonetaryAmount Der Betrag, der von Ihren Gebühren abgezogen wird, wenn FeeDiscountType einen Geldbetrag beinhaltet. Nein

Wenn FeeDiscountType einen monetären Betrag beinhaltet, wird dieser Wert aufgefüllt.

Typ: MoneyType

FeeDiscountValue Der prozentuale Rabatt Ihrer Gebühren, wenn FeeDiscountType einen nicht monetären Betrag beinhaltet. Nein

Wenn FeeDiscountType einen nicht monetären Betrag beinhaltet, wird dieser Wert aufgefüllt.

Typ: Zahl

FeesEstimate Die geschätzte Gebühr für diese Werbeaktion, falls verfügbar. Bei der Schätzung wird davon ausgegangen, dass alle für die Werbeaktion erforderlichen Bedingungen erfüllt sind. Nein Typ: FeesEstimate

PromotionActiveTimeRange

Die folgende Tabelle zeigt die Eigenschaften des PromotionActiveTimeRange-Objekts an:

NameBeschreibungErforderlichWert
EffectiveFromDateDatum (einschließlich), an dem die Werbeaktion aktiv wird.JaTyp: Zeichenfolge
EffectiveThroughDateDatum (exklusiv), an dem die Werbeaktion beendet wurde.JaTyp: Zeichenfolge

Benachrichtigungsschema: FeePromotionNotification.json

Beispiel für eine Benachrichtigung

{ "NotificationVersion": "1.0", "NotificationType": "FEE_PROMOTION", "PayloadVersion": "1.0", "EventTime": "2020-01-11T00:09:53.109Z", "NotificationMetadata": { "ApplicationId": "amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5", "SubscriptionId": "7d78cc50-95c8-4641-add7-10af4b1fedc9", "PublishTime": "2020-01-11T00:02:50.501Z", "NotificationId": " 2012e8e5-b365-4cb1-9fd8-be9dfc6d5eaf" }, "Payload": { "FeePromotionNotification": { "MerchantId": "merchantId", "MarketplaceId": "marketplaceId1", "FeePromotionType": "Pricing", "FeePromotionTypeDescription": "To help you offer a lower price to customers, we are offering you a temporary referral fee discount for every sale when the total sale price (price + shipping + gift wrap) is at or below the pricing threshold.", "PromotionActiveTimeRange": { "EffectiveFromDate": "2016-05-04T22:24:39.615Z", "EffectiveThroughDate": "2016-04-28T02:45:12.786Z" }, "Identifiers": [ { "IdentifierType": "ASIN", "IdentifierValues": [ { "IdentifierValueId": "B0000000", "IdentifierValueFriendlyName": "1234" } ] } ], "PromotionInformations": [ { "FeeType": "ReferralFee", "FeeDiscountType": "Percentage points off", "FeeDiscountValue": 5, "PriceThreshold": { "Amount": 1, "CurrencyCode": "USD" }, "FeesEstimate": { "TimeOfFeesEstimated": "2016-05-05T22:24:39.635Z", "TotalFeesEstimate": { "Amount": 10, "CurrencyCode": "USD" }, "FeeDetails": [ { "FeeType": "feeType", "FeeAmount": { "Amount": 1, "CurrencyCode": "USD" }, "FeePromotion": { "Amount": 0.8, "CurrencyCode": "USD" }, "FinalFee": { "Amount": 0.2, "CurrencyCode": "USD" } } ] } } ] } } }

FEED_PROCESSING_FINISHED

Verkäufer und Anbieter können diese Benachrichtigung abonnieren.

Die FEED_PROCESSING_FINISHED-Benachrichtigung wird immer dann gesendet, wenn ein Feed, der über die Verkaufspartner-API für Feeds eingereicht wurde, einen Feed-Verarbeitungsstatus von DONE, CANCELLED oder FATAL erreicht.

Nutzladeschema: Version 1.0

Arbeitsablauf: Amazon Simple Queue Service-Arbeitsablauf

Die Benachrichtigung FEED_PROCESSING_FINISHED mit PayloadVersion=2020-09-04 enthält die folgenden Objekte im feedProcessingFinishedNotification-Objekt.

Name Beschreibung Type Erforderlich
accountId Die Händlerkunden-ID oder Lieferantengruppenkennung des Vertriebspartnerkontos, in dessen Namen der Feed eingereicht wurde. string Ja
sellerId Die Händlerkunden-ID des Vertriebspartnerkontos, in dessen Namen der Feed eingereicht wurde. Dieses Feld ist leer, wenn der Feed im Namen einer Lieferantengruppen-ID eingereicht wurde. string Nein
feedId Die ID für den Feed. string Ja
feedType Der Feed-Typ. Weitere Informationen finden Sie unter feedType-Werte. string Ja
processingStatus Den Verarbeitungsstatus des Feeds. string Ja
resultFeedDocumentId Die ID für das Feed-Dokument. Diese ID ist nur in Kombination mit einer Verkäufer-ID eindeutig. string Nein

Benachrichtigungsschema: FeedProcessingFinishedNotification.json

Beispiel für eine Benachrichtigung für Händler

{ "notificationVersion": "2020-09-04", "notificationType": "FEED_PROCESSING_FINISHED", "payloadVersion": "2020-09-04", "eventTime": "2020-07-13T19:42:04.284Z", "payload": { "feedProcessingFinishedNotification": { "sellerId": "A3TH9S8BH6GOGM", "accountId": "amzn1.merchant.o.A3TH9S8BH6GOGM", "feedId" : "53347018456", "feedType" : "POST_PRODUCT_DATA", "processingStatus" : "DONE", "resultFeedDocumentId": "amzn1.tortuga.3.edbcd0d8-3434-8222-1234-52ad8ade1208.URUTI57URI9BMZ" } }, "notificationMetadata": { "applicationId": "amzn1.sellerapps.app.aacccfff-44aa-4b7c-b42b-ed4ec98dd746", "subscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746", "publishTime": "2020-07-13T19:45:04.284Z", "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746" } }

Beispiel für eine Benachrichtigung für Anbieter

{ "notificationVersion": "2020-09-04", "notificationType": "FEED_PROCESSING_FINISHED", "payloadVersion": "2020-09-04", "eventTime": "2020-07-13T19:42:04.284Z", "payload": { "feedProcessingFinishedNotification": { "accountId": "amzn1.vg.6213651", "feedId" : "53347018456", "feedType" : "POST_PRODUCT_DATA", "processingStatus" : "DONE", "resultFeedDocumentId": "amzn1.tortuga.3.edbcd0d8-3434-8222-1234-52ad8ade1208.URUTI57URI9BMZ" } }, "notificationMetadata": { "applicationId": "amzn1.sellerapps.app.aacccfff-44aa-4b7c-b42b-ed4ec98dd746", "subscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746", "publishTime": "2020-07-13T19:45:04.284Z", "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746" } }

FULFILLMENT_ORDER_STATUS

Verkäufer können diese Benachrichtigung abonnieren.

Die Benachrichtigung FULFILLMENT_ORDER_STATUS wird immer gesendet, wenn sich der Status einer Multi-Channel -Versandbestellung ändert.

Nutzladeschema: Version 1.0

Arbeitsablauf: Amazon Simple Queue Service-Arbeitsablauf

FulfillmentOrderStatusNotification

Die folgende Tabelle zeigt die Objekte und Eigenschaften des FulfillmentOrderStatusNotification-Objekts:

Name Beschreibung
EventType

Gibt an, ob die Benachrichtigung Bestell-, Versand- oder Rücksendeinformationen enthält.

EventType Werte:

Order – Diese Benachrichtigung enthält Informationen über eine Versandbestellung.

Shipment – Diese Benachrichtigung enthält Informationen über eine Versandlieferung. Weitere Informationen finden Sie im FulfillmentShipment-Objekt.

Return – Diese Benachrichtigung enthält Informationen über die Rücksendung einer Versandlieferung.

Erforderlich

Typ: Zeichenfolge

SellerId

Die ID des Verkäufers.

Typ: Zeichenfolge

StatusUpdatedDateTime

Datum und Uhrzeit der letzten Aktualisierung des Status im ISO 8601-Format.

Erforderlich

Typ: Zeichenfolge

SellerFulfillmentOrderId

Die ID des Versandauftrags, die Sie mit dem CreateFulfillmentOrder-Vorgang erstellt und übermittelt haben.

Erforderlich

Typ: Zeichenfolge

FulfillmentOrderStatus

Der aktuelle Status der Versandbestellung.

FulfillmentOrderStatus Werte:

  • Received – Die Versandbestellung wurde empfangen und validiert. Die Validierung umfasst die Feststellung, ob die Zieladresse gültig ist und ob aus den Aufzeichnungen von Amazon hervorgeht, dass der Verkäufer über ausreichend verkaufbaren (unbeschädigten) Lagerbestand verfügt, um die Bestellung zu versenden. Der Verkäufer kann eine Versandbestellung, die den Status "Eingegangen" hat, stornieren.

  • Invalid – Die Versandbestellung wurde empfangen, konnte aber nicht bestätigt werden. Zu den Gründen hierfür gehören eine ungültige Zieladresse oder die Aufzeichnungen von Amazon, aus denen hervorgeht, dass der Verkäufer nicht über genügend verkaufbaren Lagerbestand verfügt, um die Bestellung abzuwickeln. In diesem Fall ist der Versandauftrag ungültig und es werden keine Artikel in der Bestellung versendet.

  • Planning – Die Versandbestellung wurde an das Amazon-Versandnetzwerk gesendet, um mit der Versandplanung zu beginnen, aber es wurde noch keine Einheit aus einer Sendung aus dem Lagerbestand entnommen. Der Verkäufer kann eine Versandbestellung, die den Status "In Planung" hat, stornieren.

  • Processing – Der Prozess der Entnahme von Einheiten aus dem Lagerbestand hat für mindestens eine Lieferung in der Versandbestellung begonnen. Der Verkäufer kann eine Versandbestellung, die den Status "In Bearbeitung" hat, nicht stornieren.

  • Cancelled – Der Versandauftrag wurde vom Verkäufer storniert.

  • Complete – Alle Artikelmengen im Versandauftrag wurden versandt.

  • CompletePartialled – Einige Artikelmengen im Versandauftrag wurden versandt. Die übrigen Artikel wurden entweder storniert oder waren nicht erfüllbar.

  • Unfulfillable – Keine Artikelmengen des Versandauftrags konnten versandt werden, da die Amazon-Logistikzentrum-Mitarbeiter entweder gar keine Bestände für diese Artikel gefunden haben oder keine, die in verkaufsfähigem (unbeschädigtem) Zustand waren.

Erforderlich

Typ: Zeichenfolge

FulfillmentShipment

Liefer- und Artikelinformationen für eine Sendung in einer Versandbestellung.

Optional. Wird nur zurückgegeben, wenn EventType Shipment ist.

Typ: FulfillmentShipment

FulfillmentReturnItem

Informationen zu einem Artikel, der an ein Amazon-Logistikzentrum zurückgesendet wurde.

Optional. Wird nur zurückgegeben, wenn EventType Return ist.

Typ: FulfillmentReturnItem

FulfillmentReturnItem

Die folgende Tabelle zeigt die Objekte und Eigenschaften des FulfillmentReturnItem-Objekts:

Name Beschreibung
ReceivedDateTime

Datum und Uhrzeit, an dem der zurückgesendete Artikel beim Amazon-Logistikzentrum eingegangen ist. Hat ein Datums- und Uhrzeitformat nach ISO 8601.

Erforderlich

Typ: Zeichenfolge

ReturnedQuantity

Die zurückgegebene Menge.

Erforderlich

Typ: Ganzzahl

SellerSKU

Die Verkäufer-SKU des Artikels.

Erforderlich

Typ: Zeichenfolge

FulfillmentShipment

Die folgende Tabelle zeigt die Objekte und Eigenschaften des FulfillmentShipment-Objekts:

Name Beschreibung
FulfillmentShipmentStatus

Der aktuelle Status der Sendung.

FulfillmentShipmentStatus-Werte:

  • Pending – Die Entnahme von Einheiten aus dem Lagerbestand hat begonnen.

  • Shipped – Alle Pakete der Sendung haben das Logistikzentrum verlassen.

  • CancelledByFulfiller – Das Amazon-Logistikzentrum konnte die Sendung nicht wie geplant versenden. Dies könnte daran liegen, dass sich der Lagerbestand nicht am erwarteten Standort im Logistikzentrum befand. Nach der Stornierung der Versandbestellung erstellt Amazon sofort eine neue Versandlieferung und versucht erneut, die Bestellung zu versenden.

  • CancelledBySeller – Die Sendung wurde mit dem Vorgang CancelFulfillmentOrder storniert.

Erforderlich

Typ: Zeichenfolge

AmazonShipmentId

Eine von Amazon zugewiesene Sendungsnummer.

Erforderlich

Typ: Zeichenfolge

EstimatedArrivalDateTime

Die geschätzte Ankunftszeit der Sendung im ISO 8601-Format für Datum und Uhrzeit. Beachten Sie, dass sich dieser Wert im Zeitverlauf ändern kann. Wenn eine Sendung mehr als ein Paket umfasst, gilt EstimatedArrivalDateTime für alle Pakete in der Sendung. Wenn die Sendung storniert wurde, wird EstimatedArrivalDateTime nicht zurückgegeben.

Erforderlich

Typ: Zeichenfolge

FulfillmentShipmentPackages

Enthält alle Pakete der Versandlieferung.

Optional

Typ: Reihe von FulfillmentShipmentPackage

FulfillmentShipmentPackage

Die folgende Tabelle zeigt die Objekte und Eigenschaften des FulfillmentShipmentPackage-Objekts:

Name Beschreibung
PackageNumber

Kennzeichnet ein Paket innerhalb einer Sendung.

Erforderlich

Typ: Ganzzahl

CarrierCode

Kennzeichnet das Transportunternehmen, das das Paket ausliefern wird.

Erforderlich

Typ: Zeichenfolge

TrackingNumber

Die Sendungsverfolgungsnummer, die zum Abrufen von Sendungsverfolgungs- und Lieferinformationen verwendet wird.

Erforderlich

Typ: Zeichenfolge

Benachrichtigungsschema: FulfillmentOrderStatusNotification.json

Beispiel für eine Benachrichtigung

{ "NotificationVersion": "1.0", "NotificationType": "FULFILLMENT_ORDER_STATUS", "PayloadVersion": "1.0", "EventTime": "2020-01-11T00:09:53.109Z", "Payload": { "FulfillmentOrderStatusNotification": { "SellerId": "merchantId", "EventType": "Shipment", "StatusUpdatedDateTime": "2020-01-11T00:09:53.109Z", "SellerFulfillmentOrderId": "OrderId", "FulfillmentOrderStatus": "Complete", "FulfillmentShipment": { "FulfillmentShipmentStatus": "Shipped", "AmazonShipmentId": "DZRSmwG2N", "EstimatedArrivalDateTime": "2014-12-19T22:59:59Z", "FulfillmentShipmentPackages": [ { "PackageNumber": 1, "CarrierCode": "HERMESIT", "TrackingNumber": "&0113838XXXXXX8300169397" } ] } } }, "NotificationMetadata": { "ApplicationId": "amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5", "SubscriptionId": "7d78cc50-95c8-4641-add7-10af4b1fedc9", "PublishTime": "2020-01-11T00:02:50.501Z", "NotificationId": " 2012e8e5-b365-4cb1-9fd8-be9dfc6d5eaf" } }

ITEM_INVENTORY_EVENT_CHANGE

Verkäufer und Anbieter können diese Benachrichtigung abonnieren.

Die ITEM_INVENTORY_EVENT_CHANGE-Benachrichtigung wird immer fünf Minuten nach der vollen Stunde gesendet. Diese Benachrichtigung enthält Lagerbestandsdaten auf ASIN-Ebene und umfasst Daten für die vorangegangene Stunde sowie alle verspäteten Daten von bis zu 24 Stunden zuvor. ASINs sind enthalten, wenn sich die Anzahl der zum Kauf verfügbaren Einheiten
nach Kunden geändert hat. Jede Benachrichtigung kann mehrere ASINs enthalten und ein Verkaufspartner kann damit rechnen, pro Stunde mehrere Benachrichtigungen zu erhalten.

Nutzladeschema: Version 1.0

Arbeitsablauf: Amazon Simple Queue Service-Arbeitsablauf

ItemInventoryEventChangeNotifications

NameBeschreibungErforderlichType
itemInventoryEventChangeNotificationsEine Liste der stündlichen detaillierten Kennzahlen nach ASIN.JaArray von ItemInventoryEventChangeNotification

ItemInventoryEventChangeNotification

NameBeschreibungErforderlichType
accountIdDie Händler-Kunden- oder Anbietergruppen-ID des Verkaufspartnerkontos, für das die Benachrichtigung übermittelt wurde.JaZeichenfolge
marketplaceIdDie Online-Marktplatz-ID der Lagerbestandsdaten.JaZeichenfolge
startTimeDer Beginn des Datums-/Uhrzeitbereichs der Lagerbestandsdaten im ISO 8601-Format in UTC-Zeit.JaZeichenfolge
endTimeDas Ende des Datums-/Uhrzeitbereichs der Lagerbestandsdaten im ISO 8601-Format in UTC-Zeit.JaZeichenfolge
asinDie Amazon Standard Identification Number (ASIN) des Produkts.JaZeichenfolge
highlyAvailableInventoryDie Anzahl der Einheiten, die auf der Website zum Verkauf verfügbar sind, basierend auf Einheiten in Amazon-Logistikzentren im verkaufbaren Zustand, abzüglich der Einheiten, die sich in den Einkaufswagen der Kunden befinden oder anderweitig für andere Bestellungen gebunden sind (z. B. Bestellungen von Spar-Abo-Kunden).JaGanzzahl

Benachrichtigungsschema: ItemInventoryEventChangeNotification

Beispiel für eine Benachrichtigung

{ "notificationVersion": "2020-09-04", "notificationType": "ITEM_INVENTORY_EVENT_CHANGE", "payloadVersion": "2020-09-04", "eventTime": "2023-02-07T16:05:32.378Z", "payload": { "itemInventoryEventChangeNotifications": [ { "accountId": "amzn1.merchant.o.A21CXK3C4ERTY8", "marketplaceId": "ATVPDKIKX0DER", "startTime": "2023-02-07T15:00:00Z", "endTime": "2023-02-07T16:00:00Z", "asin": "B00032HE0O", "highlyAvailableInventory": 650 }, { "accountId": "amzn1.merchant.o.A21CXK3C4ERTY8", "marketplaceId": "ATVPDKIKX0DER", "startTime": "2023-02-07T15:00:00Z", "endTime": "2023-02-07T16:00:00Z", "asin": "B00094A20U", "highlyAvailableInventory": 519 } ] }, "notificationMetadata": { "applicationId": "amzn1.sellerapps.app.aacccfff-4455-4b7c-4422-664ecacdd336", "subscriptionId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746", "publishTime": "2023-02-07T16:45:32.378Z", "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746" } }

ITEM_SALES_EVENT_CHANGE

Verkäufer und Anbieter können diese Benachrichtigung abonnieren.

Die Benachrichtigung ITEM_SALES_EVENT_CHANGE wird immer fünf Minuten nach Beginn der vollen Stunde gesendet. Diese Benachrichtigung enthält Verkaufsdaten auf ASIN-Ebene und umfasst Daten für die vorangegangene Stunde sowie alle verzögerten Daten von bis zu 24 Stunden zuvor. ASINs sind enthalten, wenn für sie Bestellungen oder Stornierungen während einer
gegebenen Stunde bestehen. Jede Benachrichtigung kann mehrere ASINs enthalten, und ein Verkaufspartner kann damit rechnen, mehrere Benachrichtigungen pro Stunde zu erhalten.

Nutzladeschema: Version 1.0

Arbeitsablauf: Amazon Simple Queue Service-Arbeitsablauf

ItemSalesEventNotifications

NameBeschreibungErforderlichType
itemSalesEventChangeNotificationsEine Liste der stündlichen detaillierten Verkaufsdaten nach ASIN.JaArray von ItemSalesEventChangeNotification

ItemSalesEventChangeNotification

NameBeschreibungErforderlichType
accountIdDie Händler-Kunden- oder Anbietergruppen-ID des Verkaufspartnerkontos, für das die Benachrichtigung übermittelt wurde.JaZeichenfolge
marketplaceIdDie Online-Marktplatz-ID der Verkaufsdaten.JaZeichenfolge
currencyCodeDer Währungscode aller Geldbeträge im ISO 4217-Format.JaZeichenfolge
startTimeDer Beginn des Datums-/Uhrzeitbereichs der Verkaufsdaten im ISO 8601-Format in UTC-Zeit.JaZeichenfolge
endTimeDas Ende des Datums-/Uhrzeitbereichs der Verkaufsdaten im ISO 8601-Format in UTC-Zeit.JaZeichenfolge
asinDie Amazon Standard Identification Number (ASIN) des Produkts.JaZeichenfolge
orderedUnitsDie Anzahl der Einheiten, die von Amazon-Kunden im angegebenen Zeitraum bestellt wurden. Diese Zahl kann negativ sein, wenn es mehr Stornierungen als Bestellungen gibt.JaGanzzahl
orderedRevenueDer Verkauf bestellter Produkte im angegebenen Zeitraum. Bei Stornierungen werden Anpassungen vorgenommen.JaAnzahl

Benachrichtigungsschema: ItemSalesEventChangeNotification

Beispiel für eine Benachrichtigung

{ "notificationVersion": "2020-09-04", "notificationType": "ITEM_SALES_EVENT_CHANGE", "payloadVersion": "2020-09-04", "eventTime": "2023-02-07T16:05:32.378Z", "payload": { "itemSalesEventChangeNotifications": [ { "accountId": "amzn1.merchant.o.A21CXK3C4ERTY8", "marketplaceId": "ATVPDKIKX0DER", "currencyCode": "USD", "startTime": "2023-02-07T15:00:00Z", "endTime": "2023-02-07T16:00:00Z", "asin": "B00032HE0O", "orderedUnits": 9, "orderedRevenue": 80.91 }, { "accountId": "amzn1.merchant.o.A21CXK3C4ERTY8", "marketplaceId": "ATVPDKIKX0DER", "currencyCode": "USD", "startTime": "2023-02-07T15:00:00Z", "endTime": "2023-02-07T16:00:00Z", "asin": "B00094A20U", "orderedUnits": 5, "orderedRevenue": 527.60 } ] }, "notificationMetadata": { "applicationId": "amzn1.sellerapps.app.aacccfff-4455-4b7c-4422-664ecacdd336", "subscriptionId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746", "publishTime": "2023-02-07T16:45:32.378Z", "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746" } }

ITEM_PRODUCT_TYPE_CHANGE

Verkäufer können diese Benachrichtigung abonnieren.

Amazon sendet die ITEM_PRODUCT_TYPE_CHANGE-Benachrichtigung, wenn sich der Produkttyp eines Artikels ändert, zu dem der Verkaufspartner eine Markenbeziehung unterhält. Ein Verkaufspartner unterhält eine Markenbeziehung zu einem Artikel, wie im Amazon-Programm für registrierte Marken definiert, wenn er ein verifizierter Markeninhaber ist. Der Verkaufspartner ist die Partei, die eine Anwendung autorisiert, in seinem Namen die Benachrichtigungs-API aufzurufen, um Benachrichtigungsabonnements zu erstellen und zu verwalten. Amazon sendet ITEM_PRODUCT_TYPE_CHANGE-Benachrichtigungen für Artikel, die auf einem Amazon-Online-Marktplatz angeboten werden.

Nutzladeschema: Version 1.0

Arbeitsablauf: Amazon EventBridge-Arbeitsablauf

Eine ITEM_PRODUCT_TYPE_CHANGE-Benachrichtigung mit PayloadVersion=1.0 enthält die folgenden Objekte im Payload-Objekt.

ObjektBeschreibung
MarketplaceIdDer Online-Marktplatz, bei dem der Artikel angeboten wird.
AsinDie ASIN des Artikels.
PreviousProductTypeDer vorherige Produkttyp.
CurrentProductTypeDer aktuelle Produkttyp.

Benachrichtigungsschema: ItemProductTypeChangeNotification.json

Beispiel für eine Benachrichtigung

{ "NotificationVersion":"1.0", "NotificationType":"ITEM_PRODUCT_TYPE_CHANGE", "PayloadVersion":"1.0", "EventTime":"2019-03-20T18:59:30.194Z", "Payload":{ "MarketplaceId": "ATVPDKIKX0DER", "Asin": "B1234567", "PreviousProductType": "PET_HEALTH_CARE", "CurrentProductType": "PET_APPAREL" }, "NotificationMetadata":{ "ApplicationId":"amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5", "SubscriptionId":"93b098e1-c42-2f45-93a1-78910a6a8369", "PublishTime":"2019-03-20T18:59:48.768Z", "NotificationId":"0e999936-da2c-4f9c-9fc2-02b67bae5f49" } }

LISTINGS_ITEM_STATUS_CHANGE

Verkäufer können diese Benachrichtigung abonnieren.

Amazon sendet die LISTINGS_ITEM_STATUS_CHANGE-Benachrichtigung, wenn sich der Status eines Angebotsartikels für einen Verkaufspartner ändert. LISTINGS_ITEM_STATUS_CHANGE-Benachrichtigungen werden veröffentlicht, wenn ein Angebotsartikel erstellt oder gelöscht wird oder wenn sich sein Käuflichkeitsstatus ändert. Die Nutzdaten der Benachrichtigungen enthalten die aktuellen Informationen zu den Angebotsartikeln und deren Status. Amazon sendet LISTINGS_ITEM_STATUS_CHANGE-Benachrichtigungen für Artikel, die auf einem beliebigen Amazon-Online-Marktplatz angeboten werden.

Um zugehörige Informationen zu dem Angebot zu erhalten, z. B. über Probleme mit Angebotsartikeln, rufen Sie die Verkaufspartner-API für Angebotsartikel auf. Weitere Informationen finden Sie im Anwendungsfall-Leitfaden für die Angebotsartikel-API.

Der Verkaufspartner ist die Partei, die eine App dafür autorisiert, die Benachrichtigungs-API in ihrem Namen aufzurufen, um Benachrichtigungsabonnements zu erstellen und zu verwalten.

Nutzladeschema: Version 1.0

Arbeitsablauf: Amazon EventBridge-Arbeitsablauf

Die LISTINGS_ITEM_STATUS_CHANGE-Benachrichtigung mit PayloadVersion=1.0 enthält die folgenden Objekte im Payload-Objekt.

Name Beschreibung Type Erforderlich
SellerID Verkaufspartner-ID, wie z. B. ein Verkaufspartner- (Händler-)Konto, des betroffenen Angebotsartikels. string Ja
MarketplaceId Amazon-Online-Marktplatz-ID des betroffenen Angebotsartikels. string Nein
Asin Die ASIN (Amazon Standard Identification Number) des Katalogartikels mit Verknüpfung zum Angebotsartikel. string Nein
Sku ID des betroffenen Angebotsartikels. string Ja
CreatedDate Zeitstempel der Erstellung des Angebotsartikels als Datum/Uhrzeit im ISO 8601-Format. string Nein
Status Liste der Statuszustände, die aktuell mit dem betroffenen Angebotsartikel verknüpft sind. Das Fehlen eines Werts bedeutet, dass der Statuszustand aktuell nicht auf den Angebotsartikel zutrifft. Ist z. B. BUYABLE nicht vorhanden, so ist der Angebotsartikel aktuell nicht käuflich. Array von ListingsItemStatus Ja

ListingsItemStatus

Diese Tabelle zeigt die möglichen Werte für ListingsItemStatus:

NameBeschreibung
BUYABLEZeigt an, dass der Angebotsartikel auf der Amazon-Einzelhandelswebsite für den entsprechenden Amazon-Online-Marktplatz käuflich ist. Ist er angegeben, so ist der Angebotsartikel käuflich. Ist er nicht aufgeführt, so ist der Angebotsartikel nicht käuflich.
DISCOVERABLEZeigt an, dass der zugehörige Amazon-Katalogartikel (ASIN) in den Suchergebnissen auf der Amazon-Einzelhandelswebsite für den entsprechenden Amazon-Online-Marktplatz auffindbar ist. Ist er angegeben, so ist der Angebotsartikel auffindbar. Ist er nicht aufgeführt, ist der Angebotsartikel nicht auffindbar.
DELETEDIst er angegeben, so ist der Angebotsartikel gelöscht. Ist er nicht aufgeführt, ist der Angebotsartikel nicht gelöscht.

Benachrichtigungsschema: ListingsItemStatusChangeNotification.json

Beispiel für eine Benachrichtigung

{ "NotificationVersion":"1.0", "NotificationType":"LISTINGS_ITEM_STATUS_CHANGE", "PayloadVersion":"1.0", "EventTime":"2021-02-03T18:59:30.194Z", "Payload":{ "SellerId": "AXXXXXXXXXXXXX", "MarketplaceId": "ATVPDKIKX0DER", "Asin": "BT6RZ7JM4H", "Sku": "NLS-SHOES-03", "CreatedDate": "2021-02-03T18:50:26.196Z", "Status": [ "BUYABLE", "DISCOVERABLE" ] }, "NotificationMetadata":{ "ApplicationId":"amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5", "SubscriptionId":"93b098e1-c42-2f45-93a1-78910a6a8369", "PublishTime":"2021-02-03T18:59:30.194Z", "NotificationId":"0e999936-da2c-4f9c-9fc2-02b67bae5f49" } }

LISTINGS_ITEM_ISSUES_CHANGE

Verkäufer und Anbieter können diese Benachrichtigung abonnieren.

Amazon sendet eine LISTINGS_ITEM_ISSUES_CHANGE-Benachrichtigung bei jeder Änderung an den Fehlerbeschreibungen im Zusammenhang mit einem Angebotsartikel, den der Verkaufspartner besitzt. Fehlerbeschreibungen weisen auf Probleme im Zusammenhang mit dem Angebotsartikel hin, die zur Inaktivierung des Angebots, zur Unterdrückung der Suche oder zu anderen Qualitätsproblemen führen. Wenn das Produktbild des Verkaufspartners beispielsweise eine niedrige Auflösung hat, bewirkt diese Fehlerbeschreibung, dass die Suche nach diesem Produkt unterdrückt wird. Amazon sendet LISTINGS_ITEM_ISSUES_CHANGE-Benachrichtigungen für Angebotsartikel auf allen Amazon-Online-Marktplätzen.

LISTINGS_ITEM_ISSUES_CHANGE-Benachrichtigungen werden ausgelöst, wenn eine Fehlerbeschreibung zu einem Angebot erstellt, behoben oder aktualisiert wird. Die Benachrichtigungsnutzlast umfasst grundlegende Informationen zum Angebot, den Schweregrad für die Fehlerbeschreibung und die durch die Fehlerbeschreibung ausgelösten Durchsetzungsmaßnahmen. Genauere Informationen zu Fehlerbeschreibungen im Zusammenhang mit einem Angebot finden Sie unter Verkaufspartner-API für Angebotsartikel. Zusätzliche Informationen finden Sie im Anwendungsfall-Leitfaden für die Angebotsartikel-API.

Für keines der Probleme, die mit einem Angebot auftreten können, existieren entsprechende definierte Fehlerbeschreibungen. Aus diesem Grund stellt diese Benachrichtigung nicht unbedingt alle möglichen Probleme im Zusammenhang mit einem Angebot dar (ebensowenig die Verkaufspartner-API für Angebotsartikel). Amazon arbeitet an der Definition von weiteren Fehlerbeschreibungen, die die möglichen Probleme im Zusammenhang mit Angeboten genauer darstellen.

Der Verkaufspartner ist die Partei, die eine App dafür autorisiert, die Benachrichtigungs-API in ihrem Namen aufzurufen, um Benachrichtigungsabonnements zu erstellen und zu verwalten.

Derzeit LISTINGS_ITEM_ISSUES_CHANGE Notification unterstützt zwei Payload-Versionen: “2023-12-13”, und “1.0”. “2023-12-13” ist neuer als “1.0”. “2023-12-13” hat mehr “EnforcementActions” als “1.0”, das weitere Informationen zu den Auswirkungen von Problemen mit dem Angebotsartikel enthält. Zum Beispiel “LISTING_SUPPRESSED” Durch Durchsetzungsmaßnahmen wird die Kaufbarkeit des aktuellen Artikels beeinträchtigt. Bitte abonnieren Sie oder migrieren Sie auf eine neuere Version “2023-12-13”, und “1.0” Version wird bald veraltet sein.

Nutzladeschema: Version 2023-12-13

Arbeitsablauf: Amazon EventBridge-Arbeitsablauf

Die Benachrichtigung LISTINGS_ITEM_ISSUES_CHANGE mit PayloadVersion=2020-09-04 enthält die folgenden Objekte im Payload-Objekt.

Name Beschreibung Type Erforderlich
SellerId Verkaufspartner-ID, z. B. ein Verkaufspartner- (Händler-)Konto oder ein Händlercode, des betroffenen Angebotsartikels. string Ja
MarketplaceId Amazon-Online-Marktplatz-ID des betroffenen Angebotsartikels. string Nein
Asin Die ASIN (Amazon Standard Identification Number) des Katalogartikels mit Verknüpfung zum Angebotsartikel. string Nein
Sku ID des betroffenen Angebotsartikels. string Ja
Severities Liste der Schweregrade für die Fehlerbeschreibungen im Zusammenhang mit dem betroffenen Angebotsartikel. Wenn keine Fehlerbeschreibungen den Artikel des Angebots betreffen, wird stattdessen NONE angegeben. Array von IssueSeverity Ja
EnforcementActions Liste der Durchsetzungsmaßnahmen, die Amazon im Zusammenhang mit den Problemen im Zusammenhang mit dem betroffenen Angebotsartikel ergriffen hat. Aktuell mögliche Werte:
  • LISTING_SUPPRESSED - Durch diese Durchsetzung wird die Kaufbarkeit des aktuellen Artikels beeinträchtigt.

  • ATTRIBUTE_SUPPRESSED - Der Wert eines Attributs auf dem Angebotsartikel ist ungültig, weshalb er von Amazon abgelehnt wird.

  • CATALOG_ITEM_REMOVED - Dieser Katalogartikel ist bei Amazon inaktiv und alle Angebote, die auf der entsprechenden Marketplace-Site gegen ihn angeboten werden, können nicht gekauft werden.

  • SEARCH_SUPPRESSED - Dieser Wert gibt an, dass das Katalogelement in den Suchergebnissen ausgeblendet ist.

Array von Zeichenfolgen Nein

IssueSeverity

Diese Tabelle zeigt die möglichen Werte für IssueSeverity:

NameBeschreibung
ERRORFalls angegeben, mindestens ein Problem mit ERROR Es ist ein Schweregrad aufgetreten, das die Verarbeitung der Einreichung verhindert, z. B. ein Validierungsfehler.
WARNINGFalls angegeben, mindestens ein Problem mit WARNING Es ist ein Schweregrad aufgetreten, das überprüft werden sollte, der die Bearbeitung der Einreichung jedoch nicht verhindert hat.
NONEWenn angegeben, gibt es keine definierten Fehlerbeschreibungen, die den Angebotsartikel betreffen. Es können jedoch andere Probleme mit dem Angebot vorliegen.

Benachrichtigungsschema: ListingsItemIssuesChangeNotification_2023-12-13.json

Beispiel für eine Benachrichtigung

{ "NotificationVersion":"1.0", "NotificationType":"LISTINGS_ITEM_ISSUES_CHANGE", "PayloadVersion":"2023-12-13", "EventTime":"2021-02-03T18:59:30.194Z", "Payload":{ "SellerId": "AXXXXXXXXXXXXX", "MarketplaceId": "ATVPDKIKX0DER", "Asin": "BT6RZ7JM4H", "Sku": "NLS-SHOES-03", "Severities": [ "ERROR", "WARNING" ], "EnforcementActions": [ "SEARCH_SUPPRESSED", "LISTING_SUPPRESSED", "ATTRIBUTE_SUPPRESSED", "CATALOG_ITEM_REMOVED" ] }, "NotificationMetadata":{ "ApplicationId":"amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5", "SubscriptionId":"93b098e1-c42-2f45-93a1-78910a6a8369", "PublishTime":"2021-02-03T18:59:30.194Z", "NotificationId":"0e999936-da2c-4f9c-9fc2-02b67bae5f49" } }

LISTINGS_ITEM_ISSUES_CHANGE Nutzdatenschema: Version 1.0

Die LISTINGS_ITEM_ISSUES_CHANGE-Benachrichtigung mit PayloadVersion=1.0 enthält die folgenden Objekte im Payload-Objekt.

Name Beschreibung Type Erforderlich
SellerId Verkaufspartner-ID, z. B. ein Verkaufspartner- (Händler-)Konto oder ein Händlercode, des betroffenen Angebotsartikels. string Ja
MarketplaceId Amazon-Online-Marktplatz-ID des betroffenen Angebotsartikels. string Nein
Asin Die ASIN (Amazon Standard Identification Number) des Katalogartikels mit Verknüpfung zum Angebotsartikel. string Nein
Sku ID des betroffenen Angebotsartikels. string Ja
Severities Liste der Schweregrade für die Fehlerbeschreibungen im Zusammenhang mit dem betroffenen Angebotsartikel. Wenn keine Fehlerbeschreibungen den Artikel des Angebots betreffen, wird stattdessen NONE angegeben. Array von IssueSeverity Ja
EnforcementActions Liste der Durchsetzungsmaßnahmen, die Amazon aufgrund der Fehlerbeschreibungen im Zusammenhang mit dem betroffenen Angebotsartikel ergriffen hat. Array von IssueEnforcementActions Nein

IssueSeverity

Diese Tabelle zeigt die möglichen Werte für IssueSeverity:

NameBeschreibung
ERRORFalls angegeben, mindestens ein Problem mit ERROR Es ist ein Schweregrad aufgetreten, das die Verarbeitung der Einreichung verhindert, z. B. ein Validierungsfehler.
WARNINGFalls angegeben, mindestens ein Problem mit WARNING Es ist ein Schweregrad aufgetreten, das überprüft werden sollte, der die Bearbeitung der Einreichung jedoch nicht verhindert hat.
NONEWenn angegeben, gibt es keine definierten Fehlerbeschreibungen, die den Angebotsartikel betreffen. Es können jedoch andere Probleme mit dem Angebot vorliegen.

IssueEnforcementActions

Diese Tabelle zeigt die möglichen Werte für IssueEnforcementActions:

NameBeschreibung
SEARCH_SUPPRESSEDWenn angegeben, wird der Angebotsartikel aufgrund von mindestens einer Fehlerbeschreibung, die aktuell mit dem betroffenen Angebotsartikel verknüpft ist, in den Suchergebnissen unterdrückt.

Benachrichtigungsschema: ListingsItemIssuesChangeNotification.json

Beispiel für eine Benachrichtigung

{ "NotificationVersion":"1.0", "NotificationType":"LISTINGS_ITEM_ISSUES_CHANGE", "PayloadVersion":"1.0", "EventTime":"2021-02-03T18:59:30.194Z", "Payload":{ "SellerId": "AXXXXXXXXXXXXX", "MarketplaceId": "ATVPDKIKX0DER", "Asin": "BT6RZ7JM4H", "Sku": "NLS-SHOES-03", "Severities": [ "ERROR", "WARNING" ], "EnforcementActions": [ "SEARCH_SUPPRESSED" ] }, "NotificationMetadata":{ "ApplicationId":"amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5", "SubscriptionId":"93b098e1-c42-2f45-93a1-78910a6a8369", "PublishTime":"2021-02-03T18:59:30.194Z", "NotificationId":"0e999936-da2c-4f9c-9fc2-02b67bae5f49" } }

LISTINGS_ITEM_MFN_QUANTITY_CHANGE

Verkäufer können diese Benachrichtigung abonnieren.

Amazon sendet eine LISTINGS_ITEM_MFN_QUANTITY_CHANGE-Benachrichtigung an einen Integrator oder Verkäufer, wann immer sich die verfügbare Menge für den Angebotsartikel mit Versand durch den Verkäufer (MFN) ändert. Die verfügbare Menge ist die Anzahl der Einheiten, die für Kunden bei Amazon zur Bestellung verfügbar sind. Wenn ein Kunde eine Bestellung aufgibt, subtrahiert Amazon die Anzahl der bestellten Einheiten von der verfügbaren Menge für diesen Angebotsartikel. Wenn die verfügbare Menge Null erreicht, können Kunden den Artikel nicht mehr bestellen. Verkaufspartner informieren Amazon in der Regel über die genaue Anzahl der in ihrem Bestand verfügbaren Einheiten, damit Kunden Bestellungen aufgeben können.

Die verfügbare Menge für einen Angebotsartikel ändert sich aufgrund verschiedener Faktoren, z. B. aufgrund von Aktualisierungen der Lagerbestandsmenge durch den Verkaufspartner, durch die Aufgabe neuer Bestellungen oder die Stornierung vorhandener Bestellungen. Mit dieser Benachrichtigung müssen Verkaufspartner mit Abonnement nicht mehr ständig den Verkaufspartner-getListingsItem-Vorgang oder die Bestellungs-API aufrufen, um die letzte verfügbare Menge abzurufen.

Die wichtigsten Merkmale dieser Benachrichtigung sind:

  • Die Verkaufspartner bleiben über den aktuellen Lagerbestand auf dem Laufenden, der bei Amazon verfügbar ist.
  • Die Verkaufspartner planen auf Grundlage des Lagerbestands voraus, um die Nachfrage nach ihren Angebotsartikeln zu decken.
  • Die Verkaufspartner synchronisieren und aktualisieren den Lagerbestand ihrer Angebotsartikel mit ihren internen Systemen und über ihre anderen Vertriebskanäle hinweg.
  • Die Verkaufspartner müssen nicht regelmäßig den Lagerbestandsbericht abfragen oder den Verkaufspartner-getListingsItem-Vorgang aufrufen, um die verfügbare Menge zu ermitteln.

Nutzladeschema: Version 1.0

Arbeitsablauf: Amazon EventBridge-Arbeitsablauf

Die Benachrichtigung LISTINGS_ITEM_MFN_QUANTITY_CHANGE mit PayloadVersion=1.0 enthält die folgenden Eigenschaften im Objekt Payload.

Name Beschreibung Type Erforderlich
SellerId Das Händler-Token des Verkaufspartners, dem der Angebotsartikel gehört. string Ja
FulfillmentChannelCode Der Versandkanalcode, der das Programm für den MFN-Versand (Versand durch Verkäufer), das Netzwerk oder den Kanal angibt, für das/den die Menge gilt. string Ja
Sku Eine vom Verkaufspartner angegebene ID für einen Amazon-Angebotsartikel. string Ja
Quantity Die Anzahl der bei Amazon verfügbaren Einheiten. Ganzzahl Ja

Benachrichtigungsschema: ListingsItemMfnQuantityChange.json

Beispiel für eine Benachrichtigung

{ "NotificationVersion": "1.0", "NotificationType": "LISTINGS_ITEM_MFN_QUANTITY_CHANGE", "PayloadVersion": "1.0", "EventTime": "2021-02-03T18:59:30.194Z", "Payload": { "SellerId": "AXXXXXXXXXXXXX", "FulfillmentChannelCode": "DEFAULT", "Sku": "NLS-SHOES-03", "Quantity": 99 }, "NotificationMetadata": { "ApplicationId": "amzn1.sellerapps.app.f108f511-eeac-46a6-b125-bcb752069ed0", "SubscriptionId": "93b098e1-c42-2f45-93a1-78910a6a8369", "PublishTime": "2021-02-03T18:59:30.194Z", "NotificationId": "8e009934-da2c-4f9c-9bc7-93f23b7e1f60" } }

ORDER_CHANGE

Verkäufer können diese Benachrichtigung abonnieren.

Die ORDER_CHANGE-Benachrichtigung wird bei jeder wichtigen Änderung an der Bestellung gesendet. Zu den wichtigen Änderungen gehören Änderungen des Bestellstatus und vom Käufer angeforderte Stornierungen.

Diese Benachrichtigung unterstützt den folgenden eventFilter-Wert: orderChangeTypes. Um diesen Filter verwenden zu können, müssen Sie außerdem den folgenden eventFilterType angeben: "eventFilterType": "ORDER_CHANGE".

Weitere Informationen finden Sie unter Verarbeitungsrichtlinien.

Nutzladeschema: Version 1.0

Arbeitsablauf: Amazon Simple Queue Service-Arbeitsablauf

Die ORDER_CHANGE-Benachrichtigung mit PayloadVersion=1.0 enthält die folgenden Eigenschaften im OrderNotification-Objekt.

Name Beschreibung Type Erforderlich
NotificationLevel Die Benachrichtigungsebene der aktuellen Benachrichtigung. string Ja
SellerId Die ID des Verkaufspartners. string Ja
AmazonOrderId Eine von Amazon definierte Bestell-ID im 3-7-7-Format. string Ja
OrderChangeType Die Art der Bestellungsänderung, die das Versenden der Benachrichtigung ausgelöst hat. Mögliche Werte sind BuyerRequestedChange und OrderStatusChange. string Ja
OrderChangeTrigger Details zu den Gründen für das Versenden der ORDER_CHANGE-Benachrichtigung. OrderChangeReason Ja
Summary Informationen zur Bestellung und zu den Bestellartikeln, an denen die Änderung eingetreten ist. OrderChangeSummary Ja

OrderChangeReason

Name Beschreibung Type Erforderlich
TimeOfOrderChange Die Uhrzeit der Änderung, die diese Benachrichtigung ausgelöst hat, im Datums-/Uhrzeitformat nach ISO 8601. Der Wert ist Null, wenn es keinen zugehörigen Zeitstempel gibt. string Ja
ChangeReason Der Grund für das Versenden der Benachrichtigung ORDER_CHANGE. string Ja

OrderChangeSummary

Name Beschreibung Type Erforderlich
MarketplaceID Die Amazon-Online-Marktplatz-ID der Bestellung. string Ja
OrderStatus Der aktuelle Bestellstatus. Zu den möglichen Werten gehören UpComing, Pending, Unshipped, PartiallyShipped, PendingAvailability, Canceled, InvoiceUnconfirmed, Shipped und Unfulfillable. string Ja
PurchaseDate Das Kaufdatum der Bestellung im Datums-/Uhrzeitformat nach ISO 8601. Der Wert ist Null, wenn keine zugehörigen Informationen vorhanden sind. string Ja
DestinationPostalCode Die Postleitzahl der Zieladresse. Der Wert ist Null, wenn es keine zugehörigen Informationen gibt. string Ja
FulfillmentType Die Versandart der betroffenen Bestellung, MFN oder AFN. string Ja
OrderType Die Art der Bestellung. string Ja
NumberOfItemsShipped Die Anzahl der versendeten Artikel. Ganzzahl Nein
NumberOfItemsUnshipped Die Anzahl der noch nicht versendeten Artikel. Ganzzahl Nein
EarliestDeliveryDate Der Beginn des Zeitraums, für den Sie sich verpflichtet haben, die Bestellung zu versenden, im Datums-/Uhrzeitformat nach ISO 8601. Wird nur für Bestellungen zurückgegeben, die vom Verkäufer versendet werden. string Nein
LatestDeliveryDate Das Ende des Zeitraums, für den Sie sich verpflichtet haben, die Bestellung zu versenden, im Datums-/Uhrzeitformat nach ISO 8601. Wird nur für Bestellungen zurückgegeben, die vom Verkäufer versendet werden und die nicht den Status PendingAvailability, Pending oder Canceled haben. string Nein
EarliestShipDate Der Beginn des Zeitraums, für den Sie sich verpflichtet haben, die Bestellung zu versenden, im Datums-/Uhrzeitformat nach ISO 8601. string Nein
LatestShipDate Das Ende des Zeitraums, für den Sie sich verpflichtet haben, die Bestellung zu versenden, im Datums-/Uhrzeitformat nach ISO 8601. string Nein
CancelNotifyDate Das Ende des Zeitraums, in dem Sie den Verkäufer über eine mögliche Stornierung informieren müssen, im Datums-/Uhrzeitformat nach ISO 8601. string Nein
OrderPrograms Die Bestellprogramme, zu denen diese Bestellung gehört. Reihe von Zeichenketten Nein
ShippingPrograms Die Versandprogramme, zu denen diese Bestellung gehört. Reihe von Zeichenketten Nein
EasyShipShipmentStatus Der Status der Amazon Easy Ship-Bestellung. Diese Eigenschaft ist nur bei Amazon Easy Ship-Bestellungen enthalten. string Nein
ElectronicInvoiceStatus Der Status der elektronischen Rechnung. string Nein
OrderItems Informationen zu den in dieser Bestellung enthaltenen Bestellartikeln. Bei OrderItemLevel-Benachrichtigungen enthält eine Nutzlast einen Artikel. Bei OrderLevel-Benachrichtigungen enthält eine Nutzlast alle Artikel. Array von OrderItem Ja

OrderItem

Name Beschreibung Type Erforderlich
OrderItemId Die von Amazon festgelegte Bestellartikel-ID. string Ja
SellerSKU Die verkäuferspezifische SKU für einen Artikel. string Ja
SupplySourceId Die eindeutige Kennung der Lieferquelle. Der Wert ist Null, wenn es keine zugehörigen Informationen gibt. string Ja
OrderItemStatus Der aktuelle Status des Bestellartikels. Dieses Feld hat einen Wert ungleich Null, wenn der Status der Artikel unterschiedlich ist. string Nein
Quantity Die Anzahl der Artikel in der Bestellung. Ganzzahl Ja
QuantityShipped Die Anzahl der versendeten Artikel. Ganzzahl Nein
IsBuyerRequestedCancel Ist wahr, wenn der Käufer eine Stornierung angefordert hat. boolesch Nein
ItemEarliestDeliveryDate Der Beginn des Zeitraums, für den Sie sich verpflichtet haben, die Bestellung zu versenden. string Nein
ItemLatestDeliveryDate Das Ende des Zeitraums, für den Sie sich verpflichtet haben, die Bestellung zu versenden. string Nein

Benachrichtigungsschema: OrderChangeNotification.json

Beispiel für eine Benachrichtigung

{ "NotificationVersion" : "1.0", "NotificationType" : "ORDER_CHANGE", "PayloadVersion" : "1.0", "EventTime" : "2020-01-11T00:09:53.109Z", "Payload" : { "OrderChangeNotification": { "NotificationLevel": "OrderLevel", "SellerId": "A3TH9S8BH6GOGM", "AmazonOrderId": "903-8868176-2219830", "OrderChangeType": "BuyerRequestedChange", "OrderChangeTrigger": { "TimeOfOrderChange": "2022-11-29T19:42:04.284Z", "ChangeReason": "Buyer Requested Cancel" }, "Summary": { "MarketplaceId": "ATVPDKIKX0DER", "OrderStatus": "Unshipped", "PurchaseDate": "2022-07-13T19:42:04.284Z", "DestinationPostalCode": "48110", "FulfillmentType": "MFN", "OrderType": "StandardOrder", "NumberOfItemsShipped": 0, "NumberOfItemsUnshipped": 10, "EarliestDeliveryDate": "2022-11-07T19:42:04.284Z", "LatestDeliveryDate": "2022-12-07T19:42:04.284Z", "EarliestShipDate": "2022-11-07T19:42:04.284Z", "LatestShipDate": "2022-12-07T19:42:04.284Z", "CancelNotifyDate": "2022-12-07T19:42:04.284Z", "OrderPrograms": ["Business"], "ShippingPrograms": ["EasyShip"], "EasyShipShipmentStatus": "Delivered", "ElectronicInvoiceStatus": "NotFound", "OrderItems": [ { "OrderItemId": "OIID34853450", "SellerSKU": "SellerSKUID1", "SupplySourceId": "d7679e14-031b-4ab3-a81b-ec4fc7a460b3", "OrderItemStatus": "Unshipped", "Quantity": 10, "QuantityShipped": 0, "IsBuyerRequestedCancel": true, "ItemEarliestDeliveryDate": "2022-11-07T19:42:04.284Z", "ItemLatestDeliveryDate": "2022-12-07T19:42:04.284Z" } ] } } }, "NotificationMetadata" : { "ApplicationId": "app-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746", "SubscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746", "PublishTime": "2020-07-13T19:42:04.284Z", "NotificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746" } }

PRICING_HEALTH

Verkäufer können diese Benachrichtigung abonnieren.

Die PRICING_HEALTH-Benachrichtigung wird versendet, wenn ein Verkäuferangebot aufgrund eines nicht wettbewerbsfähigen Preises nicht für ein hervorgehobenes Angebot berechtigt ist ({{1}}-Angebot). Verkäufer können Maßnahmen ergreifen, um die Berechtigung für ein hervorgehobenes Angebot wiederherzustellen, indem sie den Gesamtpreis des Angebots (Preis zuzüglich Versandkosten abzüglich Punkte) so anpassen, dass er dem wettbewerbsfähigen Preis entspricht oder darunter liegt oder den angegebenen Referenzpreisen entspricht. Dazu gehören der Preis des hervorgehobenen Angebots, der durchschnittliche Verkaufspreis von 60 Tagen, der höchste 14-Tage-Preis (Versand und Verkauf durch Amazon) und der Listenpreis. Um für ein hervorgehobenes Angebot berechtigt zu sein, muss die Preisgestaltung wettbewerbsfähig sein und auch weitere Qualifizierungskriterien erfüllen, die darauf abzielen, Kunden ein hervorragendes Einkaufserlebnis zu bieten. Das umfasst sehr gute Preise, Verfügbarkeit und Liefergeschwindigkeit. Das hervorgehobene Angebot ist das Angebot, das ausgewählt wird, wenn der Kunde auf der Produktdetailseite die Schaltfläche In den Einkaufswagen wählt.

Nutzladeschema: Version 1.0

Arbeitsablauf: Amazon Simple Queue Service-Arbeitsablauf

Die PRICING_HEALTH-Benachrichtigung mit payloadVersion=1.0 enthält die folgenden Eigenschaften im Payload-Objekt.

Name Beschreibung
issueType Das Thema für die Benachrichtigung.

Erforderlich.

Typ: Zeichenfolge

sellerId Die Verkäufer-ID für das Angebot.

Erforderlich.

Typ: Zeichenfolge

offerChangeTrigger Das Ereignis, das dazu geführt hat, dass die Benachrichtigung gesendet wurde.

Erforderlich.

Typ: offerChangeTrigger

merchantOffer Angebotsdetails des Verkaufspartners (Händlers), der die Benachrichtigung erhält.

Erforderlich.

Typ: merchantOffer

summary Informationen zu dem Artikel, für den das Angebot geändert wurde. Die Informationen in dieser Zusammenfassung gelten für alle Zustände des Produkts.

Erforderlich.

Typ: summary

buyBoxPrice

Die folgende Tabelle zeigt die Objekte und Eigenschaften des buyBoxPrice-Objekts:

Name Beschreibung
condition

Zeigt den Zustand des Artikels an.

Erforderlich.

Typ: Zeichenfolge

landedPrice

Der listingPrice zzgl. Versand.

Erforderlich.

Typ: moneyType

listingPrice

Der Preis des Artikels.

Erforderlich.

Typ: moneyType

shipping

Die Versandkosten.

Erforderlich.

Typ: moneyType

points

Die Anzahl der Amazon-Punkte, die beim Kauf eines Artikels angeboten werden.

Optional.

Typ: points

merchantOffer

Die folgende Tabelle zeigt die Objekte und Eigenschaften des merchantOffer-Objekts:

Name Beschreibung
condition Zeigt den Zustand des Artikels an.

Erforderlich.

Typ: Zeichenfolge

fulfillmentType Gibt an, ob der Artikel von Amazon oder vom Verkäufer versendet wird.

Erforderlich.

Typ: Zeichenfolge

landedPrice Der listingPrice zzgl. Versand.

Erforderlich.

Typ: moneyType

listingPrice Der Preis des Artikels.

Erforderlich.

Typ: moneyType

shipping Die Versandkosten.

Erforderlich.

Typ: Zeichenfolge

points Die Anzahl der Amazon-Punkte, die beim Kauf eines Artikels angeboten werden.

Optional.

Hinweis: Das Points-Objekt wird nur in Japan (JP) zurückgegeben.

Typ: points

offerChangeTrigger

Die folgende Tabelle zeigt die Objekte und Eigenschaften des offerChangeTrigger-Objekts:

Name Beschreibung
marketplaceId Die Online-Marktplatz-ID des Artikels, für den eine Angebotsänderung vorgenommen wurde.

Erforderlich.

Typ: Zeichenfolge

asin Die ASIN für den Artikel, für den eine Angebotsänderung vorgenommen wurde.

Erforderlich.

Typ: Zeichenfolge

itemCondition Der Zustand des Artikels, für den eine Angebotsänderung vorgenommen wurde.

Erforderlich.

Typ: Zeichenfolge

timeOfOfferChange Die Aktualisierungszeit für das Angebot, das diese Benachrichtigung verursacht hat.

Optional.

Typ: Zeichenfolge

offerCount

Die folgende Tabelle zeigt die Objekte und Eigenschaften des offerCount-Objekts:

Name Beschreibung
condition

Zeigt den Zustand des Artikels an.

Erforderlich.

Typ: Zeichenfolge

fulfillmentType

Gibt an, ob der Artikel von Amazon oder vom Verkäufer versendet wird.

Erforderlich.

Typ: Zeichenfolge

offerCount

Die Gesamtzahl der Angebote für den angegebenen Zustand und den angegebenen Versandkanal.

Erforderlich.

Typ: Ganzzahl

points

Die folgende Tabelle zeigt die Objekte und Eigenschaften des points-Objekts:

Name Beschreibung
pointsNumber

Die Anzahl der Amazon-Punkte, die beim Kauf eines Artikels angeboten werden.

Erforderlich.

Typ: Ganzzahl

referencePrice

Die folgende Tabelle zeigt die Objekte und Eigenschaften des referencePrice-Objekts:

Name Beschreibung
averageSellingPrice

Der durchschnittliche Verkaufspreis des Artikels.

Optional.

Typ: moneyType

competitivePriceThreshold

Die wettbewerbsfähige Preisschwelle auf Grundlage der Produkte externer Wettbewerber von Amazon.

Optional.

Typ: moneyType

retailOfferPrice

Der höchste Einzelhandelspreis im Verlauf von 14 Tagen.

Optional.

Typ: moneyType

msrpPrice

Der unverbindliche Verkaufspreis des Herstellers für die ASIN.

Optional.

Typ: moneyType

salesRank

Die folgende Tabelle zeigt die Objekte und Eigenschaften des salesRank-Objekts:

Name Beschreibung
productCategoryId

Die Produktkategorie für den Rang.

Erforderlich.

Typ: Zeichenfolge

rank

Der Verkaufsrang der ASIN.

Erforderlich.

Typ: Ganzzahl

summary

Die folgende Tabelle zeigt die Objekte und Eigenschaften des summary-Objekts:

Name Beschreibung
numberOfOffers

Eine Liste, die die Gesamtzahl der Angebote für den Artikel für die angegebenen Bedingungen und Versandkanäle enthält.

Erforderlich.

Typ: Array von offerCount

buyBoxEligibleOffers

Eine Liste, die die Gesamtzahl der Angebote enthält, die für den {{0}} für die angegebenen Zustände und Versandkanäle berechtigt sind.

Erforderlich.

Typ: Array von offerCount

buyBoxPrices

Eine Liste, die den {{0}}-Preis des Artikels für die angegebenen Zustände enthält.

Optional.

Typ: Array von buyBoxPrice

salesRankings

Eine Liste, die die Verkaufsränge der ASIN in verschiedenen Produktkategorien enthält.

Optional.

Typ: Array von salesRank

referencePrice

Eine Reihe von Referenzpreisen für die angegebene ASIN.

Erforderlich.

Typ: referencePrice

Benachrichtigungsschema: PricingHealthNotification.json

Beispiel für eine Benachrichtigung

{ "notificationVersion": "1.0", "notificationType": "PRICING_HEALTH", "payloadVersion": "1.0", "eventTime": "2020-09-23T21:30:13.713Z", "payload": { "issueType": "BuyBoxDisqualification", "sellerId": "A3EZFOFNDPFB8R", "offerChangeTrigger": { "marketplaceId": "ATVPDKIKX0DER", "asin": "B007IBIWZY", "itemCondition": "new", "timeOfOfferChange": "2020-09-23T21:30:13.409Z" }, "merchantOffer": { "condition": "new", "fulfillmentType": "MFN", "listingPrice": { "amount": 8184.23, "currencyCode": "USD" }, "shipping": { "amount": 4.49, "currencyCode": "USD" }, "landedPrice": { "amount": 8188.72, "currencyCode": "USD" }, "points": { "pointsNumber": 34343 } }, "summary": { "numberOfOffers": [ { "condition": "new", "fulfillmentType": "MFN", "offerCount": 3 } ], "buyBoxEligibleOffers": [ { "condition": "new", "fulfillmentType": "MFN", "offerCount": 3 } ], "buyBoxPrices": [ { "condition": "new", "listingPrice": { "amount": 8184.23, "currencyCode": "USD" }, "shipping": { "amount": 4.49, "currencyCode": "USD" }, "landedPrice": { "amount": 8188.72, "currencyCode": "USD" }, "points": { "pointsNumber": 34343 } } ], "salesRankings": [ { "productCategoryId": "lawn_and_garden_display_on_website", "rank": 4013 }, { "productCategoryId": "home_garden_display_on_website", "rank": 17316 } ], "referencePrice": { "averageSellingPrice": { "amount": 7500, "currencyCode": "USD" }, "competitivePriceThreshold": { "amount": 8000, "currencyCode": "USD" }, "msrpPrice": { "amount": 7900, "currencyCode": "USD" }, "retailOfferPrice": { "amount": 8000, "currencyCode": "USD" } } } }, "notificationMetadata": { "applicationId": "amzn1.sellerapps.app.1da85d14-a68d-4ff3-9ff0-df6429e00d9a", "subscriptionId": "e3a059ca-677a-442a-8d39-05b2848971b6", "publishTime": "2020-09-23T21:30:16.903Z", "notificationId": "23ae41cd-3537-4676-af46-6ee9abf8802e" } }

PRODUCT_TYPE_DEFINITIONS_CHANGE

Verkäufer und Anbieter können diese Benachrichtigung abonnieren.

Die PRODUCT_TYPE_DEFINITIONS_CHANGE-Benachrichtigung wird gesendet, wenn es einen neuen Produkttyp oder eine neue Produkttypversion gibt.

Wenn die Benachrichtigung durch das Hinzufügen eines oder mehrerer neuer Produkttypen auf einem Online-Marktplatz ausgelöst wird, enthält die Benachrichtigungsnutzlast die Namen der neuen Produkttypen und die für diese Produkttypen geltende Produkttypversion.

Wenn die Benachrichtigung nur durch eine neue Produkttypversion ausgelöst wird, stellt die Benachrichtigungsnutzlast die neue Produkttypversion bereit.

Weitere Informationen zu Produkttypen finden Sie im Anwendungsfall-Leitfaden für die API für Produkttypdefinitionen.

Nutzladeschema: Version 1.0

Arbeitsablauf: Amazon EventBridge-Arbeitsablauf

Die Benachrichtigung PRODUCT_TYPE_DEFINITIONS_CHANGE mit PayloadVersion=1.0 enthält die folgenden Eigenschaften im Objekt Payload.

Name Beschreibung Type Erforderlich
AccountId Die Verkaufspartner-ID, z. B. ein Verkaufspartner- (Händler-)Konto oder eine Anbietergruppen-ID. string Ja
MarketplaceId Amazon-Online-Marktplatz-ID des betroffenen Produkttyps oder der betroffenen Produkttypversion. string Nein
ProductTypeVersion Version der neu veröffentlichten Amazon-Produkttypdefinition. string Ja
NewProductTypes Liste der Produkttypen, die auf einem Online-Marktplatz eingeführt wurden. Array von Zeichenfolgen Nein

Benachrichtigungsschema: ProductTypeDefinitionsChangeNotification.json

Beispiel für eine Benachrichtigung

Beispiel 1: Benachrichtigung mit neuen Produkttypen

{ "NotificationVersion":"1.0", "NotificationType":"PRODUCT_TYPE_DEFINITIONS_CHANGE", "PayloadVersion":"1.0", "EventTime":"2021-02-03T18:59:30.194Z", "Payload":{ "AccountId": "AXXXXXXXXXXXXX", "MarketplaceId": "ATVPDKIKX0DER", "ProductTypeVersion": "Uyp-Z6z_y2HhQD2x8sDBXkRAuxBqBionr", "NewProductTypes":[ "LUGGAGE", "SHOES", ] }, "NotificationMetadata":{ "ApplicationId":"amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5", "SubscriptionId":"93b098e1-c42-2f45-93a1-78910a6a8369", "PublishTime":"2021-02-03T18:59:30.194Z", "NotificationId":"0e999936-da2c-4f9c-9fc2-02b67bae5f49" } }

Beispiel 2: Benachrichtigung über Änderung der Produkttypversion

{ "NotificationVersion":"1.0", "NotificationType":"PRODUCT_TYPE_DEFINITIONS_CHANGE", "PayloadVersion":"1.0", "EventTime":"2021-02-03T18:59:30.194Z", "Payload":{ "AccountId": "AXXXXXXXXXXXXX", "ProductTypeVersion": "Uyp-Z6z_y2HhQD2x8sDBXkRAuxBqBionr" }, "NotificationMetadata":{ "ApplicationId":"amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5", "SubscriptionId":"93b098e1-c42-2f45-93a1-78910a6a8369", "PublishTime":"2021-02-03T18:59:30.194Z", "NotificationId":"0e999936-da2c-4f9c-9fc2-02b67bae5f49" } }

REPORT_PROCESSING_FINISHED

Verkäufer und Anbieter können diese Benachrichtigung abonnieren.

Die REPORT_PROCESSING_FINISHED-Benachrichtigung wird immer gesendet, wenn ein Bericht, den Sie über die Verkaufspartner-API für Berichte angefordert haben, den Berichtsverarbeitungsstatus DONE, CANCELLED oder FATAL erreicht.

Nutzladeschema: Version 1.0

Arbeitsablauf: Amazon Simple Queue Service-Arbeitsablauf

Die REPORT_PROCESSING_FINISHED-Benachrichtigung mit PayloadVersion=2020-09-04 enthält die folgenden Objekte im reportProcessingFinishedNotification-Objekt.

Name Beschreibung Type Erforderlich
accountId Die Händlerkunden-ID oder Lieferantengruppenkennung des Vertriebspartnerkontos, in dessen Namen der Bericht eingereicht wurde. string Ja
sellerId Die Händlerkunden-ID des Vertriebspartnerkontos, in dessen Namen der Feed eingereicht wurde. Dieses Feld ist leer, wenn der Feed im Namen einer Lieferantengruppen-ID eingereicht wurde. string Nein
reportId Die Kennung des Berichts. string Ja
reportType Der Berichtstyp. Weitere Informationen finden Sie unter reportType-Werte. string Ja
processingStatus Der Verarbeitungsstatus des Berichts. string Ja
reportDocumentId Die Kennung für das Berichtsdokument. Diese Kennung ist nur in Kombination mit einer Verkäufer-ID eindeutig. string Nein

Benachrichtigungsschema: ReportProcessingFinishedNotification.json

Beispiel für eine Benachrichtigung für Händler

{ "notificationVersion": "2020-09-04", "notificationType": "REPORT_PROCESSING_FINISHED", "payloadVersion": "2020-09-04", "eventTime": "2020-07-14T03:35:13.214Z", "payload": { "reportProcessingFinishedNotification": { "sellerId": "A3TH9S8BH6GOGM", "accountId": "amzn1.merchant.o.A3TH9S8BH6GOGM", "reportId": "54517018502", "reportType": "GET_FLAT_FILE_ACTIONABLE_ORDER_DATA", "processingStatus": "CANCELLED", "reportDocumentId": "amzn1.tortuga.3.edbcd0d8-3434-8222-1234-52ad8ade1208.REP4567URI9BMZ" } }, "notificationMetadata": { "applicationId": "amzn1.sellerapps.app.aacccfff-4455-4b7c-4422-664ecacdd336", "subscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746", "publishTime": "2020-07-13T19:45:04.284Z", "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746" } }

Beispiel für eine Benachrichtigung für Anbieter

{ "notificationVersion": "2020-09-04", "notificationType": "REPORT_PROCESSING_FINISHED", "payloadVersion": "2020-09-04", "eventTime": "2020-07-14T03:35:13.214Z", "payload": { "reportProcessingFinishedNotification": { "accountId": "amzn1.vg.6213651", "reportId": "54517018502", "reportType": "GET_FLAT_FILE_ACTIONABLE_ORDER_DATA", "processingStatus": "CANCELLED", "reportDocumentId": "amzn1.tortuga.3.edbcd0d8-3434-8222-1234-52ad8ade1208.REP4567URI9BMZ" } }, "notificationMetadata": { "applicationId": "amzn1.sellerapps.app.aacccfff-4455-4b7c-4422-664ecacdd336", "subscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746", "publishTime": "2020-07-13T19:45:04.284Z", "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746" } }

TRANSACTION_UPDATE

Verkäufer können diese Benachrichtigung abonnieren.

Das TRANSACTION_UPDATE Eine Benachrichtigung wird gesendet, wenn eine neue Transaktion auf dem Konto des Verkäufers gebucht wird.

Nutzladeschema: Version 1.0

Arbeitsablauf: Amazon Simple Queue Service-Arbeitsablauf

Die TRANSACTION_UPDATE-Benachrichtigung mit payloadVersion=1.0=1.0 enthält die folgenden Eigenschaften im TransactionUpdateNotification-Objekt.

NameBeschreibungType
SellingPartnerMetadataMetadaten, die den Verkäufer beschreiben.SellingPartnerMetadata
RelatedIdentifiersIdentifiers related to the transaction, such as order and shipment IDs.< RelatedIdentifier > Array
TransactionTypeDie Art der Transaktion.string
PostedDateDatum und Uhrzeit der Buchung der Transaktion.Datum
TotalAmountDer Gesamtbetrag der Transaktion.Currency

SellingPartnerMetadata

NameBeschreibungType
SellingPartnerIdEine eindeutige Verkäufer-ID.string
AccountTypeDie Art des Kontos in der Transaktion.string
MarketplaceIdDie ID der Marketplace-Site, auf der die Transaktion stattgefunden hat.string

RelatedIdentifier

NameBeschreibungType
RelatedIdentifierNameEine aufgezählte Gruppe verwandter Unternehmensbezeichnernamen.string
RelatedIdentifierValueEntsprechender Wert von RelatedIdentifierNamestring

Currency

NameBeschreibungType
CurrencyAmountDer monetäre Wert.int
CurrencyCodeDer dreistellige Währungscode im ISO-4217-Format.string

Benachrichtigungsschema: TransactionUpdateNotification.json

Beispiel für eine Benachrichtigung:

{ "NotificationVersion": "1.0", "NotificationType": "TRANSACTION_UPDATE", "PayloadVersion": "1.0", "EventTime": "2023-07-14T03:35:13.214Z", "NotificationMetadata": { "ApplicationId": "amzn1.sellerapps.app.aacccfff-4455-4b7c-4422-664ecacdd336", "SubscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746", "PublishTime": "2020-07-14T03:35:13.214Z", "NotificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746" }, "Payload": { "TransactionUpdateNotification": { "SellingPartnerMetadata": { "SellingPartnerId": "A3TH9S8BH6GOGM", "MarketplaceId": "ATIV93840DER", "AccountType": "PAYABLE" }, "RelatedIdentifiers": [ { "RelatedIdentifierName": "OrderId", "RelatedIdentifierValue": "8129762527551" } ], "TransactionType": "Shipment", "PostedDate": "2020-07-14T03:35:13.214Z", "TotalAmount": { "CurrencyAmount": 10, "CurrencyCode": "USD" } } } }

Häufig vorkommende Typen

Enthält allgemeine Typen, die von allen Benachrichtigungen verwendet werden, die in den Objekten der Benachrichtigungsnutzlast enthalten sind.

FulfillmentChannelType

Gibt an, ob der Artikel von Amazon oder vom Verkäufer versendet wird.

Typ: Zeichenfolge

FulfillmentChannelType Werte:

  • Amazon

  • Merchant

moneyType

Art und Betrag der Währung.

Die folgende Tabelle zeigt die Eigenschaften des MoneyType-Objekts an:

Name Beschreibung
amount

Der Währungsbetrag.

Typ: Zahl

currencyCode

Dreistelliger Währungscode. In Format nach ISO 4217.

Typ: Zeichenfolge

MoneyType

Art und Betrag der Währung.

Die folgende Tabelle zeigt die Eigenschaften des MoneyType-Objekts an:

Name Beschreibung
Amount

Der Währungsbetrag.

Typ: Zahl

CurrencyCode

Dreistelliger Währungscode. In Format nach ISO 4217.

Typ: Zeichenfolge


Hat Ihnen diese Seite weitergeholfen?