抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • 接入前准备
  • API接口
  • 能力
  • 历史版本文档(不推荐)
  • 景区团购(在线预约)
  • 设置分佣比例
  • 代运营佣金
  • 建立代运营合作关系
  • 代运营合作
  • 景区日历票
  • 景区行业团购|在线预约解决方案
  • 餐饮团购
  • 线索经营
  • 更新预售券的预约库存日历
  • 酒店日历房接口
  • 三方码
  • 酒店新预售券接口
  • 酒旅
  • 通用能力
  • 接入前准备
  • 外卖订单能力概述

    收藏
    我的收藏

    一、功能简介

    订单处理与团购配送息息相关,是开展团购配送过程中必不可少的环节。通过订单管理接口可以进行订单确认、发配送、查询信息、退款等操作,有效帮助商家提升经营效率。

    二、业务场景

    订单处理支持接单操作、发起配送、查询订单、发起退款等操作。
      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:不会
    ​
    ​