库存校准策略实战：金蝶云星空仓位库存向旺店通·奇门同步

这个策略解决什么问题

在零售与分销场景里，仓位级别的库存数字是发货、锁库、对账的源头。一旦金蝶云星空这一侧的仓位库存与旺店通·奇门那一侧出现偏差，前端就会出现超卖、缺货、错配仓位等问题。我们这次要拆解的「库存校准-金蝶有仓位-1」策略，正是把金蝶云星空里按仓库+物料维度的即时库存，定期推送给旺店通·奇门，作为盘点单据生成或库存对齐的依据。它属于整条供应链同步链路中的 sequence=B 一环，必须等物料主数据（sequence=A）先到位后才能稳定运行。

数据流向与字段映射

整体流向是 B（金蝶云星空）→ 中间层（轻易云数据集成平台）→ A（旺店通·奇门）。源端通过 executeBillQuery 查询库存视图，目标端调用 wdt.stock.sync.by.pd 创建盘点单据。关键字段对照如下：

实际项目里，仓库与物料编码不会凭空对上，必须依赖上一阶段同步下来的码表，否则推送必然失败。

在轻易云上如何配置

在轻易云数据集成平台中新建「库存校准-金蝶有仓位-1」策略，按以下要点配置：

1. 数据源连接：选择金蝶云星空，配置好私有化的接口账号与白名单，注意 executeBillQuery 走 POST。
2. 目标连接：选择旺店通·奇门，勾选 wdt.stock.sync.by.pd，idCheck=true 开启幂等校验。
3. 字段映射：把 FStockId_FNumber、FMaterialId_FNumber 通过变量插值写入 warehouse_no、spec_no；盘点方式 mode=1 表示按货位盘点。
4. 编码映射集中管理：仓库编码、物料编码统一在轻易云映射表里维护，避免散落在多个策略中。这是我们给客户做过的常见应对模式之一。
5. 严格模式与审核：is_check=1 自动审核，is_post_error 决定是否启用严格模式——一个明细 spec_no 不存在就整单失败。
6. 幂等键：用 api_outer_no 作为外部单号，保证重复推送不会产生脏盘点单。
7. 异常处理：开启轻易云的告警通道，遇到 4xx/5xx 自动重试与人工介入。

实施步骤

• 阶段一：增量起点。策略上线当天，先跑一次全量拉取，把金蝶云星空里所有有仓位的物料库存一次性推到旺店通·奇门，作为基线。
• 阶段二：分阶段调度。源端 crontab 设为 */5 * * * *，目标端 1-59/5 * * * *，两端错开 1–4 分钟，避免两边同时写造成资源争抢。
• 阶段三：调度频率迭代。上线头两周保持 5 分钟一轮观察稳定性，之后结合业务峰谷调整到 10–15 分钟。
• 阶段四：监控与对账。在轻易云里配置对账看板，比对两边的 FBaseQty 与推送成功的 qty 之差，超过阈值告警。
• 阶段五：增量与全量双轨。日常走增量，若遇物料新增批次或人工触发，再跑一次全量校准——这是轻易云客户场景中第二种常见的应对模式。

踩坑复盘

1. 物料主数据没先到。sequence=A 的「cp_KQM货品同步」没跑通就直接推库存，目标端 spec_no 全部对不上，整单失败。先 A 后 B，不能跳。
2. 仓库编码直接传了 FStockId。金蝶的 FStockId 是数字主键，旺店通要的是编码字符串。务必在映射层做一次翻译，否则仓库会被默认建错。
3. 批次漏传。仓位+批次库存场景下，如果 FLot 为空却把可用量当库存量下发，盘点单会出现「总数对得上、批次对不上」的诡异差异。
4. 严格模式开关混乱。一上来就开 is_post_error=1，遇到一个新物料就整单失败，导致大量库存数据延迟。先用非严格模式跑稳，再切严格模式。
5. 重复推送产生脏单。如果 api_outer_no 没填或随机生成，轻易云重试机制会在旺店通侧生成多条盘点单。稳定做法是用源端 ID+仓库+物料拼一个稳定单号。

适用场景与不适用场景

适用于金蝶云星空作为库存主数据源、旺店通·奇门作为前端履约系统的中大型零售/分销企业，仓位数量稳定、物料主数据已建立映射的场景。不适用于：物料主数据尚未同步、金蝶侧无仓位维度、需要实时秒级库存（建议走消息队列而非轮询）、或仓位数量频繁变动的组织。