更新优惠券

接口调用请求说明

创建优惠券时status=1

http请求方式:POST
https://api.weixin.qq.com/product/coupon/update?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" : 10//折扣券填  折扣*1000
    },
    "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 打折商品数量,满减券需填写
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

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

返回码

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