采购入库单同步实战:从泛微OA到金蝶云星空的一条策略讲透

这个策略解决什么问题

某制造企业的采购流程卡在一个老问题:供应商在泛微OA里走完审批,采购订单回到业务员手里,但仓库要在金蝶云星空里做入库、记账、生成应付。OA 和 ERP 两边互不认账,手工二次录入成本高、出错多。一次实际项目中,我们用轻易云数据集成平台(Qeasy)把「泛微OA-E9Http 的采购入库 Excel 单据」自动推到「金蝶云星空的采购入库单」,策略只此一条,但撑起了整条供应链闭环。

数据流向与字段映射

整体流向是 泛微OA(源) → 轻易云中间层 → 金蝶云星空(目标)。源端不是直接调 OA 接口,而是上游流程把入库数据落到一张结构化 Excel(UCD 成品 PM3003 这类模板);中间层负责解析、校验、补齐;目标端调用金蝶云星空的采购入库单保存接口。

关键字段对照(源 → 目标):

业务含义	泛微 OA 源端列	中间层处理	金蝶云星空目标字段
单据编号	单号	保留原值,加前缀防重	FBillNo
供应商	供应商名称	通过编码映射表翻译	FSupplierId(FNumber)
物料编码	物料编号	与物料主数据对齐	FMaterialId(FNumber)
数量	入库数量	类型转 decimal,保留 4 位	FQty
仓库	收货仓库	编码映射集中管理	FStockId(FNumber)
业务日期	入库日期	yyyy-MM-dd 标准化	FDate

编码映射(供应商、物料、仓库)是这一类项目里最容易踩坑的地方,轻易云里通常用一张集中的映射表来维护,源端名称进来后查表翻译,翻译不到就抛到异常队列。

在轻易云上如何配置

策略本身是一条 SYNC 类型,B→A 方向(A 为目标侧的泛微侧数据源,这里实际写入目标是金蝶,落地配置以方案为准),不依赖其他策略,没有设置 crontab——触发由上游流程驱动。

配置要点:

数据源接入:源端选「Excel 文件」适配器,文件路径指向 UCD 成品 PM3003 模板上传后的固定目录;目标端选金蝶云星空适配器,填入组织编码、账套标识(部署环境为私有化,网络要打通)。
字段映射:在轻易云可视化映射界面里,把源列拖到目标字段;数值、日期类型做显式转换,避免「字符串比字符串」这种典型翻车。
编码映射集中管理:供应商、物料、仓库三类基础资料,统一走映射表,而不是写在策略脚本里。这样新物料上线时只改映射表,不动策略。
写入模式:金蝶云星空采购入库单建议采用「先查询单据号是否存在,存在则更新,不存在则新增」,避免重复推送。
异常处理:映射缺失、必填项为空、库存超量,统统走异常队列,人工补单而不是阻塞主链路。

实施步骤

分阶段上线是稳妥的做法:

第一阶段——增量起点:从上线当天起,只同步新增的入库单。源端 Excel 按「单号 + 日期」做增量水位,轻易云里记录上次同步的最大单号或最大时间戳。
第二阶段——全量触发:试运行期间,人工触发一次全量回灌,把历史一段时间的入库单补齐到金蝶;全量跑完后切回增量。这一步务必在业务低峰期做。
第三阶段——调度频率:因为上游是流程触发(OA 审批完成落地 Excel),不需要 crontab 高频轮询。可以在轻易云里挂一个「文件到达触发」,文件落盘即跑;或者兜底一个低频巡检,防止文件漏触发。
第四阶段——对账与回滚:上线后第一周,每天做一次「源端单号 vs 目标单号」对账;对账脚本输出差异清单,仓库和 IT 一起确认。

踩坑复盘

编码映射写在脚本里:有客户一开始把供应商翻译直接写在策略里,半年后新增 50 家供应商,改了 50 个策略。稳妥的做法是映射集中管理,新供应商只改一张表。
表头表体一起推:Excel 是表头加表体多行物料,如果一次性整张推,中间一行校验失败整单回滚。正确做法是分阶段——先推表头,表头成功后再循环推表体,体行失败不影响其他行。
数量字段类型漂移:Excel 里数量有时是文本有时是数字,直接推金蝶会报类型错。中间层要显式做 toDecimal,并对负数、零做拦截。
重复单据号:OA 审批允许重提,导致同一个业务单生成两张 Excel。推送到金蝶前必须用单号做幂等控制,「先查后写」是最朴素也最有效的办法。
私有化网络抖动:金蝶云星空私有化部署,接口偶发超时。轻易云这边要配重试和熔断,不能一次失败就把单据丢到黑洞。

适用场景与不适用场景

适用:上游是审批流驱动、源端以 Excel/CSV 落地、结构化程度高、单据体量适中(月几千到几万张) 的采购入库场景;目标端是金蝶云星空私有化,需要强一致的库存与财务数据。

不适用:源端本身有成熟 API 且实时性要求秒级;目标端是异构 ERP,字段模型差异巨大;或者单据量在十万级以上,需要走流式而非文件落盘的方案。