抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 接入前准备
  • 通用接口
  • 餐饮
  • 到店餐饮团购解决方案
  • 餐饮在线点单解决方案
  • 门店接单信息设置
  • 点单相关商品发布
  • 点单商品模型介绍
  • 标品创建
  • 标品上下架
  • 点单品创建/更新
  • 点单品上下架
  • 加料品创建/更新
  • 加料品上下架
  • 加料品门店沽清
  • 团购绑定点单标品
  • 点单品门店上下架
  • 点单相关商品查询
  • 在线点单交易能力
  • 商家账单明细
  • 生活服务用户信息转换
  • 随心团解决方案
  • 大交通
  • 酒旅
  • 综合
  • 主要名词

    名词
    维度
    含义
    是否必需
    来客示意
    C端示意
    团购在线点单
    品牌维度
    团购商品在订单详情页是否展示在线点单按钮
    团购商品管理->编辑->在线点单
    点单标品
    品牌维度
    品牌维度标准菜品,用于品牌维度的信息聚合后与团购做关联,非售卖主体。在点单语境下,也可简称标品
    标品创建/修改
    团购关联标品
    来客操作页面
    点击升级在线点单,或直接创建新团购
    点单商品
    品牌/区域/门店维度均可
    商家基于实际管理诉求创建的在一个或多个门店售卖的商品,作为售卖主体。后面也简称点单品。
    选择点单品规格
    加料品
    品牌维度
    品牌维度加料商品,用于售卖时用户选择加料,满足消费者差异化需求。如芋泥,椰果等。也可简称加料,配料,小料等
    加料门店沽清
    门店维度
    加料商品售罄后可设置沽清状态,消费端展示为“缺货”
    只支持saas
    门店状态
    门店维度
    Product/SKU在不同门店的状态
    只支持saas
    门店维度商品下架-展示缺货
    门店维度SKU下架-展示规格缺货
    销售属性
    点单商品维度
    又叫规格,用于区分不同的售卖单元SKU,如杯型(大/中/小),尺码(S/M/L)等
    非销售属性
    不影响价格,但影响具体交付产品内容的属性。如冰量(少冰/去冰),甜度等

    点单商品上单流程

    公共结构体

    - 字段名
    字段类型
    是否必填
    备注
    - product
    ProductStruct
    TRUE
    门店品
    -- out_id
    string
    TRUE
    外部点单品id
    -- out_spu_id
    string
    TRUE
    关联标品id
    -- name
    string
    TRUE
    名称
    -- category_id
    int
    TRUE
    三级类目id
    -- account_id
    int
    TRUE
    抖音商家ID
    -- biz_line
    int
    TRUE
    业务线,1-闭环,固定传1即可
    -- fulfillment_method
    list<int>
    TRUE
    履约方式 2-在线点单
    -- poi_list
    list<PoiStruct>
    TRUE
    门店列表
    --- poi_id
    int
    FALSE
    抖音门店id // 与ext_id任选一个传入
    --- ext_id
    string
    FALSE
    外部门店id // 与poi_id任选一个传入
    -- images
    ProductImageStruct
    TRUE
    图片
    --- head_image
    ImageStruct
    TRUE
    头图
    ---- url
    string
    TRUE
    图片链接
    -- sold_time
    SoldTimeStruct
    TRUE
    售卖时间
    --- start_time
    int
    TRUE
    秒级时间戳,售卖开始时间
    --- end_time
    int
    TRUE
    售卖结束时间,长期售卖则设置一个较长的结束时间
    -- sale_attr_groups
    list<SaleAttrGroupStruct>
    FALSE
    规格组列表,包含加价规格,非加价规格。
    需要包含关联的spu内的规格,否则spu无法使用
    ---spec_type
    int
    FALSE
    1: 销售属性
    2: 描述属性
    不填默认是销售属性
    --- group_name
    string
    TRUE
    规格组名称,比如杯型
    --- group_code
    string
    TRUE
    规格组编码,比如杯型cup
    --- item_list
    list<SaleAttrStruct>
    TRUE
    规格列表
    ---- item_name
    string
    TRUE
    规格名称 大杯/中杯/小杯
    ---- item_key
    string
    TRUE
    外部规格编码 , 比如big/mid/small
    -- sku_list
    list<SkuStruct>
    TRUE
    SKU列表
    --- out_sku_id
    string
    TRUE
    商家系统sku_id
    --- price
    PriceStruct
    TRUE
    价格
    ---- origin_amount
    int
    FALSE
    原价,单位:分(暂无使用场景)
    ---- actual_amount
    int
    TRUE
    实付价,单位:分
    --- status
    int
    状态 1-上架,默认传1
    --- sale_attr_list
    list<SkuSaleAttrStruct>
    TRUE
    SKU关联的销售属性code list,通常只用关联加价规格,如果实在没有加价规格,建议加一个默认的规格-如“常规”,“默认”等表述
    ---- group_code
    string
    TRUE
    映射sale_attr_groups内某一规格组编码,比如杯型cup
    ---- item_key
    string
    TRUE
    映射sale_attr_groups内某一规格项item_key ,比如big
    -- affiliated_groups
    list<AffiliatedGroupStruct>
    加料组列表,目前打平成一组展示
    --- group_code
    string
    加料属性组编码
    --- group_name
    string
    加料属性组名称
    --- out_affiliated_ids
    list<string>
    外部加料品id列表
    -- settle_info
    SettleInfoStruct
    TRUE
    结算信息
    --- settle_type
    int
    TRUE
    收款方式 1-总部收款 2-门店收款 3-区域收款