一、【业务场景】

餐饮和零售商家经常需要将多个标准商品组合售卖，例如汉堡与饮料套餐、面包与牛奶组合、整条烟等。过去需分别在平台侧维护商品关系，商品信息、库存和订单明细难以统一管理。

本次升级在 OMS 商品库中新增组合商品能力，支持统一维护子品、同步平台商品、按子品库存计算可售库存，并在订单中展示组合明细。

二、【功能介绍】

更新范围：乐檬零售后台 Web，乐檬零售APP

本次系统升级主要包括：

1. 组合商品建档： 商品库新增“组合商品”页签，可创建普通组合商品（固定组合）和分组可选组合商品（M 选 N）；子品从商品库已有标准商品中选择。

2. 同步至平台： 同步商品时可选择组合商品，并同步份量、打包盒数量、打包费及子品信息；当前仅可同步至淘零和美外。

3. 平台商品绑定： 支持读取平台组合商品及子品信息，并进行组合商品与子品的绑定、解绑；绑定状态新增“部分绑定”。组合商品仅支持按商品名称匹配或手动绑定。

4. 库存自动计算： 组合商品不独立占用实物库存，系统根据子品库存和组合包含件数计算可售库存；订单完成后扣减对应标准商品库存，并重新计算组合商品库存。

5. 订单全链路展示： 订单管理、异常订单及退款订单中兼容组合商品；子品绑定关系不一致时进入异常订单处理。

6. 打印及终端适配： 小票模板支持“组合/套餐商品明细”；APP 商品编辑与订单详情可查看子品，POS 订单详情可查看组合明细。

三、【使用说明】

功能入口：乐檬零售后台 Web → 商品库 → 组合商品

1、新增组合商品

• 先在“标准商品”页签维护组合所需子品。组合商品的子品仅可选择商品库中已有、未停售的标准商品。

• 进入“组合商品”页签，点击“新增商品 → 新增组合商品”，选择组合商品类型。

• 普通组合商品：选择固定子品，并填写每个子品的组合包含件数。

• 分组可选组合商品：设置分组名称、分组类型与“本组商品 X 选”，再为各分组添加子品。该类型当前仅支持同步至美外。

• 补充商品名称、规格、组合售价、图片及平台要求字段后保存。组合商品类型保存后不可修改。

2、同步组合商品至平台

• 在商品库选择组合商品，点击“同步到平台商品”，或进入“商品同步”选择同步商品。

• 目标平台仅选择淘零或美外，其他平台不会创建或更新组合商品。

• 首次创建平台组合商品时，请勾选“子品信息”。同步至美外前，请确认份量、打包费份数、打包费均已维护。

• 若子品尚未绑定平台标准商品，系统将按平台能力对子品先创建并匹配标准商品，再创建组合商品。失败原因可在同步任务中查看。

3、平台商品绑定与订单查看

• 进入“平台商品”，读取门店商品后，可展开组合商品查看子品及绑定状态。

• 组合商品仅支持按商品名称匹配或手动绑定；绑定时，平台子品需与商品库组合商品的子品一致。

• 若子品绑定关系不一致，请在异常订单中重新绑定后重推。

4、库存计算规则

• 普通组合商品： 先按“子品库存 ÷ 组合包含件数”向下取整，再取各子品折算库存的最小值。

• 分组可选组合商品： 先计算各分组的最大可售库存，再取各分组结果的最小值作为组合商品库存。

• 平台产生订单后，仅占用并扣减子品对应标准商品的库存；系统会重新计算并同步组合商品库存。

• 淘宝闪购零售因平台限制无法自定义库存及售价，平台展示的库存及售价为平台根据子品信息自动计算的值

四、【注意事项】

1. 当前仅支持淘宝闪购零售（淘零）和美团外卖（美外）。

2. 淘零当前仅支持普通组合商品；分组可选组合商品（M 选 N）仅支持美外。

3. 组合商品创建后不可更改组合商品类型。新增过程中切换类型会清空已填写的商品及子品信息。

4. 被组合商品引用的标准商品不可直接删除。请先调整组合商品子品，再执行删除；删除组合商品不会删除其子品。

5. 组合商品不支持按规格编码自动匹配，请使用商品名称匹配或手动绑定。平台子品与商品库子品不一致时，组合商品无法自动绑定。

6. 组合商品库存由子品库存自动计算。门店手动修改平台库存后，后续库存同步可能再次按系统计算结果覆盖。

7. 淘宝闪购零售因平台限制无法自定义库存及售价，平台展示的库存及售价为平台根据子品信息自动计算的值。