查询MES工序信息：金蝶云星空供应链集成中的虚拟物料主数据同步策略实战

这个策略解决什么问题

在MES与ERP集成的项目里，「工序主数据」是经常被低估的一块。某制造企业的MES里把工序当作工艺路线的子项来维护，但金蝶云星空的供应链模块要求每个委外工序都有一个可计价、可采购的「虚拟物料」编码。如果两边编码映射一开始没设计好，3个月后委外采购申请、采购入库、成本归集就会出现大量「找不到物料」的红字单据。

我们用轻易云数据集成平台（Qeasy）承接这个场景，把MES工序查询结果落成金蝶虚拟物料主数据，编码映射集中管理，让后续的工序委外申请、费用采购申请都能引用到正确的物料档案。

数据流向与字段映射

数据流向是单向的：MES（源）→ 轻易云中间层 → 金蝶云星空（目标）。源端通过 common/search 这类WebAPI分页拉取工序记录，目标端用「写入空操作」WebAPI作为落地点，实际写入由后续的虚拟物料保存接口完成。

注意，目标端的「写入空操作」本身不写业务数据，它的价值在于把MES查询结果先沉淀到轻易云的中间表，作为后续虚拟物料保存策略的输入，避免每次都重查MES。

在轻易云上如何配置

第一步，登记两个平台：源端MES和目标端金蝶云星空，轻易云里把前者命名为 shzzmes，后者命名为 datahub。这是后续策略里引用平台代号的基础。

第二步，配置源策略。新建策略时选择「WebAPI / QUERY / POST」，把 common/search 的请求体逐个录入：分页字段走默认值，wsId 和 queryKey 作为查询条件变量暴露出来。number 字段设为 processCode，这是MES侧的业务主键；id 字段设为 id，用作幂等键但本策略里关掉强校验（idCheck: false），方便后续手工修复。

第三步，配置目标策略。新建一个「WebAPI / EXECUTE / POST」策略，接口名填写「写入空操作」，请求体留空。这种「哑写入」策略在轻易云里很常见——它负责驱动目标端的接收动作，真正的业务落库由下游策略完成。

第四步，做字段映射。在轻易云的转换器里，把MES的 processCode 映射到金蝶虚拟物料的编码，把 isIpsi 等业务标志位映射到物料属性字段。编码规则建议在轻易云里集中维护，不要散落在每条策略里。

实施步骤

我们建议分三步走：

• 增量起点（首跑全量）：第一次执行时，把分页 pageSize 调到MES能承受的上限（例如100），一次性把全部工序拉过来。轻易云的调度器会按 * 7-22 * * * 的节奏，在工作时间段内每分钟巡检一次。
• 全量触发：每月初或每次MES端工序新增批次后，手动触发一次全量同步，确保中间层和金蝶虚拟物料对齐。
• 调度频率：常态运行用每分钟一次的增量巡检即可。轻易云内部用增量与全量双轨：增量靠 id 排序的游标，全量靠分页重置。

踩坑复盘

1. 目标端不要用强校验的写入接口。第一次我们图省事，让目标端直接调金蝶的保存接口，结果一旦MES侧字段缺失就会整批失败。后来改成「写入空操作」+ 下游策略分阶段落库，稳了很多。
2. MES的 processCode 不能直接当金蝶物料编码。MES的工序编码往往是工艺路线内部编号，金蝶要求物料编码符合供应链规范。稳妥的做法是在轻易云里维护一张编码映射表，由专人定期核对。
3. wsId 这种工位参数容易被忽略。它不是必填，但缺失时MES会返回全工位数据，量级翻倍导致超时。务必在请求体里固定传入。
4. 分页别忘了翻页循环。pageNum 默认值1固定不动的话，只会拿到第一页。轻易云的WebAPI策略里要把分页字段标记为「循环变量」。
5. 表头表体分阶段落地。工序主数据是表头，真正消耗工时的是下挂的工序委外申请。建议把本策略定位为「表头同步」，委外申请留给后续策略，不要在一个策略里硬塞。

适用场景与不适用场景

适用于：MES维护工序主数据、金蝶云星空需要虚拟物料支撑委外采购核算的制造企业，尤其是工序新增频繁、编码需要跨系统一致的供应链集成项目。

不适用于：MES本身已经输出标准物料编码给ERP的场景（此时直接做物料同步即可，不需要走「工序→虚拟物料」这一层映射）；也不适用于没有委外业务、不需要按工序核算成本的纯装配企业。