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

    一、功能简介

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

    二、基本术语

    类目树

    商品所属的分类,类目决定商品归属;
    类目是有层次,分一级,二级,三级类目,互相之间是有继承关系;

    Spu

    平台标准产品单元:是商品信息聚合的最小单位,是一组可复用、易检索的标准化信息的集合,该集合描述了一个产品的特性。
      •SPU是一个很标准的产品;例如电商下iPhone13;或者外卖业务中的【宫保鸡丁】,以及一个电影【长津湖】;都可以算是一个SPU;
      •SPU是对某一类目的进一步抽象,例如手机下的各种机型,电影票类目下的具体影片,不过因为有些行业或者类目下不能进一步抽象,所以可能没有SPU;

    Product

    商品单元:通过一个SPU,会有可复用的信息继承到商家售卖的商品上(即product)
      •商品具有卖家信息,一个商品一定是对应到一个唯一卖家的,但是一个SPU可以在多个商家售卖,形成不同的商品。

    Sku

    销售单元,由类目+关键属性唯一确定。为保存库存控制的最小可用单位;也是商品销售的最细粒度。

    属性

    概念
    名词
    解释
    属性
    描述某一类事物的特性或特征。如品牌、颜色、尺码。每一个属性有一个ID值。
    属性值
    某一类事物的特征的值。比如衣服的“颜色”是属性,那么“红色、绿色”是属性值。
    属性对
    属性和其对应的属性值组成属性对。
    类目属性
    把类目和属性相关联,指定的某个类目下的商品应该具有的共同特征。
    分类
    名词
    解释
    关键属性
    是用来约束定义产品的属性,能唯一确定一个SPU。举例:“品牌:华为;型号:P40”,可以确定一款产品。
    销售属性
    是商品上能确定库存的属性,是能决定发生购买行为的属性。举例:华为P40手机,只有选择了“零度白+256G”才能下单。
    商品属性
    对商品的更详细的补充说明的属性,举例:有无前置摄像头、是否保修等。

    三、业务场景

    商品管理提供了商品创建/更新、查询、沽清、上下架、审核回调等能力。
      1.查询外卖商品品类:获取商家支持外卖商品品类
      2.查询外卖商品模版:查询商品模板,创建商品时的属性列表需与该接口保持一致,否则无法识别
      3.创建/更新外卖商品:
      ◦对于同一服务商,相同的out_id会被认为是同一商品,重复创建会被覆盖
      ◦商品和SKU属性,需要通过查询商品模板获取
      ◦创建/修改商品需要审核,通常2小时内出审
      4.更新外卖商品价格:免审修改外卖商品销售价格(组合品下单品不可独立售卖、不支持单独更新商品价格)
      5.更新外卖商品库存:免审修改外卖商品线上总库存(组合品下单品不可独立售卖、不支持单独更新库存)
      6.更新外卖商品状态:支持修改外卖商品上线、下线状态
      7.查询外卖商品线上列表:
      ◦支持查询商家所有线上商品数据
      ◦处于在线、下线、封禁状态的数据可以通过该接口查询到
      8.查询外卖商品线上数据
      ◦使用抖音商品ID或外部商品ID查询商品线上数据
      ◦线上数据是指:通过审核后可以被用户看到的数据,包括在线、下线状态的数据
      9.查询外卖商品草稿列表:仅支持服务商或开发者自己创建的商品草稿数据
      10.查询外卖商品草稿数据
      ◦使用抖音商品ID或外部商品ID查询商品草稿
      ◦处于新建审核中、修改审核中、或审核成功、失败、商家确认中的数据可以通过该接口查询到
      11.操作外卖商品门店沽清状态:
      ◦打开/关闭外卖商品对应门店沽清状态
      ◦商品门店沽清结束时间默认为发起沽清操作时间对应的次日早上4点
      12.商品审核结果通知消息webhook:商品审核通过时,会给商家已授权的服务商推送消息
      13.商品状态变更消息webhook:线上商品状态发生变更时,会给商家已授权的服务商推送消息
      14.商品库存变更消息webhook:线上商品库存发生变更时,会给商家已授权的服务商推送消息

    四、接入前期准备

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

    五、商品状态机

    商品草稿状态机:商品创建平台审核通过前,草稿状态变更
    在线商品状态机

    六、业务流程

    闭环操作动线
    核心业务流程

    七、对接接口

    接口
    接口路径
    接口分类
    调用方
    被调用方
    2.1-查询外卖商品品类接口
    OpenAPI
    商家/服务商
    抖音
    2.2-查询外卖商品模版接口
    ​
    OpenAPI
    商家/服务商
    抖音
    2.3-创建/更新外卖商品接口
    OpenAPI
    商家/服务商
    抖音
    2.4-更新外卖商品价格接口
    OpenAPI
    商家/服务商
    抖音
    2.5-更新外卖商品库存接口
    OpenAPI
    商家/服务商
    抖音
    2.6-更新外卖商品状态接口
    OpenAPI
    商家/服务商
    抖音
    2.7-查询外卖商品线上列表接口
    OpenAPI
    商家/服务商
    抖音
    2.8-查询外卖商品线上数据接口
    OpenAPI
    商家/服务商
    抖音
    2.9-查询外卖商品草稿列表接口
    OpenAPI
    商家/服务商
    抖音
    2.10-查询外卖商品草稿数据接口
    OpenAPI
    商家/服务商
    抖音
    2.11-商品审核结果通知消息
    Webhook
    抖音
    商家/服务商
    2.12-商品状态变更消息
    Webhook
    抖音
    商家/服务商
    2.13-商品库存变更消息
    Webhook
    抖音
    商家/服务商
    2.14-操作外卖商品门店沽清状态
    OpenAPI
    商家/服务商
    抖音
    2.15-查询商品适用门店及沽清信息
    OpenAPI
    商家/服务商
    ​