更新优惠券内容 | 微信开放文档

# 更新优惠券内容

# 接口说明

通过该接口可对优惠券内容进行更新。

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/ec/coupon/update?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

# 请求参数示例

{
    "coupon_id": "111",
    "type": 1,
    "name": "双十二特惠券",
    "discount_info": {
        "discount_condition": {
            "product_cnt": 2,
            "product_ids": [
                "1673110742",
                "1673110743"
            ],
            "product_price": 0
        },
        "discount_fee": 0,
        "discount_num": 5500
    },
    "ext_info": {
        "jump_product_id": "1673110742",
        "notes": "备注2"
    },
    "promote_info": {
        "promote_type": 1
    },
    "receive_info": {
        "end_time": 1673110742,
        "limit_num_one_person": 1,
        "start_time": 1673110742,
        "total_num": 100
    },
    "valid_info": {
        "end_time": 1673110742,
        "start_time": 1673110742,
        "valid_type": 2
    }
}

# 返回参数说明

参数	类型	描述
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	创建优惠券类型暂不支持
10021037	优惠券不存在
10021061	店铺未开启会员功能

# 枚举值

# 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 必填

# coupon_type

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	生效天数

# promote_type

推广类型

枚举值	描述
1	小店内推广
9	会员券
10	会员开卡礼券