获取优惠券列表

接口调用说明

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

请求参数示例

{
	"page_size": 3,
	"offset": 2
}

回包示例

{
	"errcode": 0,
	"total_num": 10,
	"result_list": [{
		"coupon": {
			"out_coupon_id": "out_coupon_id_3",
			"type": 101,
			"promote_type": 4,
			"coupon_info": {
				"name": "测试3",
				"promote_info": {
					"promote_type": "PROMOTE_TYPE_FINDER",
					"finder": {}
				},
				"receive_info": {
					"total_num": 100
				},
				"ext_info": {
					"valid_time": 1625226181
				}
			},
			"status": 0,
			"create_time": 1625218450,
			"update_time": 1625238573,
			"appid": "wx9e20708660a0991b"
		},
		"coupon_stock": {
			"out_coupon_id": "out_coupon_id_3",
			"stock_info": {
				"issued_num": 99,
				"receive_num": 1
			},
			"create_time": 1625226181,
			"update_time": 1625237877,
			"appid": "wx9e20708660a0991b"
		}
	}, {
		"coupon": {
			"out_coupon_id": "out_coupon_id_4",
			"type": 101,
			"promote_type": 4,
			"coupon_info": {
				"name": "测试4",
				"promote_info": {
					"promote_type": "PROMOTE_TYPE_FINDER",
					"finder": {}
				},
				"receive_info": {
					"total_num": 1000
				}
			},
			"status": 1,
			"create_time": 1625239595,
			"update_time": 1625239595,
			"appid": "wx9e20708660a0991b"
		}
	}, {
		"coupon": {
			"out_coupon_id": "coupon_id_1",
			"type": 101,
			"promote_type": 4,
			"coupon_info": {
				"name": "示例优惠券",
				"promote_info": {
					"promote_type": "PROMOTE_TYPE_FINDER",
					"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": "COUPON_VALID_TYPE_TIME",
					"valid_day_num": 10,
					"start_time": 1625451250,
					"end_time": 1625464250
				},
				"ext_info": {
					"valid_time": 1625473652
				}
			},
			"status": 2,
			"create_time": 1625454641,
			"update_time": 1625473652,
			"appid": "wx9e20708660a0991b"
		},
		"coupon_stock": {
			"out_coupon_id": "coupon_id_1",
			"stock_info": {
				"issued_num": 99,
				"receive_num": 1
			},
			"create_time": 1625473652,
			"update_time": 1625474308,
			"appid": "wx9e20708660a0991b"
		}
	}]
}

请求参数说明

参数 类型 说明
page_size number 页大小,最大为200
offset number 偏移量,从0开始

回包参数说明

参数 类型 说明
total_num number 总量
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
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
coupon.coupon_info.discount_info.discount_fee number 减金额,单位为分
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:生效天数
coupon.coupon_info.valid_info.valid_day_num number 生效天数
coupon.coupon_info.valid_info.start_time number 生效开始时间
coupon.coupon_info.valid_info.end_time number 生效结束时间
coupon.status number 优惠券状态
coupon.create_time number 创建时间
coupon.update_time number 更新时间
coupon.coupon_stock.out_coupon_id string 商家侧优惠券ID
coupon.coupon_stock.stock_info.issued_num number 优惠券库存剩余量
coupon.coupon_stock.stock_info.receive_num number 优惠卷发放量
coupon.coupon_stock.create_time number 创建时间
coupon.coupon_stock.update_time number 更新时间