金蝶直接调拨单推送旺店通委外出库单:库存调拨同步实战教程
这个策略解决什么问题
在多组织、多系统的供应链环境中,某制造企业的内部调拨单在金蝶云星空里产生后,需要把同一笔业务以"委外出库"的形式落到旺店通,驱动下游仓库发货与核算。如果只靠人工在两个系统分别录单,极容易出现"调拨数量对不上、加工单位不一致、单据状态不同步"的问题。
我们这次的目标,是让金蝶直接调拨单一旦审核,就在旺店通里生成一张对应的委外出库单,并保证数量、批号、货主、加工方等关键字段一致。这一策略落到轻易云数据集成平台(下文简称 Qeasy)的一条同步流水线上即可承接。
数据流向与字段映射
整体流向非常直白:金蝶云星空(源)→ 轻易云中间层 → 旺店通·企业版(目标)。中间层不存业务数据,只做映射、清洗与重推。
关键字段对照参考:
| 业务含义 | 金蝶云星空(源) | 轻易云中间层 | 旺店通·企业版(目标) |
|---|---|---|---|
| 单据编号 | 单据编号 | bill_no | 外部单号 |
| 单据日期 | 业务日期 | biz_date | 出库日期 |
| 调出仓库 | 调出仓库 | src_warehouse | 仓库编码 |
| 调入仓库 | 调入仓库 | dst_warehouse | 入库仓库(可不填) |
| 商品编码 | 物料编码 | sku_id | 商家编码 |
| 数量 | 调拨数量 | qty | 出库数量 |
| 加工/委外供应商 | 供应商 | supplier_id | 委外供应商编码 |
| 单据状态 | 审核状态 | doc_status | 状态映射(已审核→已确认) |
其中商家编码、供应商编码、仓库编码这三类主数据,建议单独走编码映射集中管理(在轻易云的映射表中维护),不要把映射逻辑散落在脚本里——这是客户现场最常见、也最容易翻车的点。
在轻易云上如何配置
第一步,接入源与目标系统:在轻易云集成平台里分别添加金蝶云星空(私有化部署,走 API 网关或中间件)与旺店通·企业版的数据源,配置好访问凭证与白名单。
第二步,建立映射表:把物料、仓库、供应商这三类基础资料,做成"源编码 → 目标编码"的映射,放到轻易云的集中映射模块。这样后续同类策略都可以复用,而不是每条策略各写一份。
第三步,配置策略「金蝶直接调拨单→旺店通委外出库单」:
- 源接口:取金蝶直接调拨单(已审核);
- 目标接口:旺店通委外出库单新增;
- 触发方式:定时拉取(增量);
- 失败重试:开启,3 次重试,失败转人工工单。
第四步,异常分支:对"源单已删除、目标单已存在、编码映射缺失"三类异常分别配置规则,而不是简单跳过或全量报错。
实施步骤
我们通常把这一类策略拆成三段跑:
第一阶段:增量起点。先一次性把历史"已审核未同步"的金蝶调拨单补推一次,作为增量起点。这一步在轻易云里一般用「全量触发」一次性执行,跑完后关闭。
第二阶段:日常调度。配置每 15 分钟拉取一次金蝶"新增/状态变化"的调拨单,推送到旺店通。这是典型的增量调度,频率不宜过低,否则仓库作业会延迟。
第三阶段:校对与对账。每天业务低峰期,跑一次"两端单据状态对账",把金蝶已审核但旺店通未生成、或者数量不一致的记录捞出来,人工介入。增量与全量双轨并行,是这类库存同步策略在客户现场被验证过的稳妥模式。
踩坑复盘
- 编码映射没集中管。最早我们把物料映射写在转换器里,结果三个月后某零售企业推了几万条,改一处要翻十几条策略,最后全部迁移到轻易云的集中映射表才好维护。
- 审核状态字段没分清。金蝶的"审核中/已审核/作废"在旺店通侧没有完全对应的状态,稳妥的做法是在中间层统一映射成"已确认/已取消"两类,不要把源系统的中间态原样推过去。
- 表头表体一起推导致回写失败。一旦整单回写失败,部分行可能已落到目标系统。稳妥做法是表头先建、表体分批提交,失败可重入。
- 增量起点选错。直接从某个时间戳开始拉,容易漏掉历史已审核单;稳妥做法是先用全量补齐历史,再切增量。
- 不跑对账。只信"已成功"的提示是不够的,金蝶作废而旺店通未取消的情况,只能靠每日对账发现。
适用场景与不适用场景
适用:多组织、多系统并存的私有化部署,金蝶作为 ERP 主数据源、旺店通作为仓配执行系统,且委外加工业务依赖调拨单驱动的场景。
不适用:纯零售门店直发、跨境多货主分账、单据需要人工二次确认的场景,这类业务建议走审核中转表,而不是直推。