# 获取优惠券列表
# 接口调用请求说明
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": "COUPON_VALID_TYPE_TIME", // 枚举字段 含义见下表
"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": "PROMOTE_TYPE_SHOP", // 枚举字段 含义见下表
"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
}
}
],
"total_num": 10
}
# 请求参数说明
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
start_create_time | string | 是 | 优惠券创建时间的搜索开始时间 |
end_create_time | string | 是 | 优惠券创建时间的搜索结束时间 |
status | number | 是 | 优惠券状态 |
page | number | 是 | 第几页(最小填1) |
page_size | number | 是 | 每页数量(不超过200) |
# 回包参数说明
参数 | 类型 | 说明 |
---|---|---|
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 | string | 优惠券有效期类型,见下表 |
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 | string | 推广类型,见下表 |
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[].coupon_info.discount_info.discount_num | number | 优惠券折扣数 * 1000, 例如 5.1折-> 5100 |
coupons[].coupon_info.discount_info.discount_fee | number | 优惠券减少金额, 单位分, 例如0.5元-> 50 |
coupons[].coupon_info.discount_info.discount_condition.product_cnt | number | 优惠券使用条件, 满x件商品可用 |
coupons[].coupon_info.discount_info.discount_condition.product_price | number | 优惠券使用条件, 价格满x可用,单位分 |
coupons[].coupon_info.discount_info.discount_condition.product_ids[] | number array | 优惠券使用条件, 指定商品id可用 |
coupons[].coupon_info.ext_info.invalid_time | string | 优惠券失效时间 |
coupons[].coupon_info.ext_info.jump_product_id | number | 商品折扣券领取后跳转的商品id |
coupons[].coupon_info.ext_info.notes | string | 备注信息 |
coupons[].coupon_info.ext_info.valid_time | string | 优惠券有效时间 |
coupons[].coupon_info.receive_info.end_time | string | 优惠券领用结束时间 |
coupons[].coupon_info.receive_info.limit_num_one_person | number | 单人限领张数 |
coupons[].coupon_info.receive_info.start_time | string | 优惠券领用开始时间 |
coupons[].coupon_info.receive_info.total_num | number | 优惠券领用总数 |
total_num | number | 优惠券总数 |
# 枚举-type
枚举值 | 描述 |
---|---|
1 | 商品条件折扣券 |
2 | 商品满减券 |
3 | 商品统一折扣券 |
4 | 商品直减券 |
101 | 店铺条件折扣券 |
102 | 店铺满减券 |
103 | 店铺统一折扣券 |
104 | 店铺直减券 |
# 枚举-status
枚举值 | 描述 |
---|---|
1 | 未生效,编辑中 |
2 | 生效 |
3 | 已过期 |
4 | 已作废 |
5 | 删除 |
200 | 过期 or 作废的券 |
# 枚举-promote_type
枚举字段名 | 枚举值 | 描述 |
---|---|---|
PROMOTE_TYPE_SHOP | 1 | 店铺内推广 |
PROMOTE_TYPE_CUSTOMIZE | 2 | 自定义推广渠道 |
PROMOTE_TYPE_TARGET | 3 | 定向优惠 |
# 枚举-valid_type
枚举字段名 | 枚举值 | 描述 |
---|---|---|
COUPON_VALID_TYPE_TIME | 1 | 商品指定时间区间 |
COUPON_VALID_TYPE_DAY | 2 | 生效天数 |
# 返回码
返回码 | 错误类型 |
---|---|
-1 | 系统异常 |
-2 | token太长 |
9401020 | 参数有误 |