开发指南
1. 能力介绍
专属下单能力适用于淘宝小程序场景下的权益商品指定用户下单（含实物、小样等），例如通过对完成特定游戏化任务的消费者进行实物奖励，对完成购物挑战的消费者进行实物权益奖励等，该类玩法可通过权益商品刺激消费者下单，进而进一步提升消费者复购率和商品连带客单价。专属下单商品按照淘宝主站订单流程流转，不需商家ERP/OMS额外改造，且专属下单商品可进行前台隐藏，不会对店铺经营造成额外影响。
专属下单插件中具备绑定专属下单商品的功能，为保证线上正常售卖流程，专属下单插件仅支持绑定已下架商品，且绑定时间到期后，商品自动解绑并下架。
2. 申请流程
2.1 创建应用
登录淘宝开放平台，
点击新建应用，选择淘宝购物小程序进行创建；
2.2 选择类目
选择合适的应用类目进行开发即可；
2.3 填写应用logo及名称
2.4 创建B端、C端应用
端应用分为商家端应用以及消费者端应用，创建应用需要配置应用logo，应用名称，应用描述等信息。其中应用描述需要大于9个字。一个端应用即表示一个小程序
2.5 申请插件
在开放平台能力中心申请以下插件：
3. 插件说明
该插件主要包含两种组件和相应的方法，分别为商品搜索和商品详情。开发者需要传入所需参数，另外插件提供了单独唤起和关闭组件的方法
先配置该专属下单插件，引入方式
{
"pages": [
"pages/index/index"
],
"plugins": {
"openTrade": { //专属下单插件
"version": "*",
"provider": "3000000077051512"
}
},
"window": {
"defaultTitle": "My App"
}
}
3.1 商品搜索页
3.1.1 组件
组件参数/方法 |
是否必填 |
说明 |
width |
N |
组件宽度，默认 100% 撑开 |
height |
N |
组件高度，默认 650px |
miniappId |
Y |
string，绑定C小程序 |
awardId |
N |
string，奖品ID |
awardPrice |
N |
number，校验奖品价格上限，价格单位为分，一般需要填写做校验 |
awardNumber |
N |
number，校验奖品数量 一般需要填写做校验 |
awardDeadline |
Y |
string，用户默认的绑定截止时间 注意：截止时间是奖品截止时间，不是奖池截止时间 格式如下 2022-10-01 |
onAfterBindShop |
N |
function(detail:Object)，确认绑定商品成功后的回调(失败的话插件内部会提示，开发者不用感知失败的回调) 参数： itemId:string 商品ID isPublish:boolean 是否已上架 desc:string 商品名称 amount:number 商品价格（单位分） count:number 库存数 startTime:string 开始时间 endTime:string 结束时间 isBind:boolean 是否已绑定 |
onAfterClose |
N |
function，关闭弹框窗口的回调 |
示例代码：
<order
width="100%"
height="650px"
miniappId="3000000062918435"
awardPrice=500000
awardNumber=1000
awardDeadline="2022-10-29"
awardId="666"
onAfterBindShop="onAfterBindShop"
onAfterClose="onAfterClose"
/>
// 确认绑定商品成功后的回调(失败的话插件内部会提示，ISV不用感知失败的回调)
onAfterBindShop(detail) {
console.log('成功绑定商品 回调', detail)
},
// 关闭订单窗口的回调
onAfterClose() {
console.log('订单窗口已被关闭 回调')
},
3.1.2 方法
var plugin = requirePlugin("myPlugin"); //引入插件
// 手动唤起 绑定商品搜索组件
plugin.openOrder()
// 手动关闭 绑定商品搜索组件
plugin.closeOrder()
3.2 商品详情页
3.2.1 组件
组件参数/方法 |
是否必填 |
说明 |
width |
N |
组件宽度，默认 100% 撑开 |
height |
N |
组件高度，默认 650px |
miniappId |
Y |
string，绑定C小程序 |
itemId |
Y |
string | number，商品ID |
onAfterClose |
N |
function，关闭弹框窗口的回调 |
示例代码：
<detail
width="100%"
height="650px"
miniappId="3000000062918435"
itemId="684149462980"
onAfterClose="onAfterClose"
/>
// 关闭订单详情窗口的回调
onAfterClose() {
console.log('订单详情窗口已被关闭 回调')
},
3.2.2 方法
var plugin = requirePlugin("myPlugin"); //引入插件
// 打开绑定详情页
plugin.openDetail()
// 关闭绑定详情页
plugin.closeDetail()
