随心团解决方案
收藏业务介绍
业务简介
随心团解决方案是平台提供的经营新能力，在支持商家的团购商品到店核销基础上，增加外送上门服务（核销）能力，丰富履约路径，满足不同场景下用户的用餐需求，从而带动整体核销率提升。
特殊场景简介
随心团M选N对接时，所有接口返回的商品信息中重点关注如下信息：
1）Products代表用户购买的第一单团购商品；
2）items结构体代表用户预约配送时，实际选择的单品/商品；
3）sku_attr_list结构体代表用户选择的单品的规格，和该单品添加的小料；
4）规格升级前抖音商品 ID，规格升级前外部商品 ID，规格升级前商品价格表示原始团购套餐中包含的单品价格和规格（用于处理用户预约配送时升级规格场景）；
5）加料价格针对用户在预约配送时，在单品上额外付费添加小料场景；
名词解释
名词 | 解释 |
抖音码 | 抖音发码，调用抖音接口完成扫码验券、输码验券 |
三方码 | 三方发码，发码和退款都由三方提供，需要对接三方码相关接口 |
快送 | 平台合作对接三方配送商，适合无自有运力的商家。（仅限在闭环抖音上选择） |
M选N | 支持用户在外卖下单时选择 M 选 N 组合（即从 M 个选项中选 N 个）及多规格信息，丰富商品选择，提升用户体验。 |
接入流程
开发者入驻和接入
根据以下指南完成开放平台的入驻和自助化接入
接口关系图
抖音码团购交易接口清单
能力 | 是否必接 | 接口 | 说明 |
商品发布和查询 | 选接 | 团购发布能力帮助商家创建/修改/上架/下架团购，由于该能力对商家端和用户端影响比较大，平台仅针对自研商家和代运营服务商开放。 说明：请商家侧先和销售经理沟通，由销售经理提出申请并且经过我们确认后，再进行此项对接。 | |
结算对账 | 选接 | 根据订单id查询订单分账明细，支持批量查询 | |
结算对账 | 选接 | 根据订单id查询订单分账明细，支持批量查询 | |
| | | |
订单接单 | 选接 | 1. 商家确认出餐完成能力，支持所有订单类型（即时单、预约单、先囤后送单），所有团购配送商品类型（标准外卖商品、到店到家双开商品），所有配送模式（快送、自配送）。 2. 商家确认已完成出餐时调用此接口，需上报真实的出餐时间，禁止自动出餐。商家接单后，默认备餐时间最少为3分钟，3分钟后才允许调用出餐接口，否则可能会接口报错。违规情况严重者，也可能会受到平台警告或处置。 | |
选接 | 1. 用户下单后，第三方可调用此接口对抖音团购配送订单进行“接单”操作。 2. 平台兜底策略：超10分钟未接单会自动取消订单。 | ||
选接 | 用户下单后，第三方可调用此接口对抖音团购配送订单进行“拒单”操作。 | ||
订单配送 | 选接 | | |
订单退款 | 选接 | 1. 收到用户申请退款的消息后，可在第三方系统中调用此接口进行异步处理，若拒绝退款，需要传拒绝原因。 | |
选接 | 1. 商家因联系不上用户、商品售完等原因需要主动退单，可调用此接口取消订单 | ||
选接 | 1.当用户发起退款申请，且需要商家审核时，需要通过此接口发消息给第三方系统。 2.收到用户申请退款消息后，可立即返回处理结果：同意、拒绝、处理中；也可先返回“处理中”，然后再异步处理。建议先返回“处理中”，待商家处理后再异步通过「商家同意/拒绝退款接口」同步处理结果。 | ||
门店配送设置 | 选接 | | |
选接 | 1. 查询商家的配送信息 2. 如果该商家还未配置配送信息返回空值 | ||
选接 | | ||
选接 | 抖音侧门店接单状态变更时，会推送消息给到第三方。 | ||
选接 | 抖音侧门店配送信息发生变更时，平台会同步状态变更消息给第三方系统 | ||
订单查询 | 选接 | 订单完成后，平台会将订单已完成消息推送给第三方系统 | |
订单推送 | 选接 | 用户下单并支付成功后，平台会推送此下单消息，消息体中包含订单详细信息，各技术服务商可据此消息同步生成订单 。 | |
选接 | 订单接单后，平台会将订单已接单消息推送给第三方系统 | ||
选接 | 订单被拒单后，平台会将订单已拒单消息推送给第三方系统 | ||
选接 | 订单退款成功后，平台会将订单已取消的消息推送给第三方系统，消息中会有具体的取消类型和原因 | ||
选接 | 用户申请退款后，若退款申请已被处理，平台会将订单已同意/拒绝退款的消息推送给第三方系统，如果是拒绝退款，则消息中会有具体的拒绝原因 | ||
选接 | 抖音侧配送状态变更，平台会同步状态变更消息给第三方系统 | ||
选接 | 订单完成1h后，平台会将订单账单确认消息推送给第三方系统 | ||
选接 | 订单部分退款成功后，平台会将订单已取消的消息推送给第三方系统，消息中会有具体的取消类型和原因 | ||
选接 | 订单完成后，平台会将订单已完成消息推送给第三方系统 | ||
仅三方码发码的商家必接 | 随心团订单未支付关单通知 Webhook | ||
三方码交易能力 | 仅三方码发码的商家必接 | 针对三 方码场景提供对应第二单锁定的三方码，商家需自行锁定 | |
次卡三方码交易能力 | 次卡三方码必接 | 针对三方码场景提供对应第二单锁定的三方码，商家需自行锁定 |
