抖音开放平台Logo
开发者文档
生活服务商家应用
“/”唤起搜索
控制台
  • 解决方案场景化拆分公告
  • 到店餐饮解决方案
  • 随心团解决方案
  • 到综行业解决方案
  • 航司saas对接解决方案
  • 度假旅行社行业解决方案
  • 景区行业解决方案
  • 景区团购（在线预约）解决方案
  • 景区日历票解决方案
  • 景区团购三方码对接方案
  • 酒店行业解决方案
  • 历史版本文档（不推荐）

    • 景区团购（在线预约）解决方案

    收藏
    我的收藏

    业务介绍

    场景简介

      •团购在线预约适合商家想要做营销，但是基于库存管理、收益管理等原因 不能给出团购品时的一种方案
      •景区团购仅支持半直连模式，即商家需在来客创建商品
      •当选择在线预约时，建议对接价格库存拉取接口拉取日历化的库存和价格来保障价库的及时性

    名词解释

    对文档中提到的专用名称、业务名词进行解释，方便商家/服务商的不同角色理解
    名词
    解释
    团购
    用户购买商品时无需指定出行日期，购买后一段时间有效或是商家指定的一段时间内有效
    团购在线预约
    用户购买商品时无需指定出行日期，需在预约时指定出行日期

    接入流程

    接入前准备

    根据以下文档完成开发者账号开通认证、生活服务应用的创建、申请解决方案和能力（参考对接能力）。

    开通认证开发者账号、创建生活服务应用

    开通解决方案及能力

      1.登录服务商平台。
      2.在右上角点击「控制台」，在「我的应用」页面选择「生活服务商家应用」，然后点击目标应用。
      3.在应用左侧导航栏点击「解决方案」，选择【景区行业解决方案】，点击「申请开通」，等待平台审核。审核通过后，即可使用相关能力。
    ​

    整体说明

    商品流程

    景区团购仅支持半直连模式，即商家需在来客创建商品
    当选择在线预约时，建议对接价格库存拉取接口拉取日历化的库存和价格来保障价库的及时性
    ​

    交易流程

    青色为无需预约/线下预约必接接口（老团购）
    黄色为在线预约需额外对接的接口（预售券）

    退款或取消预约流程说明

    状态
    取消流程
    未预约
    用户可发起券退款
    已预约未核销
      •规则内：用户发起取消
      •规则外：用户可联系抖音客服，抖音客服联系商家协商，商家同意则可取消预约
    以上场景均需提交商家审核
    已预约已核销
    客服无法取消，只能仅退款
    商家线下处理

    接口清单

    能力
    申请解决方案授权时需要勾选的能力名称
    是否必接
    有条件的必接需要描述清楚条件
    接口文档
    需要提供超链接（接口名+文档链接）
    描述
    简述接口使用场景
    日历票价格库存属性发布
    半直连模式系统方有设置库存则必接
    批量拉取库存SPI
    商品价格库存主动拉取接口，商家在抖音来客维护日历票价库时点击拉取按钮获取系统侧设置的库存。对接此接口后，来客端才会展示拉取按钮。后续可订检查失败后也会有拉取机制
    景区预订信息校验
    可选对接，用户在购券支付之前调用，返回用户是否可购
    可购校验（SPI）
    用户提交订单后，支付前，抖音侧调用第三方服务商接口进行可订检查，包括库存和限购规则等，保障消费者提交订单后不会因为库存不足或其他业务规则被拒单
    景区创建订单
    ​
    可选对接，用户在购券支付之后调用，返回用户是否下单成功
    注：
    有券模式（购券+预约）指对接第一单，无券模式（购券+预约）指不对接第一单；
    在开放平台管理后台-生活服务商家应用-解决方案接入-「景区团购（在线预约）解决方案」-交易方式，选择有券模式（购券+预约）或无券模式（购券+预约）
    购券创单（SPI）
    支付后，抖音侧调用第三方服务商接口推送用户下单消息，返回结果。服务商应通过前置可购校验来尽可能保证此接口成功。如果失败，抖音侧将会重试12次，每次间隔1min。如果最终失败，用户侧可能会继续进行预约操作，服务商如果超时不接单会触发用户自动退款。
    必须对接，用户在预约之后调用，返回用户是否预约成功
    预约创单（SPI）
    用户发起预约，抖音侧调用第三方服务商接口创建景区的预约单，务必按照错误码规范返回错误码，如果遇到需要重试的错误码，抖音侧会进行12次重试，每次间隔1分钟。如果最终失败，抖音侧会执行取消预约流程，并通知第三方。
    景区确认订单
    不建议对接，建议在预约创单时同步返回确认接单
    确认接单（OpenAPI）
    抖音侧通知第三方支付成功后，第三方需要在十分钟内通知抖音侧接单结果。
      •非必要不接入，建议服务商适配同步接单，同步接单可以不对接该接口
      •若抖音返回失败，则需要重试接口
    景区退款审核
    必接，同步返回审核结果
    申请退款/取消预约送审（SPI）
    抖音侧请求第三方申请退款，第三方同步或异步回调审核结果。
    •未预约的预售单退款不送审，直接通过【退款结果通知】进行通知。
    景区回调审核退款
    异步审核必接；同步审核可通过申请退款代替
    回调审核结果（OpenAPI）
    抖音侧请求第三方申请退款后，第三方异步回调审核结果。当退款审核结果为接受，若传入手续费小于等于平台计算手续费，以平台计算罚金为准，否则视为拒绝。
    注意：取消预约场景这里的退款金额为零
      •若抖音返回失败，则需要重试接口
    景区退款结果通知
    ​
    必接
    退款结果通知（SPI）
    仅预售单退款会收到通知，预约单退款需要配置信息同步SPI
    •抖音侧异步发起退款状态/取消结果通知，通知 SaaS 服务商退款完成信息，服务商接收消息后返回结果。
    必接
    取消预约结果通知（SPI）
    抖音侧调用第三方服务商接口通知取消抖音的预约单，按照规定返回错误码，注意只有100才会重试。
    ​
    三方码发布
    必接
    发放凭证（同步发券-SPI）
    对接方需在保证凭证成功回调至抖音后，方可进行后续使用操作
    •抖音侧服务商接单成功后向服务商发起发放凭证申请。
    •同步发码在 10 分钟内无法请求到服务商的凭证则会自动退货并发起退款流程
    ◦如果同步无法完成发码，可接入异步链路
    •履约相关功能接口参数中的订单ID：在团购线上发码场景是预约订单ID
    异步返回凭证必须对接；同步返回凭证可通过发放凭证代替
    凭证回调（异步发券 OpenAPI ）
    本接口用于服务商异步返回发码结果时通知抖音开放平台（以下简称抖音）最终状态。
    必接
    核销（验券 OpenAPI）
    景区的单据整体核销时间为预约时间 D+1，这里的核销特指某个凭证核销（身份证，二维码，券码等）。目前抖音侧，只会记录核销记录，未来这些操作会影响C端展示
    选接
    信息同步（SPI）
    若存在以下非服务商发起的审核场景，抖音侧将会通过该接口同步审核结果，若服务商系统需要感知这部分信息，可接入该接口：
    1.超时未收到服务商审核结果，抖音侧将自动执行退款
    2.客服介入处理退款
    3.来客审核流程触发退款
    ​
    必接，抖音侧请求第三方获取订单核销状态，且关系到对账
    订单状态查询（SPI）
    抖音在某些场景下需要主动查询商家/第三方的预约订单核销状态。对接方返回查询订单的核销状态，进而做下一步订单流转处理。
    ​

    常见问题

    日历票服务商对接凭证问题排查

    未请求发凭证

      1.服务商没有接单
      2.服务商配置的sku不是三方码，可以查看sku的code_source_type属性，code_source_type=2才是三方码，服务商需配置对应三方码类型的 code_type 参数值
    ​
    ​

    凭证回传失败

      1.所有订单维度下的 project_id 均不可重复
      2.日历票回传的是 vouchers 不是 voucher，vouchers 是一个集合
      3.vouchers的size需要与发码请求的copies大小一致，copies代表一单买了几份
      4.id_cards、qrcodes、certificate_nos、credentials 返回的各自集合的长度不能超过请求的 count，count 表示每份出行人数，由商品上的 crowd_num 配置，count 等于多个适用人群的 crowd_num 总和
    ​
    ​
      5.id_cards、qrcodes、certificate_nos、credentials 中必须至少返回一种有效凭证，与商品的 code_sending_info 属性对应，code_sending_info 必须配置才能回传，凭证方式可以全部配置，无需回传所有凭证，至少回传任一凭证即可，但是不允许出现如：未配置身份证，但是回传了身份证这种 case
    ​
    ​

    核销

      1.注意核销请求HTTP地址，与团购不一样
    ​
    ​