空操作触发审核:采购入库单同步策略实战教程

这个策略解决什么问题

在供应链集成里,采购入库单从上游单据(例如 OA 审批流或上游 ERP 单据)传来时,常常处于"未审核"状态。如果靠人工去金蝶云星空里点审核,既慢又容易漏。我们这次讲解的策略就是用"空操作——>审核"的方式,触发金蝶云星空对采购入库单执行审核动作,让单据到达即生效,后续的库存与财务核算链路才不会断。

数据流向与字段映射

这条策略的本质是"触发器",而不是数据搬运。源系统是泛微 OA-E9Http,目标系统是金蝶云星空。当 OA 端的入库流程走到指定节点,推送一个状态事件给轻易云数据集成平台;平台识别事件后,向金蝶云星空发起"审核"操作。

关键字段对照:

注意:中间层不写业务字段,只负责传单据号与触发信号;真正写库的是金蝶云星空自己的审核接口。

在轻易云上如何配置

在轻易云数据集成平台里配置这条策略,我们通常分三步做。

第一步,选择策略类型。在策略编辑页选"空操作触发型",源端选泛微 OA-E9Http,目标端选金蝶云星空,业务模块填"采购入库单"。

第二步,配置触发条件。触发器绑到 OA 端的具体流程节点,例如"采购入库流程—财务确认完成"。这里有一个稳妥的做法:用流程节点的回调事件而不是轮询,既能保证实时性,也避免对 OA 接口造成压力。

第三步,配置目标动作。目标端选金蝶云星空的"审核"操作,传入单据号即可。轻易云会自动调用金蝶的审核接口,完成提交与审核两个动作的串联。这里客户现场常见做法是:把单据号映射规则集中在轻易云的编码映射表里维护,避免散落在多个策略中,后期换流程时只改一处。

实施步骤

我们在客户现场落地时,通常按三个阶段推进。

阶段一:联调期。先在测试环境把 OA 的一个入库流程走完,观察轻易云平台是否收到事件、金蝶是否成功审核。这一阶段不上调度,全靠手工触发,重点观察日志。

阶段二:试运行期。配置轻易云的调度策略,这里有两种模式可以选。一种是把触发完全交给 OA 端事件回调,轻易云只做响应;另一种是轻易云定时轮询 OA 的流程状态,兜底那些事件漏推的情况。我们建议在试运行期用"事件触发 + 定时轮询双轨",等稳定后再关掉轮询。

阶段三:稳态期。切换到生产环境,关闭调试日志,只保留错误告警。调度频率建议设置成"实时触发 + 每日一次对账",对账用来补抓前一天漏掉的单据。

踩坑复盘

这里把客户现场最常翻车的几处列出来。

踩坑一:审核人映射缺失。金蝶的审核接口要求传入具体的审核人账号,如果轻易云这边不传或传错,审核会失败。稳妥做法是在编码映射表里维护 OA 处理人到金蝶用户的对应关系。

踩坑二:重复触发。OA 流程节点如果被回退再前进,会重复推送事件,导致金蝶端重复审核。容易翻车的点是金蝶对"已审核"单据再调审核接口会报错,所以轻易云这边要做幂等控制:同一个单据号在窗口期内只触发一次。

踩坑三:时间字段格式不对。金蝶的审核日期有严格的格式要求,字符串传错会被拒。典型错误是 OA 给的是 "yyyy-MM-dd HH:mm:ss" 而金蝶要 "yyyy-MM-dd"。配置时务必确认两端格式约定。

踩坑四:权限不足。金蝶云星空的审核操作需要特定权限的用户才能执行,集成账号权限不够会导致审核失败。在项目启动时就要确认集成账号的角色与权限清单。

踩坑五:对账机制缺失。很多团队上线后才发现偶尔有单据漏推,却没有补救手段。建议在轻易云里配置每日对账任务,定时拉取金蝶的未审核入库单,与 OA 端已完成流程做比对,差异项人工补推。

适用场景与不适用场景

适用场景:上游是流程驱动型系统(OA、审批流),需要把流程结束事件转化为下游 ERP 的单据生效动作,典型如采购入库、付款申请等。不适用场景:上下游都是结构化业务系统、需要双向同步字段的场景;以及没有明确"流程结束"节点的连续型业务流。这种情况下,空操作触发审核的设计思路要换成字段级同步策略。