Amazon Services China
亚马逊商城网络服务(亚马逊 MWS)文档

Deprecation Notice:

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”部分的相关内容

您可以使用亚马逊商城网络服务 (亚马逊 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”部分所提供的同步数据,来执行以下业务分析:
  • 支持FBA补货和清除决策:
    • 通过较高或较低销售量查找 SKU
    • 通过 SKU 监控销售趋势
  • 支持销售渠道和配送渠道决策:
    • 通过销售渠道和配送渠道,来查找 SKU
    • 通过 SKU 监控销售趋势
  • 问题监控:
    • 查找过长的给定状态 SKU
    • 通过 SKU 查找销售趋势的异常更改

何时使用 “订单 API”部分

“订单 API”部分已进行优化,可用于数据同步,实时检索订单更新情况,并进行订单调查。对于批量订单数据报告,您应通过 报告 API 部分来创建订单报告。要获取有关 报告 API 部分的更多信息,请参阅 报告 API 部分文档。