酒店新预售券SAAS对接方案
收藏业务介绍
业务简介
产品补充
业务流程
整体流程
产品补充，包含流程图和前端demo图
名词解释
名词 | 解释 |
client_key | 方通过接口对接抖音开放平台前需要创建应用， 应用的AppId等价于client_key，二者值相同，用于唯一区分一个应用 |
client_secret | |
测试账号 | 为了方便三方与抖音侧进行联调测试， 三方可向抖音侧技术支持同学申请测试账号（包含测试商家账号和对应的开放平台应用），测试账号的应用和权限申请抖音侧已经提前准备好，可直接投入开发测试使用 |
| |
接入流程
根据以下指南完成开放平台的入驻和自助化接入
验收和压测
- •测试环境：若需要测试环境，需联系抖音侧BD建群，由抖音测技术支持提供测试流程并协助测试。
- •注：部分解决方案必须在测试账号下完成联调验收通过后，才可以申请解决方案相关接口权限。
- •正式环境：若只需要在正式环境联调测试，可在开放平台控制台-生活服务商家应用-开发工具，进行自助验收和压测，完成后可进行上线操作
申请解决方案并上线
- •需要申请「酒店新预售券解决方案」，审批通过之后在正式环境上线
接口对接
时序图
需要研发根据业务场景补充时序图
接口清单
能力名称 | 是否必接 | 对接模式模式 | 接口 | 说明 |
酒店静态信息匹配/创建/更新 | 必接（两个模式二选一） | 模式二:自助匹配模式 合作方从抖音侧获取酒店核心静态信息,在合作方侧自行mapping |
| |
酒店静态信息匹配成功后通知服务商。 | ||||
酒店匹配状态查询 | ||||
酒店静态信息自助获取 | 模式二:自助匹配模式 合作方从抖音侧获取酒店核心静态信息,在合作方侧自行mapping | 抖音酒店查询（不适用于代理商） | ||
物理房型静态信息匹配/创建/更新 | 必接（两个模式二选一） | 模式一:推送模式 合作方推送物理房型信息,抖音进行 匹配和创建 | 创建或更新抖音物理房型 | |
物理房型审核通过/拒绝后通知服务商。 | ||||
查询物理房型审核状态 | ||||
物理房型静态信息自助获取 | 模式二:自助匹配模式 合作方从抖音侧获取物理房型核心静 态信息,在合作方侧自行mapping | 门店下物理房型查询 | ||
物理房型上下架 | 对接物理房型信息时，必接 | | 对物理房型进行上下架或者删除，单批次最多5个，单商家限制每秒最多操作40个房型 | |
房价/房态/房量更新 | 必接（两个模式二选一） | 模式一:推送模式 合作方直接通过接口实时推送ARI变化给抖音 | 保存价量态房量，该接口最多支持单次传递50组房量房态 | |
保存价量态价格，该接口最多支持单次传递50组房价 | ||||
商家侧日历库存或价格有变更触发接口商用 | ||||
主动拉取价量态 | 模式二:拉取模式 1、合作方无法通知变化,靠抖音根据尽 可能快的频率进行拉取 | 抖音侧调用第三方主动拉取价量态信息。 | ||
预售券线上开票 | 选接 | | | |
住宿预售券交易正向 | 必接 | | 抖音侧调用第三方进行可订检查。如果不可订需要返回价量信息进行价量更新 | |
必接 | | 抖音侧调用第三方创建酒店预售订单。 | ||
必接 | | 抖音侧调用第三方创建酒店订单。 | ||
选接 | 两步骤模式需要对接「酒店支付结果通知」 | 抖音侧通知第三方支付成功。供应商交易模式为支付后创单的情况下抖音不会调用该spi | ||
异步接单模式必接 | | 抖音侧通知第三方支付成功后，第三方需要在商品上单中设置的接单时间内通知抖音侧接单结果。超时会拒单 | ||
住宿预售券交易逆向 | 必接 | 立即取消（同步）模式，仅需要对接酒店取消订单接口 | 抖音侧通知第三方取消订单。 | |
异步取消模式必接 | | 抖音侧请求第三方申请退款后，第三方异步回调审核结果。 | ||
选接 | | 抖音侧完成退款后，通知第三方实际退款结果。 | ||
入住/离店状态同步 | 选接 | | 三方通知调用用户的入住状态 | |
住宿预售券创建和更新 | 直连必接 | | 保存或更新预售券预定商品信息，单次最多传入20个商品，即单商家每秒最多保存200个商品 | |
直连必接 | | 保存或更新预售券信息 | ||
选接 | | 通知三方预售券审核结果 | ||
酒旅商品上架和下架信息推送 | 选接 | | 售卖房型上下架，售卖房型创建后自动上架，无需调用该接口。该接口最多支持单次传递20个商品id，单商家每秒最多保存200个商品。 | |
KA核销对账 | 选接 | | 商家通过接口查询自己账单详情。 | |
酒店会员管理 | 选接 | | 更新酒店会员数据 | |
| | |||
| | |||
| 抖音生活服务调用对接方绑定会员接口进行会员注册或者绑定。 | |||
| 抖音生活服务调用对接方进行抖音渠道会员解绑。 | |||
| 抖音生活服务调用对接方进行会员数据查询 |
