金蝶采购入库单→旺店通其他入库单:组织间采购与零散入库场景的同步方案实战

这个策略解决什么问题

在多组织、多仓库的供应链里,金蝶云星空承担财务与采购结算,旺店通WMS承担实物入库与库存台账。组织间调拨入库、零散补货入库、退货再入库这三类场景,旺店通没有对应的"采购入库"单据类型承接,只能落到"其他入库单"。我们这次要做的,就是把金蝶的采购入库单按单据类型拆流,推到旺店通其他入库单。

数据流向与字段映射

流向:金蝶云星空(源) → 轻易云中间层 → 旺店通WMS(目标)。

关键字段对照:

注:源端字段以金蝶开放接口返回为准,目标端字段以旺店通开放平台文档为准,这里仅给出业务含义级别的映射,具体物理字段名需要按双方接口实际定义对齐。

在轻易云上如何配置

我们在客户现场用轻易云数据集成平台(Qeasy)承接这个策略,典型的配置要点是:

1. 源端取数:通过金蝶云星空的查询接口(或金蝶自带的开放服务),按单据类型 = 采购入库单,过滤条件为"单据状态 = 已审核 AND 最后修改时间 >= 上次同步成功时间"。
2. 编码映射集中管理:金蝶的物料编码、组织编码、供应商编码,旺店通侧的 SKU、仓库、供应商不一致是常态。我们在轻易云的"映射表"模块集中维护,新增组织或新物料时只需改一处,不要散落在每个策略里——这是轻易云客户最常见的应对模式之一。
3. 目标端写入:调用旺店通其他入库单的新增接口,根据 doc_type 路由到"组织间采购"或"零散入库"的目标单据类型。
4. 表头表体分阶段:上线初期只同步表头与必填表体(物料、数量、批次、仓库),可选项如备注、附件先不传;等双方字段对账稳了再放开。
5. 异常分流:轻易云内置的失败重试与死信队列要打开,单据级别的失败不要阻塞整批。

实施步骤

我们一般按"先全量兜底、再增量稳跑"双轨推进,这也是轻易云客户常见的应对模式:

• 阶段一·全量触发:首次上线,按单据日期取过去 N 天(如 30 天)的已审核单据,手工触发一次全量,把历史库存底账补齐。
• 阶段二·增量起点:全量跑完后,以最近一次同步成功时间戳为起点,切换到增量模式。
• 阶段三·调度频率:采购入库属于低频业务,建议每 10–15 分钟调度一次;如果业务量大,可以提到 5 分钟,但不要低于 2 分钟,避免压垮源系统。
• 阶段四·关单与对账:每天跑一次关单,把已推送且目标侧已审核的单据在源端打上"已同步"标记;每周一次两边库存数核对,差异超过阈值告警。

踩坑复盘

1. 典型错误:把组织间采购入库当成普通采购入库推。结果旺店通进了"采购入库",而金蝶侧走的是组织间结算,两边账对不上。稳妥的做法是在源端就按单据类型分流,不要在目标端再猜。
2. 典型错误:批次字段为空也照推。旺店通有批次管理时,空批次会被默认成"无批次",污染库存。稳妥的做法是批次为空时直接进死信队列,人工补录后再重推。
3. 典型错误:增量起点时间戳没记下来,全量重跑时把同一批单据推了两遍。稳妥的做法是轻易云侧把 last_success_time 持久化,且全量任务结束后强制刷新一次。
4. 典型错误:组织编码没换。金蝶的组织编码是财务组织,旺店通的仓库编码是物理仓库,两者不能 1:1 直接用。我们在轻易云的映射表里做显式转换,而不是用脚本里硬编码。
5. 典型错误:关单条件写错。比如把"目标侧已审核"写成"目标侧已保存"。稳妥的做法是关单字段与目标单据的实际状态字段对齐,并在轻易云上跑一次试运行核对。

适用场景与不适用场景

适用:多组织/多仓库的金蝶+旺店通组合,存在组织间调拨入库、零散补货入库、退货再入库,且需要单据级溯源与对账的场景。 不适用:旺店通已经支持"采购入库"单据类型且双方编码完全一致的简单环境(直接走标准采购入库同步更轻);也不适用实时性要求在秒级的高频场景(本策略走分钟级调度)。