# 查询订单流水列表
接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南
接口英文名：listorderflow
可通过该接口可获取订单的结算信息列表
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/funds/listorderflow?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用
# 第三方调用
本接口支持第三方平台代微信小店商家调用。第三方服务商调用模式介绍
该接口所属的权限集 id 为：138
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代微信小店商家进行调用，具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证，可使用 access_token（微信小店商家）、authorizer_access_token（服务商代调用） |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 | 枚举 |
|---|---|---|---|---|
| order_settle_state | number | 是 | 订单结算状态 | 枚举值 |
| order_state | number | 否 | 订单状态 | 枚举值 |
| order_pay_method | number | 否 | 订单支付方式 | 枚举值 |
| order_id | string | 否 | 指定订单id查询 | - |
| pagination_info | object | 否 | 分页信息 | - |
| create_time_range | object | 否 | 订单创建时间范围 | - |
# Body.pagination_info Object Payload
分页信息
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | number | 是 | 页大小 |
| offset | number | 否 | 偏移量 |
| use_page_ctx | boolean | 否 | 是否使用分页上下文，可以保证翻页的过程中订单不会遗漏和重复，此时 offset 不生效。 |
| page_ctx | string | 否 | 分页上下文，每次翻页传入上一页回参的 page_ctx，第一页可不传或者传空字符串 |
# Body.create_time_range Object Payload
订单创建时间范围
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| begin | number | 否 | 订单创建时间开始（闭区间） |
| end | number | 否 | 订单创建时间结束（开区间） |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | - |
| errmsg | string | - |
| total_count | number | 满足条件的总数量，仅供参考（翻页的过程可能变动） |
| data_list | objarray | 订单流水列表 |
| page_ctx | string | 如果使用分页上下文，则返回此字段 |
# Res.data_list(Array) Object Payload
订单流水列表
| 参数名 | 类型 | 说明 |
|---|---|---|
| order_id | string | 订单id |
| order_state | number | 订单状态 |
| order_settle_state | number | 订单结算状态 |
| order_create_time | number | 订单创建时间,单位(s) |
| order_paid_time | number | 订单支付时间,单位(s) |
| order_pay_method | number | 订单支付方式 |
| order_type | number | 订单类型 |
| mch_received_amount | number | 商户实收金额,单位(分) |
| expense_amount | number | 支出金额,单位(分) |
| mch_settle_amount | number | (预计)结算金额,单位(分) |
| mch_settle_time | number | (预计)商家货款结算时间 |
| product_list | objarray | 商品列表 |
| product_total_amount | number | 商品总金额,单位(分) |
| freight_amount | number | 运费金额,单位(分) |
| change_down_price | number | 改价金额,单位(分) |
| mch_discount_amount | number | 商户优惠金额,单位(分) |
| score_discount_amount | number | 积分抵扣金额,单位(分) |
| buyer_paid_amount | number | 用户实付金额,单位(分) |
| promoter_discount_amount | number | 达人优惠金额,单位(分) |
| platform_discount_amount | number | 平台优惠金额,单位(分) |
| national_subsidy_discount_amount | number | 国家补贴金额,单位(分) |
| freight_make_up_amount | number | 补交运费 |
| cross_shop_discount_amount | number | 跨店优惠金额,单位(分) |
| buyer_refund_amount | number | 用户退款金额,单位(分) |
| platform_discount_refund_amount | number | (预计)平台优惠退款金额,单位(分) |
| promoter_discount_refund_amount | number | 达人优惠退款金额,单位(分) |
| original_platform_commission_amount | number | 原技术服务费,单位(分) |
| platform_commission_amount | number | (预计)技术服务费,单位(分) |
| freight_insurance_subsidy_amount | number | 运费险补贴减免技术服务费,单位(分) |
| supplier_commission_amount | number | (预计)机构服务费,单位(分) |
| supplier_commission_settle_state | number | 机构服务费结算状态 |
| promoter_commission_amount | number | (预计)达人服务费,单位(分) |
| promoter_commission_settle_state | number | 达人服务费结算状态 |
| freight_insurance_amount | number | (预计)运费险金额,单位(分) |
| freight_insurance_settle_state | number | 运费险结算状态 |
| freight_insurance_make_up_amount | number | 运费险补缴他单金额,单位(分) |
| freight_insurance_make_up_order_id_list | array | 运费险补缴他单订单id列表 |
| platform_commission_settle_time | number | (预计)技术服务费结算时间,单位(s) |
| promoter_commission_settle_time | number | (预计)达人服务费结算时间,单位(s) |
| supplier_commission_settle_time | number | (预计)机构服务费结算时间,单位(s) |
| freight_insurance_settle_time | number | (预计)运费险结算时间 |
| freight_insurance_make_up_settle_time | number | (预计)运费险补缴他单结算时间 |
| pre_freight_refund_amount | number | 预付运费退回金额 |
| post_settlement_expense | object | 结算后支出 |
| refund_before_settlement | number | 结算前退款 |
| other_expense_amount | number | 其他支出 |
| platform_commission_settle_state | number | 平台服务费结算状态 |
| freight_insurance_make_up_settle_state | number | 运费险补缴他单结算状态 |
| intra_city_shop_id | number | 同城配送门店id |
# Res.data_list(Array).product_listObject Payload
Object Payload商品列表
| 参数名 | 类型 | 说明 |
|---|---|---|
| product_id | number | 商品id |
| param_list | objarray | 商品规格列表 |
| sale_price | number | 商品销售价格,单位分 |
| count | number | 商品数量 |
| product_name | string | 商品名称 |
| is_gift | boolean | 是否赠品 |
# Res.data_list(Array).product_list.param_listObject Payload
Object Payload商品规格列表
| 参数名 | 类型 | 说明 |
|---|---|---|
| key | string | 规格名称 |
| value | string | 规格值 |
# Res.data_list(Array).post_settlement_expense Object Payload
结算后支出
| 参数名 | 类型 | 说明 |
|---|---|---|
| buyer_refund_amount | number | 买家退款 |
| platform_discount_refund_amount | number | 平台优惠退款金额 |
| promoter_refund_amount | number | 达人退款金额 |
| freight_insurance_make_up_amount | number | 运费险保费 |
| freight_insurance_make_up_settle_state | number | 运费险补缴本单结算状态 |
| freight_insurance_make_up_order_id | number | 运费险补缴本单的订单id |
# 4. 枚举信息
# Body.order_settle_state Enum
订单结算状态
| 枚举值 | 描述 |
|---|---|
| 0 | 无，查询全部 |
| 1 | 待结算 |
| 2 | 无需结算 |
| 60 | 结算完成 |
| 100 | 部分结算 |
# Body.order_state Enum
订单状态
| 枚举值 | 描述 |
|---|---|
| 0 | 全部 |
| 20 | 待发货 |
| 30 | 待收货 |
| 100 | 订单完成 |
# Body.order_pay_method Enum
订单支付方式
| 枚举值 | 描述 |
|---|---|
| 0 | 全部 |
| 1 | 普通支付 |
| 2 | 先用后付 |
# 5. 注意事项
所有项目的结算状态，与order_settle_state相同
# 6. 代码示例
请求示例
{
"order_settle_state": 1,
"order_state": 30,
"order_pay_method": 0,
"order_create_time_range": {
"begin": 1761926400,
"end": 1762876799
},
"pagination_info": {
"limit": 20,
"offset": 0
}
}
返回示例
```json
{
"total_count": 1,
"data_list": [
{
"supplier_commission_settle_state": 2,
"expense_amount": 5994,
"buyer_paid_amount": 299700,
"original_platform_commission_amount": 5994,
"score_discount_amount": 0,
"promoter_discount_refund_amount": 0,
"mch_settle_amount": 293706,
"post_settlement_expense": {
"promoter_refund_amount": 0,
"buyer_refund_amount": 0,
"platform_discount_refund_amount": 0
},
"buyer_refund_amount": 0,
"freight_insurance_settle_state": 2,
"change_down_price": 0,
"order_type": 0,
"pre_freight_refund_amount": 0,
"other_expense_amount": 0,
"platform_discount_amount": 0,
"mch_received_amount": 299700,
"promoter_discount_amount": 0,
"order_paid_time": 1762854428,
"refund_before_settlement": 0,
"freight_amount": 0,
"freight_insurance_make_up_settle_state": 2,
"platform_commission_settle_state": 1,
"promoter_commission_settle_state": 2,
"order_create_time": 1762854411,
"platform_commission_settle_time": 0,
"order_id": "37000000000000000000",
"product_total_amount": 299700,
"platform_discount_transfer_state": 0,
"order_settle_state": 1,
"national_subsidy_discount_amount": 0,
"order_state": 30,
"cross_shop_discount_amount": 0,
"platform_discount_refund_amount": 0,
"mch_settle_time": 0,
"freight_make_up_amount": 0,
"product_list": [
{
"count": 1,
"is_gift": false,
"product_id": 1647017194,
"param_list": [
{
"value": "规格名称1",
"key": "规格值1"
},
{
"value": "规格名称2",
"key": "规格值2"
}
],
"sale_price": 299700,
"product_name": "商品名称"
}
],
"order_pay_method": 1,
"mch_discount_amount": 0,
"platform_commission_amount": 5994
}
]
}
# 7. 错误码
以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| 669900000 | 参数错误 | 具体查看errmsg |
| 669900001 | 系统异常 | 请重试 |
# 8. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。
接口变更日志（1条）2025 年 11 月 12 日
新增查询订单流水列表接口