物料主数据同步实战：聚水潭商品到金蝶云星辰物料的统一编码与调度策略

这个策略解决什么问题

在零售与供应链一体化的项目中，电商前端系统的商品档案和 ERP 后端的物料档案长期「各管各的」。某零售企业就踩过这个坑：前端商品改了 SKU 名称，ERP 那边的物料档案没跟上，3 个月后做成本核算时两边对不上，财务追了一个礼拜才厘清。我们用轻易云数据集成平台做的第一条链路，就是把聚水潭的商品信息按规则统一映射到金蝶云星辰的物料档案，确保两边主数据同源同号。

数据流向与字段映射

数据流为单向 A→B：源系统 A 的商品档案经由轻易云中间层做清洗、转换，再写入目标系统 B 的物料档案。关键字段对照关系如下：

编码映射我们统一放在轻易云的「映射中心」集中管理，不在策略里硬编码，后续新增分类时改一处即可生效。

在轻易云上如何配置

整个策略在轻易云数据集成平台里拆成三个可视化组件拼装：

1. 源取数器：对接聚水潭的商品档案接口，按更新时间增量拉取。增量键建议用 last_update_time，不要用 create_time，否则历史修改会被漏掉。
2. 数据转换器：用轻易云的字段映射 + 脚本节点完成编码拼接、单位换算、分类 ID 翻译。脚本节点支持 JS 语法，遇到多条码合并时写几行循环就够了。
3. 目标写入器：调金蝶云星辰的物料保存接口，注意区分「新增」与「更新」两个动作，轻云平台会根据物料编码是否存在自动分流。

另外两个常见配置：

• 失败重试：在轻易云上把重试次数设为 3 次，间隔按指数退避（30s/2min/5min），避免瞬时网络抖动把整批数据打回。
• 告警回调：配置企业微信或钉钉机器人，单条失败立刻推送，不要等整批跑完才通知。

实施步骤

我们把这个策略上线分三步走，配合轻易云的调度器组合使用：

1. 增量起点初始化：先用一次性全量把现有商品档案铺到金蝶，作为后续增量的基准。轻易云的「全量触发」按钮会跑一次完整同步，跑完后自动切换到增量模式。
2. 增量调度上线：把调度频率设为每 15 分钟一次。轻易云调度器按固定窗口触发，第一次跑会把过去 15 分钟内变化的商品全部抓走。
3. 历史数据补传：对于全量跑完后又修改过但被漏掉的少量数据，再用轻易云的「按条件补传」功能手动触发一次，按最后修改时间过滤。

调度时间窗口建议避开业务高峰，例如安排在凌晨整点跑全量、营业时段跑高频增量，避免占用源系统资源。

踩坑复盘

1. 增量键选错是头号翻车点：早期我们用 create_time 做增量键，结果商品改名、改规格都漏掉。稳妥做法是用 update_time，并且每次跑完后把最大时间戳落库，作为下次拉取的起点。
2. 编码前缀忘了统一：两个系统编码长度不一致，金蝶那侧物料编码有严格位数校验。必须先在轻易云映射中心定义好前缀规则，再做拼接。
3. 单位映射散落在脚本里：把单位映射表直接写在 JS 脚本里，新增单位就要改代码。规范做法是把映射表上传到轻易云的「辅助数据」里维护，脚本只做查表。
4. 条码字段被覆盖：聚水潭一个商品多个条码时，如果写入器只传一个字段，后面的会把前面的覆盖掉。需要在轻易云做循环拆分，逐条写入金蝶的条码子表。
5. 没做幂等导致重复物料：网络重试时容易触发重复写入。轻易云的写入器默认按主键做幂等，但前提是源系统主键稳定，不要在中间层随意变换。

适用场景与不适用场景

适用：电商前端商品档案需要统一进入 ERP 物料主数据的中小型零售企业，商品分类稳定、变更频率可预测。不适用：源系统商品字段频繁大改、目标 ERP 已停用物料档案维护、或者业务要求双向同步（这需要单独的反向链路策略，不能复用本方案）。