## 订单 / **订单查询**（*oms.trade.query*）
###### 最后更新日期：**2025-09-6 12:00:00**
*****
### **API描述**
接入方调用该接口，进行订单列表查询。
*****
### **公共参数说明**
| 参数名称 | 类型 | 必填 | 描述 | 示例值 |
| --- | --- | --- | --- | --- |
| app\_key | String(32) | 是 | 接入方AppKey，由平台对接人员提供 | |
| method | String(128) | 是 | 接口名称 | oms.trade.query |
| version | String(10) | 是 | 接口版本 | 1.0 |
| biz\_content | Text | 是 | 业务参数的集合，并以**JSON格式**表示，并做urlencode处理，最大长度不限 | |
| sign | String(32) | 是 | 请求参数签名值，参考【签名加密】 | |
### **biz\_content参数说明**
| 参数名称 | 类型 | 必填 | 描述 | 示例值 |
| --- | --- | --- | --- | --- |
| create\_start\_time | Int | 是 | 平台下单查询开始时间（Unix时间戳） | 1757174400 |
| create\_end\_time | Int | 是 | 平台下单查询结束时间（Unix时间戳），一般和开始时间间隔不超过30天 | 1757260800 |
| page_size | Int | 是 | 分页记录数（最大100条） | 50 |
| page_no | Int | 是 | 分页页码 | 1 |
```
biz_content参数原文样例：
{"create_start_time":1757174400,"create_end_time":1757260800,"page_size":3,"page_no":1}
urlencode转码后：
%7B%22create_start_time%22%3A1757174400%2C%22create_end_time%22%3A1757260800%2C%22page_size%22%3A3%2C%22page_no%22%3A1%7D
```
*****
### **响应参数说明**
| 参数名称 | 类型 | 必填 | 描述 | 示例值 |
| --- | --- | --- | --- | --- |
| code | Int| 是 | 响应代码（0为成功，非0有异常） | 0 |
| msg | String | 是 | 响应描述 | success |
| data | Object | 是 | 响应数据 | |
### **data参数说明**
| 参数名称 | 类型 | 必填 | 描述 | 示例值 |
| --- | --- | --- | --- | --- |
| order_list | Object | 是 | 订单列表数据体 | |
| total_count |Int| 是 | 查询记录数 | 115 |
### **order_list参数说明**
| 参数名称 | 类型 | 必填 | 描述 | 示例值 |
| --- | --- | --- | --- | --- |
| order\_sn | String | 是 | 申报订单编号 | |
| outer_order\_sn | String | 是 | 接入平台订单编号 | |
| order\_time | String | 是 | 下单时间 | 2021-08-08 12:00:00 |
| pay\_time | String | 是 | 支付时间 | 2021-08-08 12:00:00 |
| actural_paid | Demical | 是 | 实际支付金额 | |
```
{
"code": 0,
"msg": "success",
"data": {
"order_list": [
{
"order_sn": "TEST0001",
"outer_order_sn": "TEST0001",
"order_time": "2025-09-07 00:20:29",
"pay_time": "2025-09-07 00:20:29",
"actural_paid": "107.00"
},
{
"order_sn": "TEST0002",
"outer_order_sn": "TEST0002",
"order_time": "2025-09-07 01:14:34",
"pay_time": "2025-09-07 01:14:35",
"actural_paid": "112.00"
},
{
"order_sn": "TEST0003",
"outer_order_sn": "TEST0003",
"order_time": "2025-09-07 03:46:19",
"pay_time": "2025-09-07 03:46:20",
"actural_paid": "74.40"
}
],
"total_count": 115
}
}
```
