轻易云
注册体验

回复交期回写实战:MOM 销售订单交期同步到金蝶云星空的单一策略落地

· 尹春锐· 集成方案库· 38 次浏览· 约 5 分钟读完
MySQL金蝶云星空销售订单MOM生产通知交期回写行级回写轻易云

这个策略解决什么问题(场景与价值)

在 MOM(制造运营管理)系统与金蝶云星空并存的工厂里,销售员在 MOM 端下单后,真正的排产、备料和承诺交期是由金蝶云星空的生产/采购链路给出的。MOM 需要把这个「承诺交期」回写到自己的销售订单上,业务员才能在统一界面给客户答复。

我们这次在客户现场要落地的,就是一条非常细的策略:不传整张单,只把金蝶云星空已经算好的交期,F_DATESYNC 接口结果回写到 MOM 销售订单上。

这条策略单独拎出来的价值在于:它把「交期答复」从人工导表、QQ 截图,变成一条可调度、可追溯、可重跑的链路。一次性投入,后面每天都在省事。

数据流向与字段映射(源 → 中间层 → 目标)

这条策略的链路分两段:第一段在轻易云内部查单据,作为回写的「触发输入」;第二段调用金蝶云星空的 F_DATESYNC 接口,把交期回写回单据上。

角色系统 / 平台关键字段说明
源(查询)轻易云集成平台FBillNo(单据编号)用于定位金蝶云星空上的销售订单
源(查询)轻易云集成平台formId(单据类型表单 ID)区分销售订单、生产订单等不同单据
源(查询)轻易云集成平台rowsid(行 ID)精确到行,避免整单覆盖
目标(回写)金蝶云星空FormId由 FBillNo + formId 组装,作为入参
目标(回写)金蝶云星空rowsid唯一确定回写的明细行
目标(回写)金蝶云星空F_DATESYNC(API)执行交期回写动作

注意,源和目标里都有 formId 和 rowsid,但语义不同:源端是「我要去查的标识」,目标端是「我要去写的入参」。中间层用模板字符串把它们拼成金蝶云星空的 JSON 体,模板片段形如 _function CONCAT('{"JSON": {"formId": "','{{formId}}','","model": [{"rowsid": "','{{rowsid}}','"}]}}')。

在轻易云上如何配置

在轻易云数据集成平台里,这条策略拆成两个 WebAPI 节点配在同一条流上:

  1. 源节点(空操作查询,effect=QUERY)

    • 平台:轻易云集成平台自身。
    • 作用:不是去外部拉数据,而是作为「参数来源节点」,把后续真正要回写的 FBillNo / formId / rowsid 暴露成上下文变量,供下一步引用。
    • autoFillResponse 设为 true,允许在后续节点里直接通过 {{field}} 引用。
  2. 目标节点(effect=EXECUTE)

    • 平台:金蝶云星空。
    • 作用:调用 F_DATESYNC 接口,把上一个节点的 formId / rowsid 拼成入参,完成回写。
    • 入参里出现的 _function CONCAT(...) 是轻易云支持的表达式模板,运行时把上下文变量插值进去。
  3. 连接关系

    • 源节点的 response 字段(FBillNo / formId / rowsid)直接作为目标节点的 request 字段输入,中间不需要写复杂脚本。
  4. 元数据中的 number / id

    • 目标节点用 number、id 做幂等控制(idCheck=true),重跑不会重复回写。

实施步骤(分阶段调度:增量起点 / 全量触发 / 调度频率)

我们和客户一起跑的实施节奏是这样的,分三段:

阶段一:增量起点对齐

  • 第一次上线前,先和客户 IT 对清楚「增量起点」:从哪天开始,只回写当天之后新发生变化的销售订单行。
  • 在轻易云里给源节点的查询条件加上 modify_time >= 增量起点,先手工跑一次,核对两边数字。

阶段二:全量触发做一次冷启动

  • 增量对完之后,放开时间范围,做一次全量回写,把历史未答交期的单据一次性补齐。
  • 这一轮严禁直接挂调度,必须人工触发,盯着日志看回写成功率和异常单据。

阶段三:挂调度,稳态运行

  • 全量无误后,把调度切到稳态:目标节点配 */2 * * * *(每 2 分钟一次)。
  • 源查询节点配 1 1 1 1 1(月初 1 号 1 点 1 分),作为兜底的全量核对触发器,平时不主要靠它,只做月度的补差。
  • 跑一两周后,根据实际积压情况,再把高频节点调成每 5 分钟一次,把低频节点调成每小时一次。

踩坑复盘

  1. formId 配错类型 销售订单、生产订单、采购订单的 formId 在金蝶云星空里是不同的字符串,一旦在轻易云里把 formId 字段填成「数字」,序列化时会被丢掉引号,接口直接报参数错。稳妥的做法是:formId、rowsid 全部声明为 string,不要图省事用 int。

  2. 整单 vs 单行的回写粒度没区分 典型错误是:rowsid 没传,只想回写一行,结果把整张单据的交期都改了。永远带 rowsid,并且在测试用例里至少覆盖「只改其中一行,其他行交期保持不变」这种场景。

  3. 源节点的 effect=QUERY 被误以为是「查数据库」 这个策略里源节点其实是轻易云内部节点,不是去 MySQL 里查。它的作用只是把上下文变量组织出来。新人容易在这里加一堆 request 入参,反而干扰了模板拼接。

  4. 模板里把字符串当 JSON 直接拼 入参模板如果忘了 {{formId}} 两边的引号,运行时拼出来就是无效 JSON,金蝶云星空那边会 200 但实际不生效,排查非常费劲。所有占位符都加上引号,并且在轻易云的请求体预览里肉眼检查一遍。

  5. 调度频率和业务量不匹配 */2 * * * * 对一个普通工厂是合理的;但对刚上线、历史欠账多的客户,2 分钟一次的回写可能堆积超时。稳妥做法:上线第一周用 10 分钟,逐步收紧到 2 分钟。

适用场景与不适用场景

适用:MOM 与金蝶云星空并存、销售订单需要在两边保持「承诺交期」一致;交期由金蝶侧的生产/采购链路计算出来,需要回写到 MOM 销售订单行上;回写粒度精确到行。

不适用:需要整张销售订单(含表头表体)同步的场景,这条策略不传单据主数据,只解决交期回写这一个动作;也不适用于没有金蝶云星空 F_DATESYNC 接口的环境。

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

评论