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.
返回您在指定时间段内所创建或更新的订单。
该 ListOrders 操作可返回您在指定时间段内创建或更新的订单列表。您可以通过 CreatedAfter 参数或 LastUpdatedAfter 参数来指定时间段。您必须使用其中一个参数,但不可同时使用两个参数。您还可以通过应用筛选条件来缩小返回的订单列表范围。该 ListOrders 操作包括每个所返回订单的订单详情,其中包括 AmazonOrderId、 OrderStatus、 FulfillmentChannel 和 LastUpdateDate。
下表显示该 ListOrders 操作何时返回卖家配送网络 (MFN) 订单的买家联系信息(BuyerEmail、 BuyerName、ShippingAddress)以及费用信息 (OrderTotal)。
对于以下状态的普通订单: | …ListOrders 操作返回这些买家联系方式和费用信息响应元素: |
---|---|
Pending | 无 |
Unshipped、 PartiallyShipped、 Shipped | BuyerEmail、 BuyerName、 ShippingAddress、 OrderTotal |
对于以下状态的预订订单: | …ListOrders 操作返回这些买家联系方式和费用信息响应元素: |
---|---|
PendingAvailability、 Pending | BuyerEmail、 BuyerName |
Unshipped、 PartiallyShipped、 Shipped | BuyerEmail、 BuyerName、 ShippingAddress、 OrderTotal |
该 ListOrders 和 ListOrdersByNextToken 操作的最大请求限额为 6 个,恢复速率为每分钟 1 个请求。有关限制术语的相关定义,请参阅您应了解的“订单 API”部分的相关内容。
名称 | 描述 | 必填项 | 有效值 |
---|---|---|---|
CreatedAfter | 指定某一格式为 ISO 8601 的日期,用以选择在该日期之后(或当天)创建的订单。 | 是,如果未指定 LastUpdatedAfter 的值。 同时指定 CreatedAfter 和 LastUpdatedAfter 的值时,将返回一个错误。 |
必须不迟于两分钟,且在请求提交时间之前。 类型:xs:dateTime |
CreatedBefore
|
指定某一格式为 ISO 8601 的日期,用以选择在该日期之前(或当天)创建的订单。 | 否 只有在已指定 CreatedAfter 的值时,才可指定该参数的值。 如果已指定 LastUpdatedAfter 的值,则不可指定该参数的值。 |
必须迟于 CreatedAfter 的值。 必须不迟于两分钟,且在请求提交时间之前。 默认值:现在时间减去两分钟 类型:xs:dateTime |
LastUpdatedAfter | 指定某一格式为 ISO 8601 的日期,用以选择最后更新日期为该日期之后(或当天)的订单。更新即为对订单状态进行更改,包括新订单的创建。包括亚马逊和卖家所进行的更新。 | 是,如果未指定 CreatedAfter 的值。
同时指定 CreatedAfter 和 LastUpdatedAfter 的值时,将返回一个错误。 如果指定了 LastUpdatedAfter 的值,则无法指定 BuyerEmail 和 SellerOrderId 的值。 |
必须不迟于两分钟,且在请求提交时间之前。 类型:xs:dateTime |
LastUpdatedBefore | 指定某一格式为 ISO 8601 的日期,用以选择最后更新日期为该日期之前(或当天)的订单。更新即为对订单状态进行更改,包括新订单的创建。包括亚马逊和卖家所进行的更新。 | 否 只有在已指定 LastUpdatedAfter 的值时,才可指定该参数的值。 如果已指定 CreatedAfter 的值,则不可指定该参数的值。 |
必须迟于 LastUpdatedAfter 的值。
必须不迟于两分钟,且在请求提交时间之前。 默认值:现在时间减去两分钟 类型:xs:dateTime |
OrderStatus | OrderStatus 值的列表。用来选择当前状态与您所指定的某个状态值相符的订单。 | 否 | OrderStatus 值:
在此版本的 “订单 API”部分 中,必须同时使用 Unshipped 和 PartiallyShipped。仅使用其中一个状态值,则会返回错误。 默认值:全部 类型:xs:string |
MarketplaceId | MarketplaceId 值的列表。用来选择您所指定商城中的订单。 | 是 | 卖家注册销售商品的商城。 如果该值不是卖家注册销售商品的商城,则会返回错误。 最大值:50 类型:xs:string |
FulfillmentChannel | 指明订单配送方式的结构化列表。 | 否 | FulfillmentChannel 值:
默认值:全部 类型:xs:string |
PaymentMethod | PaymentMethod 值的列表。用来选择您指定的订单付款方式。 | 否 | PaymentMethod 值:
注: COD 和 CVS 值只在日本有效。
默认值:全部 类型:xs:string |
BuyerEmail | 买家的电子邮件地址。用来选择包含指定电子邮件地址的订单。 | 否 如果指定了 BuyerEmail 的值,则无法指定 FulfillmentChannel、 OrderStatus、 PaymentMethod、 LastUpdatedAfter、 LastUpdatedBefore 和 SellerOrderId 的值。 |
您在请求中所提供的电子邮件地址可以匿名(亚马逊)也可以不匿名。 默认值:全部 类型:xs:string |
SellerOrderId | 卖家所指定的订单编码。不是亚马逊订单编号。用来选择与卖家所指定订单编码相匹配的订单。 | 否 如果指定了 SellerOrderId 的值,则无法指定FulfillmentChannel、 OrderStatus、 PaymentMethod、 LastUpdatedAfter、 LastUpdatedBefore 和 BuyerEmail 的值。 |
默认值:全部 类型:xs:string |
MaxResultsPerPage | 该数字用来指明每页可返回的最多订单数。 | 否 | 该值必须介于 1 到 100 之间。 默认值:100 类型:xs:positiveInteger |
TFMShipmentStatus | TFMShipmentStatus 值的列表。用于选择使用亚马逊配送服务 (TFM) 且当前配送状态与您指定的某个状态值相符的订单。如果指定 TFMShipmentStatus,则仅返回 TFM 订单。 类型:xs:string 请注意:TFMShipmentStatus 请求参数仅适用于中国地区。 |
否 | TFMShipmentStatus 值:
|
名称 | 描述 |
---|---|
NextToken | 生成的字符串,用于将信息传递给下一请求。如果返回 NextToken,将 NextToken 的值传递给 ListOrdersByNextToken。如果没有返回 NextToken,则不返回其他配送订单。 可选项 类型:xs:string |
LastUpdatedBefore | 如果您使用 LastUpdatedAfter 请求参数,将返回日期。如果您还使用 LastUpdatedBefore 请求参数,将返回您随同该请求参数提供的
日期。否则将返回 LastUpdatedBefore 请求参数的默认值:您的请求时间减去两分钟。
可选。将返回 LastUpdatedBefore 或 CreatedBefore。 类型:xs:dateTime |
CreatedBefore | 如果您使用
CreatedAfter 请求参数,将返回日期。如果您还使用 CreatedBefore 请求参数,将返回您随同该请求参数提供的日期。否则将返回 CreatedBefore 请求参数的默认值:您的请求时间减去两分钟。
可选。将返回 LastUpdatedBefore 或 CreatedBefore。 类型:xs:dateTime |
Orders | 订单列表。 类型:Order 列表 |
https://mws.amazonservices.jp/Orders/2013-09-01 ?AWSAccessKeyId=0PB842EXAMPLE7N4ZTR2 &Action=ListOrders &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &MarketplaceId.Id.1=A1VC38T7YXB528 &FulfillmentChannel.Channel.1=MFN &PaymentMethod.1=COD &PaymentMethod.2=Other &OrderStatus.Status.1=Unshipped &OrderStatus.Status.2=PendingAvailability &SellerId=A2NEXAMPLETF53 &Signature=ZQLpf8vEXAMPLE0iC265pf18n0%3D &SignatureVersion=2 &SignatureMethod=HmacSHA256 &LastUpdatedAfter=2013-08-01T18%3A12%3A21 &Timestamp=2013-09-05T18%3A12%3A21.687Z &Version=2013-09-01
<?xml version="1.0" encoding="utf-8"?> <ListOrdersResponse xmlns="https://mws.amazonservices.com/ Orders/2013-09-01"> <ListOrdersResult> <NextToken>2YgYW55IGNhcm5hbCBwbGVhc3VyZS4=</NextToken> <LastUpdatedBefore>2013-09-25T18%3A10%3A21.687Z</LastUpdatedBefore> <Orders> <Order> <ShipmentServiceLevelCategory>Standard </ShipmentServiceLevelCategory> <ShipServiceLevel>Std JP Kanto8</ShipServiceLevel> <EarliestShipDate>2013-08-20T19:51:16Z</EarliestShipDate> <LatestShipDate>2013-08-25T19:49:35Z</LatestShipDate> <MarketplaceId>A1VC38T7YXB528</MarketplaceId> <SalesChannel>Amazon.com</SalesChannel> <OrderType>Preorder</OrderType> <BuyerEmail>5vlhEXAMPLEh9h5@marketplace.amazon.com</BuyerEmail> <FulfillmentChannel>MFN</FulfillmentChannel> <OrderStatus>Pending</OrderStatus> <BuyerName>John Jones</BuyerName> <LastUpdateDate>2013-08-20T19:49:35Z</LastUpdateDate> <PurchaseDate>2013-08-20T19:49:35Z</PurchaseDate> <NumberOfItemsShipped>0</NumberOfItemsShipped> <NumberOfItemsUnshipped>0</NumberOfItemsUnshipped> <AmazonOrderId>902-3159896-1390916</AmazonOrderId> <PaymentMethod>Other</PaymentMethod> </Order> <Order> <AmazonOrderId>058-1233752-8214740</AmazonOrderId> <PurchaseDate>2013-09-05T00%3A06%3A07.000Z</PurchaseDate> <LastUpdateDate>2013-09-07T12%3A43%3A16.000Z</LastUpdateDate> <OrderStatus>Unshipped</OrderStatus> <OrderType>StandardOrder</OrderType> <ShipServiceLevel>Std JP Kanto8</ShipServiceLevel> <FulfillmentChannel>MFN</FulfillmentChannel> <OrderTotal> <CurrencyCode>JPY</CurrencyCode> <Amount>1507.00</Amount> </OrderTotal> <ShippingAddress> <Name>Jane Smith</Name> <AddressLine1>1-2-10 Akasaka</AddressLine1> <City>Tokyo</City> <PostalCode>107-0053</PostalCode> <Country>JP</Country> </ShippingAddress> <NumberOfItemsShipped>0</NumberOfItemsShipped> <NumberOfItemsUnshipped>1</NumberOfItemsUnshipped> <PaymentExecutionDetail> <PaymentExecutionDetailItem> <Payment> <Amount>10.00</Amount> <CurrencyCode>JPY</CurrencyCode> </Payment> <PaymentMethod>PointsAccount</PaymentMethod> </PaymentExecutionDetailItem> <PaymentExecutionDetailItem> <Payment> <Amount>317.00</Amount> <CurrencyCode>JPY</CurrencyCode> </Payment> <PaymentMethod>GC</PaymentMethod> </PaymentExecutionDetailItem> <PaymentExecutionDetailItem> <Payment> <Amount>1180.00</Amount> <CurrencyCode>JPY</CurrencyCode> </Payment> <PaymentMethod>COD</PaymentMethod> </PaymentExecutionDetailItem> </PaymentExecutionDetail> <PaymentMethod>COD</PaymentMethod> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <BuyerName>Jane Smith</BuyerName> <BuyerEmail>5vlhEXAMPLEh9h5@marketplace.amazon.com</BuyerEmail> <ShipmentServiceLevelCategory>Standard </ShipmentServiceLevelCategory> </Order> </Orders> </ListOrdersResult> <ResponseMetadata> <RequestId>88faca76-b600-46d2-b53c-0c8c4533e43a</RequestId> </ResponseMetadata> </ListOrdersResponse>