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

    一、背景概述

    购物车点单能力,指的是在现有的允许用户将外卖套餐进行加购和下单的基础上,新增菜品维度进行加购和下单的完整能力。除了订单相关的交易链路的升级,还包括商品维护的颗粒度在套餐的基础上新增菜品维度的管理能力,需要前置完成的门店外卖信息配置项中需要完成起送价的设置,以及在用户可感知的直播间、POI货架、频道页、搜索列表页等页面新增菜品维度的信息透传。

    二、功能简介

    生活服务商品开放平台提供了标准API接口,作为外部用户接入生活服务外卖商品库的入口,外卖saas菜品对外提供菜品发布、查询、上下架、库存变更、上下架回调等能力。接口列表参考文档末尾。

    三、商品模型

    ​
    ​
    ​

    四、业务场景

    菜品管理提供了菜品创建/更新、菜品同步、查询、修改库存、上下架、上下架回调等能力。
      1.查询商家/门店适用商品类目:获取商家/门店支持的点单菜品商品品类
      2.查询品类下原料模版:查询商品品类下的原料模板,创建商品时的原料数据需遵循该模版进行送审,否则无法送审
      3.创建/编辑菜品的分组:给商家/门店的菜品进行分组数据的创建或更新
      4.菜品的分组进行排序:对商家/门店下的分组进行优先级排序
      5.商家/门店下菜品分组数据查询:查询商家/门店下的分组数据
      6.创建/更新菜品数据:
      ◦菜品的原料数据,需要通过查询品类下原料模版获取
      ◦创建/修改商品需要审核,通常2小时内出审,审核通过后,默认下架
      7.连锁菜品(含义同商家菜品)同步至门店:对连锁菜品可以选择门店后进行批量同步至多门店,任务异步执行
      8.连锁菜品同步子任务分页查询:对菜品同步任务的子任务明细进行查询,任务执行完成才会透出数据
      9.连锁菜品(含义同商家菜品)关联门店菜品查询:查询连锁菜品同步到了哪些门店
      10.门店菜品outid设置:对门店菜品的outId进行设置,仅支持全量设置,无对应值则认为没有对应的外部id
      11.更新外卖商品库存:免审修改菜品的线上总库存
      12.更新外卖商品状态:支持修改在线菜品的上线、下线状态
      13.菜品在分组内排序:对商家/门店菜品下同分组内的菜品进行优先级排序
      14.查询点单菜品线上数据
      ◦使用抖音商品ID查询商品线上数据
      ◦线上数据是指:通过审核后在线的数据,包括在线、下线状态的数据
      15.查询外卖商品线上列表:
      ◦支持查询商家/门店下所有线上商品数据
      ◦处于在线、下线、封禁状态的数据可以通过该接口查询到
      16.查询外卖商品草稿数据
      ◦使用抖音商品ID查询商品草稿
      ◦处于新建审核中、修改审核中、或审核成功、失败、商家确认中的数据可以通过该接口查询到
      17.查询外卖商品草稿列表:支持商家/门店的商品草稿数据获取
      18.商品状态变更消息webhook:线上商品状态发生变更时,会给商家已授权的服务商推送消息

    五、接入前期准备

    根据以下指南完成开放平台的入驻和自助化接入

    六、业务流程

      •菜品创建流程
      •核心接口流程
    ​

    七、对接接口

    接口
    接口路径
    接口分类
    调用方
    1-查询商家/门店适用商品类目
    OpenAPI
    商家/服务商
    2-查询品类下原料模版
    OpenAPI
    商家/服务商
    3-创建/编辑菜品的分组
    OpenAPI
    商家/服务商
    4-菜品的分组进行排序
    OpenAPI
    商家/服务商
    5-商家/门店下菜品分组数据查询
    OpenAPI
    商家/服务商
    6-创建/更新菜品数据
    OpenAPI
    商家/服务商
    7-连锁菜品(含义同商家菜品)同步至门店
    OpenAPI
    商家/服务商
    8-菜品同步子任务分页查询
    OpenAPI
    商家/服务商
    9-连锁菜品(含义同商家菜品)关联门店菜品查询
    OpenAPI
    商家/服务商
    10-门店菜品outid设置
    OpenAPI
    商家/服务商
    11-更新外卖商品库存
    OpenAPI
    商家/服务商
    12-更新外卖商品状态
    OpenAPI
    商家/服务商
    13-菜品在分组内排序
    OpenAPI
    商家/服务商
    14-查询点单菜品线上数据
    OpenAPI
    商家/服务商
    15-查询外卖商品线上列表
    OpenAPI
    商家/服务商
    16-查询外卖商品草稿数据
    OpenAPI
    商家/服务商
    17-查询外卖商品草稿列表
    OpenAPI
    商家/服务商
    18-商品状态变更消息
    webhook
    抖音
    ​