| 目录 |
|---|
背景说明
兔展支持外部奖品引入，实现「在活动中发外部奖品」的营销场景，相关功能包括货架查询、新增、补库、退库、冻结、发奖、核销等。
功能说明
一、对接流程说明
二、准备工作
1. 新建自建应用，选择申请「奖品」下的权限项
2. 自建应用申请通过后，需填入订阅/回调/请求地址
三、工作台-外部奖品同步与新增
1. 进入【奖品管理】栏目，点击「新增奖品」
2. 选择「接口同步」与对应的自建应用，点击「选择奖品」
3. 此时，兔展将调用自建应用中【奖品货架查询】所填写的接口地址，返回的奖品列表将展示于弹窗
4. 在弹窗中勾选对应奖品，点击确定
5. 此时，兔展将调用自建应用中【奖品剩余数量查询】所填写的接口地址，返回的奖品剩余数量将展示于界面
7. 输入其他奖品信息后，点击「保存」奖品
8. 此时，兔展将调用自建应用中【奖品新增】所填写的接口地址，返回成功结果则保存奖品成功
四、工作台-外部奖品补退库
1. 进入【奖品管理】栏目，针对某一奖品点击「补库」
2. 输入补库数量，点击确定
3. 此时，兔展将调用自建应用中【奖品补库】所填写的接口地址，返回成功结果则补库成功
4. 进入【奖品管理】栏目，针对某一奖品点击「退库」
5. 输入退库数量，点击确定
6. 此时，兔展将调用自建应用中【奖品退库】所填写的接口地址，返回成功结果则退库成功
五、编辑器-选用外部奖品
在编辑器的「抽奖」与「领奖」玩法中，进行「奖项设置」时，即可选择对接的外部奖品
六、C端用户-发放与核销外部奖品
1. C端用户在活动中，领奖 或 抽奖中奖后，点击「查看详情」
2. 此时，兔展将调用自建应用中【奖品发奖】所填写的接口地址
3. 若可实时发奖，则可通过【奖品发奖】接口返回奖品详情；
4. 若需异步发奖，则外部服务可异步调用【回调通知】接口，返回奖品详情
5. C端用户将进入奖品详情页，详情页将回显：奖品相关信息与券码（或卡号卡密)
6. C端用户可根据配置地址，点击跳转前往h5/小程序/app进行兑换
7. 外部服务可调用【订单完成通知接口】接口，将奖品的核销状态同步至兔展，即可在活动中查看奖品状态
注：兔展亦支持奖品无感对接模式，即可在编辑器直接同步奖品，无需在奖品管理中手动操作，具体请联系兔展运营人员。
背景说明：
兔展支持外部奖品的引入已经外部优惠券的对接，奖品包括新增、补库、退库、冻结、发奖核销等，优惠券支持外部优惠券导入已经发券通知、券码获取等功能；
功能说明：
准备工作
1、申请自建应用，选择需要的功能权限；
2、填写回调地址，即可；
工作台操作——第三方奖品同步：
1、进入【奖品管理】，点击【新增奖品】；
2、选择接口同步；
3、选择自建应用；
4、选择第三方同步来的奖品信息。
注：兔展支持奖品的无感对接模式，既在编辑器中也可直接同步奖品，无需进入工作台，具体可以联系兔展运营人员。
工作台操作——优惠券同步：
1、进入【优惠券】，点击【同步优惠券】；
2、此时兔展会通过【优惠券同步通知】自建应用向所填写的接口发送通知；
3、此时第三方需要调用【优惠券模板和库存导入】接口，将优惠券同步至兔展，即可显示如下；
4、勾选对应的券即可，相关的券信息会落入兔展；
5、填写【发券通知】自建应用，则可以在用户领奖的那一刻，触发对应的自建应用的执行；
6、填写【券码】获取的回调接口，用来在发完券后，将对应优惠券的券码同步回兔展，并进行回显。