主页文档代码示例API 参考公告模型发行说明常见问题GitHub视频
开发者中心API 状态支持
文档
开发者中心API 状态支持

征求服务 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 Solicitations API implementation flowchart

第 1 步。订阅 ORDER_CHANGE 通知

For more information, refer to Tutorial: Subscribe to the ORDER_CHANGE Notification.

第 2 步。验证 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 步。请查看 EarliestDeliveryDateLatestDeliveryDate 参数

您可以在活动结束后的五天内申请招标 EarliestDeliveryDate 到 30 天后 LatestDeliveryDate。在此时间范围之外调用请求 API 将导致意外的 API 错误。

第 4 步。存储密钥标识符

存档或缓存 amazonOrderIdMarketplaceId 参数。这些标识符是将来征求评论所必需的。

现在,您可以征求反馈了。

教程:征求订单反馈

本教程向您展示如何征求订单的商品评论和卖家反馈。您首先验证订单是否适用于征求服务,然后创建征求服务请求。

先决条件

要完成本教程,您需要:

步骤 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.


此页面对您有帮助吗?