网店商品

网店商品是微信小程序商城的商品发布台账：ERP 物料档案里的东西要变成小程序上能买、能自提、能配送的商品，全部在这一页配置。它不新建商品——商品来自物料档案，本页只决定哪个商品上不上架、微信价多少、库存怎么算、支持哪些下单方式。

一、功能概述

菜单位置：O2O业务 → 微信商城 → 网店商品（页面地址 /admin/o2o/wx_materiel/）

用途	说明
按分类挑商品	左侧商品分类树点一个分类，右侧只列该分类下的商品
控制上下架	行内开关逐条改，或用工具栏「全部上架 / 全部下架」按当前分类批量改
定微信价	「微信价格」列单独维护，与门店标准售价互不影响
定履约方式	到店自提 / 商家配送 / 快递发货 三个开关，决定小程序上出现哪种下单入口
定预约提前量	到店自提、商家配送各设提前小时与提前分钟
维护规格与图片	抽屉里维护多规格（SKU）、主图、商品描述、拓展属性

本页没有「新增」按钮：商品行来自物料档案（PCode_Materiel），物料打上「允许上传网店」并落到 WX_Materiel 表后就出现在这里。同样，本页删行也不会删物料。

二、界面布局说明

区域	内容
左侧分类树	顶部「搜索分类...」输入框，下面按「编号-名称」列出允许上传网店的商品分类，例如 01-蛋糕类、012-儿童乐园、78-商城配送
工具栏	全部下架（橙色）、全部上架（绿色）两个按钮
列表	物料信息为只读列，微信属性为可行内编辑列；每个开关列的表头自带一个筛选下拉（全部 / 是 / 否）
行编辑入口	点行打开右侧「物料详情」抽屉，抽屉里分页签维护全部属性
分页	「显示 N-M 共 X 行」，每页 10 / 20 / 50 / 100 条

只有分类树里能出现的分类才有商品：分类必须打了「允许上传服务器」标记（PCode_MateClass.fIsPostServer = 1）且未打删除标志，按分类编号排序。物料自身打了删除标志的也不会出现。

三、业务操作步骤

步骤 1：确认物料有资格成为网店商品

商品能不能进这一页，取决于两处开关：

1. 基础设置 → 商品分类：分类勾上「允许上传网店」。
2. 基础设置 → 物料管理：物料录好，条码、规格、单位齐全。

两处都满足后，到本页点左侧对应分类，商品就会列出来（尚未配置过的商品，微信侧属性为空，需要现场补）。

步骤 2：配置单个商品

点行打开抽屉，按页签填：

页签	填什么
表格	是否上架、新品上市、热销商品、推荐商品、到店自提、商家配送、快递发货 七个开关；累计销量、累计好评、排序、最低库存、使用分店实时库存
商品信息	商品标题、商品描述、微信价格、运费、商品库存、限购件数、是否显示商品库存、商家配送/到店自提的预约提前小时与提前分钟、预约提前是否按分店每日开始营业时间计算
商品信息(图) / 产品主图片	商品详情图与主图
规格 / 自定义规格	多规格（尺寸、口味），支持「导入规格」从别的物料整套搬过来
产品拓展 / 产品明细	拓展属性（名称、类型、是否必填）
区域/分店	该商品在哪些分店可售
支持的应用类型	勾选 1 小程序商城 / 2 在线商城 / 3 桌台扫码 / 4 自购GO / 5 蛋糕自选

改完点抽屉里的「保存」，回显「保存成功」。「支持的应用类型」这一组勾选直接决定商品在哪个前端露出——只在小程序商城卖就别勾在线商城。

步骤 3：批量上下架

先在左侧点中一个分类，再用工具栏：

• 全部上架：确认框「确认将所有商品上架？」→ 确定后把当前分类下的商品整体上架。
• 全部下架：确认框「确认将所有商品下架？」→ 确定后把当前分类下的商品整体下架。

没有勾选行时会提示「请选择要下架/上架的物料」；未选中分类时提示「请传入分类ID参数（fclassids）」或「分类ID列表不能为空」。

步骤 4：核对小程序

配置保存后到小程序端刷新分类页查看。图片另有单独通道上传：在菜单面板里点「更新微信商城图片」图标，界面提示「正在更新微信商城图片...」，完成后回显「图片更新请求已提交，后台正在执行上传，请稍后刷新查看」——图片不是保存即生效，要等后台上传。

四、字段详细说明

界面字段	落库字段	含义与取值
商品分类	fClassID	只读，左侧树选中的分类；分类名联 PCode_MateClass
商品编号 / 商品名称 / 单位 / 条码 / 进价 / 标准售价	PCode_Materiel	只读，来自物料档案
商品标题	WX_Materiel.fTitle	小程序上显示的名称，可与物料名称不同
商品描述	fDesc	详情文字
是否上架	fIsDelisting	模型里这个字段的中文名就叫「是否上架」，默认否
新品上市 / 热销商品 / 推荐商品	fIsNew / fIsHotSale / fIsRecommend	小程序上的角标与推荐位
到店自提 / 商家配送 / 快递发货	fIsDistill / fIsDeliver / fIsExpress	决定该商品支持哪几种履约方式
微信价格	fPrice	小程序售价
商品库存	fQuantity	商品总库存
允许在售最低库存	fMiniStock	低于该值不应再售
使用分店实时库存	fIsShopStock	开启后不按本列库存，改取分店实时结存
到店自提提前小时 / 提前分钟	fDistillHour / fDistillMinute	自提需提前多久下单
商家配送提前小时 / 提前分钟	fDeliverHour / fDeliverMinute	配送需提前多久下单
预约提前按分店每日开始营业时间算	fDistillTimeLimit / fDeliverTimeLimit	自提、配送各一个开关
限购件数	fBuy_quota	单个会员最多买几件
运费	fPost_fee	配送运费
是否显示商品库存	fHide_quantity	字段语义是「是否隐藏商品库存」，勾上后小程序不露剩余件数
累计销量 / 累计好评 / 排序	fSaleCount / fFavourateCount / fIndex	展示与陈列顺序
支持的应用类型	fSupportApps	1 小程序商城 / 2 在线商城 / 3 桌台扫码 / 4 自购GO / 5 蛋糕自选
商品规格	fSku + WX_MaterielUnits	规格名称、价格、结存数、是否发布、是否推荐选项、分销提成类型与提成值
多规格 SKU	WX_MaterielSKU	SKU 名称、价格、库存、是否发布、是否主 SKU、佣金模式与佣金值；WX_MaterielMateSku 记录物料实际启用了哪些 SKU
产品主图片	fMainImage / fMainImageURL / fMainThumbnail / fImageCRC32 + WX_MaterielMainImage	大图、缩略图与图片校验码
产品拓展	WX_MaterielExpand	属性标题、类型、是否必填
区域/分店	WX_MaterielFiliale	物料与分店的多对多，同一物料同一分店只允许一条
产品明细	fRichView / fDetail_HTML	详情页的富文本与 HTML
是否上传到网店	fIsPost	物料是否已发布到网店的总开关

后台另有一个「界面初始化」接口：读取系统选项里的微信配送开关（WXAllowDistill / WXAllowDeliver / WXAllowExpress），并把历史上架标志为空的商品补齐、把规格与 SKU 数据回填——这是运维动作，界面上没有入口。

五、典型使用场景

场景一：蛋糕只允许自提。 「到店自提」开、「商家配送」「快递发货」关，同时把「到店自提提前小时」设为 4。小程序上这个商品就只出现自提入口，且要求至少提前 4 小时下单。

场景二：现烤面包按分店库存卖。 「使用分店实时库存」开，「商品库存」列留空不用管；每家分店卖自己的结存，总库存为 0 的分店会自动显示售罄。

场景三：月饼礼盒只在小程序商城卖，不进桌台扫码。 「支持的应用类型」只勾「小程序商城」。同一物料在收银台扫码点单里就搜不到。

场景四：新品批量上架。 新建一个「2026-月饼」分类，物料全部挂进去，本页选中该分类后点「全部上架」，一次放行整批。

六、权限控制与前置条件

• 页面权限名「O2O业务-微信公众号-网店商品」，在权限映射表里有对应的 ERP 菜单项：角色没勾这个菜单就进不来。
• 前置条件依次是：分店档案已开通微信商城相关参数、商品分类勾了「允许上传网店」、物料在商品分类下且未打删除标志。
• 图片走服务端上传通道，保存商品与图片上传是两件事；批量改图后需要手动触发一次「更新微信商城图片」。

七、常见问题

问：左侧分类树里找不到我要的分类？ 答：只有勾了「允许上传网店」的分类才会进树。到基础设置 → 商品分类补勾，回本页刷新。

问：改了微信价格，门店零售价会跟着变吗？ 答：不会。WX_Materiel 与物料档案分开存价，本页只影响小程序售价。

问：批量按钮完成后提示的措辞和行内开关不一致？ 答：以列表里「是否上架」列的实际值为准。批量操作是按当前分类整体赋值，若结果与预期相反，用行内开关逐条校正即可，不影响数据。

问：图片上传了但小程序上还是旧的？ 答：图片要经服务端批量上传，先在菜单面板执行一次「更新微信商城图片」，等提示的后台任务跑完再刷新小程序。

问：商品在这一页有，但小程序搜不到？ 答：按顺序查三处——「是否上架」是否为是、「支持的应用类型」有没有勾当前前端、分店维度的「区域/分店」里有没有该商品可售的门店。