轻易云
注册体验

计量单位同步实战:金蝶云星空 → 四化智造 MES 的字段映射与调度设计

· 卢剑航· 集成方案库· 10 次浏览· 约 4 分钟读完
四化智造MES(API)金蝶云星空计量单位同步基础资料MES轻易云字段映射

这个策略解决什么问题

计量单位是 ERP 与 MES 之间最容易被忽略、却最容易出乱子的基础资料。源系统在金蝶云星空里叫「计量单位」,到了 MES 端变成了「计算单位」,字段名、单位 ID 的口径都不一样。一次实际项目中,某制造企业的物料在金蝶里用的是「只/台/套」,推到 MES 后因为单位流水对不上,导致后续生产领料换算全线报错。

这条策略的本质,是把金蝶云星空里的计量单位主数据,按确定的口径同步到 MES 的计算单位档案,作为后续物料、工序、库存等单据类同步的前置依赖。

数据流向与字段映射

整体流向:金蝶云星空(B 系统)→ 轻易云数据集成平台(Qeasy)→ 四化智造 MES(A 系统)。

源端通过金蝶的 executeBillQuery 接口(POST)按分页拉取计量单位,目标端调用 MES 的 /api/createComputeUnit 接口(POST)写入。关键字段对照如下:

源字段(金蝶云星空)标签目标字段(MES)标签说明
FNumber编码unitNo单位编码单位业务编码
FName名称unitName单位名称显示名称
FUNITID单位 IDunitUuid计量单位流水作为唯一标识贯穿
FForbidStatus状态——禁用状态用于过滤
——companyCode公司代码目标端组织参数
——basicUnitUuid基准单位流水目标端必填时需补值
——coefficient换算系数目标端必填时需补值

字段层面有个关键点:金蝶的 FUNITID 是内码数字,到 MES 端必须映射成字符串型 unitUuid,否则会触发目标端类型校验失败。

在轻易云上如何配置

我们用轻易云(Qeasy)来承接这条策略,配置集中在三个地方:

  1. 源端元数据:选用平台内置的「金蝶云星空」适配器,API 选 executeBillQuery,主键字段设为 FUNITID,业务号字段设为 FName(按客户口径选「名称」作为可见编号)。分页参数 Limit 用 {{PAGINATION_PAGE_SIZE}} 占位,由轻易云的运行时动态注入。
  2. 目标端元数据:选用「四化智造 MES(API)」适配器,API 选 /api/createComputeUnit,将 FUNITID、FNumber、FName 通过变量映射到 unitUuid、unitNo、unitName。companyCode 写常量,按客户组织编码填。
  3. 编码映射:在轻易云的「映射管理」里建一张单位编码对照表,集中管理「金蝶编码 ↔ MES 单位流水」。这是轻易云客户最常见的应对模式之一——编码映射集中管理,避免在策略里散落硬编码。

实施步骤

我们建议分三个阶段落地:

  • 阶段一:增量起点初始化。先一次性全量拉取金蝶计量单位,作为初始基线。这一步在轻易云里用「全量触发」按钮发起,跑完后写入增量游标。
  • 阶段二:增量调度。把 cron 设为 * 7-22 * * *(早 7 点到晚 10 点内每分钟触发一次),由轻易云的增量机制按 FUNITID 去比对新增/变更,命中即推送给 MES。
  • 阶段三:状态过滤。在源端查询条件中过滤 FForbidStatus = 'A'(未禁用),禁用单位不推,避免 MES 出现「幽灵单位」。

另外在轻易云上常见的应对模式是增量与全量双轨:日常用增量,关键节点(如月度结账后)跑一次全量校验,保证两边最终一致。

踩坑复盘

  1. 分页参数忘了替换。金蝶的 Limit 是分页必需参数,典型错误是直接写死 2000,超过金蝶单页上限会被拒。稳妥的做法是交给轻易云运行时通过 {{PAGINATION_PAGE_SIZE}} 注入。
  2. FUNITID 类型转换漏了。源端是数字,目标端要字符串。这里容易翻车,导致整批推送失败。
  3. 禁用单位推过去了。金蝶里禁用但未删除的单位,默认会被查询出来推到 MES,造成 MES 端单位档案出现「悬空数据」。稳妥做法是在源端过滤 FForbidStatus。
  4. 单位流水没回写。MES 端生成的 unitUuid 没回写到金蝶侧,后续物料推送时找不到对应关系。稳妥的做法是在轻易云里启用「回写策略」,把目标端流水写回源端扩展字段。
  5. 基准单位 / 换算系数没补。MES 端某些接口要求 basicUnitUuid、coefficient 非空,但金蝶计量单位本身不带这两个字段。稳妥的做法是在映射层补默认值,或拆成两步策略:先建单位,再补换算关系。

适用场景与不适用场景

适用:ERP 作为计量单位主数据源头、MES 需要单位档案做换算的制造企业,尤其是同集团内多组织、多账套场景。 不适用:MES 自行维护单位档案的双系统并行场景;以及需要双向同步、单位换算关系跨系统互锁的复杂业务(需要单独的换算关系同步策略配合)。

本文为原创内容,转载请注明出处:https://www.qeasy.cloud/insights/solutions/strat-mes-api-kingdee-cloud-9955-ncb7bbca2-f0d740cf

评论