# 创建优惠券

# 接口调用请求说明

创建优惠券时status=1

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

# 请求参数示例

{
    "type": 1,
    "coupon_info": 
    {
        "name" : "双十一特惠满100-50",  //长度 <= 10
        "discount_info" : 
        {
            "discount_condition" : 
            {
                "product_cnt" : 10,//商品折扣券填
                "product_ids" : //商品券填
                [
                    1673110742,
                    1673110743
                ],
                "product_price" : 100//满减券填
            },
            "discount_fee" : 50,//满减金额
            "discount_num" : 10//折扣券填  折扣*1000
        },
        "ext_info" : 
        {
            "jump_product_id" : 1673110742,//商品券可以填,领取后跳转
            "notes" : "备注",
            "valid_time" : 1673110742,  // valid_type=0时与valid_info.start_time一致, valid_type=1时商家自己填一个绝对开始时间
            "invalid_time" : 1673110742 // valid_type=0时与valid_info.end_time一致, valid_type=1时商家自己填一个绝对结束时间
        },
        "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=0时必填
            "start_time" : 1673110742,      //绝对生效结束时间, valid_type=0时必填
            "valid_day_num" : 1,            //相对生效时间时长, 以用户领到券的时候开始算, valid_type=1时必填
            "valid_type" : 0
        }
    }
}

# 回包示例

{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "coupon_id": 111
    }
}

# 请求参数说明

参数 类型 是否必填 说明
type number 优惠券类型
coupon_info.name string 优惠券名称
coupon_info.discount_info.discount_condition.product_cnt number 商品折扣券打折金额
coupon_info.discount_info.discount_condition.product_ids number 商品id,商品折扣券需填写
coupon_info.discount_info.discount_condition.product_price number 商品价格,满减券需填写
coupon_info.discount_info.discount_fee number 满减金额
coupon_info.discount_info.discount_num number 打折商品数量,满减券需填写
coupon_info.ext_info.invalid_time string 优惠券失效时间
coupon_info.ext_info.jump_product_id number 商品折扣券领取后跳转的商品id
coupon_info.ext_info.notes string 备注信息
coupon_info.ext_info.valid_time string 优惠券有效时间
coupon_info.promote_info.customize_channel string 用户自定义推广渠道
coupon_info.promote_info.promote_type string 推广类型
coupon_info.receive_info.end_time string 优惠券领用结束时间
coupon_info.receive_info.limit_num_one_person number 是否限制一人使用
coupon_info.receive_info.start_time string 优惠券领用开始时间
coupon_info.receive_info.total_num number 优惠券领用总数
coupon_info.valid_info.end_time number 优惠券有效期结束时间,若填了start必填
coupon_info.valid_info.start_time number 优惠券有效期开始时间,和valid_day_num二选一
coupon_info.valid_info.valid_day_num number 优惠券有效期天数,和start_time二选一
coupon_info.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

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

# 返回码

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