饿了么开放平台商品同步(刷菜)接入场景方案刷菜处理流程

1、查询门店全量商品（可选）

所属服务接口名称描述

商品服务eleme.product.item.queryItemByPage分页获取店铺下的商品

或者分两步：1、查询所有分类，2、根据分类查询商品

所属服务接口名称描述

商品服务eleme.product.category.getShopCategories查询店铺商品分类

商品服务eleme.product.item.getItemsByCategoryId获取一个分类下的所有商品

2、ISV系统菜单跟饿了么平台菜单里商品比对得出哪些商品要被删除、更新和添加（可选）

此处为第三方开发者/自研商家内部业务处理逻辑

3、查询修改受限制的商品列表

所属服务接口名称描述

商品服务eleme.product.item.getShopLimitedItemsV2获取店铺内修改受限制的商品

商品服务eleme.product.item.batchGetPidAndLocks批量查询店铺商品的连锁店PId和锁信息

接口一结果返回包含两类商品：被锁商品列表和被连锁店强管控的商品列表

被锁商品：被锁的商品不能下架和删除，被锁定规格不能删除，其他信息修改不受限制

被连锁店强管控商品：被总店商品关联的商品，商品名称和规格名称分店不能修改，也不能新增和删除规格，商品名称和规格名称只能通过修改连锁店统管菜单商品信息来更新所有被关联的分店商品信息的方式修改

🚩建议：为了保证刷菜成功率可以直接跳过这两类商品的更新操作，再根据所需单独处理被锁商品/被连锁店强管控商品

4、批量删除（单个和批量均支持）

所属服务接口名称描述其他说明

商品服务eleme.product.item.removeItem删除商品

商品服务eleme.product.item.batchRemoveItems批量删除商品

特殊说明，因商品锁删除失败场景及解决办法:

商品中的某些规格因为活动原因被锁定报错文案：“商品正在参与活动xxxx，部分信息不可修改”

商品被连锁店强管控报错文案：“该商品已被连锁店强管控xxxx，ChianID xxxx，菜单模板 xxxx”

🚩解决方法：
可以使用第3步 eleme.product.item.getShopLimitedItemsV2接口获取店铺内修改受限制的商品列表，跳过不删除。

5、批量新增（单个和批量均支持）

所属服务接口名称描述其他说明

商品服务eleme.product.category.createCategory添加商品分类分类存在则不用添加

商品服务eleme.product.item.createItem添加商品

商品服务eleme.product.item.batchCreateItems批量添加商品有个数限制

6、批量更新（单个和批量均支持）

所属服务接口名称描述其他说明

商品服务eleme.product.item.updateItem更新商品

商品服务eleme.product.item.batchUpdateItems批量添加商品

特殊说明，因商品锁更新失败场景：

商品中的某些规格因为活动原因被上锁报错文案：“商品正在参与活动xxxx，部分信息不可修改”

商品被连锁店商品关联报错文案：“该商品已被连锁店强管控xxxx，ChianID xxxx，菜单模板 xxxx”

解决方法：

使用第三步eleme.product.item.getShopLimitedItemsV2接口获取店铺内修改受限制的商品列表

如果该商品为被锁商品，那么只要不操作商品下架和删除，不删除被锁定规格则不影响商品更新；

如果商品被连锁店强管控，商品名称和规格名称分店不能修改，也不能新增和删除规格，商品名称和规格名称只能通过修改连锁店商品系统自动更新所有被关联的分店商品信息的方式修改

7、创建/绑定加料组（可选）

所属服务接口名称描述

商品服务eleme.product.item.createIngredientGroup创建配料组

商品服务eleme.product.item.deleteIngredientGroup删除配料组

商品服务eleme.product.item.bindIngredientGroups主商品绑定配料组

商品服务eleme.product.item.unbindIngredientGroups主商品解绑配料组

商品服务eleme.product.item.removeMainItemIngredientGroups移除主料商品的全部配料组

商品服务eleme.product.item.batchCreateIngredientGroups批量创建配料组

商品服务eleme.product.item.getIngredientGroup查询配料组

商品服务eleme.product.item.listIngredientGroups批量查询配料组