团购核销能力

我的收藏

业务场景

针对没有自己的券码平台和服务商的商家，对接抖音券，通过和店内 POS 机等核销系统打通来核销团购券，有以下优势：

降低店内收银设备/平台的操作成本，提升商家效率。

核销信息统一到收银系统，无需补录团购订单。

抖音端团购账单并入商家账单，方便商家统一对账。

适用行业

团购核销能力适用于以下行业解决方案。

•

•

•

•

接入前期准备

根据以下文档完成开发者账号开通认证、生活服务应用的创建、申请解决方案和接口权限。

•

技术服务商：技术服务商接入指南

•

自研：自研商家接入指南

需要申请的能力

门店管理、团购核销对账。

门店管理、团购核销对账和团购核销共存于到综行业解决方案、酒店行业预售券解决方案、景区行业解决方案和到店餐饮解决方案中。所以可以在解决方案中一并选择、申请开通。

登录服务商平台。

在右上角点击「控制台」，在「我的应用」页面选择「生活服务商家应用」，然后点击目标应用。

在应用左侧导航栏点击「解决方案」，在「解决方案」页面相关行业解决方案的「操作」列点击「查看详情」。

在目标行业解决方案面板中选择「门店管理」、「团购核销」和「团购核销对账」，以及其它所需的能力，点击「申请开通」。

在「填写使用场景」对话框中填写相关能力的使用场景及理由，点击「确定」。

等待平台审核。审核通过后，即可以使用相关能力。

业务流程

整体核销流程

核销次卡说明

（1）创建商品时，商品类型选择次卡，其余配置与团购券一致。

（2）次卡对接时调用接口不变，各接口针对次卡做了适配调整点：

接口	调整说明
验券准备接口	返回中增加 `time_card` 字段（总次数、已使用次数）
验券接口	支持次卡商品一次核销请求核销多份，多次卡商品，可以一次请求只核销一份，如果需要一次核销多份，list 中传多个相同 `encrypted_codes`
撤销核销接口	支持次卡商品按次数撤销核销，增加`times_card_cancel_count`和 `cancel_token`

接口列表

能力	接口路径	接口说明
团购核销	验券准备	抖音团购券码的核销, 需要先调用本接口, 查询订单的券列表，选择要验的券，再调用验券接口，核销券码。
	验券	用于核销券码，同时适用于抖音团购券码与三方券码，抖音券码的核销需要先调用准备接口，再调用本接口，三方券码的核销直接调用本接口即可。
	撤销核销	针对“抖音团购券码、三方券码”两种券码误核销之后的撤销操作，订单状态由“已使用”回改为“待使用”，用于验券错误需要撤回验券等场景，有时间限制，验券超过一个小时就不可再撤销。
	券状态查询	在核销的异常场景情况下，对抖音码团购、次卡券进行状态查询
	券状态批量查询	用于批量查询抖音券码和三方券码的状态

测试方案

在线上环境创建投放渠道为“仅直播间可见”的商品，进行下单、核销、退款测试。

FAQ

是否可以支持部分退？

答：一笔订单购买多张券时，未核销的券可以进行退款。

一张券是否可以验证多次？

答：不可以。

一笔订单，最多可以购买几张券？

答：10 张。

一笔订单，是否有多个团购？

答：一笔订单只有 1 个团购，可以购买多份（多张券）。

核销后支持撤销核销吗？

答：支持，1 小时内可以撤销核销，超过 1 小时无法发起撤销核销。