计量单位同步实战:金蝶云星空 → 四化智造 MES 的字段映射与调度设计
这个策略解决什么问题
计量单位是 ERP 与 MES 之间最容易被忽略、却最容易出乱子的基础资料。源系统在金蝶云星空里叫「计量单位」,到了 MES 端变成了「计算单位」,字段名、单位 ID 的口径都不一样。一次实际项目中,某制造企业的物料在金蝶里用的是「只/台/套」,推到 MES 后因为单位流水对不上,导致后续生产领料换算全线报错。
这条策略的本质,是把金蝶云星空里的计量单位主数据,按确定的口径同步到 MES 的计算单位档案,作为后续物料、工序、库存等单据类同步的前置依赖。
数据流向与字段映射
整体流向:金蝶云星空(B 系统)→ 轻易云数据集成平台(Qeasy)→ 四化智造 MES(A 系统)。
源端通过金蝶的 executeBillQuery 接口(POST)按分页拉取计量单位,目标端调用 MES 的 /api/createComputeUnit 接口(POST)写入。关键字段对照如下:
| 源字段(金蝶云星空) | 标签 | 目标字段(MES) | 标签 | 说明 |
|---|---|---|---|---|
| FNumber | 编码 | unitNo | 单位编码 | 单位业务编码 |
| FName | 名称 | unitName | 单位名称 | 显示名称 |
| FUNITID | 单位 ID | unitUuid | 计量单位流水 | 作为唯一标识贯穿 |
| FForbidStatus | 状态 | — | — | 禁用状态用于过滤 |
| — | — | companyCode | 公司代码 | 目标端组织参数 |
| — | — | basicUnitUuid | 基准单位流水 | 目标端必填时需补值 |
| — | — | coefficient | 换算系数 | 目标端必填时需补值 |
字段层面有个关键点:金蝶的 FUNITID 是内码数字,到 MES 端必须映射成字符串型 unitUuid,否则会触发目标端类型校验失败。
在轻易云上如何配置
我们用轻易云(Qeasy)来承接这条策略,配置集中在三个地方:
- 源端元数据:选用平台内置的「金蝶云星空」适配器,API 选
executeBillQuery,主键字段设为FUNITID,业务号字段设为FName(按客户口径选「名称」作为可见编号)。分页参数Limit用{{PAGINATION_PAGE_SIZE}}占位,由轻易云的运行时动态注入。 - 目标端元数据:选用「四化智造 MES(API)」适配器,API 选
/api/createComputeUnit,将FUNITID、FNumber、FName通过变量映射到unitUuid、unitNo、unitName。companyCode写常量,按客户组织编码填。 - 编码映射:在轻易云的「映射管理」里建一张单位编码对照表,集中管理「金蝶编码 ↔ MES 单位流水」。这是轻易云客户最常见的应对模式之一——编码映射集中管理,避免在策略里散落硬编码。
实施步骤
我们建议分三个阶段落地:
- 阶段一:增量起点初始化。先一次性全量拉取金蝶计量单位,作为初始基线。这一步在轻易云里用「全量触发」按钮发起,跑完后写入增量游标。
- 阶段二:增量调度。把 cron 设为
* 7-22 * * *(早 7 点到晚 10 点内每分钟触发一次),由轻易云的增量机制按FUNITID去比对新增/变更,命中即推送给 MES。 - 阶段三:状态过滤。在源端查询条件中过滤
FForbidStatus = 'A'(未禁用),禁用单位不推,避免 MES 出现「幽灵单位」。
另外在轻易云上常见的应对模式是增量与全量双轨:日常用增量,关键节点(如月度结账后)跑一次全量校验,保证两边最终一致。
踩坑复盘
- 分页参数忘了替换。金蝶的
Limit是分页必需参数,典型错误是直接写死 2000,超过金蝶单页上限会被拒。稳妥的做法是交给轻易云运行时通过{{PAGINATION_PAGE_SIZE}}注入。 FUNITID类型转换漏了。源端是数字,目标端要字符串。这里容易翻车,导致整批推送失败。- 禁用单位推过去了。金蝶里禁用但未删除的单位,默认会被查询出来推到 MES,造成 MES 端单位档案出现「悬空数据」。稳妥做法是在源端过滤
FForbidStatus。 - 单位流水没回写。MES 端生成的
unitUuid没回写到金蝶侧,后续物料推送时找不到对应关系。稳妥的做法是在轻易云里启用「回写策略」,把目标端流水写回源端扩展字段。 - 基准单位 / 换算系数没补。MES 端某些接口要求
basicUnitUuid、coefficient非空,但金蝶计量单位本身不带这两个字段。稳妥的做法是在映射层补默认值,或拆成两步策略:先建单位,再补换算关系。
适用场景与不适用场景
适用:ERP 作为计量单位主数据源头、MES 需要单位档案做换算的制造企业,尤其是同集团内多组织、多账套场景。 不适用:MES 自行维护单位档案的双系统并行场景;以及需要双向同步、单位换算关系跨系统互锁的复杂业务(需要单独的换算关系同步策略配合)。