金蝶收料通知单到旺店通采购订单同步实战教程

这个策略解决什么问题

在供应链系统集成里,「金蝶云星空里的收料通知单」和「旺店通里的外仓采购订单」通常是同一笔业务在两套系统中的不同表达。客户那边的现实场景是:采购方在金蝶里下采购订单、收料并生成收料通知单,但实际入库和结算由外仓在旺店通里完成,这就要求金蝶收料通知单上的物料、数量、批次等信息,能够可靠地落到旺店通的外仓采购订单上。一旦两边对不上,外仓收货混乱、财务对账卡壳,业务就停摆。

我们用轻易云数据集成平台(Qeasy)承接这条链路,核心价值是:把金蝶里的收料通知单,按既定规则转换为旺店通里「外仓」类型的采购订单,并保证两边编码、数目、批次口径一致。

数据流向与字段映射

整体流向是单向同步:金蝶云星空(收料通知单) → 轻易云中间层(清洗、映射、补字段) → 旺店通(外仓采购订单)。

中间层不存业务数据,只做转换。关键字段对照如下:

两张系统的物料编码往往不一致,我们采用「编码映射集中管理」的方式——把映射表维护在轻易云的「数据集」里,后续无论加物料还是改编码,只动一处,避免散落硬编码。

在轻易云上如何配置

在 Qeasy 上配置这条策略,我们遵循「源接入 → 转换 → 目标写入」三段式:

1. 源接入(金蝶云星空):通过轻易云的「金蝶云星空连接器」配置账套信息,采用增量接口按「最后修改时间」拉取收料通知单。这里要勾选「已审核」过滤条件,避免把草稿单据推过去。

2. 中间转换:在轻易云的「数据转换」节点里做三件事:字段映射、编码映射(含物料、供应商、仓库)、常量补字段(比如订单类型固定为「外仓采购订单」)。这一段通常用可视化映射 + 少量脚本表达式,便于后续维护。

3. 目标写入(旺店通):通过「旺店通连接器」调用其采购订单创建接口,采用「表头 + 表体」分阶段提交——先建表头拿到旺店通侧的采购单号,再逐行写表体。这种分阶段处理是轻易云客户常见的应对模式,可以避免一整张单据因某一行失败而全部回滚。

实施步骤

我们建议按「增量起点 → 全量触发 → 调度频率」分阶段上线:

第一步:确定增量起点。取客户生产环境最近一次成功对接的时间点作为初始游标,避免把历史几个月的数据一次性涌进来。这个游标要存到轻易云的「状态记录」节点里,断点续传靠它。

第二步:全量触发一次。上线前在测试环境用一次全量回灌,目的是校验编码映射、字段口径、库存组织。客户现场最常翻车的是这一步——全量跑通才敢切生产。

第三步:进入调度频率。建议每 10–15 分钟一轮增量,夜间再跑一次对账补单。这里的「增量 + 全量双轨」模式,也是轻易云客户常用的稳妥做法:白天高频增量保证时效,夜间全量兜底查漏。

第四步:上线后监控 1 周。重点关注丢弃率、空字段率、旺店通侧的拒单原因。

踩坑复盘

踩坑 1:草稿单据也同步过去了。金蝶的收料通知单有「暂存」「已审核」两种状态,如果不在源端过滤已审核,会把未生效的单子推到旺店通,造成外仓收货后金蝶侧单据又撤销,两边撕扯。稳妥做法:源端接口必加状态过滤。

踩坑 2:物料编码一对多。金蝶里一个物料可能在旺店通里挂了两个货品(比如不同包装规格),粗暴映射会导致数量错乱。稳妥做法:在映射表里用「金蝶物料 + 收料仓库」组合键唯一定位,而不是单字段映射。

踩坑 3:整单提交导致一行失败全回滚。如果一次性提交表头加全部表体,某一行批次号格式不对就会整张单据失败,已经在旺店通侧生成的单号还得手动清理。稳妥做法:表头表体分阶段,逐行提交,失败行单独告警。

踩坑 4:增量起点没设,首跑拉到一年前的数据。这种情况在客户现场不止一次发生。稳妥做法:增量起点必须明确指定,首跑全量时也要分段提交,而不是一次塞过去。

适用场景与不适用场景

适用场景:金蝶做采购订单与收料管理、旺店通承担外仓入库与结算的私有化项目;单据结构稳定、物料数量在万级以内、对账时效要求 T+1。

不适用场景:旺店通侧同时承担主仓收货,或者金蝶侧收料通知单频繁修订;实时性要求秒级同步(本方案按 10–15 分钟调度);需要双向回写的复杂业务,本策略只做单向同步。