饿了么开放平台商品搭售场景方案api能力介绍

发布时间：2025-05-28

商品通过在商品/商品规格下挂载不同的配料和属性，实现不同场景的搭售能力。

5.1、商品与配料的基础搭售能力（已有能力）

基础的配料搭售场景可参考文档：
https://open.shop.ele.me/openapi/documents/ingredient_useguide

5.2、商品规格维度支持挂载配料组（新增能力）

接口使用方式可参考对应的api文档
注意：当配料组挂在商品规格下时，属性也必须挂在商品规格下，不允许配料组挂在规格下，属性挂在主商品下

接口	接口名
eleme.product.item.bindSkuIngredientGroups	给主料商品绑定配料组（规格维度）
eleme.product.item.unbindSkuIngredientGroups	解绑配料组（规格维度）

5.3、商品规格维度支持挂载属性组（新增能力）

接口使用方式可参考对应的api文档
注意：当属性挂在商品规格下时，配料组也必须挂在商品规格下，不允许属性挂在商品规格下，配料组挂在主商品下

口	接口名	字段说明
eleme.product.item.createItem	新增商品	specs[].attributes字段用于设置规格属性
eleme.product.item.batchCreateItems	批量添加商品	specs[].attributes字段用于设置规格属性
eleme.product.item.updateItem	更新商品	specs[].attributes字段用于设置规格属性

5.4、单配料支持多份数和设置上下限（新增能力）

接口使用方式可参考对应的api文档
注意：当配料组必选，且多选种类时，配料的购买下限始终为0

接口	接口名	字段说明
eleme.product.item.createIngredientGroup	创建配料组	ingredientSkus[].minSelectNum字段表示购买下限 ingredientSkus[].maxSelectNum字段表示购买上限
eleme.product.item.batchCreateIngredientGroups	批量创建配料组	ingredientSkus[].minSelectNum字段表示购买下限 ingredientSkus[].maxSelectNum字段表示购买上限

5.5、配料组支持配料多份数和设置上下限（新增能力）

接口使用方式可参考对应的api文档

接口	接口名	字段说明
eleme.product.item.createIngredientGroup	创建配料组	ingredientGroup[].minMultiSelect字段表示购买下限 ingredientGroup[].maxMultiSelect字段表示购买上限
eleme.product.item.batchCreateIngredientGroups	批量创建配料组	ingredientGroup[].minMultiSelect字段表示购买下限 ingredientGroup[].maxMultiSelect字段表示购买上限

5.6、支持设置规格图片（新增能力）

接口使用方式可参考对应的api文档
注意：为保证商品图片的一致性体验，商品下的所有规格都设置了图片才会生效

接口	接口名	字段说明
eleme.product.item.createItem	新增商品	specs[].photoHash字段用于设置规格图片 specs[].selectPhotoHash字段用于设置规格选中时的图片
eleme.product.item.batchCreateItems	批量添加商品	specs[].photoHash字段用于设置规格图片 specs[].selectPhotoHash字段用于设置规格选中时的图片
eleme.product.item.updateItem	更新商品	specs[].photoHash字段用于设置规格图片 specs[].selectPhotoHash字段用于设置规格选中时的图片

5.7、订单数据中增加配料份数字段（新增能力）

接口使用方式可参考对应的api文档

接口	接口名	字段说明
eleme.message.callback	10、217消息	groups[].items[].ingredients[].quantity字段表示配料份数
eleme.order.getOrder	获取订单	groups[].items[].ingredients[].quantity字段表示配料份数
eleme.order.mgetOrders	批量获取订单	groups[].items[].ingredients[].quantity字段表示配料份数
eleme.order.getAllOrders	查询全部订单	groups[].items[].ingredients[].quantity字段表示配料份数