点单菜品能力概述
收藏我的收藏
一、背景概述
购物车点单能力,指的是在现有的允许用户将外卖套餐进行加购和下单的基础上,新增菜品维度进行加购和下单的完整能力。除了订单相关的交易链路的升级,还包括商品维护的颗粒度在套餐的基础上新增菜品维度的管理能力,需要前置完成的门店外卖信息配置项中需要完成起送价的设置,以及在用户可感知的直播间、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 | 抖音 |
