获取优惠券列表

接口调用请求说明

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

请求参数示例

  1. {
  2.     "coupon_id":12639900
  3. }

回包示例

  1. {
  2.     "errcode": 0,
  3.     "coupon": {
  4.         "coupon_id": 12639900,
  5.         "type": 103,
  6.         "status": 5,
  7.         "create_time": "2020-07-16 15:43:05",
  8.         "update_time": "2020-07-16 15:58:47",
  9.         "coupon_info": {
  10.             "name": "scs",
  11.             "promote_info": {
  12.                 "promote_type": "PROMOTE_TYPE_CUSTOMIZE",
  13.                 "customize_channel": "sc"
  14.             },
  15.             "discount_info": {
  16.                 "discount_num": 9900
  17.             },
  18.             "valid_info": {
  19.                 "valid_type": "COUPON_VALID_TYPE_TIME",
  20.                 "valid_day_num": 0,
  21.                 "start_time": 1594828800,
  22.                 "end_time": 1595433600
  23.             }
  24.         },
  25.         "stock_info": {}
  26.     }
  27. }

请求参数说明

参数类型是否必填说明
coupon_idnumber是优惠券id

回包参数说明

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

枚举-type

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

枚举-status

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

枚举-valid_type

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

返回码

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