金蝶销售出库单到旺店通其他出库单的同步实战：单策略深度拆解

这个策略解决什么问题

组织间销售与零散出库，是供应链里最容易被忽视的“边角料”单据：金蝶云星空一张销售出库单，仓库可能在另一个组织、另一个账套下，WMS 端要落成“其他出库”。一旦映射没设计好，3 个月后账面库存和实物库存开始对不上，调账成本远高于前置治理。这条策略就是把这张跨组织的单据，按统一规则从金蝶推到旺店通。

数据流向与字段映射

整体流向是 金蝶云星空（销售出库单）→ 中间层（轻易云数据集成平台）→ 旺店通WMS（其他出库单）。关键字段对照如下：

编码映射强烈建议放在轻易云里集中管理，跨策略复用，避免每条策略各自硬编码。

在轻易云上如何配置

我们在客户现场通常按四块搭：

1. 源系统适配器：选金蝶云星空的开放接口，按 FStockOrgId + 修改时间 拉取。组织间场景要把目标组织编码带出来，后面映射用得到。
2. 目标系统适配器：旺店通其他出库单的写入接口，确认 outer_no 字段是否支持幂等——这是后面“允许重跑”的前提。
3. 映射画布：表头走一张映射表，仓库、客户、币别这三类码值统一引用码表；表体（物料行）单独一张映射，商品编码和单位换算放这里。表头表体分阶段处理，调试起来更聚焦。
4. 错误处理：把金蝶侧的“未审核/作废”状态、旺店通侧的“仓库停用/商品停用”单独走异常分支，不要和正常数据混在一起冲。

实施步骤

我们一般把上线切成三段，避免一把梭哈：

1. 增量起点：先做一次历史全量同步，但只同步近 30 天的已审核单据，验证映射正确率。全量触发一次即可，不进日常调度。
2. 并行期：金蝶作为唯一记账源，旺店通这端同步只看不写，日常调度设为每 15 分钟一次；同时在金蝶侧做 UAT 抽查对账。
3. 切换后：并行期跑一周没大问题，把频率收紧到每 5 分钟一次，并启用“增量 + 全量双轨”：增量按时间窗跑，全量按业务需要（如日终对账）触发，作为补漏机制。

调度频率本身不是越快越好，而是取决于金蝶单据的生成节奏和仓库收货的容忍时延。

踩坑复盘

• 典型错误是用单据编号去重，但下游不返回这个字段。稳妥的做法是确认目标接口是否支持 outer_no 幂等，否则就要在轻易云里加一层“已写入缓存”。
• 单位换算藏在物料档案里，没提前约定。金蝶基本单位、库存单位、旺店通销售单位常常不一致，源端取数前就要在映射里固化换算逻辑，而不是抛到运行时。
• 组织间交易把销售组织和库存组织搞混。金蝶里这两个组织是两个维度，映射到旺店通时必须先按业务规则收敛成一个仓库，否则会落错仓。
• 状态字段漏处理。金蝶的“暂存”“审核中”“已审核”“作废”，下游通常只吃“已审核”，其他状态要在轻易云里前置过滤掉，不要让脏数据进 WMS。
• 时区问题。公有云跨区域部署时，FDate 是带时区的时间戳，写到 WMS 前必须显式转换，否则日切那几分钟的单据会落到第二天，月末对账就翻车。

适用场景与不适用场景

适用：跨组织销售出库、零散调拨出库、退货出库等需要落到 WMS “其他出库”类目下的场景；金蝶是唯一业务源、旺店通只做执行落单。不适用：零售门店直发、B2C 电商订单（这类走专门的销售出库接口，编码体系完全不同）；以及需要 WMS 反向驱动金蝶生成凭证的逆向同步。