获取优惠券列表

接口调用请求说明

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

请求参数示例

  1. {
  2. "start_create_time": "2020-03-25 12:05:25",
  3. "end_create_time": "2020-04-25 12:05:25",
  4. "status": 2,
  5. "page": 1,
  6. "page_size": 10
  7. }

回包示例

  1. {
  2. "errcode": 0,
  3. "errmsg": "ok",
  4. "coupons":
  5. [
  6. {
  7. "coupon_id": 123,
  8. "type": 1,
  9. "status": 1,
  10. "create_time": "2020-05-30 00:00:00",
  11. "update_time": "2020-05-30 12:00:00",
  12. "coupon_info":
  13. {
  14. "name": "服饰满100-50",
  15. "valid_info":
  16. {
  17. "valid_type": 1
  18. "valid_day_num": 0 //valid_type=2时才有意义
  19. "start_time": "2020-06-01 00:00:00" //valid_type=1时才有意义
  20. "end_time": "2020-07-01 00:00:00" //valid_type=1时才有意义
  21. },
  22. "promote_info":
  23. {
  24. "promote_type": 1 // 1:店铺内推广,2:自定义推广渠道,3:定向优惠
  25. "customize_channel": "xxxx" //自定义推广渠道具体内容,promote_type=2时才有意义
  26. },
  27. "discount_info": {
  28. "discount_condition": {
  29. "product_price": 10000,
  30. "product_ids": []
  31. },
  32. "discount_fee": 600
  33. }
  34. },
  35. "stock_info":
  36. {
  37. "issued_num": 100,
  38. "receive_num": 100,
  39. "used_num": 100
  40. }
  41. }
  42. ]
  43. }

请求参数说明

参数类型是否必填说明
start_create_timestring优惠券创建时间的搜索开始时间
end_create_timestring优惠券创建时间的搜索结束时间
statusnumber优惠券状态
pagenumber第几页(最小填1)
page_sizenumber每页数量(不超过10,000)

回包参数说明

参数类型说明
errcodenumber错误码
errmsgstring错误信息
coupons[].coupon_idnumber优惠券
coupons[].typenumber优惠券类型
coupons[].statusnumber优惠券状态
coupons[].create_timestring优惠券创建时间
coupons[].update_timestring优惠券更新时间
coupons[].coupon_info.namestring优惠券名称
coupons[].coupon_info.valid_info.valid_typenumber优惠券有效期类型
coupons[].coupon_info.valid_info.valid_day_numnumber优惠券有效天数,valid_type=2时才有意义
coupons[].coupon_info.valid_info.start_timestring优惠券有效期开始时间,valid_type=1时才有意义
coupons[].coupon_info.valid_info.end_timestring优惠券有效期结束时间,valid_type=1时才有意义
coupons[].coupon_info.promote_info.promote_typenumber推广类型,1:店铺内推广,2:自定义推广渠道,3:定向优惠
coupons[].coupon_info.promote_info.customize_channelstring自定义推广渠道具体内容,promote_type=2时才有意义
coupons[].stock_info.issued_numnumber优惠券剩余量
coupons[].stock_info.receive_numnumber优惠券领用量
coupons[].stock_info.used_numnumber优惠券已用量
coupons[].discount_info.discount_numnumber优惠券折扣数 * 1000, 例如 5.1折-> 5100
coupons[].discount_info.discount_feenumber优惠券减少金额, 单位分, 例如0.5元-> 50
coupons[].discount_info.discount_condition.product_cntnumber优惠券使用条件, 满x件商品可用
coupons[].discount_info.discount_condition.product_pricenumber优惠券使用条件, 价格满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生效天数

返回码

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