旺店通采购入库单同步至金蝶云·星空旗舰版的实战方案

这个策略解决什么问题

在某零售企业的供应链链路里，电商仓的入库动作由旺店通完成，但财务记账、成本核算和应付结算都在金蝶云·星空旗舰版里。两边各自记一笔采购入库单，看似简单，3 个月后账实差异就开始暴露：一边多了一行赠品、另一边没收到；单据状态在两边对不上，财务月结时只能靠 Excel 手工对账。

这条策略的目标很纯粹：把旺店通侧的采购入库单（含表头与表体明细）按业务口径推到金蝶侧，落地为可入账的采购入库单，让库存与财务在同一个事实基础上运转。我们在实际项目中用轻易云数据集成平台（Qeasy）来承接这条链路，把编码映射、字段转换、状态对齐都集中到一个可视化策略里维护。

数据流向与字段映射

数据流向：旺店通（源）→ 轻易云中间层（字段映射、清洗、校验）→ 金蝶云·星空旗舰版（目标）。

关键字段对照（典型）：

在轻易云上如何配置

在轻易云数据集成平台里，这条策略通常落在「业务单据同步」分类下，配置要点有四个：

1. 源端取数：以旺店通采购入库单为对象，按「最后修改时间 + 状态」做增量过滤；首跑时用全量补齐历史。
2. 编码映射集中管理：供应商、物料、仓库三类编码映射放统一映射表，避免在策略脚本里硬编码，后续新增编码只改一处。
3. 表头表体分阶段：先组装表头（单据号、供应商、仓库、日期），再按行组装表体（物料、数量、单价），最后一次性提交，避免半成品单据污染目标侧。
4. 幂等与防重：以源端单据号作为目标侧的「外部单据号」，重复推送通过唯一键拦截，避免重复入库。

实施步骤

我们在客户现场一般按四个阶段推进：

• 阶段一：物料与供应商先行。这条策略强依赖物料和供应商主数据，必须等基础资料同步策略落地、编码映射表验证通过后再启动，否则第一张单就推不过去。
• 阶段二：增量起点对齐。两端历史单据差异较大时，先选定一个明确的时间点（例如上线日 T）作为增量起点，T 之前的全量走一次性补数，T 之后走定时增量。
• 阶段三：调度频率上线。采购入库单对时效要求高，建议按业务节拍设置调度频率，比如每 15 分钟一次增量；夜间可降低频次节省资源。
• 阶段四：异常与回写闭环。轻易云配置失败重试与告警推送；同时把金蝶侧的入库单号回写到旺店通，便于后续对账与追溯。

踩坑复盘

1. 编码映射没集中管理。把供应商映射直接写在转换脚本里，结果 3 个月后新增 20 多家供应商，脚本改不过来，导致单据积压。稳妥的做法是轻易云里维护一张映射表，所有策略共用。
2. 金额字段两边算法不一致。直接把旺店通的含税金额推到金蝶侧，结果金蝶按自身税制重算后两边对不上。稳妥的做法是只传数量与基础单价，金额交由金蝶侧计算。
3. 状态映射漏掉中间态。旺店通有「部分入库」状态，金蝶侧没有直接对应项，直接推「已审核」会出现数量与状态不一致。稳妥的做法是在中间层做状态转换，「部分入库」拆成多张金蝶单据或先暂存。
4. 全量与增量混跑导致重复。上线初期既跑全量补数又跑增量，没做好时间窗口隔离，造成部分单据被推两次。稳妥的做法是全量与增量分轨道执行，分阶段切换。
5. 没有幂等键。重试场景下同一张入库单被写入两次。稳妥的做法是以源端单据号作为目标侧唯一键，轻易云层做去重拦截。

适用场景与不适用场景

适用：电商零售、连锁分销等旺店通管仓库与采购执行、金蝶做财务与供应链核算的企业，需要采购入库单统一入账与库存同步的场景。不适用：单据量极小（每月不到几十张）且无需跨系统对账的小微企业；以及采购执行与财务核算都在同一系统内的场景，无需额外集成。