学无先后达者为师!
不忘初心,砥砺前行。

亚马逊 SP-API 中的通知类型列表(一)

您可以使用通知类型值订阅销售伙伴 API 通知。根据您希望接收的通知类型选择相应的通知类型值。

ACCOUNT_STATUS_CHANGED

卖家可以订阅此通知。

当开发者订阅的销售伙伴/市场对的帐户状态发生变化时,`ACCOUNT_STATUS_CHANGED` 通知会被发送。每当销售伙伴的帐户状态在 `NORMAL`、`AT_RISK` 和 `DEACTIVATED` 之间变化时,都会发布通知。

负载模式:版本 2021-01-01

工作流:Amazon Simple Queue Service 工作流

以下表格显示了 `accountStatusChangeNotification` 对象的属性:

名称描述
previousAccountStatus卖家帐户状态的更新前状态。
必填。
类型:字符串
可能值:`NORMAL`、`AT_RISK`、`DEACTIVATED`
currentAccountStatus卖家帐户的新状态。
必填。
类型:字符串
可能值:`NORMAL`、`AT_RISK`、`DEACTIVATED`

通知模式:AccountStatusChangedNotification.json

通知示例:





{
  "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

 卖家可以订阅此通知。

此通知支持以下的 eventFilter 值:aggregationSettingsmarketplaceIds。要使用这些过滤器,您还必须提供以下内容:
eventFilterType: "eventFilterType": "ANY_OFFER_CHANGED"

有关更多信息,请参考 处理指令

ANY_OFFER_CHANGED 通知会在以下情况发生时发送:任何前 20 名商品的报价发生变化,无论是新商品还是二手商品;或者您销售的商品的外部价格(来自其他零售商的价格)发生变化;或者赢得 BuyBox 的报价发生变化;或者 BuyBox 的价格发生变化。前 20 名商品是根据落地价格来确定的,落地价格是商品价格加运费减去亚马逊积分。如果多个卖家收取相同的落地价格,结果将以随机顺序返回。

只有在您有活动报价的商品上,您才会收到 ANY_OFFER_CHANGED 通知。您不能订阅没有活动报价的商品的通知。

有效负载架构:版本 1.0

工作流程:Amazon Simple Queue Service 工作流

下表显示了 AnyOfferChangedNotification 对象的属性:

名称描述
SellerId报价的卖家标识符。
必需。
类型:字符串
OfferChangeTrigger触发通知发送的事件。必需。类型:OfferChangeTrigger
Summary关于报价变化的商品的信息。此摘要中的信息适用于该商品的所有条件。
必需。
类型:Summary
Offers触发通知的商品和条件的前 20 名竞争性报价。
必需。
类型:Offer 数组

BuyBoxPrice

以下表格显示了 `BuyBoxPrice` 对象的各个字段和属性:

名称描述
LandedPriceListingPrice + ShippingPoints
必填。
类型:MoneyType
ListingPrice商品的价格。
必填。
类型:MoneyType
Shipping运费。
必填。
类型:MoneyType
Points购买商品时提供的 Amazon 积分数量。
可选。
备注:Points 仅在日本(JP)返回。
类型:Points
Condition表示商品的状态。例如:`New`、`Used`、`Collectible`、`Refurbished` 或 `Club`。
必填。
类型:字符串

LowestPrice

以下表格显示了 `LowestPrice` 对象的各个字段和属性:

名称描述
LandedPriceListingPrice + ShippingPoints
必填。
类型:MoneyType
ListingPrice商品的价格。
必填。
类型:MoneyType
Shipping运费。
必填。
类型:MoneyType
Points购买商品时提供的 Amazon 积分数量。
可选。
备注:Points 仅在日本(JP)返回。
类型:Points
Condition表示商品的状态。例如:`New`、`Used`、`Collectible`、`Refurbished` 或 `Club`。
必填。
类型:字符串
FulfillmentChannel表示商品是否由亚马逊或卖家履行。
必填。
类型:FulfillmentChannelType

Offer

以下表格显示了 `Offer` 对象的各个字段和属性:

名称描述
SellerId卖家的标识符。
必填。
类型:字符串
SubCondition商品的子条件。例如:`New`、`Mint`、`Very Good`、`Good`、`Acceptable`、`Poor`、`Club`、`Ocode`、`Warranty`、`Refurbished Warranty`、`Refurbished`、`Open Box` 或 `Other`。
必填。
类型:字符串
SellerFeedbackRating关于卖家反馈的信息,包括正面反馈的百分比和收到的总反馈数量。
可选。
类型:SellerFeedbackRating
ShippingTime在订单下达后,商品可能被发货的最小和最大时间,以小时为单位。
必填。
类型:ShippingTime
ListingPrice商品的价格。
必填。
类型:MoneyType
Points购买商品时提供的 Amazon 积分数量。
可选。
备注:Points 仅在日本(JP)返回。
类型:Points
Shipping运费。
必填。
类型:MoneyType
ShipsFrom商品发货的州和国家。
可选。
类型:ShipsFrom
IsFulfilledByAmazon表示该商品是否由亚马逊履行。
必填。
类型:布尔值
IsBuyBoxWinner表示该商品是否当前在 Buy Box 中。每个 ASIN 每次最多可以有两个 Buy Box 获胜者,一个是符合 Prime 的,一个不是符合 Prime 的。
可选。
类型:布尔值
ConditionNotes关于商品状况的信息。
可选。
类型:字符串
PrimeInformationAmazon Prime 信息。
可选。
类型:PrimeInformation
IsExpeditedShippingAvailable表示是否提供加急运输。
可选。
类型:布尔值
IsFeaturedMerchant表示该商品的卖家是否有资格赢得 Buy Box。
可选。
类型:布尔值
ShipsDomestically表示该商品是否可以国内配送。
可选。
类型:布尔值

OfferChangeTrigger

以下表格展示了 `OfferChangeTrigger` 对象的属性:

名称描述
MarketplaceId发生报价变更的商品的市场标识符。
必填。
类型:字符串
ASIN发生报价变更的商品的 ASIN。
必填。
类型:字符串
ItemCondition发生报价变更的商品的状态。例如,如果是二手商品的报价变更,`Offers` 对象中的报价数组将仅包含二手商品。`Summary` 对象提供了其他可用于重新定价的状态的总结。
必填。
类型:字符串
TimeOfOfferChange导致此通知的报价更新时间,采用 ISO 8601 格式。
必填。
类型:字符串
OfferChangeType更改并触发此通知的报价类型。
`OfferChangeType` 的值:

`External` – `Summary` 对象中的 `CompetitivePriceThreshold` 发生了变化,由非亚马逊卖家的新报价触发。
`Internal` – 亚马逊零售网站上的报价价格发生了变化。
`Featured Offer` – 购物车买家或购物车价格发生了变化。
必填。
类型:字符串

OfferCount

以下表格展示了 `OfferCount` 对象的属性:

名称描述
Condition表示商品的状态。例如:`New`(全新)、`Used`(二手)、`Collectible`(收藏品)、`Refurbished`(翻新)或 `Club`。
必填。
类型:字符串
FulfillmentChannel表示商品是由亚马逊履行还是由卖家履行。
必填。
类型:`FulfillmentChannelType`
OfferCount指定状态和履行渠道的报价总数。
必填。
类型:整数

Points

以下表格展示了 `Points` 对象的属性:

名称描述
PointsNumber购买商品时提供的亚马逊积分数量。
必填。
类型:整数

PrimeInformation

以下表格展示了 `PrimeInformation` 对象的属性:

名称描述
IsOfferNationalPrime指示该优惠是否是亚马逊 Prime 优惠,适用于其列出的整个市场。
必填。
类型:布尔值
IsOfferPrime指示该优惠是否是亚马逊 Prime 优惠。
必填。
类型:布尔值

SalesRank

以下表格展示了 `SalesRank` 对象的属性:

名称描述
ProductCategoryId商品的产品类别标识符。
必填。
类型:字符串
Rank该商品在给定产品类别中的销售排名。
必填。
类型:整数

SellerFeedbackRating

以下表格展示了 `SellerFeedbackRating` 对象的属性:

名称描述
SellerPositiveFeedbackRating过去365天内,卖家的正面反馈百分比。
可选。
类型:双精度
FeedbackCount卖家收到的反馈次数。
必填。
类型:长整型

ShippingTime

以下表格展示了 `ShippingTime` 对象的属性:

名称描述
MinimumHours在订单下单后,商品可能会在多少小时内发货的最短时间。
可选。
类型:short
MaximumHours在订单下单后,商品可能会在多少小时内发货的最长时间。
可选。
类型:short
AvailableDate商品可以发货的日期。仅在商品当前无法发货时显示。
可选。
类型:string
AvailabilityType指示商品是否可以立即发货,或者是否会在未来的已知或未知日期发货。如果是已知日期,`availableDate` 属性表示商品可以发货的日期。
可选。
类型:string

ShipsFrom

以下表格展示了 `ShipsFrom` 对象的属性:

名称描述
State商品发货所在的州。
可选。
类型:string
Country商品发货所在的国家。
可选。
类型:string
IsFulfilledByAmazon指示该商品是否由亚马逊履行。
必填。
类型:boolean

Summary

以下表格展示了 `Summary` 对象的属性:

名称描述
NumberOfOffers一个列表,包含在给定条件和履行渠道下该商品的总报价数量。
必填。
类型:数组,包含 [`OfferCount`](#OfferCount_AnyOfferChanged)
LowestPrices一个列表,包含在给定条件和履行渠道下该商品的最低价格。
必填。
类型:数组,包含 [`LowestPrice`](#LowestPrice_AnyOfferChanged)
BuyBoxPrices一个列表,包含在给定条件下该商品的 Buy Box 价格。
可选。
类型:数组,包含 [`BuyBoxPrice`](#BuyBoxPrice_AnyOfferChanged)
ListPrice由制造商建议的商品上市价格。
可选。
类型:[`MoneyType`](#moneytype)
SuggestedLowerPricePlusShipping建议的较低价格,包括运费(减去亚马逊积分)。该建议价格基于多个因素,包括历史销售价格、最近符合 Buy Box 的价格,以及客户的反馈。
可选。
类型:[`MoneyType`](#moneytype)
SalesRankings一个列表,包含该商品在给定产品类别中的销售排名。
可选。
类型:数组,包含 [`SalesRank`](#SalesRank_AnyOfferChanged)
NumberOfBuyBoxEligibleOffers一个列表,包含在给定条件和履行渠道下符合 Buy Box 条件的报价数量。
必填。
类型:数组,包含 [`OfferCount`](#OfferCount_AnyOfferChanged)
CompetitivePriceThreshold该价格基于其他零售商(不包括其他亚马逊卖家)的竞争价格。如果你的 `price` + `shipping` 高于此竞争价格,你的报价可能无法获得 Buy Box。
可选。
类型:[`MoneyType`](#moneytype)

通知架构: AnyOfferChangedNotification.json

通知示例:

{
  "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

卖家可以订阅此通知。

当亚马逊商业(Amazon Business)中前20个B2B报价中的任何一个发生变化时,都会发送B2B_ANY_OFFER_CHANGED通知。变化的形式包括对卖家列出的商品的任何价格变化(单件商品和七个预定义数量折扣等级:2、3、5、10、20、30和50)。前20个B2B报价是根据单件商品到岸价格(即价格加上运费)来确定的。如果多个卖家收取相同的到岸价格,结果将按随机顺序返回。

您只会收到有活动报价的商品的B2B_ANY_OFFER_CHANGED通知。无法订阅没有活动报价的商品的通知。

有效载荷模式:版本 1.0

工作流: Amazon Simple Queue Service 工作流

下表展示了b2b AnyOfferChangedNotification对象的对象和属性:

名称描述
OfferChangeTrigger触发通知发送的事件。
必需。
类型:OfferChangeTrigger
Summary有关发生报价变更的商品的信息。此摘要中的信息适用于该商品的所有条件。
必需。
类型:Summary
Offers触发通知的商品和条件的前20个竞争性B2B报价。
必需。
类型:Offer 数组
SellerId报价的卖家标识符。
必需。
类型:字符串

BuyBoxPrice

下表展示了BuyBoxPrice对象的对象和属性:

名称描述
landedPricelistingPrice + shipping

可选。

类型:MoneyType

listingPrice商品的价格。

必需。

类型:MoneyType

shipping运费。

可选。

类型:MoneyType

offerType指示报价是B2B报价还是B2C报价。当报价类型为B2C且为数量折扣时,卖家之所以赢得Buy Box,是因为其他卖家在该数量上没有库存,而不是因为他们在ASIN上有数量折扣。

必需。

类型:字符串

quantityTier报价的数量等级。

必需。

类型:整数

discountType指示数量等级是否属于数量折扣或渐进折扣。

可选。

类型:字符串

condition指示商品的状况。例如:New(新)、Used(二手)、Collectible(收藏品)、Refurbished(翻新)、Club(俱乐部)。

必需。

类型:字符串

sellerId报价的卖家标识符。

可选。

类型:字符串

LowestPrice

 

下表展示了Summary对象下LowestPrice类型的对象和属性:

名称描述
LandedPriceListingPrice + Shipping

可选。

类型:MoneyType

ListingPrice商品的价格。

必需。

类型:MoneyType

Shipping运费。

可选。

类型:MoneyType

OfferType指示报价是B2B报价还是B2C报价。

必需。

类型:字符串

QuantityTier报价的数量等级。

必需。

类型:整数

DiscountType指示数量等级是否属于数量折扣或渐进折扣。

可选。

类型:字符串

Condition指示商品的状况。例如:New(新)、Used(二手)、Collectible(收藏品)、Refurbished(翻新)、Club(俱乐部)。

必需。

类型:字符串

FulfillmentChannel指示商品是由亚马逊还是卖家履行。

必需。

类型:FulfillmentChannelType

Offer

 

下表展示了Offer对象的对象和属性:

名称描述
SellerId报价的卖家标识符。

必需。

类型:字符串

SubCondition商品的子条件。例如:New(新)、Mint(完好)、Very Good(非常好)、Good(好)、Acceptable(可接受)、Poor(差)、Club(俱乐部)、OcodeWarrantyRefurbished WarrantyRefurbished(翻新)、Open BoxOther(其他)。

必需。

类型:字符串

SellerFeedbackRating卖家的反馈信息,包括正面反馈的百分比和收到的反馈总数。

可选。

类型:SellerFeedbackRating

ShippingTime商品在订单下达后可能发货的最小和最大时间(以小时为单位)。

必需。

类型:ShippingTime

ListingPrice商品的价格。

必需。

类型:MoneyType

Shipping运费。

必需。

类型:MoneyType

ShipsFrom商品发货的国家。

可选。

类型:ShipsFrom

IsFulfilledByAmazon指示报价是否由亚马逊履行。

必需。

类型:布尔值

IsBuyBoxWinner指示报价是否当前处于Buy Box。每个ASIN最多可以有两个Buy Box获胜者,一个适用于Prime,另一个不适用Prime。

可选。

类型:布尔值

ConditionNotes有关商品状况的信息。

可选。

类型:字符串

PrimeInformation亚马逊Prime信息。

可选。

类型:PrimeInformation

IsFeaturedMerchant指示卖家是否有资格赢得Buy Box。

可选。

类型:布尔值

OfferChangeTrigger

 

下表展示了OfferChangeTrigger对象的属性:

名称描述
MarketplaceId商品发生报价变更的市场标识符。

必需。

类型:字符串

ASIN发生报价变更的商品的ASIN。

必需。

类型:字符串

ItemCondition发生报价变更的商品的条件。例如,如果是二手报价变更,Offers对象中的报价数组将仅包含二手商品。Summary对象提供了其他条件的摘要,用于重新定价。

必需。

类型:字符串

TimeOfOfferChange触发此通知的报价更新时刻。

必需。

类型:字符串

OfferCount

 

下表展示了OfferCount类型的对象和属性:

名称描述
Condition指示商品的条件。例如:New(新)、Used(二手)、Collectible(收藏品)、Refurbished(翻新)、Club(俱乐部)。

必需。

类型:字符串

FulfillmentChannel指示商品是由亚马逊还是卖家履行。

必需。

类型:FulfillmentChannelType

OfferCount指定条件和履行渠道的报价总数。

类型:整数

PrimeInformation

 

下表展示了PrimeInformation对象的属性:

名称描述
IsOfferNationalPrime指示报价是否是整个市场中均为Amazon Prime报价。

必需。

类型:布尔值

IsOfferPrime指示报价是否是Amazon Prime报价。

必需。

类型:布尔值

SellerFeedbackRating

 

下表展示了SellerFeedbackRating对象的属性:

名称描述
SellerPositiveFeedbackRating卖家在过去365天中的正面反馈百分比。

可选。

类型:整数

FeedbackCount卖家收到的反馈总数。

必需。

类型:整数

ShippingTime

 

下表展示了ShippingTime对象的属性:

名称描述
MinimumHours订单下达后商品可能发货的最小时间(以小时为单位)。

可选。

类型:整数

MaximumHours订单下达后商品可能发货的最大时间(以小时为单位)。

可选。

类型:整数

AvailableDate商品将可供发货的日期。仅显示对于当前不可发货的商品。

可选。

类型:字符串

AvailabilityType指示商品是否现在可供发货,或将在未来某个已知或未知日期发货。如果已知,availableDate属性表示商品将可供发货的日期。

可选。

类型:字符串

ShipsFrom

 

下表展示了ShipsFrom对象的属性:

名称描述
Country商品发货的国家。

可选。

类型:字符串

Summary

 

下表展示了Summary对象的对象和属性:

名称描述
NumberOfOffers包含指定条件和履行渠道下B2B报价总数的列表。

必需。

类型:OfferCount数组

LowestPrices包含指定条件、履行渠道、数量等级和折扣类型下商品最低价格的列表。

必需。

类型:LowestPrice数组

BuyBoxPrices包含指定条件、数量等级和折扣类型下商品Buy Box价格的列表。

最多显示前50个数量等级。

可选。

类型:BuyBoxPrice数组

BuyBoxEligibleOffers包含指定条件和履行渠道下符合Buy Box条件的B2B报价总数的列表。

必需。

类型:OfferCount数组

通知模式: B2bAnyOfferChangedNotification.json

通知示例

{
  "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

卖家可以订阅此通知。

当任何卖家与某个 ASIN 相关联的品牌的标题、描述、要点或图片发生变化时,Amazon 会发送 BRANDED_ITEM_CONTENT_CHANGE 通知。当卖家是经过验证的品牌所有者,并且根据 Amazon 注册品牌计划与某个 ASIN 具有品牌关系时,卖家与该 ASIN 存在品牌关系。卖家是授权应用程序代表其调用通知 API,以便创建和管理通知订阅的主体。Amazon 会针对列出在任何 Amazon 市场中的商品发送 BRANDED_ITEM_CONTENT_CHANGE 通知。

有效负载架构:版本 1.0

工作流程:Amazon EventBridge 工作流

BRANDED_ITEM_CONTENT_CHANGE 通知中,PayloadVersion=_1.0_ 包含以下属性在 Payload 对象中:

名称描述是否必需
MarketplaceId商品列出的市场。
类型:字符串
BrandName商品的品牌名称。
类型:字符串
Asin商品的 ASIN。
类型:字符串
AttributesChanged发生变化的商品属性数组。属性名称、描述和要求可以通过调用产品类型定义 API 获取。更多信息,请参考 产品类型定义 API 使用案例指南
类型:字符串数组

可能的值:
bullet_point
item_name
product_description
…以及所有产品图片属性(main_product_image_locatorother_product_image_locator_1 等)。参见 JSON 响应示例 中的 images 属性组,获取完整的图片属性列表。
注意: 如果包含 image 字样的值(例如 main_product_image_locatorother_product_image_locator_1 等)出现在上述值中,表示至少有一张图片发生了变化。包含 image 字样的值的数量不一定与商品详情页上更改的图片数量相匹配。

通知架构: BrandedItemContentChangeNotification.json

通知示例:

{
  "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

卖家和供应商可以订阅此通知。

DETAIL_PAGE_TRAFFIC_EVENT 通知会在每小时开始后的五分钟发送。此通知提供按 ASIN(亚马逊标准识别号)级别的流量数据,包括前一个小时的数据以及最多 24 小时前的延迟数据。具有浏览量的 ASIN 将包含在内。每个通知可能包含多个 ASIN,销售伙伴预计每小时会收到多个通知。

负载模式:版本 1.0

工作流: Amazon Simple Queue Service 工作流

DetailPageTrafficEventNotifications

下表显示了 DetailPageTrafficEventNotifications 对象的对象和属性:

名称描述必填类型
detailPageTrafficEventNotifications按 ASIN 划分的每小时流量数据列表。DetailPageTrafficEventNotification 数组

DetailPageTrafficEventNotification

名称描述必填类型
accountId此通知发送到的商家客户 ID 或供应商组 ID。字符串
marketplaceId流量数据的市场标识符。字符串
startTime流量数据的日期时间范围的开始时间,采用 ISO 8601 格式的 UTC 时间。字符串
endTime流量数据的日期时间范围的结束时间,采用 ISO 8601 格式的 UTC 时间。字符串
asin产品的 Amazon 标准识别号。字符串
glanceViews此 ASIN 的产品详情页面的客户浏览次数。整数

通知模式: DetailPageTrafficEventNotification

通知示例

{
  "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"
  }
}

赞(0) 打赏
未经允许不得转载:码农很忙 » 亚马逊 SP-API 中的通知类型列表(一)

评论 抢沙发

给作者买杯咖啡

非常感谢你的打赏,我们将继续给力更多优质内容,让我们一起创建更加美好的网络世界!

支付宝扫一扫

微信扫一扫

登录

找回密码

注册