Notifications API v1用例指南

亚马逊SPAPI

# 什么是Notifications API?

通知的销售伙伴 API 让您可以订阅与销售伙伴业务相关的通知.使用此 API,您可以创建一个目的地来接收通知、订阅通知、删除通知订阅等.当某个事件触发了您订阅的通知时,您的应用程序可以直接从亚马逊接收信息,而不是轮询信息.

你可以代表卖家或供应商订阅通知. 要确定你是否可以只代表卖家、供应商或两者订阅通知类型,请进入notificationType.

# Terminology

  • Amazon EventBridge: 一个无服务器的事件总线,连接来自您自己的应用程序、集成的软件-as-a-Service (SaaS)应用程序和AWS服务的应用数据. 更多信息,请参阅Amazon EventBridge (opens new window).

  • 亚马逊简单队列服务 **(亚马逊SQS)**为微服务、分布式系统和无服务器应用提供完全管理的消息队列服务.更多信息,请参阅Amazon简单队列服务 (opens new window).

  • 合作伙伴的事件源由AWS合作伙伴用于向AWS客户账户发送事件.为了接收这些事件,客户必须将事件总线与合作伙伴的事件源联系起来.更多信息,请参阅什么是Amazon EventBridge? (opens new window)

  • 事件总线接收来自源的事件,并根据与事件总线相关的规则将其路由到目标资源.更多信息,请参阅EventBus (opens new window).

# Notification workflows

有两个独立的工作流程用于接收通知.你使用的工作流程取决于你要接收的通知类型.

亚马逊EventBridge工作流程

使用这个工作流程来接收下列通知类型

教程Set up notifications (Amazon EventBridge workflow).

亚马逊简单队列服务工作流程

使用此工作流程来接收以下通知类型

  • ACCOUNT_STATUS_CHANGED. 每当开发商订阅的商家/市场对的账户状态发生变化时,就会发出通知. 每当商家的账户状态在NORMAL、AT_RISK和DEACTIVATED之间变化时,就会发布通知.

  • ANY_OFFER_CHANGED. 每当前20个offer中的任何一个发生变化,按条件(新的或二手的),或者外部价格(其他零售商的价格)发生变化,卖家列出的商品.就会发送通知

  • B2B_ANY_OFFER_CHANGED. 只要前20个B2B报价中的任何一个有变化,即卖家列出的某个商品的任何价格变化(单价或数量折扣层价格),就会发送

  • FBA_OUTBOUND_SHIPMENT_STATUS. 每当我们为卖家创建或取消Fulfillment by Amazon的运输时,就会发送该信息.

  • FEE_PROMOTION. 当一个促销活动开始时发送.

  • Feed_PROCESSING_FINISHED. 当使用Selling Partner API for Feeds提交的任何feed达到DONE、CANCELLED或FATAL的feed处理状态时发送

  • FULFILLMENT_ORDER_STATUS. 每当一个多渠道Fulfillment订单的状态发生变化时,就会发送

  • MFN_ORDER_STATUS_CHANGE. 当MFN订单的状态发生变化时发送

  • ORDER_STATUS_CHANGE. 每当有订单可用性的状态发生变化时发送.

  • PRICING_HEALTH. 每当卖方报价因价格不具竞争力而无资格成为特色报价(Buy Box报价)时发送

  • REPORT_PROCESSING_FINISHED. 当您使用Selling Partner API for Reports请求的任何报告达到DONE、CANCELLED或FATAL.的报告处理状态时发送

参见Tutorial设置通知(亚马逊简单队列服务工作流程).

# Tutorial: 设置通知(亚马逊EventBridge工作流程)

使用本教程来接收以下任何一种通知类型

如果你想接收任何其他的通知类型,请跳过本教程,转到Tutorial设置通知(亚马逊简单队列服务工作流程).

先决条件

要完成本教程,你将需要

-来自销售伙伴的授权(销售商或供应商)你为其进行呼叫.参见销售伙伴API开发者指南 (opens new window)以获得更多信息.

-对Amazon EventBridge的基本了解.更多信息,请参见Amazon EventBridge (opens new window).

# 步骤1.创建一个目的地

调用createDestination操作来创建一个Amazon EventBridge的目的地.

**注意:**每个AWS账户只能创建一个EventBridge目的地.

1.调用createDestination (opens new window)操作,传递以下主体参数

Parameter Description 要求
resourceSpecification 创建目标资源所需的信息. 在这个工作流程中,包括eventBridge规范.的信息

类型resourceSpecification类型

是的
名称 一个开发者-定义的名称,以帮助识别这个目的地.

类型: string

是的

注意:调用创建目的地操作不需要任何销售伙伴的授权.在这方面,该操作是一个 "无授权 "的操作,与大多数其他销售伙伴API操作有着不同的授权模式.更多信息,请参见《销售伙伴API开发者指南》中的无授权操作 (opens new window)

请求示例

POST https://sellingpartnerapi-na.amazon.com/notifications/v1/destinations
{
  "resourceSpecification":
  {
    "eventBridge":
    {
      "accountId": "123456789",
      "region": "us-east-1"
    }
  },
  "名称": "YourDestinationName"

1
2
3
4
5
6
7
8
9
10
11
12

响应

一个成功的响应包括以下内容

姓名 Description
resource 将接收与此目的地相关的通知的资源.

类型目的地资源(DestinationResource)

destinationId 您创建目的地时产生的目的地标识符.

类型: string

名称 这个目的地的名称.

类型: string

响应实例

{
  "payload": {
    "资源"{
      "sqs": null,
      "eventBridge": {
        "name": "sellingpartnerapi.amazon.com/amzn1.sellerapps.app.15a75829-cd4a-4efc-b947-0cc39d874577",
        "accountId": "123456789",
        "region": "us-east-1"
      }
    },
    "destinationId": "64a4a891-60dd-303f-89f9-43caf25cb3ec",
    "name": "YourDestinationName"
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
  1. 保存以下值

# 步骤2.配置Amazon EventBridge来处理通知

将事件总线与您的合作伙伴的事件源联系起来.有关定义,请参阅术语.

1.进入Amazon EventBridge (opens new window),使用你在步骤1中调用createDestination操作时指定的AWS账户ID登录AWS控制台.,创建目标

2.在控制台中,确保你在调用createDestination操作时指定的AWS区域被选中.

3.在导航窗格中,点击合作伙伴的事件源.

  1. 伙伴事件源区域,在名称下,点击与资源:eventBridge.name值相匹配的伙伴事件源 name**中返回的值Step 1.创建一个目的地.伙伴事件源的格式是:aws.partner/sellingpartnerapi.amazon.com/{AWS Account Id}/{Application Id}

  2. 在出现的新页面上,点击与事件总线关联的按钮.

  3. 与事件总线关联的页面上,将复选框清除,并点击关联按钮.

你已经创建了一个伙伴事件总线并与你的伙伴事件源相关联.进入步骤3.创建一个在通知事件上触发的规则.

# 步骤3.创建一个在通知事件上触发的规则

创建一个规则,观察特定的通知事件,并将它们路由到你选择的目标资源.

1.进入Amazon EventBridge (opens new window). 如果您还没有登录到AWS控制台,请使用您在步骤1.创建目的地.中调用创建目的地操作时指定的AWS账户ID进行登录

2.在控制台中,确保你在调用createDestination操作时指定的AWS区域被选中.

3.在导航窗格中,点击规则.

  1. 点击创建规则按钮.

  2. 为规则输入一个名称和可选的描述.

6.在定义模式区域,选择事件模式.

  1. 选择前-按服务定义的模式.

8.在服务提供者下,选择服务伙伴.

9.在服务名称下,选择亚马逊销售伙伴API.

显示的事件模式应该类似于以下内容,这表明你将收到由sellingpartnerapi.amazon.com发出的所有事件

{
  "账户": [
    "1234567890"
  ]
}

1
2
3
4
5
6
  1. (Optional) 编辑事件模式,包括只匹配你想要的通知事件的规则. 下面的事件模式包含一个规则,只匹配来自sellingpartnerapi.amazon.com的BRANDED_ITEM_CONTENT_CHANGE事件
{
  "account": [
    "1234567890"
  ],
  "detail-type": [
    "branded_item_content_change"
  ]
}
1
2
3
4
5
6
7
8

关于创建更复杂的规则的信息,请参阅AWS文档中的Event Patterns (opens new window).

  1. 选择事件总线区域,选择自定义或合作伙伴事件总线,然后选择你在Step 2.配置Amazon EventBridge处理通知的合作伙伴事件总线.中配置的事件总线

12.在选择目标区域,选择在检测到所选类型的事件时要采取行动的AWS服务.如果需要,输入该目标类型特有的其他信息.

**注意.**对于许多目标类型,EventBridge需要权限来向目标发送事件.在这些情况下,您可以创建一个新的IAM角色,或者您可以使用现有的IAM角色.执行以下操作之一

- 要创建一个IAM角色,选择**为这个特定资源创建一个新的角色**.

- 要使用您已经创建的IAM角色,请选择**使用现有角色**.
  1. (Optional) 点击添加目标,为该规则添加另一个目标._

  2. (Optional)为该规则输入一个或多个标签.更多信息,请参阅AWS文档中的Tagging Your Amazon EventBridge Resources (opens new window).

15.点击创建按钮.

故障排除

-更多故障排除信息,请参见AWS文档.中的Troubleshooting Amazon EventBridge (opens new window)

# 步骤4.创建一个订阅

订阅一个通知类型,将其传递到您在步骤1.创建目的地.中创建的目的地

注意每个地区只允许每个应用程序、通知类型和党派(卖家/供应商)的一个订阅.

1.调用createSubscription (opens new window)操作,传递以下参数

路径参数

Parameter Description 要求
notificationType 你想订阅的通知的类型.

可能的值BRANDED_ITEM_CONTENT_CHANGE, ITEM_PROCT_TYPE_CHANGE, LISTINGS_ITEM_STATUS_CHANGE, LISTINGS_ITEM_ISSUES_CHANGE, PRODUCT_TYPE_DEFINITIONS_CHANGE.见notificationType.

类型: string

是的

身体参数

Parameter Description 要求
payloadVersion 通知中要使用的有效载荷对象的版本.

类型: string

是的
destinationId 将要发送通知的目的地的标识符.使用您在Step 1. Create a destination.中保存的destinationId

类型: string

是的

请求示例

POST https://sellingpartnerapi-na.amazon.com/ notifications/v1/subscriptions/BRANDED_ITEM_CONTENT_CHANGE
{
  "payloadVersion":"1.0",
  "destinationId":"3acafc7e-121b-1329-8ae8-1571be663aa2"
}
1
2
3
4
5

响应

姓名 Description
subscriptionId 创建订阅时产生的订阅标识符.

类型: string

payloadVersion 通知中要使用的有效载荷对象的版本.

类型: string

destinationId 通知将被送达的目的地的标识符.

类型: string

响应示例

{
  "payload":{
    "subscriptionId":" 7fcacc7e-727b-11e9-8848-1681be663d3e",
    "payloadVersion":" 1.0",
    "destinationId":"3acafc7e-121b-1329-8ae8-1571be663aa2"
  }
}
1
2
3
4
5
6
7

你现在已经订阅了接收BRANDED_ITEM_CONTENT_CHANGE的通知.

# Tutorial: 设置通知(亚马逊简单队列服务工作流程)

使用本教程来设置你的系统以接收以下任何一种通知类型

  • ACCOUNT_STATUS_CHANGED.每当开发商订阅的商家/市场对的账户状态发生变化时就会发送通知.每当商家的账户状态在NORMAL、AT_RISK和DEACTIVATED之间变化时就会发布通知.

  • ANY_OFFER_CHANGED. 只要前20个offer中的任何一个,按条件(新的或二手的),或者外部价格(其他零售商的价格)改变,卖家列出的物品就会发出通知.

  • B2B_ANY_OFFER_CHANGED. 只要前20个B2B报价中的任何一个有变化,即卖家列出的某个商品的任何价格变化(单价或数量折扣层价格),就会发送

  • FBA_OUTBOUND_SHIPMENT_STATUS. 每当我们为卖家创建或取消Fulfillment by Amazon的运输时,就会发送该信息.

  • FEE_PROMOTION. 当一个促销活动开始时发送.

  • Feed_PROCESSING_FINISHED. 当使用Selling Partner API for Feeds提交的任何feed达到DONE、CANCELLED或FATAL的feed处理状态时发送

  • FULFILLMENT_ORDER_STATUS. 每当一个多渠道Fulfillment订单的状态发生变化时,就会发送

  • MFN_ORDER_STATUS_CHANGE. 当MFN订单的状态发生变化时发送

  • ORDER_STATUS_CHANGE. 每当有订单可用性的状态发生变化时发送.

  • PRICING_HEALTH. 每当卖方报价因价格不具竞争力而无资格成为特色报价(Buy Box报价)时发送

  • Report_PROCESSING_FINISHED. 当您使用Selling Partner API for Reports请求的任何报告达到DONE、CANCELLED或FATAL.的报告处理状态时,就会发送

**重要的是:**要接收任何其他类型的通知,请到TutorialSet up notifications (Amazon EventBridge workflow).

先决条件

要完成本教程,你需要

-来自您为其进行呼叫的销售伙伴的授权.更多信息请参见销售伙伴API开发者指南 (opens new window).

-一个亚马逊简单队列服务(SQS)队列.关于设置SQS队列的信息,请看亚马逊简单队列服务 (opens new window).

# 步骤1.授予销售伙伴API权限以写入您的SQS队列

要接收通知,您必须授予销售伙伴API写到您的SQS队列的权限.

1.打开AWS管理控制台 (opens new window),用您的AWS凭证登录.

2.从控制台,打开简单队列服务.

3.选择你想接收通知的标准队列.

  1. 选择访问策略标签.

5.从访问策略(权限)部分,选择编辑.打开编辑测试队列页面.

6.向下滚动到访问策略,然后选择策略生成器链接. AWS策略生成器在一个新的标签页中打开.

7.在策略生成器的第1步,选择SQS队列策略.

8.在策略生成器的第2步中 -设置效果允许.

  • 设置原则437568002678.
  • 设置行动发送消息获取队列属性.
  • 亚马逊资源名称(ARN).中输入SQS ARN
  • 选择添加报表,并验证细节.

10.在策略生成器的第3步,选择生成策略.打开一个包含新策略的对话框.

11.复制该政策.

12.导航回到Amazon SQS队列,打开访问策略标签,然后将策略粘贴到**访问策略(权限)**部分.

13.保存更改.

14.参考队列的细节部分,注意这个队列的ARN.当你在步骤2中调用createDestination操作时,你将使用arn参数传递这个值.

**注意:**如果你使用服务器-端加密(SSE),那么你必须使用AWS密钥管理服务(KMS) (opens new window).考虑使用以下策略,为销售伙伴提供API访问你的密钥

{
  "版本": "2012-10-17",
  "声明": [
    {
      "效果": "允许",
      "本金": {
        "AWS": "arn:aws:iam::437568002678:root"
      },
      "行动"[
        "kms:GenerateDataKey",
        "kms:解密"
      ],
      "资源": "*"
    }
  ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

See Key management (opens new window) for more information.

# 第2步.创建一个目的地

调用createDestination操作来创建一个Amazon Simple Queue Service (SQS) destination.

1.调用createDestination (opens new window)操作,传递以下主体参数

呼叫中心的名称是 "18774",而不是 "18774"
Parameter Description 要求
resourceSpecification 创建SQS目标所需的信息.这包括sqs: arn值,你从Step 1. Grant Selling Partner API permission to write to your SQS queue.得到的

类型: object

Yes.
您指定的一个名称,以帮助您识别这个目的地.

类型:字符串

是的

注意:调用创建目的地操作不需要任何销售伙伴的授权.在这方面,该操作是一个 "无授权 "的操作,与大多数其他销售伙伴API操作有着不同的授权模式.更多信息,请参见《销售伙伴API开发者指南》中的无授权操作 (opens new window)

请求示例

POST https://sellingpartnerapi-na.amazon.com/ notifications/v1/destinations
{
  "name": "YourDestinationName"
  "resourceSpecification":
  {
    "sqs":
    {
      "arn": "arn:aws:sqs:us-east-2:444455556666:queue1"
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11

响应

姓名 Description
名称 开发者为这个目的地定义的名称.

类型:字符串

destinationId 您创建目的地时产生的目的地标识符.

类型: string

resource 将接收与此目的地相关的通知的资源.

类型: object

响应示例

{
  "payload": {
    "名称": "YourDestinationName",
    "destinationId": "ExampleDestinationId",
    "资源": {
      "sqs": {
        "arn": "arn:aws:sqs:us-east-2:444455556666:queue1"
      }
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11

2.保存destinationId值作为Step 3.创建一个订阅.的输入

# 第3步.创建一个订阅

创建一个通知类型的订阅,送到您在上一步创建的目的地.

注意每个地区只允许对每个应用程序、通知类型和当事人(卖家/供应商)进行一次订阅.

1.调用createSubscription (opens new window)操作,传递以下参数

路径参数

Parameter Description 要求
notificationType 你想订阅的通知的类型.

可能的值account_status_changed, any_offer_changed, b2b_any_offer_changed, fba_outbound_shipment_status, fee_promotion, feed_processing_finished, fulfillment_orders_status, MFN_ORDER_STATUS_CHANGE, ORDER_STATUS_CHANGE, PRICING_HEALTH, REPORT_PROCESSING_FINISHED.参见notificationType

类型: string

是的

身体参数

呼叫中心
Parameter Description 要求
payloadVersion 通知中要使用的有效载荷对象的版本.

类型: string

是的
destinationId 将要发送通知的目的地的标识符.使用你在Step 2.创建一个目的地.中保存的值

类型: string

是的
processingDirective 传递给订阅的额外信息,以控制通知的处理.例如,你可以使用一个eventFilter来定制你的订阅,只为指定的marketplaceId的发送通知,或者选择发送通知的聚集时间段(e.g.对于高频率的通知,限制为每五分钟一个通知).可用的具体功能根据通知类型而变化.

该功能仅限于特定的notificationTypes,目前只支持ANY_OFFER_CHANGED通知类型.

类型ProcessingDirective

No

请求示例(没有处理指令)

POST https://sellingpartnerapi-na.amazon.com/ notifications/v1/subscriptions/ANY_OFFER_CHANGED
{
  "payloadVersion":"1.0",
  "destinationId":"3acafc7e-121b-1329-8ae8-1571be663aa2"
}
1
2
3
4
5

响应

姓名 Description
subscriptionId 创建订阅时产生的订阅标识符.

类型: string

payloadVersion 通知中要使用的有效载荷对象的版本.

类型: string

destinationId 将要发送通知的目的地的标识符.使用你在上一步保存的destinationId值.

类型: string

响应示例

{
  "payload": {
    "subscriptionId": "7fcacc7e-727b-11e9-8848-1681be663d3e",
    "payloadVersion": "1.0",
    "destinationId": "3acafc7e-121b-1329-8ae8-1571be663aa2",
  }
}
1
2
3
4
5
6
7

响应

姓名 Description
subscriptionId 创建订阅时产生的订阅标识符.

类型: string

payloadVersion 通知中要使用的有效载荷对象的版本.

类型: string

destinationId 将要发送通知的目的地的标识符.使用你在上一步保存的destinationId值.

类型: string

使用处理指令的例子 (仅由ANY_OFFER_CHANGED通知类型支持)

请求示例创建一个订阅,只为指定的marketplaceId的发送通知

POST https://sellingpartnerapi-na.amazon.com/ notifications/v1/subscriptions/ANY_OFFER_CHANGED
{
  "destinationId": "12d803a2-7e70-4bb2-a797-2b4b43e10051",
  "payloadVersion": "1.0",
  "processingDirective": {
    "eventFilter": {
      "eventFilterType": "any_offer_changed",
      "marketplaceIds": ["ATVPDKIKX0DER"]
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11

响应实例

{
  "payload": {
    "subscriptionId": "7318ddfb-18e4-4fe0-89f5-a437321d2e79",
    "destinationId": "12d803a2-7e70-4bb2-a797-2b4b43e10051",
    "payloadVersion": "1.0",
    "processingDirective": {
      "eventFilter": {
        "marketplaceIds": [
          "atvpdkikx0der"
        ],
        "eventFilterType": "any_offer_changed"
      }
    }
  }
}


创建一个订阅的请求示例,将通知的频率限制在每五分钟一次

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

POST https://sellingpartnerapi-na.amazon.com/ notifications/v1/subscriptions/ANY_OFFER_CHANGED { "destinationId": "12d803a2-7e70-4bb2-a797-2b4b43e10051", "payloadVersion": "1.0", "processingDirective": { "eventFilter": { "eventFilterType": "any_offer_changed", "aggregationSettings": { "aggregationTimePeriod": "五分钟" } } } }


响应实例
```json
{
  "payload": {
    "subscriptionId": "b8877fdf-17a6-4d59-bb1d-9650d9d823e0",
    "destinationId": "12d803a2-7e70-4bb2-a797-2b4b43e10051",
    "payloadVersion": "1.0",
    "processingDirective": {
      "eventFilter": {
        "aggregationSettings": {
          "aggregationTimePeriod": "五分钟"
        },
        "eventFilterType": " any_offer_changed"
      }
    }
  }
}



### 处理队列中的通知

为了正确处理通知,你必须了解Amazon SQS队列的几个重要属性

- **销售伙伴 API 不支持向 FIFO 队列交付**. 你必须使用 Amazon SQS 标准队列来接收通知.

- **Selling Partner API的标准队列并不保证会按照发送的顺序接收通知**. 标准队列提供了最佳努力排序,这意味着通知通常会按照发送的顺序交付. 然而,偶尔会有一份以上的通知不按顺序交付. 因此,你必须设计你的应用程序以接受任何顺序的通知.

- **Amazon SQS标准队列的通知可能会被传递不止一次**. Amazon SQS将您的通知副本存储在多个服务器上,以实现冗余和高可用性. 在极少数情况下,当您接收或删除通知时,存储通知副本的服务器之一可能无法使用. 如果发生这种情况通知的副本并没有在那个不可用的服务器上被删除,当你收到通知时,你可能会再次得到那个通知副本.因此,你必须设计你的应用程序来接受任何给定通知的多个副本.

- 你可以通过查看通知的`notificationId`属性来确定一个通知是否是你已经收到的通知的副本. 你可以在通知的`NotificationMetaData`对象中找到`notificationId`属性.

关于处理来自Amazon SQS队列的通知的更多信息,请参见[Amazon Simple Queue Service Developer Guide](http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide)和[Amazon Simple Queue Service API Reference](http://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference),见[AWS Documentation](https://aws.amazon.com/documentation/) portal.

## Processing Directives

处理指令是一个可选的参数,你可以在调用[createSubscription](https://spapi.cyou/zh/references/notifications-api-v1-reference.html#post-notificationsv1subscriptionsnotificationtype)操作时提供.它可以用来改变某些通知类型的订阅行为.目前只支持与ANY_OFFER_CHANGED通知类型一起使用.使用不支持的通知类型会导致请求失败,出现HTTP 400响应.

使用处理指令(processingDirective)将额外的信息传递给订阅,以控制通知的处理.例如,你可以使用`eventFilter'来定制你的订阅,以便只为指定的marketplaceId发送通知,或者选择发送通知的聚集时间段(e.g.对于高频率的通知,限制为每5分钟发送一个通知).

支持以下`eventFilter`值

<table>
  <thead>
    <tr class="header">
      <th>
        <b>Name</b>
      </th>
      <th>
        <b>Description</b>
      </th>
    </tr>
  </thead>
  <tbody>
    <tr class="even">
      <td>eventFilterType</td>
      <td>特定notificationType支持的eventFilterType值.这被订阅服务用来确定事件过滤器的类型.
      <p>Example:<br/><code>"eventFilterType": "ANY_OFFER_CHANGED"</code></p>
        要求.
    </td>
    </tr>
    <tr class="odd">
      <td>aggregationSettings</td>
      <td>一个支持聚集过滤通知的容器.支持使用聚集时间周期来限制(过滤)发送通知的频率为5分钟或10分钟.
      <p>Example:<br/><code>"aggregationSettings": 
      {"aggregationTimePeriod": "FiveMinutes"}</code></p>
        可选.
      </td>
    </tr>
    <tr class="even">
      <td>marketplaceIds</td>
      <td>一个要订阅的市场标识符的列表.要接收每个市场的通知,不要提供这个列表.
        <p>示例:<br/><code>"marketplaceIds"[
                        "atvpdkikx0der",
                        "a2euq1wtgctbg2"
                      ]</code></p>
        可选.
      </td>
    </tr>
  </tbody>
</table>

更多信息,请参阅API参考中的[ProcessingDirective](https://spapi.cyou/zh/references/notifications-api-v1-reference.html#processingdirective).

实现具有两个事件过滤器值的处理指令的请求示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

POST https://sellingpartnerapi-na.amazon.com/notifications/v1/subscriptions/ANY_OFFER_CHANGED { "payloadVersion": "1.0", "destinationId": "3acafc7e-121b-1329-8ae8-1571be663aa2", "processingDirective": { "eventFilter": { "marketplaceIds": [ "atvpdkikx0der", "a2euq1wtgctbg2" ], "aggregationSettings": { "aggregationTimePeriod": "五分钟" }, "eventFilterType": " any_offer_changed" } } }

响应

{
   "payload": {
     "subscriptionId": "7fcacc7e-727b-11e9-8848-1681be663d3e",
     "payloadVersion": "1.0",
     "destinationId": "3acafc7e-121b-1329-8ae8-1571be663aa2",
     "processingDirective": {
       "eventFilter": {
         "marketplaceIds": [
           "atvpdkikx0der",
           "a2euq1wtgctbg2"
         ],
         "aggregationSettings": {
           "aggregationTimePeriod": "五分钟"
         },
         "eventFilterType": " any_offer_changed"
       }
     }
   }
 }




# Notification结构

销售伙伴的通知是JSON格式的.每个通知都包含一个**Payload**对象,它包含通知的可操作数据. [通知类型](#通知类型),与**PayloadVersion**结合,决定了**Payload**对象的结构.

一个具有**NotificationVersion**=1.0的销售伙伴通知包含以下属性

<table>
  <thead>
    <tr class="header">
      <th>
        <b>Object</b>
      </th>
      <th>
        <b>Description</b>
      </th>
      <th>
        <b>类型</b>
      </th>
    </tr>
  </thead>
  <tbody>
    <tr class="odd">
      <td>NotificationVersion</td>
      <td>通知的版本.这控制着通知的结构.</td>
      <td>字符串</td>
    </tr>
    <tr class="even">
      <td>NotificationType</td>
      <td>通知类型. <b>NotificationType</b>,结合<b>PayloadVersion,</b>控制<b>Payload对象的结构</b>.</td>
      <td>字符串</td>
    </tr>
    <tr class="odd">
      <td>PayloadVersion</td>
      <td>有效载荷版本. <b>PayloadVersion</b>,结合<b>NotificationType,</b>控制<b>Payload对象的结构</b>.</td>
      <td>字符串</td>
    </tr>
    <tr class="even">
      <td>EventTime</td>
      <td>触发通知的事件发生的日期和时间(in UTC).</td>
      <td>字符串</td>
    </tr>
    <tr class="odd">
      <td>Payload</td>
      <td>通知的可操作数据. <b>Payload</b>的结构由<b>NotificationType</b>与<b>PayloadVersion</b>.</td>共同决定
      <td>
        <p>JSON对象</p>
        <p>更多信息,请参阅<a href="#notificationtype">Notifications</a>.</p>
      </td>
    </tr>
    <tr class="even">
      <td>
        通知元数据(NotificationMetadata
      </td>
      <td>
        通知元数据.这包括以下对象
        <ul>
          <li>
            <p>
              <b>ApplicationId</b> - 使用通知的应用程序的标识符. 类型 = string</p>
          </li>
          <li>
            <p>
              <b>SubscriptionId</b> - 导致此通知的订阅的唯一标识. 类型 = string</p>
          </li>
          <li>
            <p>
              <b>PublishTime</b> - 发送通知的日期和时间(in UTC) . 类型 = string</p>_
          </li>
          <li>
            <p>
              <b>NotificationId</b> - 这个通知实例的唯一标识符. 类型 = string</p>
          </li>
        </ul>
      </td>
      <td>JSON对象</td>
    </tr>
  </tbody>
</table>

通知的例子
```json
{
  "NotificationVersion": "1.0",
  "NotificationType": "branded_item_content_change",
  "PayloadVersion": "1.0",
  "EventTime": "2019-03-20T18:59:30.194Z",
  "Payload":
  {
    "MarketplaceId": "atvpdkikx0der",
    "BrandName": "大品牌",
    "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",
      "产品形象定位器"
    ]
  },
  "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"
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141

# 通知类型

您可以订阅各种通知,这取决于您想要接收的销售伙伴信息.

以下notificationType值表示通知类型

  • ACCOUNT_STATUS_CHANGED.每当开发商订阅的商家/市场对的账户状态发生变化时,就会发出通知.每当商家的账户状态在NORMAL、AT_RISK和DEACTIVATED之间变化时,就会发布通知.

  • ANY_OFFER_CHANGED. 每当前20个报价中的任何一个发生变化,按条件(新的或二手的),或者外部价格(其他零售商的价格)发生变化,卖家列出的商品.就会发送通知

  • B2B_ANY_OFFER_CHANGED. 只要前20个B2B报价中的任何一个有变化,即卖方列出的某件商品的任何价格变化(单价或数量折扣层价格),就会发送

  • BRANDED_ITEM_CONTENT_CHANGE. 当销售伙伴与之有品牌关系的任何ASIN的标题、描述、要点或图片发生变化时,就会发出通知

  • FBA_OUTBOUND_SHIPMENT_STATUS. 每当我们为卖家创建或取消Fulfillment by Amazon的运输时,就会发送该信息.

  • FEE_PROMOTION. 当一个促销活动开始时发送.

  • Feed_PROCESSING_FINISHED. 当使用Selling Partner API for Feeds提交的任何feed达到DONE、CANCELLED或FATAL的feed处理状态时发送

  • FULFILLMENT_ORDER_STATUS. 每当一个多渠道Fulfillment订单的状态发生变化时,就会发送

  • ITEM_PRODUCT_TYPE_CHANGE. 当销售伙伴与之有品牌关系的任何ASIN的产品类型名称发生变化时发送.

  • LISTINGS_ITEM_STATUS_CHANGE. 当销售伙伴拥有的listings项目的状态发生变化时发送.

  • LISTINGS_ITEM_ISSUES_CHANGE. 每当销售伙伴拥有的listings项目的相关问题发生变化时发送.

  • MFN_ORDER_STATUS_CHANGE. 每当MFN订单可用性的状态发生变化时发送

  • ORDER_STATUS_CHANGE. 每当有订单可用性的状态发生变化时发送.

  • PRICING_HEALTH. 每当卖方报价因价格不具竞争力而无资格成为特色报价(Buy Box报价)时发送

  • PRODUCT_TYPE_DEFINITIONS_CHANGE.每当有新的产品类型或产品类型版本时发送

  • REPORT_PROCESSING_FINISHED. 当您使用报告销售伙伴API请求的任何报告达到DONE、CANCELLED或FATAL.的报告处理状态时发送

# ACCOUNT_STATUS_CHANGED

卖家可以订阅这个通知.

每当开发商订阅的商家/市场对的账户状态发生变化时,就会发送ACCOUNT_STATUS_CHANGED通知. 每当商家的账户状态在NORMAL、AT_RISK和DEACTIVATED之间变化时,就会发布通知.

ACCOUNT_STATUS_CHANGED 有效载荷模式2021-01-01版本

下表显示了accountStatusChangeNotification对象的属性

Name Description
previousAccountStatus 卖方在本次更新之前的账户状态.

Required.

类型: string

可能的值normal, at_risk, deactivated

currentAccountStatus 卖方的新账户状态.

Required.

类型:字符串

可能的值正常, 有风险, 已停用

_

通知模式: AccountStatusChangedNotification.json (opens new window)

通知示例:

{
   "notificationVersion": "1.0",
   "notificationType": "account_status_changed",
   "payloadVersion": "2021-01-01",
   "eventTime": "2020-12-11T19:42:04.284Z",
   "payload": {
     "accountStatusChangeNotification": {
       "previousAccountStatus" : "NORMAL",
       "当前账户状态" : "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"
   }
 }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

# ANY_OFFER_CHANGED

卖家可以订阅这个通知.

这个通知支持以下的事件过滤值aggregationSettings, marketplaceIds. 要使用这些过滤器,你还必须提供以下内容 eventFilterType: "eventFilterType": "ANY_OFFER_CHANGED".

更多信息请参见处理指令

当前20名中的任何一个报价发生变化时,都会发送ANY_OFFER_CHANGED通知,按条件划分(新的或二手的),或者如果你销售的商品的外部价格(其他零售商的价格)发生变化,或者哪个报价在BuyBox中获胜或者BuyBox的价格发生变化.前20名的报价是由落地价决定的,也就是价格加运费减去亚马逊积分.如果多个卖家收取相同的落地价,结果将以随机顺序返回.

你只能收到你有活动优惠的商品的ANY_OFFER_CHANGED通知. 你不能订阅你没有活动优惠的商品的通知.

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

呼叫中心
Name Description
SellerId 要约的卖方标识符.

Required.

类型字符串

OfferChangeTrigger 导致通知被发送的事件.

Required.

类型OfferChangeTrigger

Summary 有报价变化的产品信息.本摘要中的信息适用于该产品的所有条件.

Required.

类型Summary

Offers Offers 触发通知的项目和条件的前20个竞争性报价.

Required.

类型Offer的阵列

BuyBoxPrice

下表显示了BuyBoxPrice对象的对象和属性

Name Description
LandedPrice 挂牌价+运费 -点数.

Required.

类型MoneyType

ListingPrice 该物品的价格.

Required.

类型MoneyType

Shipping 运输费用.

Required.

类型MoneyType

Points 购买商品时提供的亚马逊积分的数量.

Optional.

Note: 积分对象只在日本返回(JP).

类型Points

Condition 表示物品的状况.例如新的、二手的、收藏的、翻新的或俱乐部的.

Required.

类型字符串

LowestPrice

下表显示了LowestPrice对象的对象和属性

Name Description
LandedPrice

ListingPrice + Shipping - Points.

Required.

类型MoneyType

ListingPrice

物品的价格.

Required.

类型MoneyType

Shipping

运输费用.

Required.

类型MoneyType

Points

购买商品时提供的亚马逊积分的数量.

Optional.

注意:积分对象只在日本返回(JP).

类型Points

Condition

表示物品的状况.例如新的,二手的,收藏的,翻新的,或俱乐部的.

Required.

类型字符串

FulfillmentChannel

表示该商品是由亚马逊履行还是由卖家履行.

Required.

类型FulfillmentChannelType

Offer

下表显示了Offer对象的对象和属性

Name Description
SellerId

该报价的卖方标识符.

Required.

类型字符串

SubCondition

物品的次要条件.例如, 薄荷, 非常好, , 可接受, , 俱乐部, OEMWarranty, Refurbished Warranty, Refurbished, Open Box, or Other.

Required.

类型字符串

SellerFeedbackRating

关于卖家的反馈信息,包括正面反馈的百分比,以及收到的反馈总计数.

Optional.

类型SellerFeedbackRating

ShippingTime

订单下达后,该商品可能被运走的最短和最长时间,以小时为单位.

Required.

类型ShippingTime

ListingPrice

物品的价格.

Required.

类型MoneyType

Points

购买商品时提供的亚马逊积分的数量.

Optional.

注意:积分对象只在日本返回(JP).

类型Points

Shipping

运输费用.

Required.

类型MoneyType

ShipsFrom

物品运出的州和国家.

Optional.

类型ShipsFrom

IsFulfilledByAmazon

表示该提议是否由亚马逊履行.

Required.

类型: boolean

IsBuyBoxWinner

表示该产品目前是否在购买箱中.每个ASIN在任何时候最多可以有两个购买箱赢家,一个有资格获得Prime,一个没有资格获得Prime.

Optional.

类型: boolean

ConditionNotes

关于物品状况的信息.

Optional.

类型: string

PrimeInformation

Amazon Prime信息.

Optional.

类型PrimeInformation

IsExpeditedShippingAvailable

表示是否可以加急运输.

Optional.

类型: boolean

IsFeaturedMerchant

表示该物品的卖家是否有资格获得Buy Box.

Optional.

类型: boolean

ShipsDomestically

表示该物品是否在国内发货.

Optional.

类型: 布尔型

OfferChangeTrigger

下表显示了OfferChangeTrigger对象的属性

Name Description
MarketplaceId

有报价变化的项目的市场识别码.

Required.

类型:字符串

asin

有报价变化的项目的ASIN.

Required.

类型: string

ItemCondition

有报价变化的项目的条件.例如,如果一个已使用的报价发生变化,在Offer对象中的报价数组将只有已使用的项目.摘要对象为其他可用于重新定价的条件提供一个摘要.

Required.

类型: string

TimeOfOfferChange

引起此通知的报价的更新时间,ISO 8601格式.

Required.

类型: string

OfferChangeType

改变并触发此通知的报价类型.

OfferChangeType values:

外部 -摘要对象中的CompetitivePriceThreshold发生了变化,是由一个非亚马逊卖家的新报价引发的.

内部 - 亚马逊零售网站上的一个报价的价格已经改变.

特色产品 -BuyBox的赢家或BuyBox的价格已经改变.

Required.

类型: string

OfferCount

下表显示了OfferCount对象的对象和属性

Name Description
Condition

表示物品的状况.例如新的,二手的,收藏的,翻新的,或俱乐部的.

Required.

类型: string

FulfillmentChannel

表示该商品是由亚马逊履行还是由卖家履行.

Required.

类型FulfillmentChannelType

OfferCount

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

类型: 整数

Points

下表显示了Points对象的属性

Name Description
PointsNumber

购买商品时提供的亚马逊积分数量.

Required.

类型: 整数

PrimeInformation

下表显示了PrimeInformation对象的对象和属性

Name Description
IsOfferNationalPrime

表明该产品在其上市的整个市场上是否是亚马逊Prime产品.

Required.

类型: boolean

IsOfferPrime

表示该优惠是否为亚马逊Prime优惠.

Required.

类型: boolean

SalesRank

下表显示了SalesRank对象的属性

Name Description
ProductCategoryId

该物品的产品类别标识符.

Required.

类型: string

级别

该商品在给定产品类别中的销售排名.

Required.

类型: 整数

SellerFeedbackRating

下表显示了SellerFeedbackRating对象的对象和属性

Name Description
SellerPositiveFeedbackRating

在过去的365天里,卖家的正面反馈率.

Optional.

类型: double

FeedbackCount

收到的关于卖家的反馈计数.

Required.

类型: long

ShippingTime

下表显示了ShippingTime对象的属性

Name Description
MinimumHours

订单下达后,商品可能被运走的最短时间,以小时为单位.

Optional.

类型:短

MaximumHours

下单后商品可能被运走的最长时间,以小时计.

Optional.

类型:短

AvailableDate

该物品可供运输的日期.仅显示于目前不可供运输的物品.

Optional.

类型: string

AvailabilityType

表示该物品是现在可以发货,还是在未来某个已知或未知的日期可以发货.如果已知,availableDate属性表示该物品可以发货的日期.

Optional.

类型:字符串

ShipsFrom

下表显示了ShipsFrom对象的对象和属性

Name Description
状态

该物品的发货地.

的状态

Optional.

类型: string

Country

物品运送的国家.

Optional.

类型: string

IsFulfilledByAmazon

表示该提议是否由亚马逊履行.

Required.

类型: boolean

Summary

下表显示了Summary对象的对象和属性

Name Description
NumberOfOffers

一个包含该项目在给定条件和履行渠道下的报价总数的列表.

Required.

类型OfferCount的阵列

LowestPrices

一个包含项目在给定条件和履行渠道下的最低价格的列表.

Required.

类型LowestPrice的阵列

BuyBoxPrices

一个包含项目在给定条件下的购买盒价格的列表.

Optional.

类型BuyBoxPrice的阵列

ListPrice

制造商建议的物品清单价格.

Optional.

类型MoneyType

SuggestedLowerPricePlusShipping

该商品的建议低价,包括运费(减去亚马逊积分).建议低价是基于一系列因素,包括历史销售价格、最近的Buy Box-合格价格,以及客户对你产品的输入.

Optional.

类型MoneyType

SalesRankings

一个包含商品在给定产品类别中的销售排名的列表.

Optional.

类型SalesRank的数组

NumberOfBuyBoxEligibleOffers

一个包含在给定条件和履行渠道下有资格获得Buy Box的报价总数的列表.

Required.

类型OfferCount的阵列

CompetitivePriceThreshold

这个价格是基于其他零售商的竞争价格(不包括其他亚马逊卖家).如果你的价格+运费大于这个竞争价格,你的报价可能没有资格获得购买箱.

Optional.

类型MoneyType

通知模式: AnyOfferChangedNotification.json (opens new window)

通知示例:

{
  "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": "macantId",
      "OfferChangeTrigger":
      {
        "MarketplaceId": "marketplaceId",
        "ASIN": "ysp2k4cziG",
        "ItemCondition": "Collectible",
        "TimeOfOfferChange": "2020-01-11T00:02:50.501Z",
        "OfferChangeType": ""
      },
      "摘要":
      {
        "NumberOfOffers": [
          {
            "条件": "new",
            "FulfillmentChannel": "Merchant",
            "OfferCount": 28
          }
        ],
        "LowestPrices": [
          {
            "条件": "new",
            "FulfillmentChannel": "商家",
            "LandedPrice":
            {
              "金额": 28.59,
              "CurrencyCode": "USD"
            },
            "ListingPrice":
            {
              "金额": 28.59,
              "CurrencyCode": "USD"
            },
            "航运":
            {
              "金额": 0,
              "CurrencyCode": "USD"
            }
          }
        ],
        "BuyBoxPrices": [
          {
            "条件": "新",
            "LandedPrice":
            {
              "金额": 14,
              "CurrencyCode": "美元"
            },
            "ListingPrice":
            {
              "金额": 12,
              "CurrencyCode": "USD"
            },
            "航运":
            {
              "金额": 2,
              "CurrencyCode": "USD"
            }
          }
        ],
        "ListPrice":
        {
          "金额": 14,
          "CurrencyCode": "USD"
        },
        "销售排名": [
          {
            "ProductCategoryId": "lawn_and_garden_display_on_website",
            "排名": 4013
          },
          {
            "ProductCategoryId": "home_garden_display_on_website",
            "等级": 17316
          }
        ],
        "NumberOfBuyBoxEligibleOffers": [
          {
            "条件": "new",
            "FulfillmentChannel": "Merchant",
            "OfferCount": 10
          }
        ]
      },
      "报价": [
        {
          "SellerId": "aqnacjem8puj1",
          "SubCondition": "new",
          "SellerFeedbackRating":
          {
            "FeedbackCount": 78786,
            "SellerPositiveFeedbackRating": 92
          },
          "发货时间":
          {
            "MinimumHours": 24,
            "最长时间": 48,
            "可用性类型": "",
            "AvailableDate": ""
          },
          "ListingPrice":
          {
            "金额": 28.59,
            "CurrencyCode": "USD"
          },
          "航运":
          {
            "金额": 0,
            "CurrencyCode": "USD"
          },
          "ShipsFrom":
          {
            "国家": "",
            "州": ""
          },
          "IsFulfilledByAmazon": false
        },
        {
          "SellerId": "a28ss3bs1dbq92",
          "SubCondition": "新"
          "SellerFeedbackRating":
          {
            "FeedbackCount": 6532,
            "SellerPositiveFeedbackRating": 99
          },
          "发货时间":
          {
            "MinimumHours": 24,
            "最长时间": 48,
            "可用性类型": "",
            "AvailableDate": ""
          },
          "ListingPrice":
          {
            "金额": 28.69,
            "CurrencyCode": "USD"
          },
          "航运":
          {
            "金额": 0,
            "CurrencyCode": "USD"
          },
          "ShipsFrom":
          {
            "国家": "",
            "州": ""
          },
          "IsFulfilledByAmazon": false
        }
      ]
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167

# B2B_ANY_OFFER_CHANGED

卖家可以订阅这个通知.

只要前20个B2B报价中的任何一个发生变化,即卖家列出的某个商品的任何价格变化(单价或数量折扣层价格),就会发送B2B_ANY_OFFER_CHANGED通知.前20个B2B报价是由单价-单位落地价决定的,也就是价格加运费.如果多个卖家收取相同的落地价,结果将以随机顺序返回.

你只会收到B2B_ANY_OFFER_CHANGED的通知,对于卖家有活动报价的项目.你不能订阅卖家没有活动报价的项目的通知.

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

Name Description
OfferChangeTrigger

导致通知被发送的事件.

Required.

类型OfferChangeTrigger

Summary

有报价变化的产品信息.本摘要中的信息适用于该产品的所有条件.

Required.

类型Summary

报价

触发通知的项目和条件的前20个竞争性B2B报价.

Required.

类型Offer的数组

SellerId

该报价的卖方识别码.

Required.

类型: string

# BuyBoxPrice

下表显示了BuyBoxPrice对象的对象和属性.

名称描述
landedPrice

listingPrice + shipping.

Optional.

类型MoneyType

listingPrice

项目的价格.

Required.

类型MoneyType

shipping

运输费用.

Optional.

类型MoneyType

offerType

表示该要约是B2B要约还是B2C要约.当要约类型为B2C的数量折扣时,卖家赢得购买箱是因为其他人没有该数量的库存,而不是因为他们有ASIN的数量折扣.

Required.

类型: string

quantityTier

该报价的数量层.

Required.

类型: 整数

discountType

表示该数量层是数量折扣还是累进折扣.

Optional.

类型: string

condition

表示物品的状况.例如新的,二手的,收藏的,翻新的,或俱乐部的.

Required.

类型: string

sellerId

该报价的卖方识别码.

Optional.

类型: string

# LowestPrice

下表显示了摘要对象下的LowestPrice类型的对象和属性

名称描述
LandedPrice

ListingPrice + Shipping.

Optional.

类型MoneyType

ListingPrice

物品的价格.

Required.

类型MoneyType

Shipping

运输费用.

Optional.

类型MoneyType

OfferType

表示该提议是B2B提议还是B2C提议

Required.

类型: string

QuantityTier

该报价的数量层

Required.

类型: 整数

DiscountType

表示该数量层是数量折扣还是累进折扣.

Optional.

类型: string

Condition

表示物品的状况.例如新的,二手的,收藏的,翻新的,或俱乐部的.

Required.

类型: string

FulfillmentChannel

表示该商品是由亚马逊履行还是由卖家履行.

Required.

类型FulfillmentChannelType

# Offer

下表显示了Offer对象的对象和属性

名称描述
SellerId

该报价的卖方标识符.

Required.

类型: string

SubCondition

物品的次要条件.例如, 薄荷, 非常好, , 可接受, , 俱乐部, OEMWarranty, Refurbished Warranty, Refurbished, Open Box, or Other.

Required.

类型: string

SellerFeedbackRating

关于卖家的反馈信息,包括正面反馈的百分比,以及收到的反馈总计数.

Optional.

类型SellerFeedbackRating

ShippingTime

订单下达后,该商品可能被运走的最短和最长时间,以小时为单位.

Required.

类型ShippingTime

ListingPrice

物品的价格.

Required.

类型MoneyType

Shipping

运输费用.

Required.

类型MoneyType

ShipsFrom

物品运送的国家.

Optional.

类型ShipsFrom

IsFulfilledByAmazon

表示该提议是否由亚马逊履行.

Required.

类型: boolean

IsBuyBoxWinner

表示该产品目前是否在购买箱中.每个ASIN在任何时候最多可以有两个购买箱赢家,一个有资格获得Prime,一个没有资格获得Prime.

Optional.

类型: boolean

ConditionNotes

关于物品状况的信息.

Optional.

类型: string

PrimeInformation

Amazon Prime信息.

Optional.

类型PrimeInformation

IsFeaturedMerchant

表示该物品的卖家是否有资格获得Buy Box.

Optional.

类型: boolean

# OfferChangeTrigger

下表显示了OfferChangeTrigger对象的属性

名称描述
MarketplaceId

有报价变化的项目的市场识别码.

Required.

类型:字符串

asin

有报价变化的项目的ASIN.

Required.

类型: string

ItemCondition

有报价变化的项目的条件.例如,如果一个已使用的报价发生变化,在Offer对象中的报价数组将只有已使用的项目.摘要对象为其他可用于重新定价的条件提供一个摘要.

Required.

类型: string

TimeOfOfferChange

引起此通知的offer的更新时间.

Required.

类型: string

# OfferCount

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

名称描述
Condition

表示物品的状况. 例如新的, 使用过的, 可收藏的, 翻新的, 或俱乐部.

Required.

类型: string

FulfillmentChannel

表示该商品是由亚马逊履行还是由卖家履行.

Required.

类型FulfillmentChannelType

OfferCount

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

类型: 整数

# PrimeInformation

下表显示了PrimeInformation对象的属性

名称描述
IsOfferNationalPrime

表明该产品在其上市的整个市场上是否是亚马逊Prime产品.

Required.

类型: boolean

IsOfferPrime

表示该优惠是否为亚马逊Prime优惠.

Required.

类型: boolean

# SellerFeedbackRating

下表显示了SellerFeedbackRating对象的属性

名称描述
SellerPositiveFeedbackRating

在过去的365天里,卖家的正面反馈率.

Optional.

类型: 整数

FeedbackCount

收到的关于卖家的反馈计数.

Required.

类型: 整数

# ShippingTime

下表显示了ShippingTime对象的属性

名称 描述
最短工作时间

下单后,商品可能被运走的最短时间,以小时为单位.

Optional.

类型: 整数

MaximumHours

下单后商品可能被运走的最长时间,以小时计.

Optional.

类型: 整数

AvailableDate

该物品可供运输的日期.仅显示于目前不可供运输的物品.

Optional.

类型: string

AvailabilityType

表示该物品是现在可以发货,还是在未来某个已知或未知的日期可以发货.如果已知,availableDate属性表示该物品将可以发货的日期.

Optional.

类型:字符串

# ShipsFrom

下表显示了ShipsFrom对象的属性

名称 描述
Country

物品运送的国家.

Optional.

类型: string

# Summary

下表显示了摘要对象的对象和属性

名称描述
NumberOfOffers

一个包含该项目在给定条件和履行渠道的B2B报价总数的列表.

Required.

类型OfferCount的数组

LowestPrices

一个包含项目在给定条件、履行渠道、数量层级和折扣类型下的最低价格的列表.

折扣类型 "数量折扣 "的七个预定义数量层级是2、3、5、10、20、30和50.

Required.

类型LowestPrice的数组

BuyBoxPrices

一个列表,包含了在给定条件下,数量层级和折扣类型的物品的购买盒价格.

最多显示前50个数量层.

Optional.

类型BuyBoxPrice的阵列

BuyBoxEligibleOffers

一个列表,包含了在给定条件和履行渠道下有资格获得Buy Box的B2B报价的总数.

Required.

类型OfferCount的数组

通知模式: B2bAnyOfferChangedNotification.json (opens new window)

通知示例:

{
  "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"
      },
      "摘要":
      {
        "numberOfOffers": [
          {
            "条件": "new",
            "履行渠道": "Merchant",
            "offerCount": 3
          }
        ],
        "buyBoxEligibleOffers": [
          {
            "条件": "new",
            "履行渠道": "Merchant",
            "offerCount": 3
          }
        ],
        "最低价格": [
          {
            "条件": "new",
            "fulfillmentChannel": "Merchant",
            "offerType": "B2B",
            "quantityTier": 1,
            "listingPrice":
            {
              "金额": 8184.23,
              "currencyCode": "USD"
            },
            "航运":
            {
              "金额": 4.49,
              "currencyCode": "USD"
            },
            "landedPrice":
            {
              "金额": 8188.72,
              "currencyCode": "USD"
            }
          },
          {
            "条件": "新"
            "履行渠道": "商家",
            "offerType": "B2B",
            "quantityTier": 20,
            "listingPrice":
            {
              "金额": 7500,
              "currencyCode": "USD"
            }
          },
          {
            "条件": "新"
            "履行渠道": "商家",
            "offerType": "B2B",
            "quantityTier": 30,
            "discountType": " quantity_discount",
            "listingPrice":
            {
              "金额": 6975,
              "currencyCode": "USD"
            }
          }
        ],
        "buyBoxPrices": [
          {
            "条件": "new",
            "offerType": "B2B",
            "quantityTier": 1,
            "listingPrice":
            {
              "金额": 8184.23,
              "currencyCode": "USD"
            },
            "航运":
            {
              "金额": 4.49,
              "currencyCode": "USD"
            },
            "landedPrice":
            {
              "金额": 8188.72,
              "currencyCode": "USD"
            }
          },
          {
            "条件": "新",
            "offerType": "B2B",
            "quantityTier": 20,
            "discountType": " quantity_discount",
            "listingPrice":
            {
              "金额": 8000,
              "currencyCode": "USD"
            }
          },
          {
            "条件": "新",
            "offerType": "B2B",
            "quantityTier": 30,
            "discountType": " quantity_discount",
            "listingPrice":
            {
              "金额": 7800,
              "currencyCode": "USD"
            }
          }
        ]
      },
      "offer": [
        {
          "sellerId": "a2vuidm8bz902a",
          "subCondition": "new",
          "sellerFeedbackRating":
          {
            "feedbackCount": 1,
            "sellerPositiveFeedbackRating": 0
          },
          "发货时间":
          {
            "minimumHours": 24,
            "最长时间": 48,
            "可用性类型": "可用",
            "availableDate": "2020-07-13T19:42:04.284Z"
          },
          "listingPrice":
          {
            "金额": 8184.23,
            "currencyCode": "USD"
          },
          "航运":
          {
            "金额": 4.49,
            "currencyCode": "USD"
          },
          "shipsFrom":
          {
            "country": "美国"
          },
          "isFulfilledByAmazon": false,
          "isBuyBoxWinner": true,
          "conditionNotes": "箱内新货"
          "primeInformation":
          {
            "isPrime": true,
            "isNationalPrime": true
          },
          "IsFeaturedMerchant": true
        }
      ]
    }
  }
}


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177

# BRANDED_ITEM_CONTENT_CHANGE

卖家可以订阅此通知.

只要标题、描述、要点或图片发生变化,亚马逊就会发送BRANDED_ITEM_CONTENT_CHANGE通知,该通知适用于任何与销售伙伴有品牌关系的ASIN.销售伙伴与ASIN有品牌关系,如亚马逊注册品牌计划中所定义当他们是一个经过验证的品牌所有者时. 销售伙伴是授权应用程序代表他们调用通知API的一方,目的是创建和管理通知订阅. 亚马逊为在任何亚马逊市场上列出的商品发送品牌_ITEM_CONTENT_CHANGE通知.

BRANDED_ITEM_CONTENT_CHANGE 有效载荷模式版本1.0

一个BRANDED_ITEM_CONTENT_CHANGE通知,其PayloadVersion=1.0包括Payload对象中的以下属性.

邓小平说过:"我们要做的是,把我们的工作做得更好,把我们的工作做得更好
名称 Description 要求
MarketplaceId 该物品被列入的市场.

类型: string

BrandName 该物品的品牌名称.

类型: string

是的
该物品的ASIN.

类型: string

AttributesChanged 已经改变的项目属性数组.属性名称、描述和要求可以通过调用产品类型定义API获得.更多信息,请参见产品类型定义API使用案例指南.

类型字符串的数组

可能的值:
bullet_point
项目名称
产品描述
main_product_image_locator
Other_product_image_locator_1
另一个产品形象定位器_2
其他产品形象定位器_3
其他_产品_图像_定位器_4
其他_产品_图像定位器_5
其他_产品_图像_定位器_6
其他_产品_图像_定位器_7
其他_产品_图像_定位器_8
色板_产品_图像_定位器

注: 上述数值中出现一个或多个包含image的字样(例如,main_product_image_locator, other_product_image_locator_1,等等)表示至少有一个图片在产品详细页上发生了变化.包含image字样的数值数量不一定与产品详细页上的图片数量一致.
是的

通知模式: BrandedItemContentChangeNotification.json (opens new window)

通知示例:

{
  "NotificationVersion": "1.0",
  "NotificationType": "branded_item_content_change",
  "PayloadVersion": "1.0",
  "EventTime": "2019-03-20T18:59:30.194Z",
  "Payload":
  {
    "MarketplaceId": "atvpdkikx0der",
    "BrandName": "大品牌",
    "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",
      "产品形象定位器"
    ]
  },
  "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"
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

# FBA_OUTBOUND_SHIPMENT_STATUS

卖家可以订阅这个通知.

每当亚马逊为卖家创建或取消Fulfillment by Amazon货物时,就会发送FBA_OUTBOUND_SHIPMENT_STATUS通知.该通知仅适用于FBA Onsite货物.该通知仅在巴西市场可用.

# FBAOutboundShipmentStatusNotification

下表显示了FBAOutboundShipmentStatusNotification对象的对象和属性

Name Description
SellerId

卖家识别码.

类型:字符串

AmazonOrderId

亚马逊-定义的订单标识符.

类型: string

AmazonShipmentId

亚马逊-定义的货件标识符.

类型: string

ShipmentStatus

货件状态.ShipmentStatus值创建,取消.

类型: string

通知模式: FBAOutboundShipmentStatusNotification.json (opens new window)

通知示例:

{
  "NotificationVersion": "1.0",
  "NotificationType": "fba_outbound_shipment_status",
  "PayloadVersion": "1.0",
  "EventTime": "2020-01-11T00:09:53.109Z",
  "Payload":
  {
    "FBAOutboundShipmentStatusNotification":
    {
      "SellerId": "mercantId",
      "AmazonOrderId": "113-2646096-4474645",
      "AmazonShipmentId": "DrLqQwqvb",
      "ShipmentStatus": "创建"
    }
  },
  "NotificationMetadata":
  {
    "ApplicationId": "appId",
    "SubscriptionId": "subId",
    "PublishTime": "2020-01-11T00:02:50.501Z",
    "NotificationId": "requestId"
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# FEE_PROMOTION

卖家可以订阅这个通知.

使用Selling Partner API的卖家可以从时间-有限的费用促销中获益.为了接收可用的费用促销通知,卖家必须订阅FEE_PROMOTION通知.当卖家最初注册订阅并且isEnabled被设置为true时,卖家会收到所有当前活动的促销.每个促销都以单个消息的形式发送.后续的促销通知会在促销变得活跃时发送.

FEE_PROMOTION通知是由一组数据字段组成的,描述了该促销的细节.每个促销的所有资格标准都将在这些数据字段中描述.

注意:该API返回的估计费用是不保证的.实际费用可能会有所不同.关于费用的更多信息,请参阅Selling on Amazon Fee Schedule (opens new window)FBA features and fees (opens new window) on Seller Central.

# FeeDetail

下表显示了FeeDetail对象的对象和属性

Name Description 要求 Value
FeeType 收费的类型. 是的

允许的费用类型ReferralFee, VariableClosingFee, PerItemFee, FBAFees, FBAPickAndPack, FBAWeightHandling, FBAOrderHandling, FBADeliveryServicesFee.

类型: string

FeeAmount 与收费类型相对应的收费金额. 是的 类型MoneyType
FeePromotion 与费用类型相对应的费用促销金额. 没有 类型MoneyType
TaxAmount 将向卖方收取的费用之外的税款计算. 没有 类型MoneyType
FinalFee 将向卖方收取的最终费用. 是的

FeeAmount减去FeePromotion.

类型MoneyType

IncludedFees 一个结构化的FeeDetail列表,包含特定费用类型的项目. 没有 类型FeeDetail的阵列

# FeesEstimate

下表显示了 FeesEstimate 对象的对象和属性

名称 描述 要求 价值
TimeOfFeesEstimated 估计费用的日期时间. 类型:字符串
TotalFeesEstimate 如果价格降到或低于价格阈值的费用总额. 类型MoneyType
FeeDetails TotalFeesEstimate). Yes Type: 数组的FeeDetail

# FeePromotionNotification

每个FeePromotionNotification对象是由以下数据对象组成的

名称 Description 要求 Value
FeePromotionType 促销的类型. 是的

值定价、SelectionASIN或SelectionCategory.未来可能会有更多的类型.

类型:字符串

FeePromotionTypeDescription 提供关于促销目的的更多细节. 没有

一个友好的、本地化的字符串描述.对集成商在用户界面上显示很有用.

类型:字符串

MarketplaceId 该促销活动适用于这个marketplaceId. 是的 类型: string
MerchantId 该促销活动适用于该商户ID. 是的 类型: string
Identifiers 本促销活动适用的项目列表. 是的 类型Identifier的数组
PromotionActiveTimeRange 该促销活动的时间范围. 是的 类型PromotionActiveTimeRange
PromotionInformation 一个包含关于促销活动的额外细节的对象.如果适用,还包括一个费用估算. 是的 类型PromotionInformation

# Identifier

下表描述了Identifiers数组中的对象和属性

的商户标识符类型
Name Description 要求 Value
IdentifierType 该促销活动将适用于.是的

例如ASIN, SKU, 浏览节点, 品牌.

类型: string

IdentifierValues ID值的友好名称. 是的

例如:商家的实际ASIN或SKU,一个实际的品牌列表(如Nike),一个实际的浏览节点列表.

类型IndentifierValue的数组

# IdentifierValue

该促销活动所适用的标识符值的描述.

名称 Description 要求 Value
IdentifierValueId 实际的浏览节点ID,实际的ASIN/SKU,或品牌值. 是的 类型: string
IdentifierValueFriendlyName 该促销活动将适用的商家标识符值. 没有 仅与浏览节点等相关/填充.例如,这将是一个浏览节点的友好名称.

类型: string

# PromotionInformation

下表显示了PromotionInformation对象的对象和属性

Name Description 要求 Value
FeeType 本次促销活动中被打折的费用类型. 是的

允许的费用类型ReferralFee, VariableClosingFee, PerItemFee, FBAFees, FBAPickAndPack, FBAWeightHandling, FBAOrderHandling, FBADeliveryServicesFee.

类型: string

FeeDiscountType 您将获得的费用促销类型. 是的

要么是固定的,要么是折扣的,要么是百分比点的折扣.

类型:字符串

PriceThreshold 促销活动必须满足的合格阈值报价,或更低的报价. 没有 类型MoneyType
FeeDiscountMonetaryAmount 如果FeeDiscountType涉及货币金额,您将从您的费用中获得的金额. 没有

如果FeeDiscountType涉及一个货币金额,这个值将被填充.

类型MoneyType

FeeDiscountValue 如果FeeDiscountType涉及到一个非-货币金额,您的费用的折扣百分比. 没有

如果FeeDiscountType涉及到一个非-货币金额,这个值将被填充.

类型:数字

FeesEstimate 该促销活动的费用估算,如果有的话.该估算假设促销活动所需的所有条件都已满足. 没有 类型FeesEstimate

# PromotionActiveTimeRange

下表显示了PromotionActiveTimeRange对象的属性

名称 描述 要求 价值
EffectiveFromDate Date (inclusive) when the promotion becomes active. Yes Type: string
EffectiveThroughDate Date (exclusive) when the promotion has ended. Yes Type: string

通知模式: FeePromotionNotification.json (opens new window)

通知的例子:

{
  "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": "mercantId",
      "MarketplaceId": "marketplaceId1",
      "FeePromotionType": "定价",
      "FeePromotionTypeDescription": "为了帮助您向客户提供更低的价格,当总售价(价格+运费+礼品包装)达到或低于定价阈值时,我们将为您的每笔销售提供临时的推荐费折扣."
      "促销活动时间范围"
      {
        "EffectiveFromDate": "2016-05-04T22:24:39.615Z",
        "EffectiveThroughDate": "2016-04-28T02:45:12.786Z"
      },
      "标识符": [
        {
          "IdentifierType": "ASIN",
          "IdentifierValues": [
            {
              "IdentifierValueId": "B0000000",
              "IdentifierValueFriendlyName": "1234"
            }
          ]
        }
      ],
      "PromotionInformations": [
        {
          "费用类型": "ReferralFee",
          "FeeDiscountType": "百分点折扣"
          "FeeDiscountValue": 5,
          "PriceThreshold":
          {
            "金额"1,
            "CurrencyCode": "美元"
          },
          "费用估算"
          {
            "TimeOfFeesEstimated": "2016-05-05T22:24:39.635Z",
            "TotalFeesEstimate":
            {
              "金额": 10,
              "CurrencyCode": "美元"
            },
            "FeeDetails": [
              {
                "FeeType": "feeType",
                "FeeAmount":
                {
                  "金额": 1,
                  "CurrencyCode": "美元"
                },
                "FeePromotion":
                {
                  "金额": 0.8,
                  "CurrencyCode": "USD"
                },
                "FinalFee":
                {
                  "金额": 0.2,
                  "CurrencyCode": "USD"
                }
              }
            ]
          }
        }
      ]
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

# FEED_PROCESSING_FINISHED

卖家可以订阅此通知.

每当使用Selling Partner API for Feeds提交的任何feed达到DONE、CANCELLED或FATAL的feed处理状态时,就会发送FEED_PROCESSING_FINISHED通知.

FEED_PROCESSING_FINISHED 有效载荷模式版本1.0

一个FEED_PROCESSING_FINISHED通知,其PayloadVersion=2020-09-04包括在feedProcessingFinishedNotification对象中的下列对象.

名称 Description 类型 Required
sellerId 销售伙伴识别码. 字符串 是的
feedId feeds的识别码. 字符串 Yes 是的
feedType feeds类型.更多信息,见feeds类型值. 字符串 是的
processingStatus feeds的处理状态. 字符串 是的
resultFeedDocumentId 进料文件的标识符.该标识符只有在与卖方ID结合时才是唯一的. 字符串 No

通知模式FeedProcessingFinishedNotification.json (opens new window)

通知的例子:

{
  "notificationVersion": "2020-09-04",
  "notificationType": "feed_processing_finished",
  "payloadVersion": "2020-09-04",
  "eventTime": "2020-07-13T19:42:04.284Z",
  "payload":
  {
    "feedProcessingFinishedNotification":
    {
      "sellerId": "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:42:04.284Z",
    "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746"
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

# FULFILLMENT_ORDER_STATUS

卖家可以订阅这个通知.

每当多渠道履约订单的状态发生变化时,就会发送FULFILLMENT_ORDER_STATUS通知.

# FulfillmentOrderStatusNotification

下表显示了FulfillmentOrderStatusNotification对象的对象和属性

Name Description
EventType

表示该通知是否包含订单、发货或退货信息.

EventType值:

Order -这个通知包含了关于一个履行订单的信息.

Shipment -这个通知包含了关于一个履行货物的信息.更多信息,请参阅FulfillmentShipment对象.

Return - 这个通知包含了关于一个履约退货的信息.

Required

类型: string

SellerId

卖家的识别码.

类型:字符串

StatusUpdatedDateTime

最后一次更新状态的日期和时间.以ISO 8601格式.

要求

类型:字符串

SellerFulfillmentOrderId

您使用CreateFulfillmentOrder操作创建并提交的履约订单标识符.

Required

类型: string

FulfillmentOrderStatus

履行订单的当前状态.

FulfillmentOrderStatus values:

  • Received -该履行订单已被收到并验证.验证包括确定目的地地址是有效的,并且亚马逊的记录显示卖家有足够的可销售的(未损坏的)库存来履行该订单.卖家可以取消一个状态为Received.

    的履行订单
  • 无效-该履行订单已收到,但无法验证.其原因包括无效的目的地地址或亚马逊的记录显示卖家没有足够的可销售库存来履行该订单.当这种情况发生时,该履行订单是无效的,该订单中的任何物品都不会发货.

  • Planning - 该履行订单已被发送到亚马逊的履行网络,开始装运计划,但任何货物中的任何单元都还没有从库存中提取. 卖方可以取消一个状态为Planning的履行订单.

  • Processing -该履行订单中至少有一批货物已经开始从库存中提取单位. 卖方不能取消状态为Processing的履行订单.

  • Cancelled - 该履行订单已被卖方取消

  • Complete -履行订单中的所有项目数量都已完成.

  • CompletePartialled -履行订单中的一些项目数量已经完成;其余的要么被取消,要么无法履行.

  • Unfulfillable -履行订单中没有物品数量可以被履行,因为亚马逊履行中心的工作人员没有发现这些物品的库存,或者没有发现可销售的库存(undamaged)状况.

Required

类型: string

FulfillmentShipment

履行订单中的货件的交付和物品信息.

Optional.仅当EventType为Shipment时返回.

类型FulfillmentShipment

FulfillmentReturnItem

关于被退回到亚马逊履行中心的物品的信息.

Optional.只在EventType为Return时返回.

类型FulfillmentReturnItem

# FulfillmentReturnItem

下表显示了FulfillmentReturnItem对象的对象和属性

Name Description
ReceivedDateTime

亚马逊履约中心收到退回物品的日期和时间.以ISO 8601日期时间格式.

要求

类型: string

ReturnedQuantity

被退回的数量.

Required

类型: 整数

SellerSKU

该物品的卖方SKU.

Required

类型: string

# FulfillmentShipment

下表显示了FulfillmentShipment对象的对象和属性

Name Description
FulfillmentShipmentStatus

货件的当前状态.

FulfillmentShipmentStatus的值:

  • Pending -从库存中挑选单位的过程已经开始.

  • Shipped -货物中的所有包裹都已离开履行中心.

  • CancelledByFulfiller - 亚马逊履行中心无法按计划履行货物.这可能是因为库存不在履行中心的预期位置.取消履行订单后,亚马逊立即创建一个新的履行货物并再次尝试履行订单.

  • CancelledBySeller - 这批货是用CancelFulfillmentOrder操作取消的.

Required

类型: string

AmazonShipmentId

由亚马逊分配的货物标识符.

Required

类型: string

EstimatedArrivalDateTime

货件的预计到达时间,格式为ISO 8601日期时间.注意这个值可能会随时间变化.如果货件包括多个包裹,EstimatedArrivalDateTime适用于货件中的所有包裹.如果货件已被取消,EstimatedArrivalDateTime不会返回.

Required

类型: string

FulfillmentShipmentPackages

包含了履行货件中的所有包裹.

可选择的

类型FulfillmentShipmentPackage的阵列

# FulfillmentShipmentPackage

下表显示了FulfillmentShipmentPackage对象的对象和属性

Name Description
PackageNumber

识别货件中的一个包裹.

要求

类型: 整数

CarrierCode

确定交付包裹的承运人.

要求

类型: string

TrackingNumber

用于获得追踪和交付信息的追踪号码.

要求

类型: string

通知模式: FulfillmentOrderStatusNotification.json (opens new window)

通知示例:

{
  "NotificationVersion": "1.0",
  "NotificationType": "fulfillment_order_status",
  "PayloadVersion": "1.0",
  "EventTime": "2020-01-11T00:09:53.109Z",
  "Payload":
  {
    "FulfillmentOrderStatusNotification":
    {
      "SellerId": "macantId",
      "EventType": "Shipment",
      "StatusUpdatedDateTime": "2020-01-11T00:09:53.109Z",
      "SellerFulfillmentOrderId": "OrderId",
      "FulfillmentOrderStatus": "完成"
      "FulfillmentShipment":
      {
        "FulfillmentShipmentStatus": "已发货",
        "AmazonShipmentId": "DZRSmwG2N",
        "EstimatedArrivalDateTime": "2014-12-19T22:59:59Z",
        "FulfillmentShipmentPackages": [
          {
            "PackageNumber": 1,
            "CarrierCode": "HERMESIT",
            "TrackingNumber": "&amp;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"
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

# ITEM_PRODUCT_TYPE_CHANGE

卖家可以订阅这个通知.

只要销售伙伴与之有品牌关系的任何商品的产品类型发生变化,亚马逊就会发送ITEM_PRODUCT_TYPE_CHANGE通知. 销售伙伴与某商品有品牌关系,具体定义见亚马逊注册品牌计划当他们是经过验证的品牌所有者时. 销售伙伴是授权应用程序代表他们调用通知API的一方,目的是创建和管理通知订阅. 亚马逊为在任何亚马逊市场上列出的物品发送ITEM_PRODUCT_TYPE_CHANGE通知.

ITEM_PRODUCT_TYPE_CHANGE 有效载荷模式版本1.0

一个ITEM_PRODUCT_TYPE_CHANGE通知,其PayloadVersion=1.0包括在Payload对象中的下列对象.

Object Description
MarketplaceId 该物品所处的市场.
Asin 该物品的ASIN.
PreviousProductType 以前的产品类型.
CurrentProductType 当前的产品类型.

通知模式: ItemProductTypeChangeNotification.json (opens new window)

通知示例:

{
  "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",
    "当前产品类型": "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"
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

# LISTINGS_ITEM_STATUS_CHANGE

卖家可以订阅这个通知.

当销售伙伴的listings项目状态发生变化时,亚马逊会发送LISTINGS_ITEM_STATUS_CHANGE通知. LISTINGS_ITEM_STATUS_CHANGE通知在listings项目创建、删除或其可购买性发生变化时发布. 通知的有效载荷提供了当前listings项目的信息和状态. 亚马逊对在任何亚马逊市场上市的项目发送了LISTINGS_ITEM_STATUS_CHANGE通知.

要检索关于清单的其他相关细节,如清单项目问题,请调用**清单项目的销售伙伴API.更多信息,见清单项目API用例指南 (opens new window).

销售伙伴是授权应用程序代表他们调用Notifications API以创建和管理通知订阅的一方.

LISTINGS_ITEM_STATUS_CHANGE 有效载荷模式版本1.0

一个LISTINGS_ITEM_STATUS_CHANGE通知,其PayloadVersion=1.0包括Payload对象中的下列对象.

的标识符
名称 Description 类型 Required
SellerID 销售伙伴的标识符,如卖家(商家)账户,受影响的列表项目.字符串 是的
MarketplaceId 受影响列表的亚马逊市场识别码 item. 字符串 No
Asin 亚马逊标准识别码(ASIN)与列表物品相关的目录物品的识别码. 字符串 No
Sku 受影响清单项目的标识符. 字符串 是的
CreatedDate 创建列表项目的时间戳,格式为ISO8601日期-时间. 字符串 No
状态 当前与受影响的列表项目相关的状态列表.没有一个值表示该状态目前不适用于该列表项目.例如,如果&quot;BUYABLE&quot;不存在,该列表项目目前不可购买. ListingsItemStatus的数组 是的

# ListingsItemStatus

该表显示了ListingsItemStatus的可能值

名称 描述
BUYABLE 表示列表中的物品可以在亚马逊零售网站上购买到相应的亚马逊市场. 当提供时,列表中的物品是可购买的. 当省略时,列表中的物品是不可购买的-buyable.
DISCOVERABLE 表示相关的亚马逊目录商品(ASIN)在亚马逊零售网站上的搜索结果中可以发现相应的亚马逊市场. 当提供时,该列表商品是可以发现的. 当省略时,该列表商品是不可-discoverable.
DELETED 当提供时,该列表项目被删除. 当省略时,该列表项目为非-删除.

通知模式ListingsItemStatusChangeNotification.json (opens new window)

通知的例子:

{
  "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",
    "状态": [
      "BUYABLE",
      "可发现"
    ]
  },
  "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"
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# LISTINGS_ITEM_ISSUES_CHANGE

卖家和供应商可以订阅这个通知.

只要销售伙伴拥有的listings项目的相关问题发生变化,亚马逊就会发送LISTINGS_ITEM_ISSUES_CHANGE通知.问题指出listings项目存在问题,导致上市不活跃、搜索抑制或其他质量问题.例如,如果销售伙伴的产品图片分辨率低,这个问题会导致这个产品的搜索抑制.亚马逊对在任何亚马逊市场上市的项目发出LISTINGS_ITEM_ISSUES_CHANGE通知.

LISTINGS_ITEM_ISSUES_CHANGE*通知是在清单上的问题被创建、修复或更新时触发的.通知的有效载荷包括基本的清单信息、相关问题的严重程度以及问题引起的执行行动.要检索与清单相关的问题的更多细节,请调用Selling Partner API for Listings Items**.更多信息,见Listings Items API Use Case Guide (opens new window).

列表中可能出现的所有问题都没有相应的定义问题.因此,该通知不一定代表列表中的所有问题(也不代表销售伙伴API for Listings Items).亚马逊正在努力定义更多的问题,以更紧密地代表可能出现的列表问题.

销售伙伴是授权应用程序代表他们调用Notifications API以创建和管理通知订阅的一方.

LISTINGS_ITEM_ISSUES_CHANGE 有效载荷模式版本1.0

一个LISTINGS_ITEM_ISSUES_CHANGE通知,其PayloadVersion=1.0包括Payload对象中的下列对象.

的标识符
名称 Description 类型 Required
SellerId 销售伙伴的标识符,如卖家(商人)账户或供应商代码,受影响的列表项目.字符串 是的
MarketplaceId 受影响列表的亚马逊市场识别码 item. 字符串 No
Asin 亚马逊标准识别码(ASIN)与列表物品相关的目录物品的识别码. 字符串 No
Sku 受影响列表项目的标识符. string 是的
Severities 与受影响的列表项目相关的问题的严重性列表.当没有问题影响列表项目时,会提供&quot;NONE&quot;代替. Array of IssueSeverity 是的
EnforcementActions 亚马逊针对与受影响列表项目相关的问题所采取的执法行动清单. Array of IssueEnforcementActions No

# IssueSeverity

这个表格显示了IssueSeverity的可能值

名称 描述
ERROR 当提供时,至少有一个严重程度为 "ERROR "的问题正在影响列表中的项目.
WARNING 当提供时,至少有一个严重程度为 "WARNING "的问题正在影响列表 item.
NONE 当提供时,没有定义的问题影响列表项目. 然而,列表可能有其他问题.

# IssueEnforcementActions

该表显示了IssueEnforcementActions的可能值

名称 描述
SEARCH_SUPPRESSED 当提供时,由于目前至少有一个问题与受影响的上市项目相关,该上市项目被抑制在搜索结果中.

通知模式ListingsItemIssuesChangeNotification.json (opens new window)

通知的例子:

{
  "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",
      "警告"
    ],
    "EnforcementActions": [
      "搜索_压制"
    ]
  },
  "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"
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

# MFN_ORDER_STATUS_CHANGE

卖家可以订阅这个通知.

每当MFN订单可用性的状态发生变化时,MFN_ORDER_STATUS_CHANGE通知就会发送.

MFN_ORDER_STATUS_CHANGE 有效载荷模式版本1.0

一个MFN_ORDER_STATUS_CHANGE通知,其PayloadVersion=1.0包括MFNOrderNotification对象中的以下属性.

名称 Description 类型 Required
SellerId 销售伙伴识别码. 字符串 是的
MarketplaceId 市场识别码. 字符串 是的
AmazonOrderId 一个亚马逊-定义的订单标识符,以3-7-7的格式. 字符串 是的
PurchaseDate 订单的购买日期,以大纪元时间为准. 整数或空 是的
OrderStatus 当前的订单状态. 字符串 是的
DestinationPostalCode 目的地邮政编码.
注意:这个邮政编码暂时不可用,在通知中会显示为空值.
string或null 是的
SupplySourceId 供应源的唯一标识符. 字符串或空 是的
OrderItemId 亚马逊-定义的订单项目标识符. 字符串 是的
SellerSKU 物品的卖家-特定SKU标识符. 字符串 是的
Quantity 订单中的物品数量. 字符串 是的

通知模式MfnOrderStatusChangeNotification.json (opens new window)

通知的例子:

{
  "NotificationVersion": "1.0",
  "NotificationType": "mfn_order_status_change",
  "PayloadVersion": "1.0",
  "EventTime": "2020-07-13T19:42:04.284Z",
  "Payload":
  {
    "MFNOrderStatusChangeNotification":
    {
      "SellerId": "axxxxxxxxxxxxx",
      "MarketplaceId": "atvpdkikx0der",
      "AmazonOrderId": "333-7777777-7777777",
      "PurchaseDate": 1595882000633,
      "OrderStatus": "SHIPPING",
      "DestinationPostalCode": "48110",
      "SupplySourceId": "55448834-0d79-5155-75c4-8529543a7c31",
      "OrderItemId": "oiid34853450"
      "SellerSKU": "SellerSKUID1",
      "数量": 45
    }
  },
  "NotificationMetadata":
  {
    "ApplicationId": "app-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746",
    "SubscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746",
    "发布时间""2020-07-13T19:42:04.284Z",
    "NotificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746"
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

# ORDER_STATUS_CHANGE

卖家可以订阅这个通知.

每当订单可用性状态发生变化时,就会发送ORDER_STATUS_CHANGE通知.

ORDER_STATUS_CHANGE 有效载荷模式版本1.0

具有PayloadVersion=1.0ORDER_STATUS_CHANGE通知包括OrderNotification对象中的以下属性.

名称 Description 类型 Required
SellerId 销售伙伴识别码. 字符串 是的
MarketplaceId 受影响订单的亚马逊市场识别码. 字符串 是的
AmazonOrderId 一个亚马逊-定义的订单标识符,以3-7-7的格式. 字符串 是的
PurchaseDate 订单的购买日期,以大纪元时间为准. 整数或空 是的
OrderStatus 当前的订单状态.可能的值包括UpComing, Pending, Unshipped, PartiallyShipped, PendingAvailability, Canceled, InvoiceUnconfirmed, Shipped, and Unfulfillable. 字符串 是的
DestinationPostalCode 目的地邮编.
注意:此邮编暂时不可用,将在通知中显示为空值.
字符串或空值 是的
SupplySourceId 供应源的唯一标识符. 字符串或空 是的
OrderItemId 亚马逊-定义的订单项目标识符. 字符串 是的
SellerSKU 物品的卖家-特定SKU标识符. 字符串 是的
Quantity 订单中的物品数量. 字符串 是的
FulfillmentChannel 受影响订单的履行渠道.
可能的值MFN或AFN.
字符串 是的

通知模式OrderStatusChangeNotification.json (opens new window)

通知的例子:

{
  "NotificationVersion": "1.0",
  "NotificationType": "order_status_change",
  "PayloadVersion": "1.0",
  "EventTime": "2020-07-13T19:42:04.284Z",
  "Payload":
  {
    "OrderStatusChangeNotification":
    {
      "SellerId": "axxxxxxxxxxxxx",
      "MarketplaceId": "atvpdkikx0der",
      "AmazonOrderId": "333-7777777-7777777",
      "PurchaseDate": 1595882000633,
      "OrderStatus": "未发货"
      "DestinationPostalCode": "48110",
      "SupplySourceId": "55448834-0d79-5155-75c4-8529543a7c31",
      "OrderItemId": "oiid34853450"
      "SellerSKU": "SellerSKUID1",
      "数量": 45,
      "FulfillmentChannel": "MFN"
    }
  },
  "NotificationMetadata":
  {
    "ApplicationId": "app-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746",
    "SubscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746",
    "发布时间""2020-07-13T19:42:04.284Z",
    "NotificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746"
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

# PRICING_HEALTH

卖家可以订阅这个通知.

只要卖家的报价因为没有竞争力的价格而没有资格成为特色报价(买箱报价),就会发送PRICING_HEALTH通知.卖家可以采取措施,通过调整报价的总价(价格加运费减积分),使其符合或低于竞争力的价格,或符合提供的参考价格.这些包括特色报价的价格60-天的平均销售价格,14-天的最高价格(由亚马逊运输和销售),以及清单价格.要想获得特色报价资格,您必须定价具有竞争力,并满足其他旨在为客户提供良好购物体验的合格标准,包括优惠的价格、可用性和交付速度.特色报价是客户在产品详细页面上选择**添加到购物车时选择的报价.

payloadVersion=1.0的PRICING_HEALTH通知在payload对象中包括以下属性.

名称 Description
issueType 该通知的问题类型.

Required.

类型: string

sellerId 该报价的卖方标识符.

Required.

类型: string

offerChangeTrigger 导致通知被发送的事件.

Required.

类型offerChangeTrigger

merchantOffer 收到通知的商户的优惠详情.

Required.

类型merchantOffer

summary 关于有报价变化的项目的信息.该摘要中的信息适用于该产品的所有条件.

Required.

类型summary

buyBoxPrice

下表显示了buyBoxPrice对象的对象和属性

Name Description
condition

表示项目的条件.

Required.

类型: string

landedPrice

挂牌价加运费.

Required.

类型moneyType

listingPrice

物品的价格.

Required.

类型moneyType

shipping

运输费用.

Required.

类型moneyType

points

购买商品时提供的亚马逊积分的数量.

Optional.

类型points

merchantOffer

下表显示了 merchantOffer 对象的对象和属性

帐户余额为1,000,000美元
Name Description
condition 表示该物品的状况.

Required.

类型:字符串

fulfillmentType 表示该商品是由亚马逊履行还是由卖家履行.

Required.

类型:字符串

landedPrice 挂牌价加运费.

Required.

类型moneyType

listingPrice 项目的价格.

Required.

类型moneyType

shipping 运输费用.

Required.

类型: string

购买商品时提供的亚马逊积分的数量.

Optional.

Note: 积分对象只在日本返回(JP).

类型points

offerChangeTrigger

下表显示了offerChangeTrigger对象的对象和属性

Name Description
marketplaceId 有报价变化的项目的市场标识符.

Required.

类型:字符串

asin 有报价变化的项目的ASIN.

Required.

类型:字符串

itemCondition 有报价变化的项目的条件.

Required.

类型:字符串

timeOfOfferChange 引起此通知的offer的更新时间.

Optional.

类型:字符串

offerCount

下表显示了offerCount对象的对象和属性

Name Description
condition

表示项目的条件.

Required.

类型: string

fulfillmentType

表示该物品是由亚马逊履行还是由卖家履行.

Required.

类型: string

offerCount

"指定条件和履行渠道的报价总数.

Required.

类型: 整数

points

下表显示了point对象的对象和属性

Name Description
pointsNumber

购买商品时提供的亚马逊积分的数量.

Required.

类型: 整数

referencePrice

下表显示了referencePrice对象的对象和属性

Name Description
averageSellingPrice

该物品的平均销售价格.

Optional.

类型moneyType

competitivePriceThreshold

来自亚马逊外部竞争者的竞争价格门槛.

Optional.

类型moneyType

retailOfferPrice

零售报价的14天上限.

Optional.

类型moneyType

msrpPrice

制造商对ASIN.

的建议零售价

Optional.

类型moneyType

salesRank

下表显示了salesRank对象的对象和属性

排名
Name Description
productCategoryId

该等级的产品类别.

Required.

类型: string

该ASIN的销售排名.

Required.

类型: 整数

summary

下表显示了摘要对象的对象和属性

Name Description
numberOfOffers

一个包含该项目在给定条件和履行渠道下的报价总数的列表.

Required.

类型:offerCount

的阵列
buyBoxEligibleOffers

一个列表,包含了在给定条件和履行渠道下有资格获得购买盒的优惠的总数.

Required.

类型:offerCount

的阵列
buyBoxPrices

一个包含给定条件下物品的买箱价格的列表.

Optional.

类型:buyBoxPrice

的数组
salesRankings

一个包含ASIN在不同产品类别中的销售排名的列表.

Optional.

类型:salesRank

的数组
referencePrice

一组给定的ASIN.

的参考价格

Required.

类型referencePrice

通知模式PricingHealthNotification.json (opens new window)

通知的例子:

{
  "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":
    {
      "条件": "new",
      "履行类型": "MFN",
      "listingPrice":
      {
        "金额": 8184.23,
        "currencyCode": "USD"
      },
      "航运":
      {
        "金额": 4.49,
        "currencyCode": "USD"
      },
      "landedPrice":
      {
        "金额": 8188.72,
        "currencyCode": "USD"
      },
      "积分":
      {
        "pointNumber": 34343
      }
    },
    "摘要"
    {
      "numberOfOffers": [
        {
          "条件": "new",
          "履行类型": "MFN",
          "offerCount": 3
        }
      ],
      "buyBoxEligibleOffers": [
        {
          "条件": "新",
          "履行类型": "MFN",
          "offerCount": 3
        }
      ],
      "buyBoxPrices": [
        {
          "条件": "new",
          "listingPrice":
          {
            "金额": 8184.23,
            "currencyCode": "USD"
          },
          "航运":
          {
            "金额": 4.49,
            "currencyCode": "USD"
          },
          "landedPrice":
          {
            "金额": 8188.72,
            "currencyCode": "USD"
          },
          "积分":
          {
            "pointNumber": 34343
          }
        }
      ],
      "销售排名": [
        {
          "productCategoryId": "lawn_and_garden_display_on_website",
          "等级": 4013
        },
        {
          "productCategoryId": "home_garden_display_on_website",
          "等级": 17316
        }
      ],
      "参考价格":
      {
        "平均销售价格"
        {
          "金额": 7500,
          "currencyCode": "美元"
        },
        "competitivePriceThreshold":
        {
          "数额": 8000,
          "currencyCode": "美元"
        },
        "msrpPrice":
        {
          "金额": 7900,
          "currencyCode": "USD"
        },
        "retailOfferPrice":
        {
          "金额": 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"
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

# PRODUCT_TYPE_DEFINITIONS_CHANGE

卖家和供应商可以订阅这个通知.

只要有新的产品类型或产品类型版本,就会发送**PRODUCT_TYPE_DEFINITIONS_CHANGE通知.

如果通知是由市场上增加一个或多个新的产品类型触发的,通知的有效载荷提供了新产品类型的名称和适用于这些产品类型的产品类型版本.

如果通知只由新的产品类型版本触发,通知的有效载荷提供新的产品类型版本.

关于产品类型的更多信息,请参阅产品类型定义API用例指南 (opens new window).

PRODUCT_TYPE_DEFINITIONS_CHANGE 有效载荷模式版本1.0

一个PRODUCT_TYPE_DEFINITIONS_CHANGE通知,其PayloadVersion=1.0包括Payload对象中的以下属性.

的字符串
名称 Description 类型 Required
AccountId 销售伙伴的标识符,如销售商(商人)账户或供应商组ID. 字符串 是的
MarketplaceId 受影响产品类型或产品类型版本的亚马逊市场识别码. 字符串 没有
ProductTypeVersion 发布的亚马逊产品类型定义的版本. 字符串 是的
NewProductTypes 在市场上推出的产品类型列表. Array of string没有

通知模式ProductTypeDefinitionsChangeNotification.json (opens new window)

通知的例子

示例1:新产品类型的通知

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

例2:产品类型版本变更的通知

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

# REPORT_PROCESSING_FINISHED

卖家可以订阅这个通知.

当您使用Selling Partner API for Reports请求的任何报告达到DONE、CANCELLED或FATAL的报告处理状态时,将发送REPORT_PROCESSING_FINISHED通知.

REPORT_PROCESSING_FINISHED 有效载荷模式版本1.0

具有PayloadVersion=2020-09-04REPORT_PROCESSING_FINISHED通知在reportProcessingFinishedNotification**对象中包括下列对象.

名称 Description 类型 Required
sellerId 销售伙伴识别码. 字符串 是的
reportId 报告的识别码. 字符串 是的
reportType 报告类型.更多信息,见报告类型值. 字符串 是的
processingStatus 报告的处理状态. 字符串 是的
reportDocumentId 报告文件的标识符.该标识符只有在与卖方ID结合时才是唯一的. 字符串 No

通知模式ReportProcessingFinishedNotification.json (opens new window)

通知的例子:

{
  "notificationVersion": "2020-09-04",
  "notificationType": " report_processing_finished",
  "payloadVersion": "2020-09-04",
  "eventTime": "2020-07-14T03:35:13.214Z",
  "payload":
  {
    "reportProcessingFinishedNotification":
    {
      "sellerId": "axxxxxxxxxxxxx",
      "reportId": "54517018502",
      "报告类型": "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:42:04.284Z",
    "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746"
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

# 通用类型

包含所有通知所使用的普通类型,这些类型包含在通知有效载荷对象中.

# FulfillmentChannelType

表示该商品是由亚马逊还是由卖家完成的.

类型:字符串

FulfillmentChannelType的值

  • 亚马逊

-商家

# moneyType

货币类型和金额.

下表显示了MoneyType对象的属性

Name Description
金额

货币金额.

类型:数字

currencyCode

三位数的货币代码.在ISO 4217格式.

类型:字符串

# MoneyType

货币类型和金额.

下表显示了MoneyType对象的属性

Name Description
金额

货币金额.

类型:数字

CurrencyCode

三位数的货币代码.在ISO 4217格式.

类型:字符串

Last Updated: 2022/10/20 下午11:58:42