订单详情列表

提供订单详情的批量查询能力，支持通过订单号或平台订单号获取多个订单的详细信息，包括订单状态、商品明细、收货信息、费用明细等，满足订单管理和核对需求。

适用场景

批量查询多个订单的详细信息（状态、商品、地址等）

核对订单的商品明细和费用构成

追踪订单的物流和配送信息

分析订单的售后状态和历史记录

接口类型

POST

请求频率限制

默认频率：以平台配额为准

请求说明

请求URL

正式环境：https://www.westmonth.com/openapi/v2/order/details
测试环境：https://testing.westmonth.com/openapi/v2/order/details

请求参数

Header参数

参数名	类型	必填	示例值	说明
Authorization	string	是	authorization	身份验证Token
Content-Type	string	是	application/json	建议固定传此值

Body参数

根字段

参数名	类型	必填	默认值	说明
order_nos	array	否	-	西之月订单号列表，最多支持100单，与seller_order_nos不能同时存在
seller_order_nos	array	否	-	商家订单号列表，最多支持100单，与order_nos不能同时存在

⚠️ 注意：order_nos和seller_order_nos为互斥参数，只能选择其中一个传入，同时传入会返回参数错误。

响应字段说明

成功响应（HTTP 200）

根字段

字段	类型	说明
code	integer	业务状态码（0表示成功）
msg	string	提示信息（成功时为空）
data	array	订单详情列表

data数组字段

字段	类型	说明
order_id	integer	订单ID
order_number	string	西月订单号
place_order_time	string	下单时间（格式：yyyy-MM-dd HH:mm:ss）
status	string	订单状态标识（如：unpaid、cancelled）
order_status	string	订单状态中文描述（如：待支付、交易已取消）
customer_name	string	收件人姓名
phone	string	收件人电话
entrepot	array	仓库信息列表（可能为空）
address	string	收件人完整地址
mode_payment	string	支付方式（如：微信支付、支付宝）
pay_time	string	支付时间（未支付时为空）
postcode	string	配送地址邮编
order_products	array	订单包含的商品列表
amount_payable	string	订单总金额（含运费，格式化显示）
trade_platforms	integer	支付平台（1：微信，2：支付宝，3：额度支付，4：货到付款）
sub_total	string	商品总计金额（格式化显示）
freight	string	运费金额（格式化显示）
comment	string	买家备注
delivery_mode_name	string	配送方式（快递配送、第三方物流自提、个人自提）
name_supplier	string	提货人姓名
contact_number	string	联系电话
seller_order_no	string	平台订单号
platform_name	string	订单所属平台名称
logistics_company_name	string	物流公司名称（中文）
logistics_company_name_en	string	物流公司名称（英文）
logistics_company_code	string	物流公司编码
shipment_no	string	物流单号
shipments	array	物流信息列表（可能为空）

order_products数组字段

字段	类型	说明
id	integer	商品项ID
order_id	integer	所属订单ID
product_id	integer	产品ID
order_number	string	西月订单号
product_sku	string	商品SKU编码
name	string	商品名称
image	string	商品图片URL
quantity	integer	购买数量
price	string	商品单价
subtotal	string	商品小计金额（格式化显示）
warehouses	object	发货仓库信息
region	object	发货区域信息
after_sale_status_label	string	售后状态（如：未售后）

warehouses对象字段

字段	类型	说明
depot_id	integer	仓库ID
address	string	仓库地址
contact_name	string	仓库联系人
contact_phone	string	仓库联系电话
postcode	string	仓库邮编

region对象字段

字段	类型	说明
id	integer	区域ID
name	string	区域名称（如：中国）
code	string	区域编码（如：CN）
service_type	string	支持的服务类型

调用示例

URL请求

请求示例

{
    "order_nos": [
        "aOP2505071626702",
        "aOP2505071618005"
    ]
}

成功返回示例

{
    "code": 0,
    "msg": "",
    "data": [
        {
            "order_id": 1841981,
            "order_number": "aOP2505071618005",
            "place_order_time": "2025-05-07 16:03:12",
            "status": "cancelled",
            "order_status": "交易已取消",
            "customer_name": "Stacie R. Sheppard",
            "phone": "18965213578",
            "entrepot": [],
            "address": "United States ALABAMA Sylacauga , Alabama, Talladega, Sylacauga, / 301 S Broadway Ave",
            "mode_payment": "",
            "pay_time": "",
            "postcode": "35150",
            "order_products": [
                {
                    "id": 1963211,
                    "order_id": 1841981,
                    "product_id": 100,
                    "order_number": "aOP2505071618005",
                    "order_shipment_id": 0,
                    "shipped_at": null,
                    "product_sku_delivery_region_id": 35791,
                    "delivery_region_id": 5,
                    "depot_id": 5,
                    "product_sku": "cbsft114yy02-一盒12pcs",
                    "name": "South Moon 艾蒿臂贴 手臂和腿部天然草药艾灸贴",
                    "image": "https://westmonth/SKUDatum/old/cbsft114yy02-一盒12pcs/mainpicture/cbsft114yy02-一盒12pcs-001.jpg",
                    "quantity": 1,
                    "price": "5.00",
                    "original_price": "5.00",
                    "subtotal": "￥5.00",
                    "original_subtotal": "5.00",
                    "is_add": 0,
                    "is_barter": 0,
                    "is_split": 0,
                    "is_merge": 0,
                    "after_sale_id": 0,
                    "after_sale_status": "default_status",
                    "created_at": "2025-05-07 16:03:12",
                    "updated_at": "2025-05-07 16:03:12",
                    "deleted_at": null,
                    "price_format": "￥5.00",
                    "total_price_format": "￥0.00",
                    "subtotal_format": "￥0.00",
                    "after_sale_status_label": "未售后",
                    "warehouses": {
                        "id": 167,
                        "depot_id": 5,
                        "address": "广东省汕头市龙湖区练江中路工业大厦H7幢201号房之一",
                        "contact_name": "西之月",
                        "contact_phone": "13076369857",
                        "postcode": "515000",
                        "created_at": "2024-11-29T02:31:55.000000Z",
                        "updated_at": "2024-11-29T02:31:55.000000Z"
                    },
                    "region": {
                        "id": 5,
                        "name": "中国",
                        "code": "CN",
                        "shop_id": 15632946,
                        "wms_co_id": 0,
                        "country_id": 44,
                        "logo": "https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/test/20250415150112204143.jpg",
                        "sort": 99,
                        "created_at": "2024-02-01 06:15:38",
                        "updated_at": "2025-04-18 12:14:14",
                        "deleted_at": null,
                        "service_type": "1,2"
                    }
                }
            ],
            "amount_payable": "￥45.00",
            "trade_platforms": 0,
            "sub_total": "￥5.00",
            "freight": "￥40.00",
            "comment": "买家备注",
            "delivery_mode_name": "快递配送",
            "name_supplier": "Stacie R. Sheppard",
            "contact_number": "xxxx",
            "seller_order_no": "576722608781890541",
            "platform_name": "",
            "logistics_company_name": "",
            "logistics_company_name_en": "",
            "logistics_company_code": "",
            "shipment_no": "",
            "shipments": []
        },
        {
            "order_id": 1841982,
            "order_number": "aOP2505071626702",
            "place_order_time": "2025-05-07 16:13:53",
            "status": "unpaid",
            "order_status": "待支付",
            "customer_name": "Stacie R. Sheppard",
            "phone": "18965213578",
            "entrepot": [],
            "address": "United States ALABAMA Sylacauga , Alabama, Talladega, Sylacauga, / 301 S Broadway Ave",
            "mode_payment": "",
            "pay_time": "",
            "postcode": "35150",
            "order_products": [
                {
                    "id": 1963212,
                    "order_id": 1841982,
                    "product_id": 100,
                    "order_number": "aOP2505071626702",
                    "order_shipment_id": 0,
                    "shipped_at": null,
                    "product_sku_delivery_region_id": 35791,
                    "delivery_region_id": 5,
                    "depot_id": 5,
                    "product_sku": "cbsft114yy02-一盒12pcs",
                    "name": "South Moon 艾蒿臂贴 手臂和腿部天然草药艾灸贴",
                    "image": "https://westmonth/SKUDatum/old/cbsft114yy02-一盒12pcs/mainpicture/cbsft114yy02-一盒12pcs-001.jpg",
                    "quantity": 1,
                    "price": "5.00",
                    "original_price": "5.00",
                    "subtotal": "￥5.00",
                    "original_subtotal": "5.00",
                    "is_add": 0,
                    "is_barter": 0,
                    "is_split": 0,
                    "is_merge": 0,
                    "after_sale_id": 0,
                    "after_sale_status": "default_status",
                    "created_at": "2025-05-07 16:13:53",
                    "updated_at": "2025-05-07 16:13:53",
                    "deleted_at": null,
                    "price_format": "￥5.00",
                    "total_price_format": "￥0.00",
                    "subtotal_format": "￥0.00",
                    "after_sale_status_label": "未售后",
                    "warehouses": {
                        "id": 167,
                        "depot_id": 5,
                        "address": "广东省汕头市龙湖区练江中路工业大厦H7幢201号房之一",
                        "contact_name": "西之月",
                        "contact_phone": "xxx",
                        "postcode": "515000",
                        "created_at": "2024-11-29T02:31:55.000000Z",
                        "updated_at": "2024-11-29T02:31:55.000000Z"
                    },
                    "region": {
                        "id": 5,
                        "name": "中国",
                        "code": "CN",
                        "shop_id": 15632946,
                        "wms_co_id": 0,
                        "country_id": 44,
                        "logo": "https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/test/20250415150112204143.jpg",
                        "sort": 99,
                        "created_at": "2024-02-01 06:15:38",
                        "updated_at": "2025-04-18 12:14:14",
                        "deleted_at": null,
                        "service_type": "1,2"
                    }
                }
            ],
            "amount_payable": "￥45.00",
            "trade_platforms": 0,
            "sub_total": "￥5.00",
            "freight": "￥40.00",
            "comment": "买家备注",
            "delivery_mode_name": "快递配送",
            "name_supplier": "Stacie R. Sheppard",
            "contact_number": "xxx",
            "seller_order_no": "576722608781890541",
            "platform_name": "",
            "logistics_company_name": "",
            "logistics_company_name_en": "",
            "logistics_company_code": "",
            "shipment_no": "",
            "shipments": []
        }
    ]
}

失败返回示例

{
    "code": 3,
    "msg": "授权无效 authorization timestamp error",
    "data": []
}

错误处理

公共错误码

HTTP status code	错误码	错误信息	描述

注意事项

订单号列表（order_nos/seller_order_nos）最多支持100个订单，超过会返回参数错误

响应中的金额字段（如amount_payable、sub_total）已做格式化处理（含货币符号），可直接展示

若订单无物流信息，logistics_company_name、shipment_no等字段可能为空

常见问题

Q1：如何通过商家订单号查询订单详情？

A：使用seller_order_nos参数传入商家订单号列表，如：{"seller_order_nos": ["576722608781890541"]}。

Q2：如何区分订单的支付方式？

A：通过trade_platforms字段判断，1代表微信支付，2代表支付宝，3代表额度支付，4代表货到付款。

Q3：查询多个订单时，部分订单未返回是什么原因？

A：未返回的订单可能：1. 不存在；2. 不属于当前授权账号；3. 已被删除或归档。可单独查询该订单确认状态。

版本历史

版本	日期	修改说明
v1.0	2025-01-15	初始版本，支持订单详情查询

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "",
    "data": [
        {
            "order_id": 1841981,
            "order_number": "aOP2505071618005",
            "place_order_time": "2025-05-07 16:03:12",
            "status": "cancelled",
            "order_status": "交易已取消",
            "customer_name": "Stacie R. Sheppard",
            "phone": "18965213578",
            "entrepot": [],
            "address": "United States ALABAMA Sylacauga , Alabama, Talladega, Sylacauga, / 301 S Broadway Ave",
            "mode_payment": "",
            "pay_time": "",
            "postcode": "35150",
            "order_products": [
                {
                    "id": 1963211,
                    "order_id": 1841981,
                    "product_id": 100,
                    "order_number": "aOP2505071618005",
                    "order_shipment_id": 0,
                    "shipped_at": null,
                    "product_sku_delivery_region_id": 35791,
                    "delivery_region_id": 5,
                    "depot_id": 5,
                    "product_sku": "cbsft114yy02-一盒12pcs",
                    "name": "South Moon 艾蒿臂贴 手臂和腿部天然草药艾灸贴",
                    "image": "https://westmonth/SKUDatum/old/cbsft114yy02-一盒12pcs/mainpicture/cbsft114yy02-一盒12pcs-001.jpg",
                    "quantity": 1,
                    "price": "5.00",
                    "original_price": "5.00",
                    "subtotal": "￥5.00",
                    "original_subtotal": "5.00",
                    "is_add": 0,
                    "is_barter": 0,
                    "is_split": 0,
                    "is_merge": 0,
                    "after_sale_id": 0,
                    "after_sale_status": "default_status",
                    "created_at": "2025-05-07 16:03:12",
                    "updated_at": "2025-05-07 16:03:12",
                    "deleted_at": null,
                    "price_format": "￥5.00",
                    "total_price_format": "￥0.00",
                    "subtotal_format": "￥0.00",
                    "after_sale_status_label": "未售后",
                    "warehouses": {
                        "id": 167,
                        "depot_id": 5,
                        "address": "广东省汕头市龙湖区练江中路工业大厦H7幢201号房之一",
                        "contact_name": "西之月",
                        "contact_phone": "13076369857",
                        "postcode": "515000",
                        "created_at": "2024-11-29T02:31:55.000000Z",
                        "updated_at": "2024-11-29T02:31:55.000000Z"
                    },
                    "region": {
                        "id": 5,
                        "name": "中国",
                        "code": "CN",
                        "shop_id": 15632946,
                        "wms_co_id": 0,
                        "country_id": 44,
                        "logo": "https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/test/20250415150112204143.jpg",
                        "sort": 99,
                        "created_at": "2024-02-01 06:15:38",
                        "updated_at": "2025-04-18 12:14:14",
                        "deleted_at": null,
                        "service_type": "1,2"
                    }
                }
            ],
            "amount_payable": "￥45.00",
            "trade_platforms": 0,
            "sub_total": "￥5.00",
            "freight": "￥40.00",
            "comment": "买家备注",
            "delivery_mode_name": "快递配送",
            "name_supplier": "Stacie R. Sheppard",
            "contact_number": "18965213578",
            "seller_order_no": "576722608781890541",
            "platform_name": "",
            "logistics_company_name": "",
            "logistics_company_name_en": "",
            "logistics_company_code": "",
            "shipment_no": "",
            "shipments": []
        },
        {
            "order_id": 1841982,
            "order_number": "aOP2505071626702",
            "place_order_time": "2025-05-07 16:13:53",
            "status": "unpaid",
            "order_status": "待支付",
            "customer_name": "Stacie R. Sheppard",
            "phone": "18965213578",
            "entrepot": [],
            "address": "United States ALABAMA Sylacauga , Alabama, Talladega, Sylacauga, / 301 S Broadway Ave",
            "mode_payment": "",
            "pay_time": "",
            "postcode": "35150",
            "order_products": [
                {
                    "id": 1963212,
                    "order_id": 1841982,
                    "product_id": 100,
                    "order_number": "aOP2505071626702",
                    "order_shipment_id": 0,
                    "shipped_at": null,
                    "product_sku_delivery_region_id": 35791,
                    "delivery_region_id": 5,
                    "depot_id": 5,
                    "product_sku": "cbsft114yy02-一盒12pcs",
                    "name": "South Moon 艾蒿臂贴 手臂和腿部天然草药艾灸贴",
                    "image": "https://westmonth/SKUDatum/old/cbsft114yy02-一盒12pcs/mainpicture/cbsft114yy02-一盒12pcs-001.jpg",
                    "quantity": 1,
                    "price": "5.00",
                    "original_price": "5.00",
                    "subtotal": "￥5.00",
                    "original_subtotal": "5.00",
                    "is_add": 0,
                    "is_barter": 0,
                    "is_split": 0,
                    "is_merge": 0,
                    "after_sale_id": 0,
                    "after_sale_status": "default_status",
                    "created_at": "2025-05-07 16:13:53",
                    "updated_at": "2025-05-07 16:13:53",
                    "deleted_at": null,
                    "price_format": "￥5.00",
                    "total_price_format": "￥0.00",
                    "subtotal_format": "￥0.00",
                    "after_sale_status_label": "未售后",
                    "warehouses": {
                        "id": 167,
                        "depot_id": 5,
                        "address": "广东省汕头市龙湖区练江中路工业大厦H7幢201号房之一",
                        "contact_name": "西之月",
                        "contact_phone": "13076369857",
                        "postcode": "515000",
                        "created_at": "2024-11-29T02:31:55.000000Z",
                        "updated_at": "2024-11-29T02:31:55.000000Z"
                    },
                    "region": {
                        "id": 5,
                        "name": "中国",
                        "code": "CN",
                        "shop_id": 15632946,
                        "wms_co_id": 0,
                        "country_id": 44,
                        "logo": "https://westmonth-test.oss-cn-shenzhen.aliyuncs.com/test/20250415150112204143.jpg",
                        "sort": 99,
                        "created_at": "2024-02-01 06:15:38",
                        "updated_at": "2025-04-18 12:14:14",
                        "deleted_at": null,
                        "service_type": "1,2"
                    }
                }
            ],
            "amount_payable": "￥45.00",
            "trade_platforms": 0,
            "sub_total": "￥5.00",
            "freight": "￥40.00",
            "comment": "买家备注",
            "delivery_mode_name": "快递配送",
            "name_supplier": "Stacie R. Sheppard",
            "contact_number": "18965213578",
            "seller_order_no": "576722608781890541",
            "platform_name": "",
            "logistics_company_name": "",
            "logistics_company_name_en": "",
            "logistics_company_code": "",
            "shipment_no": "",
            "shipments": []
        }
    ]
}

订单详情列表

订单详情列表

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

注意事项

常见问题

Q1：如何通过商家订单号查询订单详情？

Q2：如何区分订单的支付方式？

Q3：查询多个订单时，部分订单未返回是什么原因？

版本历史

请求参数

请求示例代码

返回响应

订单详情列表

订单详情列表#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

注意事项#

常见问题#

Q1：如何通过商家订单号查询订单详情？#

Q2：如何区分订单的支付方式？#

Q3：查询多个订单时，部分订单未返回是什么原因？#

版本历史#

请求参数

请求示例代码

返回响应

订单详情列表

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

注意事项

常见问题

Q1：如何通过商家订单号查询订单详情？

Q2：如何区分订单的支付方式？

Q3：查询多个订单时，部分订单未返回是什么原因？

版本历史