外卖商品
外卖商品是外卖业务的总部商品台账：决定公司里哪些物料有资格上外卖平台、外卖售价是多少、库存怎么算。它管的是「商品能不能上、按什么价上」，各门店在具体平台上的在售/估清状态由分店外卖商品逐店处理。
一、功能概述
菜单位置：O2O业务 → 外卖管理 → 外卖商品（页面地址 /admin/waimai/wm_materiel/）
| 用途 | 说明 |
|---|---|
| 圈定可上外卖的商品 | 把物料加入台账，打上美团/淘宝/京东/企迈的平台标记 |
| 定外卖价 | 在列表里直接改「价格」列，与门店标准售价分开维护 |
| 定库存口径 | 逐行开关「自动同步库存」「使用虚拟库存」，并设「最低库存」下限 |
| 批量维护 | 导入商品、同步新商品、清理失效商品三个批量动作 |
这个页面不能新增行，只能导入。 手工新增按钮是关闭的，商品一律从物料档案里选进来，或靠「同步新商品」自动补齐。同理，删除行等于「取消外卖标记」，不会动物料档案本身。
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 工具栏 | 导入商品、同步新商品、清理失效商品；右侧有搜索、刷新、导出三个图标按钮 |
| 查询条 | 搜索框（占位提示「搜索...」）+ 美团外卖 / 淘宝外卖 / 京东外卖 三个下拉（取值 全部 / 是 / 否 / 未知）+ 更多（展开后追加 企迈 下拉） |
| 列表 | 只读列 + 可行内编辑列混排，见下表 |
| 分页 | 「共 N 条」「共 N 页 第 N 页」，每页 10 / 20 / 30 / 50 / 100 / 200 条 |
| 列 | 能不能改 | 说明 |
|---|---|---|
| 类别名称 | 只读 | 取自物料的商品分类 |
| 物料编号 | 只读 | 锁定列并带超链，点开可看物料 |
| 物料名称 / 物料规格 / 条码 / 标准进价 | 只读 | 都来自物料档案，不在本页维护 |
| 价格 | 行内编辑 | 外卖售价，与门店零售价互不影响 |
| 美团外卖 / 淘宝外卖 / 京东外卖 / 企迈 | 行内编辑（开关） | 打上该平台标记，商品才有资格同步到该平台 |
| 自动同步库存 | 行内编辑（开关） | 开启后按门店实时库存推给平台 |
| 使用虚拟库存 | 行内编辑（开关） | 开启后不占门店真实库存，按固定值上报 |
| 最低库存 | 行内编辑 | 允许在售的最低库存线，低于它就不该再卖 |
平台四列、价格、两个库存开关与最低库存这几列的表头带 *，表示它们是本页真正要维护的字段；前面的物料信息列只是参照。
三、业务操作步骤
步骤 1：把商品纳入外卖台账
三条路，任选其一：
- 导入商品：点「导入商品」，弹出物料选择器（支持多选），勾选后确认。已存在的物料会被跳过，不会重复建台账行。
- 同步新商品：点「同步新商品」，确认框提示「确认同步新商品？」。系统把物料档案里未删除且允许外购/外销控制为开的新物料补进台账。
- 自动补齐：打开本页时系统会先静默执行一次「同步新商品」，所以新物料通常不需要手工点。
步骤 2：定外卖价与平台标记
在列表里直接改「价格」，并把要上的平台开关打开。判定标准很简单：开关关着的平台，这个商品不会出现在该平台的门店商品里，分店外卖商品 也搜不到它。
步骤 3：定库存口径
| 组合 | 效果 |
|---|---|
| 自动同步库存 = 开，使用虚拟库存 = 关 | 按门店实时库存上报，卖完自动估清 |
| 自动同步库存 = 开，使用虚拟库存 = 开 | 上报固定虚拟值（999），不受门店库存影响，适合现做现卖、库存不准的商品 |
| 自动同步库存 = 关 | 不推库存，平台侧库存由门店自己维护 |
| 最低库存 > 0 | 门店库存低于这条线时不再上报为在售 |
步骤 4：清理不再卖的商品
点「清理失效商品」，确认框提示「确认清理已删除/停售的商品？」，执行后回显「已清理 N 条失效商品」。清理条件是物料已打删除标志或停售控制关闭，台账行会被删掉。
四、字段详细说明
| 界面字段 | 落库字段 | 含义 |
|---|---|---|
| 美团外卖 | fIsPost | 是否上美团外卖 |
| 淘宝外卖 | fIsElmPost | 是否上淘宝闪购（饿了么系）。模型里叫「淘宝外卖」、列表筛选写「淘宝外卖」、分店页的平台单选写「淘宝闪购」、映射弹窗里写「饿了么」，指的是同一个开关 |
| 京东外卖 | fIsJd | 是否上京东秒送 |
| 企迈 | fIsQM | 是否上企迈渠道 |
| 价格 | fPrice | 外卖售价 |
| 自动同步库存 | fIsAutoStock | 是否按门店库存自动更新平台库存 |
| 使用虚拟库存 | fIsVirtualStock | 是否用固定虚拟库存上报 |
| 最低库存 | fLowFinalQty | 允许在售的最低库存线 |
台账落在 WM_Materiel 表，主键是物料 ID，一个物料一行；类别、规格、条码、进价等列是查询时从 PCode_Materiel、PCode_MateClass 联出来的，不写在本表。
五、典型使用场景
场景一：新品上架外卖。 物料建好后直接打开本页，新物料已经在列表里（打开页面即自动同步）。把外卖价填好、要上的平台开关打开即可，无需点「同步新商品」。
场景二：蛋糕类不做库存限制。 现做商品门店库存常年不准，就把「自动同步库存」开、「使用虚拟库存」一起开，平台侧永远显示有货，实际由门店接单后判断能否履约。
场景三：某商品只上美团不上京东。 只在「美团外卖」列留开关，把「京东外卖」关掉。分店页里该商品的京东状态会一直是「未绑定」。
六、权限控制与前置条件
- 页面权限名为「O2O业务-外卖接口-外卖商品」。该权限项在权限映射里被标注为客户端无对应菜单，实际不参与过滤，能进 O2O业务 的角色一般都能看到本页。
- 前置条件：门店已在分店档案里录好平台门店号（美团
fMTpoiId、饿了么fElmpoiId、京东fJD_FilialeNo）。平台侧的 shopId 就是 ERP 的分店 ID，所以本页和分店页都没有录入 appKey/appSecret 的地方，也不需要「测试连通」按钮——凭据由服务端网关与租户码自动取。 - 平台未启用时，相关操作会直接提示「平台 未启用」，京东参数缺失时提示「尚未配置京东平台参数!」。
七、常见问题
问：为什么列表是空的？ 答：台账只收录「允许外销控制为开」的物料。先到基础设置 → 物料管理确认物料的这个开关，再回本页刷新。
问：改了「价格」为什么平台上没变？ 答：本页只改台账价。要推到平台，到分店外卖商品 选门店和平台后做同步，台账改价不等于已下发。
问：「同步新商品」和打开页面自动同步会不会重复建数据？ 答：不会。已存在的物料会被跳过，同步只补差集。
问：「清理失效商品」会不会删掉只是暂时停售的商品？ 答：会。判定条件包含停售控制关闭，恢复销售后需要重新导入或等同步补回。