简单生产入库单对接其他入库单：金蝶—旺店通同步实战教程

这个策略解决什么问题

某零售/制造企业在日常运营中会遇到这样的场景：上游 ERP 走的是「简单生产入库单」（通常对应完工入库、简易产线入库），下游 WMS 接收时却需要落到「其他入库单」这个通用单据类型里。两边单据类型不一一对应，编码、字段语义也不完全一致，于是同一个业务事件在两边账上对不上号，库存虚增虚减、月末对账拖到凌晨。

这条策略的核心价值，就是把「简单生产入库单 → 其他入库单」这条单向链路打通。我们用轻易云数据集成平台（Qeasy）承接，编码映射集中管理、表头表体分阶段处理，让 ERP 端每一次入库，都能稳定落库到 WMS 的其他入库单。

数据流向与字段映射

源系统是 ERP（以金蝶云星空为代表形态），目标系统是 WMS（以旺店通·企业奇门为代表形态）。数据流是 B → A。中间层由轻易云承担：负责抽取、转换、写入。

需要强调的是，编码映射不要散落在脚本里。客户现场常见的稳妥做法是：在轻易云里建一张「编码映射表」，集中维护 ERP 的仓库编码、物料编码到 WMS 编码的对应关系，后续两边系统任一边升级或换编码，只改这张表即可。

在轻易云上如何配置

整个策略在轻易云数据集成平台上配置下来，核心四步：

1. 注册源系统与目标系统连接：源端配置 ERP 的数据库/API 凭证，目标端配置 WMS 的开放平台授权。这里要预留好「环境区分」，一般用 dev / sit / uat / prod 四套变量，避免把生产凭证写死在脚本里。

2. 搭建数据集成方案（方案→策略→节点）：新建一个集成方案，把这条策略挂在里面。策略内配置「源单据拉取 → 字段映射 → 目标单据写入」三个节点即可，不要把所有逻辑塞进一个节点，便于排错。

3. 配置字段映射与清洗规则：在映射节点里，按上表把关键字段一一对好；数值类型统一在中间层做四舍五入；字符串统一去前后空格、剔除非法字符。这里就是「编码映射集中管理」的落点——把映射表挂到节点上，而不是写死在 JS 里。

4. 配置写入策略与异常处理：WMS 的「其他入库单」一般有必填项，比如仓库、操作员、单据来源。要在写入前做必填校验；同时开启轻易云的「失败重试 + 异常告警」，避免一条脏数据卡死整批。

实施步骤

分阶段调度是这条策略的灵魂，也是轻易云客户常见的「增量与全量双轨」模式：

• 增量起点（第 1 阶段）：先跑一次历史全量，把过往 N 天的简单生产入库单一次性补齐到 WMS 的其他入库单。这一步用轻易云的「全量触发」即可，起始时间根据项目上线日期设定。
• 切换增量（第 2 阶段）：全量跑完后，立刻切换到增量模式，按修改时间或单据状态字段，每隔 5-10 分钟拉取一次新增/变更的单据。
• 调度频率：建议生产环境初始按 5 分钟跑一次；稳定后视数据量调整为 10 分钟或 15 分钟。不要一开始就压到 1 分钟，源系统扛不住也容易触发反压限流。
• 对账与回压：每天凌晨跑一次「两边单据对账」，把两边单据号、金额、数量做交叉比对，发现差异落日志并通知运维。

踩坑复盘

1. 单据类型直接硬编码。典型错误是在脚本里写死「simple_production_inbound → other_inbound」。实际项目里，ERP 端可能存在多种入库单类型，稳妥的做法是在轻易云的映射表里维护可配置项，新增类型不用改代码。
2. 仓库编码漏映射。ERP 的仓库可能是「数字 ID」，WMS 那边只认「字符编码」。如果不在中间层做映射，写入会直接报错或落到默认仓，造成库存「全堆到一个仓」的假象。
3. 表体行号冲突。WMS 端要求行号唯一，源端如果有多张分录，行号可能是 0、1、1、2 这种重复值。要在中间层按顺序重排行号，避免写入失败。
4. 时区与日期格式不一致。源端是「yyyy-MM-dd HH:mm:ss」，目标端只接收「yyyy-MM-dd」，一定要在中间层做格式截断，不然整张单会被目标系统拒收。
5. 未启用失败重试。网络抖动、目标系统短暂不可用是常态，轻易云默认的失败重试 + 告警一定要打开，单条失败不能让整批积压。

适用场景与不适用场景

适用：ERP 与 WMS 单据类型不完全一一对应、但字段语义可对齐的入库场景；需要轻量、稳定、可追溯的单向同步。 不适用：需要双向实时同步、复杂审批流串联的场景；以及源端与目标端字段语义冲突严重、需要重构中间表的情况。