创建优惠券

接口调用请求说明

创建优惠券时status=1 注意下面所有时间字段里面的均为以秒为单位的时间戳!

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

请求参数示例

  1. {
  2. "type": 1,
  3. "name" : "双十一特惠满100-50", //长度 <= 10
  4. "discount_info" :
  5. {
  6. "discount_condition" :
  7. {
  8. "product_cnt" : 10,//商品折扣券填
  9. "product_ids" : //商品券填
  10. [
  11. 1673110742,
  12. 1673110743
  13. ],
  14. "product_price" : 100//满减券填
  15. },
  16. "discount_fee" : 50,//满减金额
  17. "discount_num" : 5000//折扣券填,换算规则,比如5000=5折,7800=7.8折,范围是1000-10000,必须是100的整数
  18. },
  19. "ext_info" :
  20. {
  21. "jump_product_id" : 1673110742,//商品券可以填,领取后跳转
  22. "notes" : "备注",
  23. "valid_time" : 1673110742, // valid_type=1时与valid_info.start_time一致, valid_type=2时商家自己填一个绝对开始时间
  24. "invalid_time" : 1673110742 // valid_type=1时与valid_info.end_time一致, valid_type=2时商家自己填一个绝对结束时间
  25. },
  26. "promote_info" :
  27. {
  28. "customize_channel" : "//自定义推广渠道,具体内容",
  29. "promote_type" : 1 //推广类型,1:店铺内推广,2:自定义推广渠道
  30. },
  31. "receive_info" : // 允许用户领取优惠券的设置
  32. {
  33. "end_time" : 1673110742,
  34. "limit_num_one_person" : 1,
  35. "start_time" : 1673110742,
  36. "total_num" : 100
  37. },
  38. "valid_info" :
  39. {
  40. "end_time" : 1673110742, //绝对生效开始时间, valid_type=1时必填
  41. "start_time" : 1673110742, //绝对生效结束时间, valid_type=1时必填
  42. "valid_day_num" : 1, //相对生效时间时长, 以用户领到券的时候开始算, valid_type=2时必填
  43. "valid_type" : 1
  44. }
  45. }

回包示例

  1. {
  2. "errcode": 0,
  3. "errmsg": "ok",
  4. "data": {
  5. "coupon_id": 111
  6. }
  7. }

请求参数说明

参数类型是否必填说明
typenumber优惠券类型
namestring优惠券名称
discount_info.discount_condition.product_cntnumber商品折扣券打折金额
discount_info.discount_condition.product_idsnumber商品id,商品折扣券需填写
discount_info.discount_condition.product_pricenumber商品价格,满减券需填写
discount_info.discount_feenumber满减金额
discount_info.discount_numnumber打折商品数量,满减券需填写,换算规则,5000=5折,7000=7折,范围是1000-10000,必须是100的整数
ext_info.invalid_timestring优惠券失效时间
ext_info.jump_product_idnumber商品折扣券领取后跳转的商品id
ext_info.notesstring备注信息
ext_info.valid_timestring优惠券有效时间
promote_info.customize_channelstring用户自定义推广渠道
promote_info.promote_typestring推广类型
receive_info.end_timestring优惠券领用结束时间
receive_info.limit_num_one_personnumber是否限制一人使用
receive_info.start_timestring优惠券领用开始时间
receive_info.total_numnumber优惠券领用总数
valid_info.end_timenumber优惠券有效期结束时间,若填了start必填
valid_info.start_timenumber优惠券有效期开始时间,和valid_day_num二选一
valid_info.valid_day_numnumber优惠券有效期天数,和start_time二选一
valid_info.valid_typenumber优惠券有效期类型

回包参数说明

参数类型说明
errcodenumber错误码
errmsgstring错误信息
data.coupon_idnumber优惠券ID

枚举-coupon_type

枚举值描述
1商品条件折券, discount_condition.product_ids, discount_condition.product_cnt, discount_info.discount_num 必填
2商品满减券, discount_condition.product_ids, discount_condition.product_price, discount_info.discount_fee 必填
3商品统一折扣券, discount_condition.product_ids, discount_info.discount_num必填
4商品直减券, 如果小于可用的商品中的最小价格会提醒(没有商品时超过50w提醒), discount_condition.product_ids, discount_fee 必填
101店铺条件折扣券, discount_condition.product_cnt, discount_info.discount_num必填
102店铺满减券, discount_condition.product_price, discount_info.discount_fee 必填
103店铺统一折扣券, discount_info.discount_num 必填
104店铺直减券, 如果小于可用的商品中的最小价格会提醒(没有商品时超过50w提醒), discount_fee 必填

枚举-valid_type

枚举值描述
1指定时间范围生效
2生效天数

返回码

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