维易淘客联盟接口开发文档：店铺优惠券
淘宝天猫店铺优惠券查询接口
本接口可以帮助淘客查询商品可用的店铺券。为您的客户提供更实惠的券选择。
接口功能：查询商品对应的可用店铺券。
一、淘宝天猫店铺优惠券查询接口
【调用权限】店铺券查询专用点卡
【接口使用】
http://api.vephp.com/shopcoupon?vekey=xxx&itemid=626132884654
【参数说明】
itemid：必选，要查询的淘宝或天猫的商品ID
sellerId：可选，店铺ID，在淘客接口中搜索或高佣转链详情接口有此参数值
二、店铺券查询接口返回值：
接口返回和手淘产品详情页的领券功能显示的优惠券一样，即为该商品可用的店铺优惠券（注意不是产品单品券）。
以下是商品626132884654查询的店铺券结果：
http://api.vephp.com/shopcoupon?vekey=xxx&itemid=626132884654
执行结果：
{
"error": "0",
"msg": "店铺优惠券查询成功！",
"coupons_total": 1, //店铺优惠券数量
"has_coupon_prom": 1, //是否有店铺满减活动，1表示有，0表示没有
"data": [
{
"subTitles": [
"有效期至2021.03.31 23:59"
],
"effectiveTime": 1614614400000, //有效期
"titles": [
"满199使用" //使用条件
],
"type": 1,
"uuid": "de5b3aaebe87400c83a0232217bc8a7d", //券ID
"logoImageUrl": "https://gw.alicdn.com/tfs/TB19Nsthbr1gK0jSZR0XXbP8XXa-498-90.png",
"promotionUniqueId": "de5b3aaebe87400c83a0232217bc8a7d",
"priceCurrency": "￥",
"applyText": "立即领取",
"uuid4Cal": "de5b3aaebe87400c83a0232217bc8a7d",
"priceText": "5", //优惠券面额：减5元（满199元）
"unEffectiveTime": 1617206399000, //有效期
"bgUrl": "https://gw.alicdn.com/tfs/TB1UZgNf7T2gK0jSZFkXXcIQFXa-1428-288.png"
},
........ //其它券略掉
{
"priceDes": "起",
"priceCurrency": "￥",
"subTitles": [
"距到期仅剩2天"
],
"applyUrl": "//h5.m.taobao.com/shopb/shopactivity.html?activityId=15626565363&sellerId=2271279753&source=2&spm=W-a211f8.10431435&scm=20140619.detail.dpb.0",
"effectiveTime": 1615704560000,
"titles": [],
"type": 1007,
"items": [ //店铺满减活动
{
"actionType": "4",
"actionValue": "8",
"title": "满35元,省8元",
"gifts": [],
"promotionUniqueId": "15626565363-1"
},
{
"actionType": "4",
"actionValue": "11",
"title": "满41.9元,省11元",
"gifts": [],
"promotionUniqueId": "15626565363-2"
},
{
"actionType": "4",
"actionValue": "14",
"title": "满47.9元,省14元",
"gifts": [],
"promotionUniqueId": "15626565363-3"
},
{
"actionType": "4",
"actionValue": "19",
"title": "满53.9元,省19元",
"gifts": [],
"promotionUniqueId": "15626565363-4"
}
],
"priceText": "8",
"unEffectiveTime": 1615856399000,
"logoImageUrl": "https://gw.alicdn.com/tfs/TB1a.3vheH2gK0jSZJnXXaT1FXa-498-90.png",
"bgUrl": "https://gw.alicdn.com/tfs/TB1rPY7gkT2gK0jSZFkXXcIQFXa-714-142.png"
}
]
}
可以在手淘端产品详情页看到这些优惠券，如图：
如果有店铺满减活动，则结果如下：
以商品ID ：38134950905 为例，有满4000元减600元活动。
{
"error": "0",
"msg": "店铺优惠券查询成功！",
"coupons_total": 0,
"has_coupon_prom": 1,
"data": [
{
"priceCurrency": "￥",
"subTitles": [
"距到期仅剩3天"
],
"applyUrl": "//h5.m.taobao.com/shopb/shopactivity.html?activityId=16626807583&sellerId=595397331&source=2&spm=W-a211f8.10431435&scm=20140619.detail.dpb.0",
"effectiveTime": 1617204851000,
"titles": [],
"type": 1007,
"items": [
{
"actionType": "4",
"actionValue": "600",
"title": "满4000元,省600元",
"gifts": [],
"promotionUniqueId": "16626807583-1"
}
],
"priceText": "600",
"unEffectiveTime": 1618502399000,
"logoImageUrl": "https://gw.alicdn.com/tfs/TB1a.3vheH2gK0jSZJnXXaT1FXa-498-90.png",
"bgUrl": "https://gw.alicdn.com/tfs/TB1rPY7gkT2gK0jSZFkXXcIQFXa-714-142.png"
}
]
}
满减在手淘上显示：
如果有赠品，则返回如下：
{
"error": "0",
"msg": "店铺优惠券查询成功！",
"coupons_total": 0,
"has_coupon_prom": 1,
"data": [
{
"subTitles": [
"有效期至2021.06.01 00:00"
],
"applyUrl": "//h5.m.taobao.com/shopb/shopactivity.html?activityId=18487071808&sellerId=1767192580&source=2&spm=W-a211f8.10431435&scm=20140619.detail.dpb.0",
"effectiveTime": 1611072000000,
"activityLogo": "https://gw.alicdn.com/tfs/TB1R7zPgNn1gK0jSZKPXXXvUXXa-168-168.png",
"titles": [],
"type": 1007,
"items": [
{
"actionType": "131080",
"title": "满2件,领超值赠品（赠完即止）",
"gifts": [
{
"picUrl": "//img.alicdn.com/imgextra/i4/1767192580/O1CN01h0jJdT1UvgVUmfajW_!!2-item_pic.png",
"name": "窑变蓝兔毫",
"id": "637042766886",
"title": "窑变陶瓷功夫茶具套装家用整套蓝兔毫简约泡茶器茶壶杯子",
"jumpUrl": "https://detail.tmall.com/item.htm?id=637042766886"
}
],
"promotionUniqueId": "18487071808-1"
}
],
"unEffectiveTime": 1622476800000,
"logoImageUrl": "https://gw.alicdn.com/tfs/TB1H4kshoD1gK0jSZFGXXbd3FXa-498-90.png",
"bgUrl": "https://gw.alicdn.com/tfs/TB1rPY7gkT2gK0jSZFkXXcIQFXa-714-142.png"
}
]
}
手淘上显示为：
三、店铺券如何使用？
通过上面接口取得券信自息后，可以接在拼装在淘客商品二合一领券页链接后，也可以直接拼接成店铺优惠券领取链接，在PC端领取。
如：
1、直接在PC上取券（需要登录淘宝天猫）：
以下只是例子，请把 activity_id 和 seller_id 参数换成新的。
https://taoquan.taobao.com/coupon/unify_apply_result_tmall.htm?success=false&need_check=false&need_ok=true&activity_id=a193b56e052643719c788f4bb983c54a&seller_id=3538683476
打开页面可领取。
2、直接在淘客商品二合一领券页链接后面加activityId参数，如：
商品：https://item.taobao.com/item.htm?id=23883488910
默认单品券为满18元减5元，二合一链接为：
https://uland.taobao.com/coupon/edetail?e=aofRcWByBLIbwa0ArmopK9dmXiDhg%2BmQXmFKNv7IlMYb3RSls5eFe4PO1%2Fx2sWd1xwGwtHJmqGx65Jmwg7uAgQAiCtVOu0vMkGH6wWCd7AJ2zIbJA0ocBS3%2FM4lAwO%2BXrOugqOzy%2BV3F8WVlIJ68AEy5otPERvyno4uTMKfHYjAMW8kuaGjDkHqVXNQKelMhYgSDYA7FPLBNCI5rN9wQRA%3D%3D&traceId=0bb625ec16143045052791940ea698&union_lens=lensId:TAPI@1614304505@2105ac63_07e7_177dc0bede7_71ce@01
该店有一个满69元减10元的优惠券，券ID是 b0367b7a84c24aadb78f41564cbdc381
拼接后如下：
https://uland.taobao.com/coupon/edetail?e=aofRcWByBLIbwa0ArmopK9dmXiDhg%2BmQXmFKNv7IlMYb3RSls5eFe4PO1%2Fx2sWd1xwGwtHJmqGx65Jmwg7uAgQAiCtVOu0vMkGH6wWCd7AJ2zIbJA0ocBS3%2FM4lAwO%2BXrOugqOzy%2BV3F8WVlIJ68AEy5otPERvyno4uTMKfHYjAMW8kuaGjDkHqVXNQKelMhYgSDYA7FPLBNCI5rN9wQRA%3D%3D&traceId=0bb625ec16143045052791940ea698&union_lens=lensId:TAPI@1614304505@2105ac63_07e7_177dc0bede7_71ce@01&activityId=b0367b7a84c24aadb78f41564cbdc381
这样就切换了优惠券。
当然，如果淘客商品没有优惠券，维易高佣接口或超级搜索接口会返回original_uland_link字段，可以把券ID拼到它后面，实现有券。
如图：
