点单商品模型介绍
主要名词
名词 | 维度 | 含义 | 是否必需 | 来客示意 | 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-区域收款 |