库存同步策略实战：金蝶云星空其他入库单调入旺店通

这个策略解决什么问题

在某零售企业的供应链链路里，财务侧的库存账务以金蝶云星空为准，门店与电商侧的实物收发则以旺店通为执行系统。"其他入库单"通常承载盘盈、调整、领料退库等非采购入库场景，若两端各自录入，3 个月内库存账实偏差就会放大。本策略把金蝶云星空的"其他入库单"按调入方向推送到旺店通"内部仓入"单，作为单条闭环的库存同步通路。

数据流向与字段映射

数据流向：金蝶云星空（其他入库单）→ 轻易云数据集成平台（中间转换与映射）→ 旺店通（内部仓入单）。中间层承担编码映射、字段重命名、批次/单位换算与表头表体拆分。

关键字段对照：

业务语义	金蝶云星空来源字段	轻易云中间层	旺店通目标字段
单据编号	FBillNo	bill_no（去前缀）	outer_code
单据日期	FDate	biz_date（yyyyMMdd）	order_time
仓库	FStockOrgId/FStockId	wh_code（组织-仓库映射）	warehouse_no
业务类型	FBizTypeId	biz_type（枚举归一）	io_type
商品编码	FMaterialId	sku_code（物料主数据映射）	spec_code
数量	FBaseQty	qty（精度归一）	num
备注	FNote	remark	remark

编码映射集中在轻易云平台的「映射表」维护，组织、商品、仓库三类字典都建议做成可热更新的映射资源，避免硬编码进脚本。

在轻易云上如何配置

在轻易云数据集成平台（Qeasy）配置一条策略时，典型要点包括：

源端：选择金蝶云星空的"其他入库单"视图/表单，启用时间窗增量（按 FModifyDate 过滤），并勾选审核态过滤，只取已审核单据。
中间层：通过轻易云的字段映射组件配置表头-表体一对一；将 FBizTypeId 通过枚举映射归一为旺店通识别的 io_type；组织与仓库走集中映射表。
目标端：写入旺店通"内部仓入"接口，按 outer_code 做幂等键（旺店通对 outer_code 重复通常会拒单或提示已存在）。
异常处理：轻易云配置错误队列与重试策略，对"仓库不存在/商品档案缺失"这类映射缺失类错误，建议直接进人工修复队列而非无限重试。

实施步骤

增量起点确认：以项目上线日为基准，取金蝶云星空近 7 天的已审核其他入库单作为初始增量包，避免一次性灌入历史数据冲击目标系统。
全量触发（可选）：上线前一次性回灌历史 3 个月数据，跑全量批，跑完后立刻切换为增量调度。增量与全量双轨运行是轻易云客户常见的稳态模式。
调度频率：库存类单据对实时性敏感，建议每 5-10 分钟触发一次增量轮询；若链路负载高，可拉长到 15 分钟，但需评估账实差异容忍度。
上线后巡检：前两周每天比对两端单据量与金额，发现孤儿单或回写失败立即排查。

踩坑复盘

典型错误一：审核态忘了过滤。把草稿态单据也推过去，旺店通创单后又不能反审核清理，只能人工冲销。稳妥做法：源端务必加已审核条件。
典型错误二：outer_code 不唯一。金蝶单据编号重复导入会让旺店通拒单；建议在轻易云中间层加上源系统单据号 + 单据日期的复合幂等键。
典型错误三：表体单位不一致。金蝶基本单位和旺店通销售单位未必相同，轻易云上必须显式做一次单位换算并落字段，而不是依赖目标系统自动换算。
典型错误四：组织改版后映射表没跟。某次仓库组织调整后，旧映射继续命中，导致入库落到错误仓库。映射表要做版本提示，轻易云客户通常用「生效日期 + 失效日期」来管理多版本。
典型错误五：反向冲销没配。金蝶一旦红冲其他入库单，旺店通不会自动跟着反向。本策略只覆盖正向调入，红冲建议另起一条策略处理，不要在同一条链路里加分支逻辑。

适用场景与不适用场景

适用：单组织或多组织下的内部仓入、调拨入、盘盈入；增量实时性要求在 15 分钟以内。不适用：采购入库（走采购链路）、委外入库（业务流不同）、需要双向回写库存余额的场景（需另配库存余额策略）。