查询亚马逊订单列表
POST
/erp/sc/data/mws/orders接口信息
| API Path | 请求协议 | 请求方式 | 令牌桶容量 |
|---|---|---|---|
/erp/sc/data/mws/orders | HTTPS | POST | 1 |
请求参数
sidintegersid_listarray<any>start_datestring必填end_datestring必填date_typeintegerorder_statusarray<any>sort_desc_by_date_typeintegerfulfillment_channelintegeroffsetintegerlengthinteger返回结果
Json Object
codeinteger必填messagestring必填error_detailsarray<any>必填request_idstring必填response_timestring必填totalinteger必填dataarray<object>必填隐藏子属性
sidstring必填seller_namestring必填amazon_order_idstring必填order_statusstring必填order_total_amountstring必填fulfillment_channelstring必填postal_codestring必填is_returninteger必填is_mcf_orderinteger必填is_assessedinteger必填is_replaced_orderinteger必填is_replacement_orderinteger必填is_return_orderinteger必填order_total_currency_codestring必填sales_channelstring必填tracking_numberstring必填refund_amountnumber必填item_listarray<object>必填隐藏子属性
asinstring必填quantity_orderedstring必填seller_skustring必填local_skustring必填local_namestring必填purchase_date_localstring必填purchase_date_local_utcstring必填shipment_datestring必填shipment_date_utcstring必填shipment_date_localstring必填last_update_datestring必填last_update_date_utcstring必填posted_datestring必填posted_date_utcstring必填purchase_datestring必填purchase_date_utcstring必填estimated_arrival_datestring必填earliest_ship_datestring必填earliest_ship_date_utcstring必填gmt_modifiedstring必填gmt_modified_utcstring必填返回成功示例
{
"code":0,
"message":"success",
"error_details":[],
"request_id":"FAFAE080-A0E1-D12E-8151-5CEDA5540D29",
"response_time":"2023-04-14 12:14:50",
"data":[
{
"sid":101,
"seller_name":"8p-US",
"amazon_order_id":"110-1821908-7840000",
"order_status":"Shipped",
"order_total_amount":"145.00",
"fulfillment_channel":"MFN",
"postal_code":"",
"is_return":0,
"is_mcf_order":0,
"is_assessed":0,
"is_return_order": 0,
"is_replaced_order": 0,
"is_replacement_order": 0,
"order_total_currency_code":"USD",
"sales_channel":"Amazon.com",
"tracking_number":"",
"hide_time":"2020-11-06 19:25:38",
"refund_amount":0,
"item_list":[
{
"asin":"B08xxxxx",
"quantity_ordered":1,
"seller_sku":"sku-355",
"local_sku":"SKU7A67306",
"local_name":"[演示数据]带2件装相机镜头保护膜"
}
],
"purchase_date_local":"2020-11-06 19:25:38",
"purchase_date_local_utc":"2020-11-07 03:25:38",
"shipment_date":"",
"shipment_date_utc":"",
"shipment_date_local":"",
"last_update_date":"2023-02-03 02:27:25",
"last_update_date_utc":"2023-02-03 10:27:25",
"posted_date":"2020-11-07 03:35:38",
"posted_date_utc":"2020-11-07 03:35:38",
"purchase_date":"2020-11-07T03:25:38Z",
"purchase_date_utc":"2020-11-07 03:25:38",
"earliest_ship_date":"2020-11-09T08:00:00Z",
"earliest_ship_date_utc":"2020-11-09 08:00:00",
"gmt_modified":"2023-02-03 18:38:10",
"gmt_modified_utc":"2023-02-03 10:38:10"
}
],
"total":1
}
附加说明
order_status 说明如下:
作为入参时:除了Pending、Unshipped、PartiallyShipped、Canceled其余的状态不支持,Pending、Unshipped、Canceled没有发货时间,当date_type为10时,传入这三个参数无意义。
- PendingAvailability:只有预订订单才有此状态;订单已生成,但是付款未授权且商品的发售日期是将来的某一天,订单尚不能进行发货;
【注意】仅在日本 (JP),Preorder 才可能是一个 OrderType 值; - Pending:订单已生成,但是付款未授权,订单尚不能进行发货;
【注意】
对于 OrderType = Standard 的订单,初始的订单状态是 Pending;
对于 OrderType = Preorder 的订单(仅适用于 JP),初始的订单状态是 PendingAvailability,当进入付款授权流程时,订单状态将变为 Pending; - Unshipped:付款已经过授权,订单已准备好进行发货,但订单中商品尚未发运;
- PartiallyShipped:订单中的一个或多个(但并非全部)商品已经发货;
- Shipped:订单中的所有商品均已发货;
- InvoiceUnconfirmed:订单中的所有商品均已发货,但是卖家还没有向亚马逊确认已经向买家寄出发票;请注意:此参数仅适用于中国地区;
- Canceled:订单已取消;
- Unfulfillable:订单无法进行配送,该状态仅适用于通过亚马逊零售网站之外的渠道下单但由亚马逊进行配送的订单;