征求服务 API v1 用例指南
向买家发送一致、高质量的征求服务。
API 版本:v1
什么是征求服务 API?
You can use the Selling Partner API for Solicitations (Solicitations API) to build applications that let sellers send consistent, high-quality solicitations to buyers. Sellers can request both a product review and seller feedback by sending a single template-based email.
教程 1:设置请求 API
本指南演示了如何在征求反馈之前设置请求 API。
先决条件
要完成本教程,您需要:
- 适用于征求服务的订单。
- The Buyer Solicitation role or the Product Listing role.
第 1 步。订阅 ORDER_CHANGE
通知
ORDER_CHANGE
通知For more information, refer to Tutorial: Subscribe to the ORDER_CHANGE Notification.
第 2 步。验证 OrderStatus
参数
OrderStatus
参数The Amazon Simple Queue Service (SQS) workflows receives the payload of the ORDER_CHANGE
notification. You can use Amazon SQS to validate the OrderStatus
parameter. Check that the OrderStatus
value has changed to Shipped
. Eliminate redundancies to make sure whether a solicitation has already been dispatched for a specific order. For more information on how to poll the SQS queue, refer to Tutorial: Set up notifications (Amazon Simple Queue Service workflow).
第 3 步。请查看 EarliestDeliveryDate
和 LatestDeliveryDate
参数
EarliestDeliveryDate
和 LatestDeliveryDate
参数您可以在活动结束后的五天内申请招标 EarliestDeliveryDate
到 30 天后 LatestDeliveryDate
。在此时间范围之外调用请求 API 将导致意外的 API 错误。
第 4 步。存储密钥标识符
存档或缓存 amazonOrderId
和 MarketplaceId
参数。这些标识符是将来征求评论所必需的。
现在,您可以征求反馈了。
教程:征求订单反馈
本教程向您展示如何征求订单的商品评论和卖家反馈。您首先验证订单是否适用于征求服务,然后创建征求服务请求。
先决条件
要完成本教程,您需要:
- 适用于征求服务的订单。
- The Buyer Solicitation role or the Product Listing role.
步骤 1. 验证订单是否适用于征求服务
Call the getSolicitationActionsForOrder
operation, passing the following parameters:
路径参数
参数 | 描述 | 必填项 |
---|---|---|
amazonOrderId |
亚马逊订单编号。指定您希望获得其可用征求服务类型列表的订单。 类型:字符串 |
有帮助 |
查询参数
参数 | 描述 | 必填项 |
---|---|---|
marketplaceIds |
商城标识符。指定下订单的商城。只能指定一个商城。 类型:数组 [字符串] |
有帮助 |
请求示例
GET https://sellingpartnerapi-na.amazon.com/solicitations/v1/orders/333-7777777-7777777
?marketplaceIds=ATVPDKIKX0DER
响应示例
没有可用征求服务操作时的响应示例:
{
"_links": {
"actions": [],
"self": {
"href": "/solicitations/v1/orders/111-1111111-1111111?marketplaceIds=ATVPDKIKX0DER"
}
},
"_embedded": {
"actions": []
}
}
有征求服务操作时的响应示例:
{
"_links": {
"actions": [
{
"href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback?marketplaceIds=ATVPDKIKX0DER",
"name": "productReviewAndSellerFeedback"
}
],
"self": {
"href": "/solicitations/v1/orders/111-1111111-1111111?marketplaceIds=ATVPDKIKX0DER"
}
},
"_embedded": {
"actions": [
{
"_links": {
"schema": {
"href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback/schema",
"name": "productReviewAndSellerFeedback"
},
"self": {
"href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback?marketplaceIds=ATVPDKIKX0DER",
"name": "productReviewAndSellerFeedback"
}
},
"_embedded": {
"schema": {
"_links": {
"self": {
"href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback/schema",
"name": "productReviewAndSellerFeedback"
}
},
"type": "object",
"name": "productReviewAndSellerFeedback",
"title": "Request seller feedback and product review",
"description": "Request seller feedback and product review",
"properties": {},
"required": [],
"$schema": "http://json-schema.org/draft-04/schema#",
"x-ui-hidden": true
}
},
"name": "productReviewAndSellerFeedback",
"title": "Request seller feedback and product review"
}
]
}
}
步骤 2. 创建产品评论征求服务
If the productReviewAndSellerFeedback
action is listed in the response, call the createProductReviewAndSellerFeedbackSolicitation
operation, passing the following parameters:
路径参数
参数 | 描述 | 必填项 |
---|---|---|
amazonOrderId |
亚马逊订单编号。指定发送征求服务的订单。 类型:字符串 |
有帮助 |
查询参数
参数 | 描述 | 必填项 |
---|---|---|
marketplaceIds |
商城标识符。指定下订单的商城。只能指定一个商城。 类型:数组 [字符串] |
有帮助 |
请求示例
POST https://sellingpartnerapi-na.amazon.com/solicitations/v1/orders/333-7777777-7777777/solicitations/productReviewAndSellerFeedback
?marketplaceIds=ATVPDKIKX0DER
响应示例
不符合条件的订单的响应示例:
{}
不符合条件的订单的响应示例:
{
"errors": [
{
"code": "Unauthorized",
"message": "The requested solicitation is not available for this amazonOrderId.",
"details": ""
}
]
}
最佳实践
征求评论时,请确保:
- 为已配送的订单寻求评论。
- 在允许的时间范围内提示反馈。
请注意,你不能:
- 有选择地寻求正面评价。
- 请求修改现有评论。
- 为评论提供奖励或激励。
For more information on how to ethically navigate solicitations, review the Anti-Manipulation Policy for Customer Reviews.
将负面反馈转化为机会
When you receive negative reviews, your effort to resolve the buyer's issue can change the narrative. Once you have resolved the buyer's problem, call the createNegativeFeedbackRemoval
operation from the Messaging API. Sellers can use this operation to ask the buyer to remove the unfavorable feedback. This offers sellers a second chance and underscores their commitment to customer satisfaction.
Updated 7 months ago