获取订单列表 | 微信开放文档

# 获取订单列表

# 接口说明

可通过该接口获取视频号小店的订单列表

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/ec/order/list/get?access_token=ACCESS_TOKEN

# 请求参数说明

参数	类型	是否必填	描述
create_time_range	object TimeRange	时间范围至少填一个	订单创建时间范围，具体结构请参考TimeRange结构体
update_time_range	object TimeRange	时间范围至少填一个	订单更新时间范围，具体结构请参考TimeRange结构体
status	number	否	订单状态，具体枚举值请参考RequestOrderStatus枚举
openid	string	否	买家身份标识
next_key	string	否	分页参数，上一页请求返回
page_size	number	是	每页数量(不超过100)

# 请求参数示例

{
    "create_time_range": {
        "start_time": 1658505600,
        "end_time": 1658509200
    },
    "page_size": 10,
    "next_key": "THE_NEXT_KEY"
}

# 返回参数说明

参数	类型	描述
errcode	string	错误码
errmsg	string	错误信息
order_id_list	array string	订单号列表
next_key	string	分页参数，下一页请求返回
has_more	bool	是否还有下一页，true:有下一页；false:已经结束，没有下一页。

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok",
    "order_id_list": [
        "3704612354559743232",
        "3704849110714209536"
    ],
    "next_key": "THE_NEXT_KEY_NEW",
    "has_more": true
}

# 错误码

错误码	错误描述
公共错误码	-
47001	请求体格式不正确，请检查请求体中各个参数的类型是否正确
40097	请求体参数不正确，请检查各个参数是否按规范填写，具体原因查看errmsg
606006	next_key参数不正确，本次请求参数与上一页不一致
31042	请求内订单过多，请缩短时间范围后重试

# 结构体

# TimeRange

时间范围

参数	类型	是否必填	描述
start_time	number	是	秒级时间戳（距离end_time不可超过7天）
end_time	number	是	秒级时间戳（距离start_time不可超过7天）

# 枚举值

# RequestOrderStatus

订单状态

枚举值	描述
10	待付款
20	待发货（包括部分发货
21	部分发货
30	待收货（包括部分发货）
100	完成
250	订单取消（包括未付款取消，售后取消等）