获取优惠券列表
接口调用请求说明
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时才有意义
},
"discount_info": {
"discount_condition": {
"product_price": 10000,
"product_ids": []
},
"discount_fee": 600
}
},
"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 | 优惠券已用量 |
coupons[].discount_info.discount_num | number | 优惠券折扣数 * 1000, 例如 5.1折-> 5100 |
coupons[].discount_info.discount_fee | number | 优惠券减少金额, 单位分, 例如0.5元-> 50 |
coupons[].discount_info.discount_condition.product_cnt | number | 优惠券使用条件, 满x件商品可用 |
coupons[].discount_info.discount_condition.product_price | number | 优惠券使用条件, 价格满x可用,单位分 |
coupons[].discount_info.discount_condition.product_ids[] | number array | 优惠券使用条件, 指定商品id可用 |
枚举-type
枚举值 | 描述 |
---|
1 | 商品条件折扣券 |
2 | 商品满减券 |
3 | 商品统一折扣券 |
4 | 商品直减券 |
101 | 店铺条件折扣券 |
102 | 店铺满减券 |
103 | 店铺统一折扣券 |
104 | 店铺直减券 |
枚举-status
枚举值 | 描述 |
---|
1 | 未生效,编辑中 |
2 | 生效 |
3 | 已过期 |
4 | 已作废 |
5 | 删除 |
200 | 过期 or 作废的券 |
枚举-valid_type
返回码
返回码 | 错误类型 |
---|
-1 | 系统异常 |
-2 | token太长 |
9401020 | 参数有误 |