优惠卷详情

简要描述：

  • 获取指定商品的优惠卷详情

请求域名:

请求URL

  • /addons/yun_shop/api.phpi=2&m=yun_shop&do=6148&route=coupongetGoodsCouponByCouponId&coupon_id=329

参数:

参数名 是否必须 类型 说明
coupon_id 是 int 优惠券ID

返回示例:

正确时返回:

{
	"result": 1,
	"msg": "ok",
	data: {
		id: 157,
		uniacid: 12,
		cat_id: 0,
		name: "lzh",
		get_type: 1,
		level_limit: -1,
		get_max: -1,
		use_type: 2,
		return_type: 0,
		bgcolor: "",
		enough: 11,
		coupon_type: 0,
		time_limit: 0,
		time_days: 1,
		time_start: "2020-06-02 00:00:00",
		time_end: "2020-06-09 00:00:00",
		coupon_method: 2,
		discount: "1.00",
		deduct: "1.00",
		back_type: 0,
		back_money: "",
		back_credit: "",
		back_redpack: "",
		back_when: 0,
		thumb: "",
		desc: null,
		total: 0,
		status: 1,
		money: "0.00",
		resp_desc: null,
		resp_thumb: "",
		resp_title: "",
		resp_url: "",
		credit: 0,
		usecredit2: 0,
		remark: "",
		descnoset: 0,
		display_order: 999999999,
		supplier_uid: 0,
		getcashier: 0,
		cashiersids: null,
		cashiersnames: null,
		category_ids: null,
		categorynames: null,
		goods_names: [],
		goods_ids: [],
		storeids: null,
		storenames: null,
		getstore: 0,
		getsupplier: 0,
		supplierids: null,
		suppliernames: null,
		createtime: 0,
		created_at: "2020-06-02 14:43:43",
		updated_at: "2020-06-05 15:10:20",
		deleted_at: null,
		is_complex: 0,
		plugin_id: 0,
		api_availability: 3,
		goods: [
					{
					id: 539,
					uniacid: 12,
					brand_id: 0,
					type: 1,
					status: 1,
					display_order: 666,
					title: "测试商品",
					thumb: "http://test-1251768088.cosgz.myqcloud.com/images/12/2019/10/qJeQJDix4V8BVdJzzQZ2JjljDXDQjI.jpg",
					thumb_url: "a:1:{i:0;s:52:"images/12/2018/12/hVsiSftuwC5FtIFu5UuPsDDFdrOdoe.png";}",
					sku: "件",
					goods_sn: "",
					product_sn: "",
					market_price: "120.00",
					price: "101212.23",
					cost_price: "90.00",
					stock: 62,
					reduce_stock_method: 0,
					show_sales: 46,
					real_sales: 46,
					weight: "200.00",
					has_option: 1,
					is_new: 1,
					is_hot: 1,
					is_discount: 1,
					is_recommand: 1,
					is_comment: 0,
					is_deleted: 0,
					created_at: "2018-12-10 14:04:52",
					deleted_at: null,
					updated_at: "2020-04-09 17:41:57",
					comment_num: 0,
					is_plugin: 0,
					plugin_id: 0,
					virtual_sales: 10,
					goods_video: "",
					no_refund: 0,
					need_address: 0,
					type2: 1,
					old_id: null,
					deduct_price: 10121.223,
					vip_price: "101200.23",
					has_many_goods_discount: []
					}
					],
}

错误时返回:

优惠券类型错误:

{
	result: 0,
	msg: "优惠券类型错误",
	data: [ ]
}

返回参数说明:

参数名 类型 说明
name str 优惠券名称
coupon_method int 优惠方式: 1为立减deduct, 2为折扣discount
deduct int 立减多少元(注意,coupon_method为1时,该数据才有意义)
discount float 折扣(注意,coupon_method为2时,该数据才有意义; 例子:7表示打7折,即原价的0.7倍)
enough int 消费满多少元, 优惠券才可用(空或0为不限制)
use_type int 适用范围，0商城通用 1指定分类 2指定商品
category_ids array 适用的分类ID (受use_type影响)
categorynames array 适用的分类名称 (受use_type影响)
goods_ids array 适用的商品ID (受use_type影响)
goods_names array 适用的商品名称 (受use_type影响)
time_limit int 时间限制类型: 0领取后几天有效, 1时间范围
time_days int 领取后几天有效(受time_limit影响)
time_start int 有效期的起始时间(受time_limit影响)
time_end int 有效期的终止时间(受time_limit影响)
get_max int 每人限领的上限
total int 发放总数量限制( -1 为不限制)
has_many_member_coupon_count int 已经被领取多少张
member_got_count int 该用户已经领取该优惠券多少张
api_availability int 优惠券是否可用: 1 可领取, 2 已经领取, 3 已经被抢光
api_remaining int 优惠券还剩多少张
belongs_to_coupon. api_limit str 适用范围的描述, 比如"适用于下列商品: 测试商品-电视1,99测试"
goods array 商品详情（参考商品详情接口）

备注:

  • 正确时返回的数据中, coupon_method 是"优惠方式", 1为立减deduct, 2为折扣discount; 所以当它的值为 1 时, deduct 字段才有意义, discount 无意义(之所以有值是因为可能用户期间变更了优惠方式类型,但是旧有的数据会残留)
  • 正确时返回的数据中, use_type 是"适用范围", 0商城通用 1指定分类 2指定商品; 所以当它的值为 1 时, categorynames 字段才有意义, goods_names 无意义
  • 同样的, time_limit 是"时间限制类型", 0领取后几天有效, 1为时间范围; 当它的值为 0 时, time_days 才有意义, 同时 time_start 和 time_end 无意义