# 获取优惠券列表

# 接口调用请求说明

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

# 请求参数示例

{
    "start_create_time": "2020-03-25 12:05:25",
    "end_create_time": "2020-04-25 12:05:25",
    "status": 2,
    "page": 1,
    "page_size": 10
}

# 回包示例

{
    "errcode": 0,
    "errmsg": "ok",
    "coupons": 
    [
        {
            "coupon_id": 123,
            "type": 1,
            "status": 1,
            "create_time": "2020-05-30 00:00:00",
            "update_time": "2020-05-30 12:00:00",
            "coupon_info":
            {
                "name": "服饰满100-50",
                "valid_info": 
                {
                    "valid_type": 1
                    "valid_day_num": 0                      //valid_type=2时才有意义
                    "start_time": "2020-06-01 00:00:00"     //valid_type=1时才有意义
                    "end_time": "2020-07-01 00:00:00"       //valid_type=1时才有意义
                },
                "promote_info":
                {
                    "promote_type": 1       // 1:店铺内推广,2:自定义推广渠道,3:定向优惠
                    "customize_channel": "xxxx" //自定义推广渠道具体内容,promote_type=2时才有意义
                }
            },
            "stock_info":
            {
                "issued_num": 100,
                "receive_num": 100,
                "used_num": 100
            }
        }
    ]
}

# 请求参数说明

参数 类型 是否必填 说明
start_create_time string 优惠券创建时间的搜索开始时间
end_create_time string 优惠券创建时间的搜索结束时间
status number 优惠券状态
page number 第几页(最小填1)
page_size number 每页数量(不超过10,000)

# 回包参数说明

参数 类型 说明
errcode number 错误码
errmsg string 错误信息
coupons[].coupon_id number 优惠券
coupons[].type number 优惠券类型
coupons[].status number 优惠券状态
coupons[].create_time string 优惠券创建时间
coupons[].update_time string 优惠券更新时间
coupons[].coupon_info.name string 优惠券名称
coupons[].coupon_info.valid_info.valid_type number 优惠券有效期类型
coupons[].coupon_info.valid_info.valid_day_num number 优惠券有效天数,valid_type=2时才有意义
coupons[].coupon_info.valid_info.start_time string 优惠券有效期开始时间,valid_type=1时才有意义
coupons[].coupon_info.valid_info.end_time string 优惠券有效期结束时间,valid_type=1时才有意义
coupons[].coupon_info.promote_info.promote_type number 推广类型,1:店铺内推广,2:自定义推广渠道,3:定向优惠
coupons[].coupon_info.promote_info.customize_channel string 自定义推广渠道具体内容,promote_type=2时才有意义
coupons[].stock_info.issued_num number 优惠券发放量
coupons[].stock_info.receive_num number 优惠券领用量
coupons[].stock_info.used_num number 优惠券已用量

# 枚举-type

枚举值 描述
1 商品条件折扣券
2 商品满减券
3 商品统一折扣券
4 商品直减券
101 店铺条件折扣券
102 店铺满减券
103 店铺统一折扣券
104 店铺直减券

# 枚举-status

枚举值 描述
1 未生效,编辑中
2 生效
3 已过期
4 已作废
5 删除
100 生效中
101 已过期
102 已经使用

# 枚举-valid_type

枚举值 描述
1 商品指定时间区间
2 生效天数

# 返回码

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