回复交期回写实战: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 节点配在同一条流上:
-
源节点(空操作查询,effect=QUERY)
- 平台:轻易云集成平台自身。
- 作用:不是去外部拉数据,而是作为「参数来源节点」,把后续真正要回写的 FBillNo / formId / rowsid 暴露成上下文变量,供下一步引用。
- autoFillResponse 设为 true,允许在后续节点里直接通过
{{field}}引用。
-
目标节点(effect=EXECUTE)
- 平台:金蝶云星空。
- 作用:调用 F_DATESYNC 接口,把上一个节点的 formId / rowsid 拼成入参,完成回写。
- 入参里出现的
_function CONCAT(...)是轻易云支持的表达式模板,运行时把上下文变量插值进去。
-
连接关系
- 源节点的 response 字段(FBillNo / formId / rowsid)直接作为目标节点的 request 字段输入,中间不需要写复杂脚本。
-
元数据中的 number / id
- 目标节点用 number、id 做幂等控制(idCheck=true),重跑不会重复回写。
实施步骤(分阶段调度:增量起点 / 全量触发 / 调度频率)
我们和客户一起跑的实施节奏是这样的,分三段:
阶段一:增量起点对齐
- 第一次上线前,先和客户 IT 对清楚「增量起点」:从哪天开始,只回写当天之后新发生变化的销售订单行。
- 在轻易云里给源节点的查询条件加上
modify_time >= 增量起点,先手工跑一次,核对两边数字。
阶段二:全量触发做一次冷启动
- 增量对完之后,放开时间范围,做一次全量回写,把历史未答交期的单据一次性补齐。
- 这一轮严禁直接挂调度,必须人工触发,盯着日志看回写成功率和异常单据。
阶段三:挂调度,稳态运行
- 全量无误后,把调度切到稳态:目标节点配
*/2 * * * *(每 2 分钟一次)。 - 源查询节点配
1 1 1 1 1(月初 1 号 1 点 1 分),作为兜底的全量核对触发器,平时不主要靠它,只做月度的补差。 - 跑一两周后,根据实际积压情况,再把高频节点调成每 5 分钟一次,把低频节点调成每小时一次。
踩坑复盘
-
formId 配错类型 销售订单、生产订单、采购订单的 formId 在金蝶云星空里是不同的字符串,一旦在轻易云里把 formId 字段填成「数字」,序列化时会被丢掉引号,接口直接报参数错。稳妥的做法是:formId、rowsid 全部声明为 string,不要图省事用 int。
-
整单 vs 单行的回写粒度没区分 典型错误是:rowsid 没传,只想回写一行,结果把整张单据的交期都改了。永远带 rowsid,并且在测试用例里至少覆盖「只改其中一行,其他行交期保持不变」这种场景。
-
源节点的 effect=QUERY 被误以为是「查数据库」 这个策略里源节点其实是轻易云内部节点,不是去 MySQL 里查。它的作用只是把上下文变量组织出来。新人容易在这里加一堆 request 入参,反而干扰了模板拼接。
-
模板里把字符串当 JSON 直接拼 入参模板如果忘了
{{formId}}两边的引号,运行时拼出来就是无效 JSON,金蝶云星空那边会 200 但实际不生效,排查非常费劲。所有占位符都加上引号,并且在轻易云的请求体预览里肉眼检查一遍。 -
调度频率和业务量不匹配
*/2 * * * *对一个普通工厂是合理的;但对刚上线、历史欠账多的客户,2 分钟一次的回写可能堆积超时。稳妥做法:上线第一周用 10 分钟,逐步收紧到 2 分钟。
适用场景与不适用场景
适用:MOM 与金蝶云星空并存、销售订单需要在两边保持「承诺交期」一致;交期由金蝶侧的生产/采购链路计算出来,需要回写到 MOM 销售订单行上;回写粒度精确到行。
不适用:需要整张销售订单(含表头表体)同步的场景,这条策略不传单据主数据,只解决交期回写这一个动作;也不适用于没有金蝶云星空 F_DATESYNC 接口的环境。