外卖订单能力概述
一、功能简介
订单处理与团购配送息息相关,是开展团购配送过程中必不可少的环节。通过订单管理接口可以进行订单确认、发配送、查询信息、退款等操作,有效帮助商家提升经营效率。
二、业务场景
订单处理支持接单操作、发起配送、查询订单、发起退款等操作。
- 1.接单操作:商家可以确认订单或取消订单
- 2.查询订单:支持商家主动查询订单状态等详细信息
- 3.发起或处理退款:商 家可以接受或拒绝用户退款请求,以及主动发起取消订单。
- 4.配送:商家可以同步配送信息给抖音,以及接收订单配送信息。
三、接入前期准备
根据以下指南完成开放平台的入驻和自助化接入
四、具体流程和接口
4.1 新订单接单流程
接口调用流程:
- 1.用户下单并预约配送后,抖音开放平台会通过【3.1-用户下单消息 Webhook】回调接口将订单信息推送给收银系统;
- 2.商家接收到订单信息后,需要在15分钟内确认订单,若接单,则调用【3.2-确认订单接口】;若拒单,则调用【3.3-拒绝订单接口】;
- 3.若商家在抖音来客操作接单或拒单,抖音开放平台会通过【3.5-订单已接单消息 Webhook】和【3.6-订单已拒单消息 Webhook】回调接口将接单信息通知给收银系统。
4.2 用户退款流程
业务流程:
调用流程:
接口调用流程
商家取消订单(暂不支持完单后发起,暂不支持部分退):
- 1.商家在收银系统申请取消订单后,收银系统需要调用【3.4-商家取消订单接口】取消订单。
- 2.订单取消后,抖音开放平台会通过【3.7-订单已取消消息】回调接口通知给收银系统。
用户发起退款:
- 1.用户申请退款后,抖音开放平台会通过【3.9-用户申请退款消息】回调接口将订单退款信息推送给收银系统;收银系统可立即返回处理结果:同意、拒绝、处理中;也可先返回“处理中”,然后再异步处理。
- 2.异步处理:商家接收到退款请求后,若同意退款,则调用【3.10-商家同意/拒绝退款接口】同意退款;若拒单,同样调用【商家同意/拒绝退款】拒绝退款;
- 3.若商家在抖音来客操作接受或拒绝退款,抖音开放平台会通过【3.11-订单已同意/已拒绝退款消息】回调接口将退款信息通知给收银系统。
部分退(免审):
- 1.用户在商家接单前发起部分退,客服在完单后发起部分退时,抖音开放平台会通过【3.18-订单已部分退消息】回调接口将退款信息通知给收银系统。
4.3 出餐、配送流程
接口调用流程
- 1.商家确认已完成出餐时,收银系统需通过【3.19-商家确认出餐完成接口】上报出餐完成。
- 2.商家自配送:配送后,每当配送状态流转时,都需要调用【3.12-回传配送信息接口】将配送状态同步给抖音。
- 3.商家自配送:骑手已接单后,请尽量每30秒左右回传一次更新的经纬度信息,至少保证每分钟回传一次,以确保用户端信息展示的实时性。
- 4.平台配送:抖音会在配送状态发生变更时,通过【3.13-配送状态变更消息】将配送状态同步给收银系统。
- 5.需要同步的配送状态有: 1=发起配送; 2=骑手已接单; 3=骑手已到店; 4=骑手已取货(配送中);5=骑手已送达; 6=运单取消。
4.4 完单流程
接口调用流程
订单完单后,抖音开放平台会通过【3.16-订单已完成消息】回调接口将完单信息通知给收银系统。
4.5 预计收入流程
接口调用流程
- 1.用户下单后,抖音开放平台会通过【3.1-用户下单消息】回调接口将预计收入信息通知给收银系统。
- 2.部分退完成后,抖音开放平台会通过【3.18-订单已部分退消息】回调接口将预计收入变化通知给收银系统。
- 3.自配送订单完单后,平台配送完单1h后,抖音开放平台会通过【3.17-账单确认消息】回调接口将预计收入通知给收银系统。
- 4.订单完成后生成分账明细,收银系统可以通过【3.14-根据订单id查询结算明细接口(KA)】或者【3.15-根据订单id查询结算明细接口(技术服务商)】查询真实收入。
五、对接接口
接口 | 接口路径 | 接口分类 | 调用方 | 被调用方 |
3.1-用户下单消息 | Webhook | 抖音 | 商家/服务商 | |
3.2-确认订单接口 | OpenAPI | 商家/服务商 | 抖音 | |
3.3-拒绝接单接口 | OpenAPI | 商家/服务商 | 抖音 | |
3.4-商家取消订单接口 | OpenAPI | 商家/服务商 | 抖音 | |
3.5-订单已接单消息 | Webhook | 抖音 | 商家/服务商 | |
3.6-订单已拒单消息 | Webhook | 抖音 | 商家/服务商 | |
3.7-订单已取消消息 | Webhook | 抖音 | 商家/服务商 | |
3.8-订单查询接口 | OpenAPI | 商家/服务商 | 抖音 | |
3.9-用户申请退款消息SPI | SPI | 抖音 | 商家/服务商 | |
3.10-商家同意/拒绝退款接口 | OpenAPI | 商家/服务商 | 抖音 | |
3.11-订单已同意/已拒绝退款消息 | Webhook | 抖音 | 商家/服务商 | |
3.12-自配送-回传配送信息接口 | OpenAPI | 商家/服务商 | 抖音 | |
3.13-配送状态变更消息 | Webhook | 抖音 | 商家/服务商 | |
3.14-根据订单id查询结算明细接口(KA) | OpenAPI | 商家自研 | 抖音 | |
3.15-根据订单id查询结算明细接口(技术服务商) | OpenAPI | 服务商 | 抖音 | |
3.16-订单完成消息 | Webhook | 抖音 | 商家/服务商 | |
3.17-账单确认消息 | Webhook | 抖音 | 商家/服务商 | |
3.18-订单已部分退消息 | Webhook | 抖音 | 商家/服务商 | |
3.19-商家确认出餐完成接口 | OpenAPI | 商家/服务商 | 抖音 |
六、FAQ
Q:下单消息中没有下发虚拟号/预计收入
A:降级导致未及时获取到 部分信息,请先使用订单查询接口补偿
Q:为什么有的"商家超时未接单"不是10分钟自动退款?自动退款的机制到底是什么?
A:比如商家营业时间是早8点至晚22点,如果非营业时间23点下预定单,会在商家开始营业时,通知商家接单,商家超时10分钟不接单会自动退款
Q:下单消息接口返回的预计实收不准确,比如少扣了「服务商佣金」部分等等
A:下单消息中是不保证准确的,准确的信息需等分账后,会下发【账单确认Webhook】或主动查询【根据订单id查询结算明细】
Q:门店没有发起配送,订单满8小时后自动完单
A:兜底逻辑是8小时后自动完单,用户可以致电客服发起退款
Q:下单消息中的划线价和商品中划线价不一致是怎么回事?
A:划线价在商品侧是一个固定值,但是C端展示的时候随着用户在商品里面选择的商品的变化,划线价也会变化。目前 SaaS 展示的是 C 端展示的划线价
Q:外卖订单没有支付就取消了,会发下单消息么?
A:不会
