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