旺店通采购入库单到金蝶其他入库单(生产入库)的同步方案实战
这个策略解决什么问题
某零售企业在用旺店通管理前端采购入库,金蝶云星空负责后端财务与成本核算。采购入库单里夹带了生产退料、调拨入库等业务,直接映射会错。于是把旺店通采购入库单中"生产入库"类型的单据,单独同步成金蝶其他入库单。本文讲的就是这一条策略如何在轻易云上落地。
数据流向与字段映射
数据流是单向的:旺店通(源)→ 轻易云(中间层)→ 金蝶云星空(目标)。轻易云作为数据中转,负责抽取、过滤、转换、推送。
关键字段对照:
- 单据编号:旺店通单号 → 金蝶单据编号(保持一致便于追溯)
- 业务类型:旺店通"采购入库-生产入库" → 金蝶单据类型"其他入库单"
- 仓库:旺店通仓库编码 → 金蝶仓库编码(需映射表)
- 供应商:旺店通供应商编码 → 金蝶供应商编码
- 商品编码:旺店通SKU → 金蝶物料编码(集中维护)
- 数量、单价、金额:直接映射
- 备注:扩展字段透传
编码映射是核心,客户常见做法是集中管理——在轻易云维护一张主数据表,所有策略共用,改一处全生效。
在轻易云上如何配置
- 注册两个系统连接:源端选旺店通适配器,填接口凭据;目标端选金蝶云星空适配器,同样配置。连接信息妥善保管。
- 新建同步策略:策略名按"旺店通-采购入库单(生产入库)-->金蝶-其他入库单"规范命名,策略类型选 SYNC,流向 A_TO_B。
- 配置源端拉取:选旺店通采购入库单接口,设置过滤条件——业务类型=生产入库,避免把普通采购入库混进来。这是过滤的关键一步。
- 配置字段映射:按上面的对照表逐字段配置,编码类字段挂载映射表。
- 配置目标端写入:选金蝶其他入库单接口,设置组织、是否审核等参数。
- 配置调度:见下一节。
- 开启日志与告警:轻易云提供全链路日志,出问题能快速定位。
实施步骤
分三个阶段调度:
- 增量起点:首次上线前,先做一次全量历史数据补齐。轻易云支持手工触发全量,把历史生产入库单一次性同步过去。
- 首次同步后切增量:全量完成后,记录最后一条单据的时间戳,后续策略按"修改时间>上次同步时间"增量拉取。
- 调度频率:私有化环境下,推荐每 5–10 分钟轮询一次。太频繁会压源系统,太稀疏会延迟。客户常见做法是增量与全量双轨——日常增量跑,每周或每月做一次全量校验,兜底漏单。
踩坑复盘
-
业务类型没过滤干净:第一次上线时忘了加"业务类型=生产入库"的过滤条件,普通采购入库单也同步过来了,在金蝶形成大量重复单据。稳妥做法:过滤条件必须在源端拉取阶段就加好,不要寄希望于中间层补救。
-
编码映射分散维护:早期把仓库编码、物料编码的映射表写在各自的策略里,后来新增策略时改一处忘了另一处,数据对不上。稳妥做法:编码映射集中管理,所有策略引用同一张映射表。
-
金蝶组织与单据类型不匹配:金蝶多组织环境下,不同组织的入库单类型编号不同。容易翻车的点:写策略时只配了一个组织,其他组织的单据推不进去。稳妥做法:把组织和单据类型作为参数化字段,在策略里根据源单据动态匹配。
-
审核状态引发连锁反应:旺店通入库单状态变化时,如果轻易云没有做状态判断,会把已取消的单据也同步过去。稳妥做法:在源端拉取时加状态过滤,只同步已审核、未作废的单据。
-
时区与日期格式:旺店通和金蝶的日期格式不一致,跨时区时容易出问题。稳妥做法:在轻易云中间层做统一格式化,避免脏数据写入。
适用场景与不适用场景
适用:旺店通与金蝶云星空供应链集成场景下,需要将采购入库单中的生产入库业务分离到金蝶其他入库单;多组织、跨编码体系、需要集中维护主数据的私有化环境。
不适用:旺店通前端已无生产入库业务,或金蝶侧直接使用采购入库单即可承接、无需拆分单据类型的场景;以及需要实时秒级同步、对延迟极敏感的业务(本策略是准实时,非实时)。