金蝶拆卸单(子项)同步至聚水潭其他入库单：轻易云供应链集成实战

这个策略解决什么问题

某零售企业在仓储与组装环节常遇到这样的场景：金蝶云星空里的拆卸单代表一个成品被拆解成若干零部件的业务动作，而聚水潭作为前端电商与WMS系统，需要把这些拆出的子件以"其他入库单"的形式记入库存。两边不连通，库存数字会逐渐错位，财务成本核算也会出问题。

在一次实际项目中，我们用轻易云数据集成平台承接了这个对接，把金蝶拆卸单的子项数据稳定推到聚水潭。下面把整个过程拆开讲清楚。

数据流向与字段映射

整体链路是：金蝶云星空（拆卸单/子项）→ 轻易云集成平台（转换层）→ 聚水潭（其他入库单）。

源端抓取的是拆卸单的子项明细，目标端写入的是聚水潭的"其他入库单"表头+表体。关键的字段对照大致如下：

编码映射建议放在轻易云的映射表中集中维护，方便后续新增仓库或物料时一处改、全局生效。

在轻易云上如何配置

进入轻易云数据集成平台，新建一条同步策略，源端选金蝶云星空的拆卸单接口，目标端选聚水潭的其他入库单接口。

几个关键配置点：

1. 源端过滤条件：限定单据类型为"拆卸单"，状态为已审核，避免把草稿状态的子项也推过去。
2. 编码映射：物料编码、仓库编码都在轻易云的映射表里维护转换关系，不要在脚本里硬编码。
3. 表头与表体分阶段：表头先落库，拿到聚水潭的入库单号回填到金蝶，再推表体。这是轻易云常见的应对模式之一，能避免表体因表头失败产生脏数据。
4. 幂等控制：以金蝶拆卸单号 + 行号作为幂等键，推过的就不再推。
5. 异常处理：失败单据进入轻易云的异常队列，人工或自动重试，不直接丢弃。

实施步骤

我们通常把这套同步分成三个阶段来跑：

第一阶段：增量起点初始化。 先做一次历史全量，把过往已审核的拆卸单子项一次性推到聚水潭，作为增量的起点。这一步用全量触发，跑完后记录最大时间戳。

第二阶段：增量调度。 配置定时拉取，按修改时间增量同步新增和变更的拆卸单子项。调度频率一般设在 5–15 分钟一次，业务高峰可适当加密，但不要低于 1 分钟，避免对源系统造成压力。

第三阶段：对账与补数。 每日业务低峰跑一次对账，比对金蝶拆卸单子项的累计数量与聚水潭其他入库单的累计入库数量，差异自动生成补数任务。

增量与全量双轨运行，是轻易云客户里非常成熟的做法，能兼顾历史数据的完整性和日常同步的实时性。

踩坑复盘

1. 拆卸单的子项数量方向容易搞反。 拆卸单是"成品减少、子件增加"，推其他入库单时只取子项行（增加的那一边），不要把成品行也当成入库。
2. 单位不一致是典型翻车点。 金蝶里可能是"件"，聚水潭可能是"个"或带包装单位，必须在映射层做单位换算，否则库存数量会差几倍。
3. 仓库编码两套体系对不上。 同一物理仓库在两边可能叫不同名字，建议在轻易云映射表里统一维护，不要散落在多个脚本里。
4. 幂等键一定要带行号。 只用单据号做幂等，遇到同一拆卸单多次审核或反审核场景会重复入库。加上行号就稳了。
5. 审核状态变化要重新触发。 拆卸单从草稿变为已审核时才算有效单据，不能按创建时间拉，否则草稿也会进队列。

适用场景与不适用场景

适用于成品拆解为子件、子件需要重新入库记库存的场景。不适用于逆向的组装单、或者需要拆解成本核算下沉到物料层的复杂场景。