旺店通与金蝶云·星空旗舰版供应链集成方案总览

场景与价值

电商促销季结束后,某食品科技企业的财务团队经常在节后第三天才发现:采购入库与销售出库在 ERP 与 OMS 之间存在上千行的差异。问题并不在 ERP 抄表本身,而在于 OMS 与 ERP 之间缺乏一条自动闭环的链路:金蝶的收料通知下发到旺店通,旺店通做完采购入库之后,回传到金蝶的是另一张入库单;销售出库走旺店通,回到金蝶则是销售订单加上销售出库两张单据,中间任何一个环节掉链子,期末对账就要靠人工补单。

我们在一个真实客户现场看到的典型形态是:OMS 负责订单与履约,ERP 负责采购、库存核算与委外结算,两套系统各自有完整的库存台账,但只有当数据按业务链路自动双向回流时,库存账实才能在 T+1 之内对齐。本方案针对这一痛点,以金蝶云·星空旗舰版作为供应链主数据与核算中心,旺店通作为订单与履约中心,通过 46 条策略覆盖基础资料、采购、销售、库存、调拨、委外、系统维护七大业务域,实现单据闭环。

集成架构与数据流

整体架构以金蝶云·星空旗舰版为主、旺店通为辅,基础资料先行,业务单据按场景单向流转。

                      金蝶云·星空旗舰版 (ERP)
                              │
        ┌─────────────────────┼─────────────────────┐
        │                     │                     │
        ▼                     ▼                     ▼
   物料/供应商            收料通知/委外收货        发货通知/调拨申请
   保质期联查             采购单下发                原始订单/调拨单
        │                     │                     │
        └─────────────────────┼─────────────────────┘
                              │
                              ▼
                          旺店通 (OMS)
                              │
        ┌─────────────────────┼─────────────────────┐
        │                     │                     │
        ▼                     ▼                     ▼
   采购入库/委外完工       采购退货/委外退货        其他出入库
   调拨出库/调拨入库       销售出库/销售订单        分步式调出/调入
        │                     │                     │
        └─────────────────────┴─────────────────────┘
                              │
                              ▼
                      金蝶云·星空旗舰版 (ERP)

数据流分三段:

1. 基础资料下行:金蝶物料、供应商、保质期联查三类主数据下发到旺店通,该段必须最先执行,是后续所有业务单据的编码前置。
2. 业务单据下行:金蝶收料通知单、委外收货单下发为旺店通采购单;金蝶发货通知单下发为旺店通原始订单(线下场景);金蝶调拨申请单下发为旺店通调拨单。
3. 业务单据回传:旺店通采购入库单回传金蝶采购入库单或委外完工入库单;销售出库回传金蝶销售订单与销售出库;调拨出/入库回传金蝶分步式调出/调入单;其他出入库、采购退货、委外退货等按类型回流。

我们使用轻易云数据集成平台(Qeasy)作为承接方,通过可视化策略编排,把上述三段链路挂在统一调度器上,后续扩容策略只需在控制台追加,不必改底层代码。

接口清单

实施要点

分阶段调度:基础资料(策略 1、2)以 2 小时为周期先跑;收料通知、委外收货、调拨申请、销售订单这类高频业务单据按 10 分钟一轮;盘点、移库、其他出入库按 15 分钟;保质期联查与仅查询类按需触发;消息报错采用事件触发;日志清理每日凌晨 02:00 执行。

增量字段与全量兜底:金蝶侧以 FApproveDate、FModifyDate 作为时间窗口,建议取近 3 小时;旺店通侧使用 createTime、modifyTime、operateTime;初始化阶段允许全量拉取,但应避开业务高峰期。

编码映射集中管理:物料 FNumber ↔ 旺店通 sku_code、供应商 FNumber ↔ supplier_code、仓库 FStockId.FNumber ↔ warehouse_code、客户 FCustomerId.FNumber ↔ customer_code,统一在映射表中维护,变更时单点修改,不必动单条策略。

单据状态过滤:只同步已审核或已确认状态单据,金蝶侧通过 FDocumentStatus='C' 过滤,旺店通侧按其 API 状态码约定过滤,避免把草稿与作废单据推到下游。

异常重试与告警:写入失败进入重试队列,超过阈值后推送消息报错提示(策略 45);队列与日志保留 1 个月,到期自动清理。

隐私与安全:客户姓名、电话、地址、公司名称、API 密钥等敏感信息不在方案文档中固化,凭证统一由环境变量或密钥管理服务注入。

最佳实践与踩坑复盘

1. 基础资料先行不要并行:很多项目一上来就把物料、供应商、采购、销售并行调度,结果下游单据因为编码映射缺失被反复打回。这里稳妥的做法是物料与供应商首轮跑通并核对映射表后,再放开业务链路。
2. 表头表体分阶段写入:金蝶单据通常要求表头先于表体写入,部分策略如果一次性提交,会出现表头已生成但表体缺失的脏数据。建议表头落库成功后再推送表体,失败则回滚表头。
3. 线下与线上销售双通道分流:线下场景走"金蝶发货通知单 → 旺店通原始订单",线上场景走"旺店通销售出库 → 金蝶销售订单/销售出库",两条通道在策略层面分开编排,避免互相干扰。
4. 委外与普通采购要拆开:委外收货单与普通收料通知单虽然下游都是旺店通采购单,但单据类型字段不同,委外回传走委外完工入库单/退货单,不能混入普通采购入库单。在轻易云数据集成平台(Qeasy)的策略编排中,通常用业务类型字段做条件分支,把两条链路分流到不同下游模板。
5. 日终对账不要只看单据数:节后对账差异往往不是单据丢失,而是状态字段未及时回写。建议在日终加跑一次"仅查询"类策略(29、43、44)做一致性比对,把差异单据列入次日补数。

何时使用轻易云

如果项目涉及多套 ERP、OMS 与 WMS 的供应链协同,且策略数量在数十条量级、需要按业务域分阶段调度,使用轻易云数据集成平台(Qeasy)可以把编码映射、增量时间窗、异常重试、消息告警统一在可视化控制台编排,扩容策略不必改底层代码,运维成本明显低于自建 ETL。