订单搜索 | 微信开放文档

# 订单搜索

# 接口调用请求说明

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

# 请求参数示例

{
    "search_condition": {
        "title": "标题关键字",
        "sku_code": "12321",
        "user_name": "张三",
        "tel_number": "13700000000",
        "order_id": "3713218625342112768",
        "merchant_notes": "晚点发货",
        "customer_notes": "发顺丰"
    },
    "on_aftersale_order_exist": 0,
    "status": 20,
    "page_size": 10,
    "next_key": "THE_NEXT_KEY"
}

# 回包示例

{
    "errcode": 0,
    "errmsg": "ok",
    "orders": [
        "3715847042071365120",
        "3715847042071365121"
    ],
    "has_more": false,
    "next_key": "THE_NEXT_KEY_NEW"
}

# 请求参数说明

参数	类型	是否必填	说明
search_condition	object SearchCondition	是	搜索条件
on_aftersale_order_exist	number	否	不填该参数:全部订单 0:没有正在售后的订单, 1:正在售后单数量大于等于1的订单
status	number	否	订单状态，枚举值见RequestOrderStatus
next_key	string	是	分页参数，上一页请求返回
page_size	number	是	每页数量(不超过100)

# SearchCondition

备注：以下参数必须至少设置一个字段，否则接口报错

参数	类型	是否必填	说明
title	string	否	商品标题关键词
sku_code	string	否	商品编码
user_name	string	否	收件人
tel_number	string	否	收件人电话
order_id	string	否	选填，只搜一个订单时使用
merchant_notes	string	否	商家备注
customer_notes	string	否	买家备注
address_under_review	bool	否	申请修改地址审核中

# 回包参数说明

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

# 枚举-RequestOrderStatus

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

# 错误码

错误码	错误信息
公共错误码	点击查看
47001	请求体格式不正确，请检查请求体中各个参数的类型是否正确
40097	请求体参数不正确，请检查各个参数是否按规范填写
10080000	账号发起注销，进入注销公示期
10080001	账号已注销
6060456	请求失败，请检查请求内是否包含不合法字符