创建优惠券
接口调用请求说明
创建优惠券时status=1 注意下面所有时间字段里面的均为以秒为单位的时间戳!
http请求方式:POST
https://api.weixin.qq.com/product/coupon/create?access_token=xxxxxxxxx
请求参数示例
{
"type": 1,
"name" : "双十一特惠满100-50", //长度 <= 10
"discount_info" :
{
"discount_condition" :
{
"product_cnt" : 10,//商品折扣券填
"product_ids" : //商品券填
[
1673110742,
1673110743
],
"product_price" : 100//满减券填
},
"discount_fee" : 50,//满减金额
"discount_num" : 5000//折扣券填,换算规则,比如5000=5折,7800=7.8折,范围是1000-10000,必须是100的整数
},
"ext_info" :
{
"jump_product_id" : 1673110742,//商品券可以填,领取后跳转
"notes" : "备注",
"valid_time" : 1673110742, // valid_type=1时与valid_info.start_time一致, valid_type=2时商家自己填一个绝对开始时间
"invalid_time" : 1673110742 // valid_type=1时与valid_info.end_time一致, valid_type=2时商家自己填一个绝对结束时间
},
"promote_info" :
{
"customize_channel" : "//自定义推广渠道,具体内容",
"promote_type" : 1 //推广类型,1:店铺内推广,2:自定义推广渠道
},
"receive_info" : // 允许用户领取优惠券的设置
{
"end_time" : 1673110742,
"limit_num_one_person" : 1,
"start_time" : 1673110742,
"total_num" : 100
},
"valid_info" :
{
"end_time" : 1673110742, //绝对生效开始时间, valid_type=1时必填
"start_time" : 1673110742, //绝对生效结束时间, valid_type=1时必填
"valid_day_num" : 1, //相对生效时间时长, 以用户领到券的时候开始算, valid_type=2时必填
"valid_type" : 1
}
}
回包示例
{
"errcode": 0,
"errmsg": "ok",
"data": {
"coupon_id": 111
}
}
请求参数说明
参数 | 类型 | 是否必填 | 说明 |
---|
type | number | 是 | 优惠券类型 |
name | string | 是 | 优惠券名称 |
discount_info.discount_condition.product_cnt | number | 否 | 商品折扣券打折金额 |
discount_info.discount_condition.product_ids | number | 否 | 商品id,商品折扣券需填写 |
discount_info.discount_condition.product_price | number | 否 | 商品价格,满减券需填写 |
discount_info.discount_fee | number | 是 | 满减金额 |
discount_info.discount_num | number | 否 | 打折商品数量,满减券需填写,换算规则,5000=5折,7000=7折,范围是1000-10000,必须是100的整数 |
ext_info.invalid_time | string | 是 | 优惠券失效时间 |
ext_info.jump_product_id | number | 否 | 商品折扣券领取后跳转的商品id |
ext_info.notes | string | 否 | 备注信息 |
ext_info.valid_time | string | 是 | 优惠券有效时间 |
promote_info.customize_channel | string | 是 | 用户自定义推广渠道 |
promote_info.promote_type | string | 是 | 推广类型 |
receive_info.end_time | string | 是 | 优惠券领用结束时间 |
receive_info.limit_num_one_person | number | 是 | 是否限制一人使用 |
receive_info.start_time | string | 是 | 优惠券领用开始时间 |
receive_info.total_num | number | 是 | 优惠券领用总数 |
valid_info.end_time | number | 否 | 优惠券有效期结束时间,若填了start必填 |
valid_info.start_time | number | 否 | 优惠券有效期开始时间,和valid_day_num二选一 |
valid_info.valid_day_num | number | 是 | 优惠券有效期天数,和start_time二选一 |
valid_info.valid_type | number | 是 | 优惠券有效期类型 |
回包参数说明
参数 | 类型 | 说明 |
---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
data.coupon_id | number | 优惠券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 | token太长 |
9401020 | 参数有误 |