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 文档

ListOrders

返回您在指定时间段内所创建或更新的订单。

描述

ListOrders 操作可返回您在指定时间段内创建或更新的订单列表。您可以通过 CreatedAfter 参数或 LastUpdatedAfter 参数来指定时间段。您必须使用其中一个参数,但不可同时使用两个参数。您还可以通过应用筛选条件来缩小返回的订单列表范围。该 ListOrders 操作包括每个所返回订单的订单详情,其中包括 AmazonOrderIdOrderStatusFulfillmentChannelLastUpdateDate

获取买家联系方式和费用信息

下表显示该 ListOrders 操作何时返回卖家配送网络 (MFN) 订单的买家联系信息(BuyerEmailBuyerNameShippingAddress)以及费用信息 (OrderTotal)。

表 1. 普通订单
对于以下状态的普通订单: …ListOrders 操作返回这些买家联系方式和费用信息响应元素:
Pending
UnshippedPartiallyShippedShipped BuyerEmailBuyerNameShippingAddressOrderTotal
表 2. 预订订单
对于以下状态的预订订单: …ListOrders 操作返回这些买家联系方式和费用信息响应元素:
PendingAvailabilityPending BuyerEmailBuyerName
UnshippedPartiallyShippedShipped BuyerEmailBuyerNameShippingAddressOrderTotal
注: 只有预订订单才有 PendingAvailabitity 状态。预订订单仅适用于日本。

ListOrdersListOrdersByNextToken 操作的最大请求限额为 6 个,恢复速率为每分钟 1 个请求。有关限制术语的相关定义,请参阅您应了解的“订单 API”部分的相关内容

请求参数

名称 描述 必填项 有效值
CreatedAfter 指定某一格式为 ISO 8601 的日期,用以选择在该日期之后(或当天)创建的订单。 是,如果未指定 LastUpdatedAfter 的值。

同时指定 CreatedAfterLastUpdatedAfter 的值时,将返回一个错误。

必须不迟于两分钟,且在请求提交时间之前。

类型:xs:dateTime

CreatedBefore

指定某一格式为 ISO 8601 的日期,用以选择在该日期之前(或当天)创建的订单。

只有在已指定 CreatedAfter 的值时,才可指定该参数的值。

如果已指定 LastUpdatedAfter 的值,则不可指定该参数的值。

必须迟于 CreatedAfter 的值。

必须不迟于两分钟,且在请求提交时间之前。

默认值:现在时间减去两分钟

类型:xs:dateTime

LastUpdatedAfter 指定某一格式为 ISO 8601 的日期,用以选择最后更新日期为该日期之后(或当天)的订单。更新即为对订单状态进行更改,包括新订单的创建。包括亚马逊和卖家所进行的更新。 是,如果未指定 CreatedAfter 的值。

同时指定 CreatedAfterLastUpdatedAfter 的值时,将返回一个错误。

如果指定了 LastUpdatedAfter 的值,则无法指定 BuyerEmailSellerOrderId 的值。

必须不迟于两分钟,且在请求提交时间之前。

类型:xs:dateTime

LastUpdatedBefore 指定某一格式为 ISO 8601 的日期,用以选择最后更新日期为该日期之前(或当天)的订单。更新即为对订单状态进行更改,包括新订单的创建。包括亚马逊和卖家所进行的更新。

只有在已指定 LastUpdatedAfter 的值时,才可指定该参数的值。

如果已指定 CreatedAfter 的值,则不可指定该参数的值。

必须迟于 LastUpdatedAfter 的值。

必须不迟于两分钟,且在请求提交时间之前。

默认值:现在时间减去两分钟

类型:xs:dateTime

OrderStatus OrderStatus 值的列表。用来选择当前状态与您所指定的某个状态值相符的订单。 OrderStatus 值:
PendingAvailability
只有预订订单才有此状态。订单已生成,但是付款未授权且商品的发售日期是将来的某一天。订单尚不能进行发货。请注意:仅在日本 (JP),Preorder 才可能是一个 OrderType 值。
Pending
订单已生成,但是付款未授权。订单尚不能进行发货。请注意:对于 OrderType = Standard 的订单,初始的订单状态是 Pending。对于 OrderType = Preorder 的订单(仅适用于 JP),初始的订单状态是 PendingAvailability,当进入付款授权流程时,订单状态将变为 Pending
Unshipped
付款已经过授权,订单已准备好进行发货,但订单中商品尚未发运。
PartiallyShipped
订单中的一个或多个(但并非全部)商品已经发货。
Shipped
订单中的所有商品均已发货。
InvoiceUnconfirmed
订单中的所有商品均已发货。但是卖家还没有向亚马逊确认已经向买家寄出发票。请注意:此参数仅适用于中国地区。
Canceled
订单已取消。
Unfulfillable
订单无法进行配送。该状态仅适用于通过亚马逊零售网站之外的渠道下达但由亚马逊进行配送的订单。

在此版本的 “订单 API”部分 中,必须同时使用 UnshippedPartiallyShipped。仅使用其中一个状态值,则会返回错误。

默认值:全部

类型:xs:string
MarketplaceId MarketplaceId 值的列表。用来选择您所指定商城中的订单。 卖家注册销售商品的商城。

如果该值不是卖家注册销售商品的商城,则会返回错误。

最大值:50

类型:xs:string
FulfillmentChannel 指明订单配送方式的结构化列表。 FulfillmentChannel 值:
AFN
亚马逊配送
MFN
卖家自行配送

默认值:全部

类型:xs:string
PaymentMethod PaymentMethod 值的列表。用来选择您指定的订单付款方式。 PaymentMethod 值:
COD
货到现金付款
CVS
便利店付款
Other
CODCVS 之外的任意付款方式
注: CODCVS 值只在日本有效。

默认值:全部

类型:xs:string
BuyerEmail 买家的电子邮件地址。用来选择包含指定电子邮件地址的订单。

如果指定了 BuyerEmail 的值,则无法指定 FulfillmentChannelOrderStatusPaymentMethodLastUpdatedAfterLastUpdatedBeforeSellerOrderId 的值。

您在请求中所提供的电子邮件地址可以匿名(亚马逊)也可以不匿名。

默认值:全部

类型:xs:string

SellerOrderId 卖家所指定的订单编码。不是亚马逊订单编号。用来选择与卖家所指定订单编码相匹配的订单。

如果指定了 SellerOrderId 的值,则无法指定FulfillmentChannelOrderStatusPaymentMethodLastUpdatedAfterLastUpdatedBeforeBuyerEmail 的值。

默认值:全部

类型:xs:string

MaxResultsPerPage 该数字用来指明每页可返回的最多订单数。 该值必须介于 1 到 100 之间。

默认值:100

类型:xs:positiveInteger

TFMShipmentStatus TFMShipmentStatus 值的列表。用于选择使用亚马逊配送服务 (TFM) 且当前配送状态与您指定的某个状态值相符的订单。如果指定 TFMShipmentStatus,则仅返回 TFM 订单。

类型:xs:string

请注意:TFMShipmentStatus 请求参数仅适用于中国地区。
TFMShipmentStatus 值:
PendingPickUp
亚马逊尚未从卖家处取件。
LabelCanceled
卖家取消了取件。
PickedUp
亚马逊已从卖家处取件。
AtDestinationFC
包裹已经抵达亚马逊运营中心。
Delivered
包裹已经配送给买家。
RejectedByBuyer
包裹被买家拒收。
Undeliverable
包裹无法配送。
ReturnedToSeller
包裹未配送给买家,已经退还给卖家。
Lost
包裹被承运人丢失。
类型:xs:string

响应元素

名称 描述
NextToken 生成的字符串,用于将信息传递给下一请求。如果返回 NextToken,将 NextToken 的值传递给 ListOrdersByNextToken。如果没有返回 NextToken,则不返回其他配送订单。

可选项

类型:xs:string

LastUpdatedBefore 如果您使用 LastUpdatedAfter 请求参数,将返回日期。如果您还使用 LastUpdatedBefore 请求参数,将返回您随同该请求参数提供的 日期。否则将返回 LastUpdatedBefore 请求参数的默认值:您的请求时间减去两分钟。

可选。将返回 LastUpdatedBeforeCreatedBefore

类型:xs:dateTime

CreatedBefore 如果您使用 CreatedAfter 请求参数,将返回日期。如果您还使用 CreatedBefore 请求参数,将返回您随同该请求参数提供的日期。否则将返回 CreatedBefore 请求参数的默认值:您的请求时间减去两分钟。

可选。将返回 LastUpdatedBeforeCreatedBefore

类型: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>