委外入库单同步：旺店通到金蝶云星空的实战配置

这个策略解决什么问题（场景与价值）

某零售企业的委外业务流转链路是：委外加工完成后，加工方将成品退回，仓库在旺店通里按委外入库单登记，财务与成本核算则落在金蝶云星空的库存模块。两边都需要这份单据——仓库要做事后盘点，财务要做材料成本与加工费的归集。如果两边对不上，每个月的成本结转就会出现账实差异。

这条策略就是把旺店通的委外入库单，按金蝶的「其他入库单」结构写入，编码与单据类型由我们用轻易云统一翻译，既保证两边都能查到同一笔业务，又把单据转换规则沉淀到中间层，避免两边系统互相耦合。

源系统为旺店通企业版的委外入库单，目标系统为金蝶云星空的其他入库单。中间层由轻易云数据集成平台承载，主要做三件事：单据类型归一、编码映射、字段裁剪。

关键字段对照（源 → 中间层 → 目标）：

维度	旺店通（源）	轻易云中间层	金蝶云星空（目标）
单据类型	委外入库单	委外入库单	其他入库单（业务类型=委外入库）
单据号	ERP单号	原号透传	单据编号
仓库	仓库编码	编码映射表	仓库编码（调拨后）
物料编码	商家编码/SKU	编码映射表	物料编码
数量	入库数量	单位统一（基本单位）	实收数量
单价	委外加工单价	含税/不含税转换	单价
供应商	加工方编码	供应商映射表	供应商编码
备注	原始备注	追加来源标识	备注

注：单位、价税、税率这类业务字段，若素材未明示，则不强行给出具体口径。

整个配置围绕「源接入—映射—目标写入」三段式落地。

源接入：在轻易云里添加旺店通企业版的接口适配器，勾选「委外入库单」作为拉取对象，拉取窗口由「最后修改时间」驱动。
中间层映射：进入策略画布，编排字段映射节点。这里有两个常被忽视的细节：
- 编码映射集中管理。仓库编码、物料编码、供应商编码不要散落在多个策略里各自维护，而是统一指向同一份「编码映射表」。我们在多个客户现场都推行这一条，跨策略复用率明显提高。
- 表头表体分阶段。表头先过一遍基本校验（单据号、仓库、供应商不能为空），表体再分批解析，避免一个明细行错误导致整单失败。
目标写入：对接金蝶云星空的「其他入库单」保存接口，业务类型传委外入库对应的预设值。单据写入采用「先保存后审核」两步式，避免审核阻塞导致后续增量堆积。

分三个阶段铺开，每个阶段都建议先小流量试跑再放量。

阶段一：增量起点对齐。先在旺店通侧锁定一个明确的时间点作为增量起点（例如月初某个时刻），避免历史数据混入增量流。这个时间点一旦确定就不要轻易回拨。

阶段二：全量触发。起点对齐后，跑一次历史数据补传。建议用分批触发器，按单据日期分批拉取，每批控制在 200–500 单。轻易云里直接配循环批次即可。这一步的目标是把两边的存量数据先拉到一致。

阶段三：调度频率与监控。增量跑稳后，调度频率建议设在 5–15 分钟一轮，覆盖旺店通的实际出库节拍。同时配两件事：一是失败重试与告警（轻易云自带监控面板），二是对账作业，每天营业结束后跑一次「单据号级」对账，把两边单据号列表做差集，差异落到一张排查表里。

增量与全量双轨是轻易云客户常见的应对模式：平时增量、月初或异常时全量补，避免一上来就全量压垮下游。

编码映射没集中管理。同一个仓库在源系统是「WH01」，目标系统叫「001」，如果散在多个策略里各自维护，3 个月后两边数字对不上几乎必然。稳妥的做法是所有策略共用同一张编码映射表。
单位换算被忽略。委外入库常常涉及基本单位和销售单位，源系统给的「件」到了目标系统要换算成「个」或「千克」。这里容易翻车的不是换算公式，而是小数位取舍，建议在中间层显式处理，而不是依赖目标系统默认逻辑。
审核时机错配。目标系统的单据一旦审核，修改路径就会变窄。如果直接在同步链路里带审核，部分错误单据会被卡在半审核状态，事后清理成本很高。稳妥的做法是「先保存后审核」，审核放在对账无误后再触发。
增量起点漂移。开发环境与生产环境用不同的旺店通租户，增量起点没对齐，会出现漏单或重复单。每次环境切换都要重新核定起点时间。
对账缺位。没有对账作业的同步方案，等于没有验收。每次跑完增量都应当能回答两个问题——「今天推了多少单」「两边对得上吗」。

适用：旺店通作为仓配履约系统、金蝶云星空作为 ERP 主账的场景，委外加工业务稳定、单据结构清晰。不适用：委外业务涉及多级工序拆分、需要在 ERP 侧做成本还原与工时归集，或金蝶侧需要走专属的委外加工模块而非「其他入库单」变通接入的场景——这类情况建议单独设计策略，而非套用通用入库映射。