# Add coupons

# Interface call specification

Http request method: POST
https://api.weixin.qq.com/shop/coupon/add?access_token=xxxxxxxxx

# Request Parameter Sample

{
  "coupon": {
    "out_coupon_id": "coupon_id_1",
    "type": 101,  
    "promote_type": 4,
    "coupon_info": {
      "name": Sample Coupon,
      "promote_info": {
        "promote_type": 4,  // Video Number
        "finder": {
          "nickname": "Video Number 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_in a": 9800,
        "discount_fee": "6400"
      },
      "receive_info": {
        "start_time": "1625451250",
        "end_time": "1625454250",
        "limit_A_one_person": 10,
        "total_in a": 100
      },
      "valid_info": {
        "valid_type": 1,  // 1: product specified time interval, 2: effective days
        "valid_day_in a": 10,
        "start_time": "1625451250",
        "end_time": "1625464250"
      }
    }
  }
}

# Return Package Example

{
	"errcode": 0
}

# Request Parameter Dxplaination

parameter type Introductions
coupon.out_coupon_id string Merchant Side Coupon ID
coupon.type number Coupon Type
coupon.promote_type number Coupon Promotion Type
coupon.coupon_info.name string Coupon Name
coupon.coupon_info.promote_info.promote_type number Coupon Promotion Type
coupon.coupon_info.promote_info.finder.nickname string Promotional Video Number
coupon.coupon_info.discount_info.discount_condition.product_cnt number Number of items required for discount terms
coupon.coupon_info.discount_info.discount_condition.product_price number Amount required to satisfy discount conditions
coupon.coupon_info.discount_info.discount_condition.out_product_ids string array Specify merchandise merchant side ID, merchandise coupons must
coupon.coupon_info.discount_info.discount_condition.tradein_info.out_product_id string The merchant side ID of the exchange product, the exchange voucher must be
coupon.coupon_info.discount_info.discount_condition.tradein_info.price number Amount to be paid, Unit Points, Coupon Redemption Required
coupon.coupon_info.discount_info.discount_condition.buyget_info.buy_out_product_id string Purchase merchandise business side ID, buy coupons required
coupon.coupon_info.discount_info.discount_condition.buyget_info.buy_product_cnt number Number of items purchased, coupon required
coupon.coupon_info.discount_info.discount_condition.buyget_info.get_out_product_id string Gift merchandise business side ID, buy coupons required
coupon.coupon_info.discount_info.discount_condition.buyget_info.get_product_cnt number The number of gifts, buy coupons necessary
coupon.coupon_info.discount_info.discount_A number Discount, such as 5.1% off, fill in 5100, discount coupon required
coupon.coupon_info.discount_info.discount_fee number Reduce the amount, the unit for points, directly reduce coupons required
coupon.coupon_info.receive_info.start_time number Collection Start Time
coupon.coupon_info.receive_info.end_time number End of collection
coupon.coupon_info.receive_info.limit_A_one_person number Number of claims
coupon.coupon_info.receive_info.total_A number Total issued
coupon.coupon_info.valid_info.valid_type number Validity Type, 1: Product Specified Time Interval, 2: Effective Days
coupon.coupon_info.valid_info.valid_day_A number Effective days, valid type 2 required
coupon.coupon_info.valid_info.start_time number Effective Start Time, required for Validity Type 1
coupon.coupon_info.valid_info.end_time number Effective end time

# Enumerations-type

Enumeration value describe
1 Discount coupon for condition of goods
2 Coupon Coupon
3 Unified Merchandise Discount Coupon
4 Commodities Direct Coupon
5 Product Exchange Voucher
6 Buy Coupons
101 Shop Condition Discount Coupon
102 Shop full discount coupon
103 Shop unified discount coupon
104 Shop Direct Coupon

# Enumerations-promote_type

Enumeration value describe
4 Live video number