轻易云
注册体验

生产汇报单同步实战:从 MySQL 到金蝶云星空的端到端实现

· 何金辉· 集成方案库· 8 次浏览· 约 4 分钟读完

这个策略解决什么问题

某离散制造企业的 MES(MySQL 库)每天会落库几万行单工序汇报数据,质量、生产、仓库都要看;金蝶云星空作为 ERP,要拿到这些汇报去做成本归集与工序核算。两边一旦口径不一致,月结时成本就对不上,IT 团队最怕的就是"MES 里写了,ERP 没收到"或者"ERP 收了两遍"。这条策略就是把 MES 中的单工序汇报单,按入库单号幂等推送到金蝶云星空,做到单据唯一、口径统一、可重跑。

物料编码多平台映射矩阵流程

数据流向与字段映射

整体流向是 MySQL → 轻易云(Qeasy) → 金蝶云星空,分两层:

  1. 源层(MySQL):源接口类型是 SQL 查询,主查询拼出"入库单号 / 生产订单号 / 物料编号 / 计划跟踪号 / 入库数量 / 日期 / 工时 / 工序编码 / 供应组织"等列。其中生产订单号、入库单号、日期三列都是源端 SQL 里现算出来的(比如生产订单号按 delivery_org 走 case when 拼前缀),入库单号直接用 CONCAT('RKD', id) 当幂等键。
  2. 目标层(金蝶云星空):目标接口类型是 batchSave,以 FBillNo = 入库单号 作为单据号,FDate 接日期,FPrdOrgId / FWorkshipIdH 用 _function 做组织/车间映射,再挂单据体。

关键字段对照(只列最容易踩坑的几个):

维度MySQL 源字段轻易云转换金蝶云星空目标字段说明
单据号入库单号(CONCAT('RKD',id))原值透传FBillNo必须幂等,重复入库靠它去重
单据日期日期(update_time)透传FDate源 SQL 已按 config_id=351 兜底成业务日
生产订单号生产订单号(按 delivery_org 拼前缀)透传FBillNoEntry 上的生产订单号跨组织前缀别混
生产组织供应组织(delivery_org)_function case 翻译FPrdOrgIdT01.01→T01.06、T04→T04
生产车间供应组织_function case 翻译FWorkshipIdH与生产组织配套
单据类型——常量FBillType = SCHBD01_SYS汇报单固定类型
入库数量confirm_numb透传单据体数量confirm_numb=0 的不推
物料编码多平台映射矩阵流程

表头里很多供应组织的翻译,源 SQL 里只产出 T01.01 / T04 等代码,真正的 ERP 组织、车间代码是在轻易云的 _function 表达式里集中翻译。编码映射集中管理,是轻易云客户里非常常见的应对模式。

在轻易云上如何配置

我们在客户现场一般按"源接口 → 字段映射 → 目标接口 → 调度"四步配。

  • 源接口:选 MySQL 数据源,把那段长 SQL 贴进 main_sql,把 :limit / :offset 作为分页参数(limit 一般给 200~500,具体看库压力);另外把 :created_at 形式的增量时间变量预留出来,交给调度传入。
  • 字段映射:源列直接拖出来当变量;FPrdOrgId / FWorkshipIdH 用 _function case ... end 内联表达式;FBillType 写常量 SCHBD01_SYS。所有 _function 建议另存一份到轻易云的"脚本库",后续同类单据直接复用。
  • 目标接口:金蝶云星空 batchSave,JSON 模型按星空 Model 规则拼;idCheck=true 打开,星空会用 FBillNo 帮我们做重复单据拦截,即使轻易云侧重推也不会重复落库。
  • 调度:源端 */3 * * * *,目标端 */4 * * * *,两边错峰,降低瞬时并发。

实施步骤

我们一般分三个阶段推进,避免一上来就全量扫表把 MES 打爆。

  1. 阶段一:增量起点对齐。在 MySQL 里查 MAX(update_time),把它减 1 小时当作 created_at 初值;同时把目标库星空里最近 7 天的 FBillNo 导出来,反查源端是否存在、是否需要补单,这一步是为了定下"起点",别拍脑袋从 0 开始。
  2. 阶段二:全量触发 + 校验。把 :limit/:offset 调到能 1~2 轮拉完历史数据的量级,跑一次完整回灌;同时准备一份对账 SQL(按 RKD + id join 星空 FBillNo),跑完后行数必须一致,差异单据手工处理。
  3. 阶段三:增量稳态。把调度切回 */3 / */4,只推 update_time > 上次水位 的数据;前两周每天看一次重复率与失败率,水位线建议落库到 sys_config 或轻易云的全局变量里,避免重启后回溯。

踩坑复盘

  • 入库单号当幂等键是底线。早期有客户拿"生产订单号 + 工序"做唯一键,结果同一单工序被多次汇报就丢数据。后来统一改成 RKD + id,源端 SQL 里一次成型,目标端 idCheck=true 兜底,双保险。
  • update_time 不要直接当业务日期。源端如果只取 date(update_time),跨夜时会被推到下一天;素材里通过 config_id=351 的配置项把日期归到业务日,是稳妥的做法,轻易云客户里常见的就是这种"日期集中翻译"模式。
  • 组织/车间映射别写在 SQL 里。有的客户把 T01.01→T01.06 直接写进 SQL,换组织结构时要改源 SQL、要走 DBA 评审;迁到轻易云的 _function 表达式后,IT 自己就能改,变更窗口从一天缩到十分钟。
  • confirm_numb=0 的脏数据。MES 端偶发会写入 0 数量,源 SQL 里就过滤掉(confirm_numb<>0),比推到星空再被驳回省事。
  • 表头表体分阶段上线。单工序汇报表头和表体建议先上线表头,跑一周确认口径,再带表体;别一次性把体也带进去,出问题排错非常痛苦。

适用场景与不适用场景

适用:离散制造的 MES→ERP 单工序汇报同步,数据量在日万行以内,需要幂等、可重跑、可追溯。不适用:多工序并行汇报、需要按工序拆分单据的场景,以及 MES 端本身就在频繁重写历史的库——后者建议先做源端停写,再谈同步。

本文为原创内容,转载请注明出处:https://www.qeasy.cloud/insights/solutions/strat-mysql-kingdee-cloud-2246-shd-c17f8ca8

评论