历史版本文档（不推荐）

餐饮在线点单解决方案

我的收藏

餐饮团购快点-在线点单说明

为提升餐饮团购核销率，平台推出的端内团购券兑换点单能力

•

三方码商家注意

针对三方码场景，用户点单订单下单后，平台会锁定三方码，并在用户支付点单订单后单方核销三方码，三方码商家/服务商建议按照如下规则处理：

•

锁定原团购三方码：商家/服务商创建点单订单时，需根据平台创单SPI中给到的三方码code锁定券码；

•

核销原团购三方码：平台通知商家/服务商用户支付完成、或者商家/服务商接单时，需自行核销三方码；（无需再调用平台核销三方码，平台已自行核销，调用平台核销将失败）；

•

释放原团购三方码：商家/服务商创建点单订单后，如果平台通知商家订单取消，或商家拒单，或平台通知商家退款完成，需商家释放对应的券码；

接入前期准备

商家入驻抖音来客【技术服务商可跳过】

首先确保商家已经入驻抖音来客，完成POI的认领：https://life.douyin.com/

能力开通

联系对接产运&BD提报开通

开平接入流程

明确需接入的接口（主要是需不需要感知支付通知）

抖音来客测试账号申请（需要BD建群后在群内申请）

与抖音侧技术同学联调对接

验收阶段：在飞书群内找技术同学验收

技术服务商入驻开平

抖音开放平台 https://partner.open-douyin.com/docs/resource/

参考技术服务商接入指南：https://partner.open-douyin.com/docs/resource/zh-CN/dop/ability/life-service-ability/life.capacity/guide/

KA自研入驻开平：https://developer.open-douyin.com/

技术服务商创建应用（已有可忽略）

如复用已有应用，请注意【发放凭证】SPI是复用接口，与预售券、三方码团购一样

参考文档 https://partner.open-douyin.com/docs/resource/zh-CN/dop/ability/life-service-ability/life.capacity/guide/

创建第三方生活服务商家应用：

填写相关信息，创建应用。

应用创建成功后，可进入应用详情页查看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 签名机制：https://partner.open-douyin.com/docs/resource/zh-CN/dop/develop/openapi/life-service-open-ability/life.capacity/beforeinsert/signruleintroduce

使用SPI接口涉及：创建订单、通知支付结果、申请退款、三方码发放凭证、申请退货、超时退货通知

目前已支持线上配置webhook，在开发设置中配置：

参考webhook 消息推送：https://partner.open-douyin.com/docs/resource/zh-CN/dop/develop/openapi/life-service-open-ability/life.capacity/beforeinsert/massages.push

接口清单

服务商必接接口说明，对于必接接口必须对接，否则验收不予通过

能力名称	是否必接	接口	说明
门店接单信息设置	必接	点单的接单信息设置	1.设置门店接单状态和时间，必须前置在抖音来客完成对门店认领 2.serve_week的长度固定等于7，代表周一至周日的接单信息 3.当系统同时命中serve_date和serve_week的配置规则时，优先取serve_date 4.poiid单次最多支持批量设置20个；
门店接单信息设置	必接	点单的接单信息查询	设置门店接单状态和时间，必须前置在抖音来客完成对门店认领
点单相关商品发布	必接	点单标品创建/更新	创建或更新点单标品
点单相关商品发布	必接	点单标品上下架	操作标品的上下架状态，影响来客端可见状态
点单相关商品发布	必接	团购绑定点单标品	将点单标品与团购券进行绑定
	必接	点单品门店上下架	门店点单品上下架
	必接	同步门店库存（免审）	同步商品sku在门店维度的库存信息
	可选（不接门店价格同整个点单品价格）	同步门店价格（免审）	同步商品sku在门店维度的价格信息，若不同步则以点单品创建接口中设置的全局价格为准
	必接	点单品门店上下架	门店点单品上下架
点单相关商品发布	可选（如果团购品有可选加料品必须对接）	加料品创建/更新	创建或更新加料品
	可选（如果团购品有可选加料品必须对接）	加料品上下架	上下架加料品
	可选（如果团购品有可选加料品必须对接）	加料品门店沽清	操作加料品的门店沽清信息
点单相关商品查询	可选（如果团购品有可选加料品必须对接）	加料品查询	使用加料品ID或外部ID查询加料品线上数据
	可选（如果团购品有可选加料品必须对接）	加料品门店沽清查询	查询加料品的门店沽清信息
	必接	查询团购绑定点单信息	查询团购已经绑定的点单标品信息
	必接	点单品查询	查询点单品信息
	必接	商品门店维度信息查询	查询商品在门店维度的状态信息，价格信息，库存信息
	必接	点单标品查询	查询点单标品
点单相关商品发布	必接	团购绑定点单标品	将点单标品与团购券进行绑定
商品查询	必接	查询商品品类	查询商品类目，创建商品前可获取类目信息。
商品发布	必接	商品审核结果同步	用于商品审核完以后向商家通知审核结果
在线点单交易能力	必接	通知外部商家创单	抖音侧通知第三方创建点单订单。仅支持支付前通知第三方创单。
	必接	通知外部商家订单已关闭	抖音侧通知第三方取消订单。通知类型的接口请勿返回业务类型的错误（譬如订单不存在）
	必接	通知外部商家支付成功	抖音侧通知第三方支付成功。通知类型的接口请勿返回业务类型的错误（譬如订单不存在），返回系统类型的错误抖音侧可以重试。
	必接	通知外部商家待接单	抖音侧通知第三方准备接单。通知类型的接口请勿返回业务类型的错误（譬如订单不存在），返回系统类型的错误抖音侧可以重试。
	必接	查询外部商家订单	抖音在某些场景下需要主动查询商家/第三方的订单状态，判断接单结果，进而做下一步订单流转处理。
	必接	退款结果同步外部商家	抖音侧完成退款后，通知第三方实际退款结果。通知类型的接口请勿返回业务类型的错误（譬如订单不存在）
	必接	「OpenAPI」商家接单/拒单	抖音侧通知第三方“待接单”后，商家同步请求该接口进行接单或拒单，接单时需支持回传取餐号。
	必接	「OpenAPI」商家回传备餐/出餐/取餐信息	商家接单后，需要通过接口回传备餐/出餐/取餐信息。
	必接	「OpenAPI」商家发起退款	商家接单后，可以通过接口发起退款。
	推荐接入	「Webhook」通知外部商家履约备餐状态变更	将生服点单订单的履约备餐状态变更通知外部商家，如备餐中、已出餐、已取餐事件。
商家账单明细	必接	「OpenAPI」餐饮账单详情查询	账单金额均为绝对值，不显示正负，调用时请注意账单的结算类型。 2、核销后 1 小时内撤销或退款的订单，不会生成账单，无法通过本接口查询。