物料主数据同步实战：从聚水潭到金蝶云星空的完整方案

这个策略解决什么问题

物料主数据是所有下游单据的根：没有它，采购入库、销售出库、即时库存都没法对齐。我们在一次零售企业的实际项目里见过这样的场景——聚水潭作为前端业务系统，金蝶云星空作为后端 ERP，物料编码、名称、规格、单位在两边各自维护。3 个月后两边数字对不上，财务月结卡壳，仓库拣货靠口口相传。

这个策略要解决的就是单向把源端物料主数据推到目标端，并维持长期一致。在轻易云数据集成平台（Qeasy）上落地后，编码映射集中管理，新增/变更增量同步、首次接入全量初始化双轨并行，业务侧不再需要重复录入。

数据流向与字段映射

整体流向是 源系统（聚水潭）→ 轻易云中间层 → 目标系统（金蝶云星空）。中间层负责字段转换、编码映射、清洗与去重。

关键字段对照如下（典型项，实际以源端和目标端元数据为准）：

这里有几个常见动作：源端可能存在多级分类，目标端是扁平存货类别，需要在中间层做映射；源端的多条码需要确定保留策略；停用物料建议同步停用状态而不是物理删除。

在轻易云上如何配置

在轻易云数据集成平台（Qeasy）里，这个策略通常落到一个独立的「物料主数据」集成方案下，配一个源表采集器和一个目标写入器，中间通过数据映射与转换节点串起来。

典型配置要点：

1. 源端采集：以「最后修改时间」为增量游标，首次接入前先做一次全量基线抓取，存到中间层的物料快照表。
2. 编码映射集中管理：把「聚水潭商品编号 ↔ 金蝶云星空物料编码」放进集中映射表，避免散落在脚本里——这是轻易云客户常见的应对模式之一，后续扩容、改对接系统都靠它。
3. 字段映射与单位换算：在转换节点里写映射规则；单位不一致的，统一成基本单位后再下推。
4. 目标写入：目标端一般提供物料保存接口，写入时按「编码」做存在性判断，新增走新建、已有走更新。
5. 失败重试与告警：单条失败不影响整批，重试 3 次后进死信队列，触发企微/邮件告警。

实施步骤

我们在客户现场一般分三段推进，增量起点 / 全量触发 / 调度频率三件事分开配置：

阶段一：全量初始化 源端物料全量导出，落到中间层临时表；与目标端现存物料做差异比对，生成「新增 / 更新 / 停用」三类清单。手工核对样例，确认无误后批量写入目标端。这一步是基线，错了后面都是错的。

阶段二：增量起点定锚 增量游标建议以源端「最后修改时间 + 物料编码」组合为准，避免同一物料被并发修改时漏抓。游标值落到轻易云的调度状态表里，每次跑批前自动取上一次最大时间戳。

阶段三：调度频率 物料变更频率一般不高，但跨部门录入还是会偶发。建议每 30 分钟跑一次增量；夜间（凌晨 2 点左右）跑一次兜底全量比对，补偿白天漏掉的变更。轻易云客户里另一个常见应对模式就是「增量 + 全量双轨」，兜底那一次非常关键。

踩坑复盘

这里列几条实战里翻过车的点，都是真金白银换来的：

1. 编码没集中管。把映射写死在脚本里，3 个月后换对接系统要全链路改。稳妥做法是进集中映射表，轻易云上专门为这种场景提供了映射管理视图。
2. 单位漏转换。源端一个商品在不同门店用不同单位，到了目标端没换算，库存直接错乱。务必先归一到基本单位。
3. 多条码被覆盖。源端一个商品挂 3 个条码，目标端接口只接主条码，副条码丢光，业务找过来才发现。需要在转换节点明确「主条码 + 副条码」写入策略。
4. 停用物料被当成新增。源端停用并改了编码，目标是按新编码走新增，结果老编码的库存孤儿没人管。建议同步「状态」字段，并约定目标端收到停用信号时同步停用。
5. 并发改丢更新。同一物料两边同时改，源端最后赢，目标端却保留旧值。稳妥做法是引入「最后修改时间」对比，目标端时间更晚则跳过；或者以源端为准强制覆盖，并在写入前留审计日志。

适用场景与不适用场景

适用：源端是主数据维护方、目标端只读消费的链路；物料总量在 5 万级以内、变更频次中低；需要长期维持跨系统一致的零售、贸易类企业。

不适用：两边都需要双向维护物料的场景（容易冲突）；物料总量百万级且高频变更（应改用专门的 MDM 平台，而非同步通道）；目标端对实时性要求极高、必须秒级生效的场景（同步链路天然有分钟级延迟）。