搜索订单

接口调用请求说明

http请求方式:POST
https://api.weixin.qq.com/product/order/search?access_token=xxxxxxxxx

请求参数示例

{
    "start_pay_time": "2020-03-25 12:05:25",
    "end_pay_time": "2020-04-25 12:05:25",
    "title": "标题关键字",
    "sku_code": "12321",
    "user_name": "张三",
    "tel_number": "13700000000",
    "on_aftersale_order_exist": 0,
    "status": 20,
    "source": 1, //订单来源,默认0, 0:全部, 1:小商店自营订单, 2:带货订单
    "order_id": 123,    // 选填,只搜一个订单时使用
    "page": 1,
    "page_size": 10
}

回包示例

{
    "errcode": 0,
    "errmsg":"ok",
    "orders": 
    [
        {
            "order_id":32434234,
            "status": 23,
            "craete_time": "2020-03-25 13:05:25",
            "update_time": "2020-03-25 14:05:25",
            "order_detail":
            {
                "product_infos":
                [
                    {
                        "product_id": 234245,
                        "sku_id":23424,
                        "sku_cnt": 10,
                        "on_aftersale_sku_cnt": 10,
                        "finish_aftersale_sku_cnt": 0,
                        "title":"健身环",
                        "thumb_img": "http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg",
                        "sku_attrs": 
                        [
                           {
                               "attr_key": "选择颜色",
                               "attr_value": "红蓝主机"
                           }
                        ],
                        "slae_price": 2000
                    },
                    ...
                ]
                "pay_info":
                {
                    "pay_method": "微信支付",
                    "prepay_id": "42526234625",
                    "transaction_id": "131456479687",
                    "prepay_time": "2020-03-25 14:04:25"
                    "pay_time": "2020-03-25 14:05:25"
                },
                "price_info":
                {
                    "product_price": 20000,
                    "order_price": 10500,
                    "freight": 500,
                    "discounted_price": 10000
                    "is_discounted": 1
                }
                "delivery_info":
                {
                    "delivery_method": "快递",
                    "delivery_time": "2020-03-25 16:05:25",
                    "delivery_product_info":
                    [
                        {
                            "waybill_id": "134654612313",
                            "delivery_id": "STO",
                            "product_infos":
                            [
                                {
                                    "product_id": 234245,
                                    "sku_id":23424,
                                    "product_cnt":1
                                }
                            ]
                        }
                    ]
                    "address_info":
                    {
                        "user_name":"陈先生",
                        "postal_code": "2435245",
                        "province_name": "广东",
                        "city_name": "广州",
                        "county_name": "海珠区",
                        "detail_info": "大塘",
                        "national_code": "234234",
                        "tel_number": "24534252"
                    }
                }
            },
            "after_sale_info": 
            {
                "aftersale_order_list": [
                    {
                        "aftersale_order_id": 1234
                    }
                ],
                "on_aftersale_order_cnt": 1
            },
            "openid": "xxxxx",
            "ext_info":
            {
                "customer_notes": "发顺丰",
                "merchant_notes": "库存不足,取消"
            }
        },
        ...
    ],
    "total_num": 20
}

请求参数说明

参数 类型 是否必填 说明
start_pay_time string 订单支付时间的搜索开始时间
end_pay_time string 订单支付时间的搜索结束时间
title string 商品标题关键词
sku_code string 商品编码
user_name string 收件人
tel_number string 收件人电话
on_aftersale_order_exist number 不填该参数:全部订单 0:没有正在售后的订单, 1:正在售后单数量大于等于1的订单
status number 订单状态
source number 订单来源,默认0, 1:小商店自营订单, 2:带货订单
order_id number 选填,只搜一个订单时使用
page number 第几页(最小填1)
page_size number 每页数量(不超过10,000)

回包参数说明

参数 类型 说明
errcode string 错误码
errmsg string 错误信息
orders[].order_id number 订单ID
orders[].create_time string 创建时间
orders[].update_time string 更新时间
orders[].order_detail.product_infos[].product_id number 小商店内部商品ID
orders[].order_detail.product_infos[].sku_id number 小商店内部skuID
orders[].order_detail.product_infos[].thumb_img string sku小图
orders[].order_detail.product_infos[].sku_cnt number sku数量
orders[].order_detail.product_infos[].on_aftersale_sku_cnt number 正在售后/退款流程中的sku数量
orders[].order_detail.product_infos[].finish_aftersale_sku_cnt number 完成售后/退款的sku数量
orders[].order_detail.product_infos[].sale_price number 售卖价格,以分为单位
orders[].order_detail.product_infos[].sku_attrs[].attr_key string 属性键key(属性自定义用)
orders[].order_detail.product_infos[].sku_attrs[].attr_value string 属性值(属性自定义用)
orders[].order_detail.pay_info.pay_method string 支付方式(目前只有"微信支付")
orders[].order_detail.pay_info.prepay_id string 预支付ID
orders[].order_detail.pay_info.transaction_id string 支付订单号
orders[].order_detail.pay_info.prepay_time string 预付款时间
orders[].order_detail.pay_info.pay_time string 付款时间
orders[].order_detail.price_info.product_price number 商品金额(单位:分)
orders[].order_detail.price_info.order_price number 订单金额(单位:分)
orders[].order_detail.price_info.freight number 运费(单位:分)
orders[].order_detail.price_info.discounted_price number 优惠金额(单位:分)
orders[].order_detail.price_info.is_discounted number 是否有优惠(0:无优惠/1:有优惠)
orders[].order_detail.delivery_info.delivery_method string 快递方式(目前只有"快递")
orders[].order_detail.delivery_info.delivery_time string 发货时间
orders[].order_detail.delivery_info.delivery_product_info[].waybill_id string 快递单号
orders[].order_detail.delivery_info.delivery_product_info[].delivery_id string 快递公司编号
orders[].order_detail.delivery_info.delivery_product_info[].product_infos[].product_id number 已发货商品小商店内部商品ID
orders[].order_detail.delivery_info.delivery_product_info[].product_infos[].sku_id number 已发货商品小商店内部skuID
orders[].order_detail.delivery_info.delivery_product_info[].product_infos[].product_cnt number 已发货商品数量
orders[].order_detail.delivery_info.address_info.username string 收货人姓名
orders[].order_detail.delivery_info.address_info.postal_code string 邮编
orders[].order_detail.delivery_info.address_info.province_name string 国标收货地址第一级地址
orders[].order_detail.delivery_info.address_info.city_name string 国标收货地址第二级地址
orders[].order_detail.delivery_info.address_info.county_name string 国标收货地址第三级地址
orders[].order_detail.delivery_info.address_info.detail_info string 详细收货地址信息
orders[].order_detail.delivery_info.address_info.national_code string 收货地址国家码
orders[].order_detail.delivery_info.address_info.tel_number string 收货人手机号码
orders[].aftersale_detail.aftersale_order_list[].aftersale_order_id number 售后单ID(售后接口开放后可用于查询)
orders[].aftersale_detail.on_aftersale_order_cnt number 正在售后流程的售后单数
orders[].openid string 用户的openid,用于物流助手接口
orders[].ext_info.customer_notes string 用户备注
orders[].ext_info.merchant_notes string 商家备注
total_num number 订单总数

枚举-status

枚举值 描述
10 待付款
15 拼团活动 支付成功 等待成团中
16 支付成功 等待商家接单中 (同城配送, 线下自提)
17 支付成功待核销
20 待发货
21 部分发货
30 待收货
100 完成
200 全部商品售后之后,订单取消
250 用户主动取消或待付款超时取消

返回码

返回码 错误类型
-1 系统异常
-2 token太长
9401020 参数有误