开通与同步链路
要把 O2O业务 真正跑起来，光有页面不够：微信侧要授权、分店要录平台门店号、系统选项要打开、物料要满足上架条件。这一篇把开通顺序和数据往哪同步讲清楚，避免在某个页面里反复点「为什么没变化」。
一、开通顺序
按下面五步做，每步做完再进下一步。
步骤 1：微信与小程序侧
- 小程序商城已开通并绑定到本客户套账。
- 机构微信的 AppId 与加密密钥在服务端配好。这两项没配，任何「推广链接 / 生成链接」都会报错，见第四节。
- 微信服务地址（配置项
TWXOption.WXServiceUrl）已配置，否则推广链接同样出不来。
网页端没有录入 appKey/appSecret 的页面，也没有「测试连通」按钮——凭据由服务端网关按客户码自动取，实施阶段一次性配好。
步骤 2：分店档案录平台门店号
外卖相关操作全部依赖分店上的平台标识：
| 平台 | 分店档案字段 |
|---|---|
| 美团外卖 | fMTpoiId |
| 淘宝闪购（饿了么系） | fElmpoiId |
| 京东秒送 | fJD_FilialeNo |
平台侧的 shopId 就等于 ERP 的分店 ID，所以外卖商品 和分店外卖商品 两个页面里都找不到填密钥的地方。没录门店号的分店，在外卖页面上表现为该平台永远「未绑定」。
步骤 3：打开需要的系统选项
| 选项 | 影响 |
|---|---|
InviteCaseEnable | 不开时，拉新下单送券查询 直接提示「未开启【拉新下单送券】系统选项（InviteCaseEnable），无法查询」 |
平台未在服务器上启用时，相关操作提示「平台 未启用」；京东缺配置时提示「尚未配置京东平台参数!」。
步骤 4：物料满足上架条件
商品要能出现在商城或外卖台账里，前提条件不同：
| 目标页面 | 物料侧要求 |
|---|---|
| 网店商品（微信商城） | 物料未删除；所属分类的「允许上传到网店」开关打开（类别表 PCode_MateClass.fIsPostServer = 1） |
| 外卖商品（外卖台账） | 物料未删除且允许外购/外销控制为开 |
| 秒杀 / 拼团明细 | 类别启用配送 且 该商品在微信商城已上架 |
不满足时，导入或同步会静默跳过并回显原因，例如「以下商品未上架或类别未启用配送，已跳过：…」「商品编码【X】不存在或未上架（需类别启用配送且微信商品已上架）」。
步骤 5：配方案、上架、同步
到这一步才是在各功能页里干活：商城活动方案生效 → 商品上架 → 订单开始进来 → 线上订单处理。
二、三条同步链路
链路 A：微信商城商品
物料档案（PCode_Materiel）
↓ 打开页面时自动补齐 / 手工「导入商品」
网店商品（WX_Materiel） ← 定商城价、主图、规格、上架开关
↓ 单个「更新微信商城图片」/ 批量上下架
微信小程序商城关键点：WX_Materiel 是 ERP 侧的商城商品台账，微信侧的 fProductID / fCategoryId1~3 记录映射关系。台账改价不等于已下发到小程序，要看列表「是否上架」列的实际值。
链路 B：外卖商品
物料档案
↓ 同步新商品（打开外卖商品页时自动跑一次）
外卖商品台账（WM_Materiel） ← 定外卖价 + 美团/淘宝/京东/企迈平台开关 + 库存口径
↓ 分店外卖商品：同步商品 / 自动匹配 / 商品映射
分店 × 平台 的在售状态（估清、置满、上架、下架）关键点：总部台账只决定「有没有资格上这个平台」，逐店逐平台的状态在分店外卖商品 处理。台账改价同样不等于已下发，要到分店页做同步。
链路 C：活动 → 订单 → 查询
商城活动方案（生效）
↓ 推广链接 / 生成链接
小程序会员参与（签到 / 抽奖 / 秒杀 / 拼团 / 买券包 / 拉新）
↓
线上订单、卖券单、拉新记录
↓
线上订单 / 线上卖券单查询 / 拉新下单送券查询 / 拉新查询 / 分销员查询关键点：活动页只出方案，不查结果；查询页只读，唯一的写动作是卖券单的作废。
三、批量动作的幂等性
| 动作 | 重复执行会怎样 |
|---|---|
| 外卖商品「同步新商品」 | 已存在的物料跳过，只补差集，不会重复建台账 |
| 网店商品「导入商品」 | 同上，已存在的物料被跳过 |
| 分店外卖商品「自动匹配」 | 按条码→物料编号重跑一遍，不比对名称 |
| 外卖「清理失效商品」 | 会把停售控制关闭的商品也删掉，恢复销售后需重新导入或等下一次同步补回 |
四、报错对照
| 提示原文 | 缺什么 |
|---|---|
| 未配置微信服务地址（TWXOption.WXServiceUrl） | 服务端没配微信服务地址 |
| 未配置 AppId（TWXOption.FixedAppId 或机构微信 AppId） | 机构微信 AppId 缺失 |
| 未配置机构加密密钥（Srv_Pard.fEncryptKey） | 客户加密密钥缺失 |
| 请先保存商品明细后再生成推广链接 | 单据还没保存就点推广链接 |
| 平台 未启用 | 该平台在服务器上没开 |
| 尚未配置京东平台参数! | 京东参数缺失 |
| 未开启【拉新下单送券】系统选项（InviteCaseEnable），无法查询 | 系统选项未开 |
| 找不到pardguid | 登录态里没有客户标识，回 ERP 重新登录 |
| 模块404，模块未成功加载，详情看模块加载日志（log/adminLoad_*.log） | 模块注册未加载成功 |
五、常见问题
问：我要在哪里填美团/京东的 appSecret？ 答：网页端没有这个入口。平台凭据由服务端网关按客户码统一取，需要实施人员在服务端配置。
问：物料建好了，外卖商品页里为什么没有？ 答：外卖台账只收「允许外购/外销控制为开」的物料。先到基础设置 → 物料管理确认这个开关。
问：改了商城价，小程序还是旧价？ 答：台账价与平台侧是两回事。检查网店商品 的「是否上架」列实际值，必要时重新做一次上架/更新图片动作。
问：新加的秒杀商品导不进来？ 答：先看该商品的微信商城上架状态和类别的「启用配送」，两个条件缺一个都会被跳过并提示。