Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.
您可以使用亚马逊商城网络服务 (亚马逊 MWS)的“订单 API”部分来创建简单应用程序,以便仅检索您所需的订单详情。这样,您即可针对如下领域开发快速、灵活、定制的应用程序:订单同步、订单搜索,以及根据需求进行决策的支持工具。
“订单 API”部分包括以下操作:
操作 | 简短说明 |
---|---|
ListOrders | 返回您在指定时间段内所创建或更新的订单。 |
ListOrdersByNextToken | 使用 NextToken 参数返回下一页订单。 |
GetOrder | 根据您指定的 AmazonOrderId 值返回订单。 |
ListOrderItems | 根据您指定的 AmazonOrderId 返回订单商品。 |
ListOrderItemsByNextToken | 使用 NextToken 参数返回下一页订单商品。 |
GetServiceStatus | 返回 “订单 API”部分 的运行状态。 |
您可以通过 ListOrders 操作来检索订单商品信息,进而找到您在指定时间段内所创建或更新的订单。所返回的订单中包含 AmazonOrderId 值。然后,您便可以使用这些 AmazonOrderId 值(通过 ListOrderItems 操作)获取每个订单的详细订单商品信息。
想要确定向订单 API 发送请求时使用的 URL,只需要向您的商城端点添加“/Orders/2013-09-01”。例如,如果使用中国的亚马逊商城服务,则 URL 应为 https://mws.amazonservices.com.cn/Orders/2013-09-01
以下列表对 API 部分一些重要词汇进行定义:
术语 | 定义 |
---|---|
Order item | 商品和数量。例如,如果买家购买了三本同款图书,则订单所包含的一种商品的数量为 3。如果其中一本图书进行礼品包装,则订单中包含以下两种订单商品:
|
Order | 订单需考虑以下因素:
|
Pre-order | 订单所含商品的制造商发售日期是将来的某一天。请注意:预订订单仅适用于日本。 |
Standard order | 订单所含商品具有可售库存。 |
请注意:对于使用多渠道配送的亚马逊物流 (FBA) 卖家:如果您提交的主动移除订单中未包含 ShippingAddress,则订单 API 部分将不会返回该订单的 ShippingAddress。有关多渠道配送的更多信息,请参阅您的商城中的亚马逊卖家平台网站的帮助页面。
以下列表中介绍了亚马逊MWS限制 理念:
“订单 API”部分已进行优化,可用于数据同步,实时检索订单更新情况,并进行订单调查。对于批量订单数据报告,您应通过 报告 API 部分来创建订单报告。要获取有关 报告 API 部分的更多信息,请参阅 报告 API 部分文档。