添加优惠券 | 微信开放文档

# 添加优惠券

# 接口调用说明

http请求方式：POST
https://api.weixin.qq.com/shop/coupon/add?access_token=xxxxxxxxx

# 请求参数示例

{
  "coupon": {
    "out_coupon_id": "coupon_id_1",
    "type": 101,  
    "promote_type": 4,
    "coupon_info": {
      "name": "示例优惠券",
      "promote_info": {
        "promote_type": 4,  // 视频号
        "finder": {
          "nickname": "视频号昵称"
        }
      },
      "discount_info": {
        "discount_condition": {
          "product_cnt": 2,
          "product_price": 5000,
          "out_product_ids": [
            "product_id_3",
            "product_id_4"
          ],
          "tradein_info": {
            "out_product_id": "product_id_5",
            "price": 10000
          },
          "buyget_info": {
            "buy_out_product_id": "product_id_1",
            "buy_product_cnt": 3,
            "get_out_product_id": "product_id_2",
            "get_product_cnt": 2131241242
          }
        },
        "discount_num": 9800,
        "discount_fee": 6400
      },
      "receive_info": {
        "start_time": 1625451250,
        "end_time": 1625454250,
        "limit_num_one_person": 10,
        "total_num": 100
      },
      "valid_info": {
        "valid_type": 1,  // 1：商品指定时间区间，2：生效天数，3：生效秒数
        "valid_day_num": 10,
        "valid_second": 3600,
        "start_time": 1625451250,
        "end_time": 1625464250
      }
    }
  }
}

# 回包示例

{
    "errcode": 0
}

# 请求参数说明

参数	类型	是否必填	说明
coupon.out_coupon_id	string	是	商家侧优惠券ID
coupon.type	number	是	优惠券类型
coupon.promote_type	number	是	优惠券推广类型
coupon.coupon_info.name	string	是	优惠券名
coupon.coupon_info.promote_info.promote_type	number	是	优惠券推广类型
coupon.coupon_info.promote_info.finder.nickname	string	是	推广视频号昵称
coupon.coupon_info.discount_info.discount_condition.product_cnt	number	否	优惠条件所需的商品数
coupon.coupon_info.discount_info.discount_condition.product_price	number	否	优惠条件所需满足的金额
coupon.coupon_info.discount_info.discount_condition.out_product_ids	string array	否	指定商品商家侧ID，商品券必需，最多128个
coupon.coupon_info.discount_info.discount_condition.tradein_info.out_product_id	string	否	换购商品商家侧ID，换购券必需
coupon.coupon_info.discount_info.discount_condition.tradein_info.price	number	否	需要支付的金额，单位分，换购券必需
coupon.coupon_info.discount_info.discount_condition.buyget_info.buy_out_product_id	string	否	购买商品商家侧ID，买赠券必需
coupon.coupon_info.discount_info.discount_condition.buyget_info.buy_product_cnt	number	否	购买商品数，买赠券必需
coupon.coupon_info.discount_info.discount_condition.buyget_info.get_out_product_id	string	否	赠送商品商家侧ID，买赠券必需
coupon.coupon_info.discount_info.discount_condition.buyget_info.get_product_cnt	number	否	赠送商品数，买赠券必需
coupon.coupon_info.discount_info.discount_num	number	否	折扣数,比如5.1折,则填5100，折扣券必需（不可低于2折）
coupon.coupon_info.discount_info.discount_fee	number	否	减金额,单位为分，直减券、满减券必需（不可超过200元，同时如果是商品券，适用商品优惠后不可低于原价2折，如果是店铺满减券，不可低于价格门槛的2折。）
coupon.coupon_info.receive_info.start_time	number	是	领取开始时间（秒级时间戳）
coupon.coupon_info.receive_info.end_time	number	是	领取结束时间（秒级时间戳）
coupon.coupon_info.receive_info.limit_num_one_person	number	是	个人限领张数，只做展示，领券回调时接入方判断有无超领。
coupon.coupon_info.receive_info.total_num	number	是	总发放量，即初始库存数，只做展示，领券回调时接入方判断有无超领。
coupon.coupon_info.valid_info.valid_type	number	是	有效期类型,1:商品指定时间区间,2:生效天数,3:生效秒数
coupon.coupon_info.valid_info.valid_day_num	number	否	生效天数，有效期类型为2时必需
coupon.coupon_info.valid_info.valid_second	number	否	生效秒数，有效期类型为3时必需
coupon.coupon_info.valid_info.start_time	number	否	生效开始时间（秒级时间戳），有效期类型为1时必需
coupon.coupon_info.valid_info.end_time	number	否	生效结束时间（秒级时间戳），有效期类型为1时必需

# 注意

一张商品券最多关联128个商品

# 枚举-type

枚举值	描述
1	商品条件折扣券
2	商品满减券
3	商品统一折扣券
4	商品直减券
5	商品换购券
6	商品买赠券
101	店铺条件折扣券
102	店铺满减券
103	店铺统一折扣券
104	店铺直减券

# 枚举-promote_type

枚举值	描述
4	视频号直播