# 创建优惠券
# 接口说明
可通过此接口创建优惠券。
# 注意事项
- 创建优惠券时status=1（未生效，编辑中）;
- 注意下面所有时间字段里面的均为以秒为单位的时间戳。
# 接口调用请求说明
POST https://api.weixin.qq.com/channels/ec/coupon/create?access_token=ACCESS_TOKEN
# 请求参数说明
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| type | number | 是 | 优惠券类型，枚举值详情请参考type |
| name | string | 是 | 优惠券名称，最长10个中文字符 |
| discount_info.discount_condition.product_cnt | number | 否 | 商品件数门槛，不能和价格门槛同时设置 |
| discount_info.discount_condition.product_ids | string array | 否 | 商品id，商品券需填写，最多 200 个商品 |
| discount_info.discount_condition.product_price | number | 否 | 商品价格门槛，单位为分，不能和件数门槛同时设置 |
| discount_info.discount_fee | number | 否 | 优惠减免金额，单位为分，不可超过200元，同时如果是商品券，适用商品优惠后不可低于原价2折，如果是店铺满减券，不可低于价格门槛的2折。 详见详情描述 |
| discount_info.discount_num | number | 否 | 优惠减免折扣数，换算规则，5000=5折，7000=7折，范围是1000-10000，必须是100的整数，不可低于2折，详见详情描述 |
| ext_info.jump_product_id | string | 否 | 商品折扣券领取后跳转的商品id |
| ext_info.notes | string | 否 | 备注信息 |
| promote_info.promote_type | number | 是 | 推广类型，枚举值详情请参考promote_type |
| receive_info.end_time | number | 是 | 优惠券领用结束时间戳（秒级时间戳） |
| receive_info.limit_num_one_person | number | 是 | 单人限领张数 |
| receive_info.start_time | number | 是 | 优惠券领用开始时间戳（秒级时间戳） |
| receive_info.total_num | number | 是 | 优惠券领用总数 |
| valid_info.end_time | number | 否 | 优惠券有效期结束时间（秒级时间戳），valid_type为1时必填 |
| valid_info.start_time | number | 否 | 优惠券有效期开始时间（秒级时间戳），valid_type为1时必填 |
| valid_info.valid_day_num | number | 否 | 优惠券有效期天数，valid_type为2时必填 |
| valid_info.valid_type | number | 是 | 优惠券有效期类型，枚举值详情请参考valid_type |
| auto_valid_info.auto_valid_type | number | 否 | 优惠券开启自动生效类型，枚举值详情请参考auto_valid_type |
# 请求参数示例
{
"type": 2,
"name": "双十一特惠券",
"discount_info": {
"discount_condition": {
"product_cnt": 0,
"product_ids": [
"1673110742",
"1673110743"
],
"product_price": 100
},
"discount_fee": 50,
"discount_num": 0
},
"ext_info": {
"jump_product_id": "1673110742",
"notes": "备注"
},
"promote_info": {
"promote_type": 1
},
"receive_info": {
"end_time": 1673110742,
"limit_num_one_person": 1,
"start_time": 1673110742,
"total_num": 100
},
"valid_info": {
"valid_day_num": 1,
"valid_type": 1
},
"auto_valid_info": {
"auto_valid_type": 1
}
}
# 返回参数说明
| 参数 | 类型 | 描述 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| data.coupon_id | string | 优惠券ID |
# 返回参数示例
{
"errcode": 0,
"errmsg": "ok",
"data": {
"coupon_id": "111"
}
}
# 错误码
| 错误码 | 错误描述 |
|---|---|
| 公共错误码 | - |
| 10021005 | 优惠券名称太长 |
| 10021006 | 校验折扣数失败 |
| 10021007 | 校验优惠价格失败 |
| 10021008 | 校验直减券是否小于最低价格 |
| 10021009 | 校验领取时间失败 |
| 10021010 | 校验有效时间失败 |
| 10021011 | 校验优惠券总发放量失败 |
| 10021012 | 校验限领失败 |
| 10021013 | 校验商户失败 |
| 10021014 | 推广类型不对 |
| 10021021 | 校验入参失败，含有非商户的指定商品 |
| 10021024 | 优惠券信息违规 |
| 10021035 | 创建 优惠券类型 暂不支持 |
| 10021061 | 店铺未开启会员功能 |
| 10021071 | 券可领取的结束时间应晚于当前时间 |
| 10021072 | 券可领取的开始时间应早于券有效期的结束时间 |
| 10021073 | 有效开始时间应早于有效结束时间 |
| 10021074 | 券有效结束时间应晚于领取结束时间 |
| 10021075 | 领取后有效期最长180天 |
| 10021077 | 领券时间区间不可大于365天 |
| 10021078 | 券有效期区间不可大于365天 |
| 10021080 | 置券时传了非上架商品 |
# 枚举值
# 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 | 生效天数 |
# promote_type
推广类型
| 枚举值 | 描述 |
|---|---|
| 1 | 小店内推广 |
| 9 | 会员券 |
| 10 | 会员开卡礼券 |
# auto_valid_type
优惠券开启自动生效类型
| 枚举值 | 描述 |
|---|---|
| 0 | 不启用自动生效 |
| 1 | 启用自动生效，按领券开始时间（自动生效时间为 receive_info.start_time） |