分店外卖商品

分店外卖商品是外卖业务的逐店逐平台操作台：总部在外卖商品 圈好哪些商品可以上外卖之后，具体到某家门店、某个平台，商品到底在不在售、库存报多少、平台商品和本地物料对不对得上，都在这里处理。

一、功能概述

菜单位置：O2O业务 → 外卖管理 → 分店外卖商品（页面地址 /admin/waimai/wmstoreproductpage/）

用途	说明
看状态	一个商品在美团/淘宝/京东/企迈/微商城各渠道分别是在售、售罄、已下架还是未绑定
改状态	批量估清、置满、上架、下架
对商品	用「商品映射」把平台上的商品和本地物料一一对上，或按条码自动匹配
补数据	从平台同步新商品、清理平台侧已失效的商品

本页不建商品，只改状态和绑定关系。 商品能不能上外卖由外卖商品 的平台开关决定；本页出现不了的商品，先回台账检查。

二、界面布局说明

区域	内容
查询条	分店（下拉，默认公司总部）；平台（单选：所有平台 / 美团外卖 / 淘宝闪购 / 京东秒送 / 企迈 / 微商城）；搜索（匹配方式 包含 / 等于 / 开头为 / 结尾为 / 不等于 / 不包含 / 介于，输入框提示「名称/编号/条码」）；分类（下拉，默认「不限」，选项由页面按所选分店动态加载）；绑定（全部 / 已绑定 / 未绑定）；查询、重置
工具栏	批量操作下拉 + 平铺按钮，按所选平台显隐，见第三节
计数行	「共 96 条，第 1-96 条」
列表	勾选框、排序柄、商品图片、分类、商品名称/条码、价格、库存、平台状态
底部统计	「共 X 件商品 | 已绑定 X 件 | 未绑定 X 件」
分页	每页 200 条

列说明

列	显示规则
商品图片	平台侧图片；取不到图时显示占位文字「无图」
商品名称/条码	主行是「商品名称（规格）」，副行是 SKU 或条码
库存	空值显示 ----；值为 -1 显示「不限」；开启虚拟库存时副行标「虚拟」
平台状态	「所有平台」视图下是五枚徽标（美团/淘宝/京东/企迈/微商城）；选中单一平台后只显示该平台的状态

徽标颜色与含义：

颜色	文案	含义
蓝	在售	平台上架且可售
黄	售罄 / 已估清	库存上报为 0，顾客看到「已售完」
红	已下架	平台上架状态被关闭
灰	未绑定	本地物料还没和平台商品对上

三、业务操作步骤

步骤 1：选分店和平台

先选分店，再选平台。平台决定两件事：列表显示哪一列状态，以及工具栏留下哪些按钮。

平台	可见按钮
所有平台	估清、置满、上架、下架、商品映射、自动匹配、清理失效
美团外卖 / 淘宝闪购 / 京东秒送	同步商品、估清、置满、自动置满、上架、下架、商品映射、自动匹配、清理失效
企迈	估清、置满（企迈不支持真正的上架/下架）
微商城	估清、置满（微商城是本地渠道，无同步、无映射）

步骤 2：把平台商品和本地物料对上

这是第一次接入门店时必须做的动作，没绑定的商品状态永远是灰色「未绑定」，任何状态操作都不会下发到它。

• 自动匹配：点「自动匹配」，确认框提示「确认按条码/编号自动匹配绑定？」。匹配优先级是先条码、再物料编号，不比对名称，避免同名不同货被错绑。执行后回显「映射成功 N 件 / 共 M 件」。
• 商品映射（手工）：点「商品映射」打开弹窗，标题为「商品映射 · 平台名」。
  • 左侧是平台商品，页签为 全部 / 已映射 / 未映射 / 异常，各带件数；「异常」页签只有美团有，异常行标「条码异常」。
  • 右侧是本地商品搜索框（输入即搜，约 0.3 秒防抖）。
  • 操作提示原文：「点击左侧平台商品选中，再点击右侧本地商品完成映射」。
  • 顶部按钮：自动匹配并映射、解除映射、关闭。
  • 只有美团外卖、淘宝闪购、京东秒送支持映射；在企迈或微商城下打开会提示「当前平台不支持映射（仅 美团/淘宝闪购/京东）」。
  • 常见提示：未选分店「请先选择分店」；未选左侧行「请先点击左侧平台商品选中」；对没绑定的行解绑「该商品尚未映射」；解绑确认「确定解除该商品的映射？」；自动匹配确认「确定要自动匹配并映射商品？」；平台或本地数据取不到时「平台商品加载失败」「本地商品加载失败」。

步骤 3：批量改销售状态

勾选若干行后点按钮。未勾选时统一提示「请先勾选商品」。

按钮	做什么	说明
估清	把该行库存报成 0	顾客端立刻显示售罄，但商品还在架上
置满	按门店实时库存（或虚拟库存值）重新上报	恢复售卖的常规做法
自动置满	只更新本地库存口径	三个平台都不会向平台发请求，属于本地动作
上架	打开平台上架状态	京东的下架/上架在网关侧存在已知不一致，见常见问题
下架	关闭平台上架状态	与「估清」不同：下架是整条商品不可见

步骤 4：同步与清理

• 同步商品：确认框「确认从平台同步新商品？」。美团、淘宝同步后会自动再跑一次匹配，回显「同步完成，自动匹配 X/Y 件」；其余平台回显「同步完成」。
• 清理失效：确认框「确认清理已删除/停售的商品？」，回显「已清理 N 条失效商品」。

「所有平台」视图下不能同步，会提示「all 视图不能执行同步」；企迈和微商城会提示「该平台无需同步」。

四、字段详细说明

界面项	取值	含义
平台	all / meituan / taobao / jd / qimai / wechat	淘宝闪购在代码里与饿了么同源，两处名字指同一渠道
绑定	全部 / 已绑定 / 未绑定	是否已建立平台商品与本地物料的映射
平台 SKU 键	美团取 fOriginSkuId、京东取 fSkuId、淘宝/饿了么取 fItemId	映射与解绑时定位平台商品的依据

五、典型使用场景

场景一：早上开店，把现烤商品全部置满。 选分店 + 选平台，把「绑定」筛成「已绑定」，全选后点「置满」。

场景二：某款蛋糕今天不做了。 勾上它点「估清」，顾客端立即显示售罄，但不影响其它商品；明天恢复用「置满」。

场景三：新接入一家美团门店。 先在该分店下点「同步商品」把平台商品拉进来，再用「自动匹配」按条码批量绑定，最后到「商品映射」弹窗的「未映射」页签里手工补齐剩下的。

六、权限控制与前置条件

• 本页是网页端新增功能，权限映射里标注为「Django 新增，始终放行」，不参与权限过滤：能打开 O2O业务 的角色都能执行估清、上架、同步、清理失效等写操作。要限制到人，目前只能靠不分配该菜单入口。
• 前置条件：分店档案里已录平台门店号（美团 fMTpoiId、饿了么 fElmpoiId、京东 fJD_FilialeNo）。平台侧的 shopId 就等于 ERP 分店 ID，没有单独的密钥录入页和连通性测试按钮，凭据由服务端按客户码自动取。
• 平台开关：未在服务器上启用的平台，操作会提示「平台 未启用」；京东缺配置时提示「尚未配置京东平台参数!」。

七、常见问题

问：为什么「企迈」和「微商城」看不到上架/下架按钮？ 答：企迈渠道不支持真正的上下架，只能估清/置满；微商城是本地渠道，状态由本地库存决定，没有平台可下发。

问：自动匹配为什么把某些商品漏掉了？ 答：自动匹配只按条码、再按物料编号比对，刻意不比对名称以免同名错绑。漏掉的商品请到「商品映射」弹窗手工对一次。

问：京东点了「下架」，平台为什么还在售？ 答：京东的下架动作在网关侧存在已知不一致，可能只改了本地状态而未通知平台。稳妥做法是下架后同时做一次「估清」，并到平台商家端复核。

问：「自动置满」和「置满」有什么区别？ 答：「置满」会向平台上报库存；「自动置满」只更新本地库存口径，不向平台发请求，需要再点一次「置满」才会真正上报。

问：外卖订单在哪个页面查？ 答：网页端目前没有外卖订单查询、接口调用查询、订单错误日志查询、配送参数配置、分店/工厂地址管理这几个页面，它们只在客户端 ERP 的「O2O业务 → 外卖接口」下提供。网页端的外卖部分只做商品与状态维护。