餐饮在线点单解决方案
收藏餐饮团购快点-在线点单说明
为提升餐饮团购核销率，平台推出的端内团购券兑换点单能力
- •三方码商家注意
针对三方码场景，用户点单订单下单后，平台会锁定三方码，并在用户支付点单订单后单方核销三方码，三方码商家/服务商建议按照如下规则处理：
- •锁定原团购三方码：商家/服务商创建点单订单时，需根据平台创单SPI中给到的三方码code锁定券码；
- •核销原团购三方码：平台通知商家/服务商用户支付完成、或者商家/服务商接单时，需自行核销三方码；（无需再调用平台核销 三方码，平台已自行核销，调用平台核销将失败）；
- •释放原团购三方码：商家/服务商创建点单订单后，如果平台通知商家订单取消，或商家拒单，或平台通知商家退款完成，需商家释放对应的券码；
接入前期准备
商家入驻抖音来客【技术服务商可跳过】
首先确保商家已经入驻抖音来客，完成POI的认领：https://life.douyin.com/
能力开通
联系对接产运&BD提报开通
开平接入流程
- 明确需接入的接口（主要是需不需要感知支付通知）
- 抖音来客测试账号申请（需要BD建群后在群内申请）
- 与抖音侧技术同学联调对接
- 验 收阶段：在飞书群内找技术同学验收
技术服务商入驻开平
参考技术服务商接入指南：https://partner.open-douyin.com/docs/resource/zh-CN/dop/ability/life-service-ability/life.capacity/guide/
KA自研入驻开平：https://developer.open-douyin.com/
技术服务商创建应用（已有可忽略）
如复用已有应用，请注意【发放凭证】SPI是复用接口，与预售券、三方码团购一样
创建第三方生活服务商家应用：
填写相关信息，创建应用。
应用创建成功后，可进入应用详情页查看ClientKey&ClientSecret
等待应用审核完成。审核时效 3 个工作日。
商家授权技术服务商 or 绑定自研服务商
若是技术服务商，需商家在抖音来客授权给技术服务商：
若是自研服务商，在商家自研服务里绑定开发者：
开通应用的解决方案【for 技术服务商】
在应用详情中，点击解决方案，选择对应的解决方案申请开通。审核时效 3 个工作日。
门店管理 / 三方码 / 团购核销 / 订单查询 / 商品发布 /日历票商品发布/日历票商品查询/日历票接口库存属性发布/景区确认订单/景区回调审核退款/景区履约验券/景区创建订单/景区支付通知/景区退款审核/景区取消订单通知/景区退款结果通知/景区预订信息校验/景区订单状态查询
生成 access-token
通过请求参数ClientKey&ClientSecret调用/oauth/client_token/生成的token，此token不需要用户授权。示例: clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
参考 client_token 接口：https://partner.open-douyin.com/docs/resource/zh-CN/dop/develop/openapi/account-permission/client-token，body 返回 access-token
注意：需每2小时更新（开发阶段给到的测试账号不同，按对应文档说明使用，参考步骤2）
商家回调地址配置
系统已支持线上配置SPI，技术服务商可线上配置：
使用SPI接口涉及：创建订单、通知支付结果、申请退款、三方码发放凭证、申请退货、超时退货通知
目前已支持线上配置webhook，在开发设置中配置：
接口清单
服务商必接接口说明，对于必接接口必须对接，否则验收不予通过
能力名称 | 是否必接 | 接口 | 说明 |
门店接单信息设置 | 必接 |
| |
必接 | 设置门店接单状态和时间，必须前置在抖音来客完成对门店认领 | ||
点单相关商品发布 | 必接 | 创建或更新点单标品 | |
必接 | 操作标品的上下架状态，影响来客端可见状态 | ||
点单相关商品发布 | 必接 | 将点单标品与团购券进行绑定 | |
必接 | 门店点单品上下架 | ||
必接 | 同步商品sku在门店维度的库存信息 | ||
可选（不接门店价格同整个点单品价格） | 同步商品sku在门店维度的价格信息，若不同步则以点单品创建接口中设置的全局价格为准 | ||
必接 | 门店点单品上下架 | ||
点单相关商品发布 | 可选（如果团购品有可选加料品必须对接） | 创建或更新加料品 | |
| 可选（如果团购品有可选加料品必须对接） | 上下架加料品 | |
| 可选 （如果团购品有可选加料品必须对接） | 操作加料品的门店沽清信息 | |
点单相关商品查询 | 可选（如果团购品有可选加料品必须对接） | 使用加料品ID或外部ID查询加料品线上数据 | |
可选（如果团购品有可选加料品必须对接） | 查询加料品的门店沽清信息 | ||
必接 | 查询团购已经绑定的点单标品信息 | ||
必接 | 查询点单品信息 | ||
必接 | 查询商品在门店维度的状态信息，价格信息，库存信息 | ||
必接 | 查询点单标品 | ||
点单相关商品发布 | 必接 | 将点单标品与团购券进行绑定 | |
商品查询 | 必接 | 查询商品类目，创建商品前可获取类目信息。 | |
商品发布 | 必接 | 用于商品审核完以后向商家通知审核结果 | |
在线点单交易能力 | 必接 | 抖音侧通知第三方创建点单订单。仅支持 支付前 通知第三方创单。 | |
必接 | 抖音侧通知第三方取消订单。 通知类型的接口 请勿返回业务类型的错误（譬如订单不存在） | ||
必接 | 抖音侧通知第三方支付成功。 通知类型的接口 请勿返回业务类型的错误（譬如订单不存在），返回系统类型的错误抖音侧可以重试。 | ||
必接 | 抖音侧通知第三方准备接单。 通知类型的接口 请勿返回业务类型的错误（譬如订单不存在），返回系统类型的错误抖音侧可以重试。 | ||
必接 | 抖音在某些场景下需要主动查询商家/第三方的订单状态，判断接单结果，进而做下一步订单流转处理。 | ||
必接 | 抖音侧完成退款后，通知第三方实际退款结果。 通知类型的接口 请勿返回业务类型的错误（譬如订单不存在） | ||
必接 | 抖音侧通知第三方“待接单”后，商家同步请求该接口进行接单或拒单，接单时需支持回传取餐号。 | ||
必接 | 商家接单后，需要通过接口回传备餐/出餐/取餐信息。 | ||
必接 | 商家接单后，可以通过接口发起退款。 | ||
推荐接入 | 将生服点单订单的履约备餐状态变更通知外部商家，如备餐中、已出餐、已取餐事件。 | ||
推荐接入 | 点单订单查询能力 | ||
商家账单明细 | 必接 | 账单金额均为绝对值，不显示正负，调用时请注意账单的结算类型。 2、核销后 1 小时内撤销或退款的订单，不会生成账单，无法通过本接口查询。 |
