> ## Documentation Index
> Fetch the complete documentation index at: https://docs.v-moo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 商品与分类管理

> 创建分类、上传商品、配置规格套餐和导入竞对商品库

# 商品与分类管理

从门店列表进入目标门店的“商品”或“商品分类”。商品配置分为基本信息、详情信息、促销信息和高级设置四个页签。

## 一、创建商品分类

先建立分类，再上传商品。分类名称应简短清楚，排序应与用户点餐习惯一致。

* 一级分类用于门店点餐页的主分类导航。
* 二级分类用于进一步分组。
* 调整或删除分类前，先检查分类下是否还有商品。
* 分类和门店必须匹配，不要在错误门店重复创建同名分类。
* 分类扣点会影响该分类商品的结算，修改前先确认合同口径，并用订单核对实际分摊。

## 二、商品列表

<Frame caption="商品列表支持按名称、价格、SKU、UPC、分类、商品类型、图片、售罄和状态筛选。">
  <img src="https://mintcdn.com/weimao/4lOxkfdyt4VsPegl/images/product/product-list.png?fit=max&auto=format&n=4lOxkfdyt4VsPegl&q=85&s=2511c5342cb6d0122bca7354106d6d15" alt="门店商品列表" width="1440" height="720" data-path="images/product/product-list.png" />
</Frame>

列表可执行编辑、克隆、删除、上下架、售罄、批量分类、批量餐盒费、批量结算价、批量销售时段和同步控制等操作。批量操作前先用筛选结果确认目标数量。

删除只用于误建且无需保留的商品；暂停售卖应使用下架或售罄。克隆商品后要重新核对分类、价格、规格、库存、促销时间和第三方编号，不能直接上线。

## 三、新增或编辑商品

<Frame caption="商品编辑页分为基本信息、详情信息、促销信息和高级设置四个页签。">
  <img src="https://mintcdn.com/weimao/4lOxkfdyt4VsPegl/images/product/product-form-tabs.png?fit=max&auto=format&n=4lOxkfdyt4VsPegl&q=85&s=ddfe6310b87c8e417a3bb70cb4fae4bd" alt="商品编辑四个页签" width="1440" height="900" data-path="images/product/product-form-tabs.png" />
</Frame>

### 1. 基本信息

| 配置项      | 说明                                |
| -------- | --------------------------------- |
| 商品名称、副标题 | 用户端主标题和补充说明                       |
| 商品分类     | 选择当前门店内正确分类                       |
| 商品图片     | 使用 `360×360` 或 1:1 图片，文件不超过 500KB |
| 价格       | 核对销售价格和可能存在的结算价格                  |
| 餐盒费      | 按份数和实际打包规则配置                      |
| 商品类型     | 普通商品或套餐商品                         |
| 规格和属性    | 用于杯型、口味、温度、加料等选择                  |
| 套餐分组     | 配置套餐内必选、可选和可加购商品                  |

<Warning>
  商品图片规格以当前后台提示为准，不再使用旧的 800×800、5MB 标准。图片过大或比例不一致会影响列表加载和展示裁切。
</Warning>

### 2. 详情信息

可配置视频、原料、重量、单位、SKU、UPC、轮播图和图文详情。SKU 和 UPC 常用于第三方收银或商品同步，同一门店内应保持唯一和稳定。

### 3. 促销信息

设置促销日期、星期、时段、折扣或减价、每单限购和每日限购。活动时间与门店营业时间不一致时，用户可能看到商品但无法享受促销。

### 4. 高级设置

常用项目包括：

* 文字标签和商品标识。
* 最少购买数量。
* 独立销售时段。
* 招牌商品和商家推荐。
* 单点不送。
* 仅随套餐购买。
* 打印文字或图片标签。

## 四、规格、套餐和加购

### 普通规格

适合杯型、份量等会改变价格或库存的选择。每个规格应有清晰名称和完整价格，不要把做法说明误建成规格。

不同规格组之间可以设置互斥关系，例如选择某种杯型后不能再选择不适用的加料。互斥关系只需从任一侧设置一次，系统会同步到另一侧；保存后必须在小程序验证冲突组合会被拦截，正常组合仍可下单。

### 做法或属性

适合冷热、辣度、口味等选项。根据业务设置必选、可多选和选择数量。

### 套餐和加购

套餐可以建立多个分组，并限制每组选择数量。加购商品应明确是否加价、可选数量以及是否必须随套餐购买。

套餐中的同一子商品可以按当前套餐关系禁用不适用的规格或属性。禁用只影响这个套餐内的选择，不影响商品单独售卖或出现在其他套餐中。配置时不能禁用全部规格，必选属性组还必须保留足够的可用选项；如果页面提示“至少需要保留”或保存失败，应先恢复必选项再提交。

<Frame caption="套餐商品可按分组配置主商品、可选项和加购规格。每个分组都要核对必选数量。">
  <img src="https://mintcdn.com/weimao/4lOxkfdyt4VsPegl/images/product/combo-and-addons.png?fit=max&auto=format&n=4lOxkfdyt4VsPegl&q=85&s=08eed6320cb8df81a856016b20a82472" alt="套餐和加购规格" width="1440" height="760" data-path="images/product/combo-and-addons.png" />
</Frame>

配置后在小程序完成以下组合测试：最少选择、最多选择、重复加购、不同规格价格、互斥组合、已禁用规格和取消选择。若用户端提示套餐或规格已更新，应退出当前商品并重新选择，不要继续使用旧购物车数据。

## 五、通过外卖商家助手导入竞对商品库

操作入口：`商家与点评 → 供应商 → 门店列表 → 导入商品库`

这项功能适合商家已有美团闪购、美团外卖、京东或饿了么/淘宝闪购商品库，希望减少重复建品工作。进入目标门店的“导入商品库”后，先使用 Windows 电脑点击“下载外卖商家助手”并完成安装。

<Frame caption="测试后台的导入商品库窗口会提供外卖商家助手下载、平台选择、价格调整和当前平台的操作提示。">
  <img src="https://mintcdn.com/weimao/g59D_cV39BVbkwK4/images/product/competitor-product-import.png?fit=max&auto=format&n=g59D_cV39BVbkwK4&q=85&s=9c4c5e94ab5a54ce13302c8ad3f85de1" alt="通过外卖商家助手导入竞对商品库" width="1365" height="900" data-path="images/product/competitor-product-import.png" />
</Frame>

推荐流程：

1. 在门店列表用门店编号确认目标门店，再打开“导入商品库”。
2. 下载并打开外卖商家助手，选择对应平台，点击“添加商家”并登录该平台的商家账号。
3. 回到导入窗口选择同一平台，按业务需要填写价格调整比例；填正数表示加价，填负数表示降价，留空或填 `0` 表示保持原价。
4. 美团闪购、美团外卖和京东按页面提示，从助手复制 Cookie（登录凭证）到导入窗口，再点击“开始导入”。
5. 饿了么/淘宝闪购在助手内点击“商品”获取商品信息，搜索对应的微猫门店后直接导入。
6. 导入完成后抽查分类、名称、图片、价格、规格、餐盒费和上下架状态，再到小程序试加购。

<Warning>
  导入前必须确认第三方账号和微猫门店属于同一商家。Cookie 属于登录凭证，不得发送到无关群聊或长期留存在公共文档；失效后应回到助手重新登录获取。点击导入前再次确认价格调整比例，首次操作优先使用测试门店验证，避免错误比例影响整店商品。
</Warning>

## 六、第三方同步

系统当前支持以下品牌和渠道，实际可选范围以后台已配置的接入为准：

| 接入机制       | 品牌或渠道                                     | 说明                                            |
| ---------- | ----------------------------------------- | --------------------------------------------- |
| 品牌直连，仅同步商品 | 古茗、华莱士、必胜客、中原大刀                           | 同步商品资料；古茗的动态价格、库存和售罄依赖有效凭证，活动价和活动限购不自动同步为微猫促销 |
| 品牌渠道同步并代下单 | 天天中餐厅、肯德基、霸王茶姬、塔斯汀·中国汉堡、库迪咖啡、星巴克、瑞幸咖啡、麦当劳 | 商品随对应品牌渠道接入，具体同步字段以当前绑定能力为准                   |
| 外卖平台商品导入   | 美团外卖、美团闪购、京东外卖、淘宝闪购/饿了么                   | 通过外卖商家助手导入，操作方法见上一节                           |
| 收银系统接入     | 客如云 onPOS、客如云智享版                          | 通过门店收银系统绑定，先确认商品字段由哪一端维护                      |

账号绑定、凭证维护和发起同步由有对应权限的人员处理。运营人员在商品列表和小程序核对分类、名称、价格、规格、库存、上下架和售罄状态；部分失败时不要视为整店同步完成。

绑定前先明确商品名称、价格、库存、上下架和规格由哪一端维护，不要同时在两端修改同一字段。

## 上线检查

* 分类顺序和名称符合点餐路径。
* 商品图为 1:1 且不超过 500KB。
* 名称、价格、餐盒费、单位、SKU 和 UPC 正确。
* 规格、属性、套餐和加购经过完整选择测试。
* 促销日期、星期、时段和限购正确。
* 单点不送、仅随套餐购买等高级规则符合预期。
* 用户端价格、购物车金额和打印内容一致。
