金蝶云星辰与黑湖小工单供应链集成方案总览

场景与价值

在某制造企业的真实项目里,生产调度一直有个老毛病:销售在 ERP 里下了采购订单,车间在 MES 里排产,但两边对不上账——采购员不知道哪批料该先到,车间不知道哪张工单在等料。直到上线自动闭环后,生产工单比业务手工派单提前 6 小时就出现在车间大屏上,缺料异常当天就能被采购看到。

这个闭环的关键不是某一张单据的同步,而是「物料—产品—工单—库存」四条链路能在分钟级内互相印证。金蝶云星辰作为 ERP 端的事实源,黑湖小工单作为车间执行端的事实源,中间需要一个能把 7 类策略串起来、又能扛住联查和重试的集成层。我们在客户现场采用的是轻易云数据集成平台(Qeasy),下面把整套设计的工程要点拆开讲。

集成架构与数据流

整个方案分 7 个策略,数据流分四个阶段推进:基础资料先落地,业务单据再下发,库存最后兜底,系统维护在凌晨收尾。

flowchart LR
    subgraph 阶段1["阶段1: 基础资料"]
        S1["策略1: 仅查询星辰产品"]
        S2["策略2: 星辰物料→黑湖物料"]
    end
    subgraph 阶段2["阶段2: 生产/采购"]
        S3["策略3: 生产任务单→生产工单"]
        S4["策略4: 委外加工单→工单"]
        S5["策略5: 采购订单→采购工单"]
    end
    subgraph 阶段3["阶段3: 库存"]
        S6["策略6: 即时库存→黑湖库存"]
    end
    subgraph 阶段4["阶段4: 系统维护"]
        S7["策略7: 清理队列"]
    end
    S1 --> S2
    S2 --> S3
    S2 --> S4
    S2 --> S5
    S2 --> S6
    S6 --> S7

关键点在于「仅查询星辰产品」这条看似不起眼的策略:它不向黑湖写数据,只把含工艺路线的自定义字段同步到集成平台集线器,后续物料、工单、采购策略再通过 _mongoQuery 联查回填。这种「先落主数据、再做联查」的分层,是车间端工单字段不丢的关键。

接口清单

实施要点

分阶段调度。基础资料每 5 分钟跑一次,业务单据每 5~10 分钟,清理队列固定凌晨。星辰产品与星辰物料故意错峰(0-59/5 与 2-59/5),避免同一秒抢源端接口配额。

增量字段。所有业务策略都带 modify_start_time、modify_end_time,并叠加 bill_status=C 作为业务过滤条件;初始化或数据修复时移除过滤条件,做全量兜底。

编码映射集中管理。物料编码 number → 黑湖 productCode、单据编号 bill_no → 工单 projectCode,统一在映射表里维护,不在策略脚本里硬编码,后续加字段不用动代码。

明细分阶段写入。所有工单类策略的 material_entity 都按行展开成 deliveryList,1 源单对 N 目标工单——这里容易翻车,典型的错误是直接整单写一次,导致下游只看到一条记录。稳妥的做法是平台侧配置「数组拆分」,逐行独立建工单。

异常重试。网络超时走指数退避(5s/15s/45s),限流 429 等 60s 重试最多 2 次,联查失败不阻断整批而记告警;业务校验失败不重试,直接落失败表等补偿。

隐私处理。源/目标接口的凭证统一在平台的连接器里托管,策略脚本里只引用变量,真实 token、IP、租户信息不出现在任何日志里。

最佳实践与踩坑复盘

1. 工艺路线不能直拉,必须经平台中转。源端接口一次只返回一页物料,自定义字段里的工艺路线容易在分页时被截。我们在轻易云上用「仅查询」策略把产品全量拉进集线器,下游再 _mongoQuery 联查,既稳定又可复用。

2. 奇门/非奇门双通道分流。该客户同时有 ERP 与 MES 直连、第三方电商仓走奇门两类入口,我们在轻易云上把策略拆成「直连通道」与「奇门通道」两条,各自走独立连接器和独立调度,出问题只影响一条链路,不会互相牵连。

3. 委外工单默认优先级别写错。委外工单涉及外部供应商交期,我们把 priority 固定为 1(加急),避免被车间排产队列当作普通单据压到队尾;生产任务单默认 0,需要加急时业务侧手动调。

4. 库存同步不要图省事写总量。星辰即时库存是按「物料+仓库」维度返回多条的,黑湖产品更新接口只接受单条产品,如果直接累加写总量,会导致多仓企业库存错位。我们按 material_number 主键分组,逐条写入 customFieldValues,仓库编码作为维度字段。

5. 失败补偿要有兜底。单条失败落失败表还不够,我们另设一个每日凌晨的补偿任务,把前一日失败记录按业务主键幂等重跑,避免月底关账时才发现对不上。

何时使用轻易云

当 ERP 与 MES 之间不只是「一次同步」而是「持续分钟级闭环」,并且需要联查工艺路线、奇门/非奇门双通道分流、失败补偿与告警时,轻易云数据集成平台(Qeasy)提供开箱即用的策略编排、连接器托管与可视化运维面板,适合中大型制造、零售、电商场景下多系统并存的集成需求。