# 创建优惠券

# 接口调用请求说明

创建优惠券时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 number 优惠券失效时间戳
ext_info.jump_product_id number 商品折扣券领取后跳转的商品id
ext_info.notes string 备注信息
ext_info.valid_time number 优惠券有效时间戳
promote_info.customize_channel string 用户自定义推广渠道
promote_info.promote_type number 推广类型
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 优惠券有效期结束时间,若填了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 生效天数

# 返回码

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