Lingxing
切换旧版

查询亚马逊订单列表

POST/erp/sc/data/mws/orders

接口信息

API Path请求协议请求方式令牌桶容量
/erp/sc/data/mws/ordersHTTPSPOST1

请求参数

sidinteger
店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】
sid_listarray<any>
店铺id列表,最大长度20
start_datestring必填
查询时间,左闭右开,格式:Y-m-d 或 Y-m-d H:i:s
当date_type=3时,需要传入时间格式为:Y-m-d H:i:s
end_datestring必填
查询时间,左闭右开,格式:Y-m-d 或 Y-m-d H:i:s
当date_type=3时,需要传入时间格式为:Y-m-d H:i:s
date_typeinteger
查询日期类型:【默认1】
1 订购时间【站点时间】
2 订单修改时间【北京时间】
3 平台更新时间【UTC时间】
10 发货时间【站点时间】
查询时间范围不超过一年
order_statusarray<any>
Pending 待处理
Unshipped 未发货
PartiallyShipped 部分发货
Shipped 已发货
Canceled 取消
sort_desc_by_date_typeinteger
是否按查询日期类型排序:0 否,1 降序,2 升序【默认0】
fulfillment_channelinteger
配送方式:1 亚马逊订单-AFN,2 自发货-MFN
offsetinteger
分页偏移量,默认0
lengthinteger
分页长度,默认1000,上限5000

返回结果

Json Object

codeinteger必填
状态码,0 成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 502B9DD9-1BA0-03C5-6C61-D77C830440A6
response_timestring必填
响应时间
示例 2020-05-18 11:23:47
totalinteger必填
总数
示例 1
dataarray<object>必填
响应数据
隐藏子属性
sidstring必填
店铺id
示例 101
seller_namestring必填
店铺名称
示例 店铺8
amazon_order_idstring必填
亚马逊订单号
示例 111-8056674-6381837
order_statusstring必填
订单状态
示例 Unshipped
order_total_amountstring必填
订单金额
示例 8.99
fulfillment_channelstring必填
配送方式:亚马逊订单-AFN,自发货-MFN
示例 AFN
postal_codestring必填
邮编
示例 LA1 5DS
is_returninteger必填
退款状态:0 未退款,1 退款中,2 退款完成
示例 0
is_mcf_orderinteger必填
是否多渠道订单:0 否,1 是
【2023年后的多渠道订单数据均不在此接口返回】
示例 0
is_assessedinteger必填
是否推广订单:0 否,1 是
示例 0
is_replaced_orderinteger必填
是否换货订单:0 否,1 是
示例 0
is_replacement_orderinteger必填
是否已换货订单:0 否,1 是
示例 0
is_return_orderinteger必填
是否退货订单:0 否,1 是
示例 0
order_total_currency_codestring必填
币种,order_total_amount为0时,币种信息为空
示例 GBP
sales_channelstring必填
销售渠道
示例 Amazon.co.uk
tracking_numberstring必填
物流运单号
示例 D5714B7AB
refund_amountnumber必填
退款金额(含币种)
示例 -5.83
item_listarray<object>必填
商品信息
隐藏子属性
asinstring必填
ASIN
示例 B0ABC49975
quantity_orderedstring必填
数量
示例 1
seller_skustring必填
MSKU
示例 MSKUD33BAE7
local_skustring必填
本地sku
示例 SKU7A67306
local_namestring必填
本地品名
示例 [演示数据]带2件装相机镜头保护膜
purchase_date_localstring必填
订购时间【站点时间】
示例 2020-11-06 19:25:38
purchase_date_local_utcstring必填
订购时间【UTC】
示例 2020-11-07 03:25:38
shipment_datestring必填
发货日期【亚马逊返回时间,不一定为站点时间】
示例 2021-01-02T12:59:13+00:00
shipment_date_utcstring必填
发货日期【UTC】
示例 2021-01-02 12:59:13
shipment_date_localstring必填
发货日期【站点时间】
示例 2021-01-02 12:59:13
last_update_datestring必填
订单更新时间【站点时间】
示例 2023-02-03 02:27:25
last_update_date_utcstring必填
订单更新时间【UTC】
示例 2023-02-03 10:27:25
posted_datestring必填
付款时间【亚马逊返回时间,不一定为站点时间】
示例 2020-11-07 03:25:38
posted_date_utcstring必填
付款时间【UTC】
示例 2020-11-07 03:25:38
purchase_datestring必填
订购时间【亚马逊返回时间,不一定为站点时间】
示例 2020-11-07T03:25:38Z
purchase_date_utcstring必填
订购时间【UTC】
示例 2020-11-07 03:25:38
estimated_arrival_datestring必填
收货预计时间
earliest_ship_datestring必填
发货时限【亚马逊返回时间,不一定为站点时间】
示例 2020-11-09T08:00:00Z
earliest_ship_date_utcstring必填
发货时限【UTC】
示例 2020-11-09 08:00:00
gmt_modifiedstring必填
订单修改时间
示例 2022-06-17 15:57:04
gmt_modified_utcstring必填
订单修改时间【UTC】
示例 2022-06-17 07:57:04

返回成功示例

{
    "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时,传入这三个参数无意义。

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