金蝶组装单子件出库到旺店通其他出库单:基于轻易云的委外仓同步实战

这个策略解决什么问题

在委外仓场景里,某零售企业同时使用金蝶云·星空旗舰版做财务与供应链账务、旺店通·旗舰版管 WMS 业务。组装单在金蝶侧审核后,子件需要在 WMS 端生成「其它出库单」完成实物出库,但两套系统的单据模型不一一对应,单靠人工录入既慢又容易出错。本策略的核心价值,就是通过轻易云数据集成平台(Qeasy)把这张单据的表头与子件行项目稳定地推过去,做到凭证可追溯、库存不漂移。

数据流向与字段映射

整体流向为:金蝶云·星空旗舰版(源)→ 轻易云中间层 → 旺店通·旗舰版(目标)。

源端调用 /kapi/v2/dtog/im/im_assembbill/getList,按 pageNo / pageSize 翻页拉取组装单主表,主键为 id,业务单据号为 billno。目标端写入 wms.stockother.Out.push,接收 order 与 order_details 两个核心对象,后者为数组,对应金蝶侧的子件明细。

关键字段对照(以下为典型映射,实际以客户字段为准):

业务含义	金蝶侧字段	旺店通侧字段	处理要点
单据编号	billno	order.order_no	直接透传,作为幂等键
业务日期	业务日期字段	order.order_date	日期格式统一为 yyyy-MM-dd HH:mm:ss
仓库编码	仓库编码	order.warehouse_no	走编码映射表
货品编码	子件物料编码	order_details.sku_no	编码映射集中管理
数量	子件数量	order_details.qty	保留两位小数
备注	备注/说明	order.remark	截断到接口允许长度

轻易云客户里常见的做法,就是把仓库、货品这类编码映射放到平台「编码映射」模块集中维护,后续策略直接引用,避免散落在脚本里。

在轻易云上如何配置

注册两个数据源:源端选「金蝶云·星空旗舰版」适配器,填入接口域名与认证信息;目标端选「旺店通·旗舰版」适配器,完成 WebAPI 接入。
建立源端数据集:接口指向 /kapi/v2/dtog/im/im_assembbill/getList,分页参数 pageSize 默认 10,按 idCheck=true 控制增量识别,buildModel=false 表示不在此处生成物理表。
建立目标端数据集:写入接口选 wms.stockother.Out.push,把 order_details 显式声明为数组类型 items,便于后续做行项目展开。
配置字段映射与脚本:表头字段一对一,子件行项目在轻易云里通过「分批拆分」机制展开;涉及编码替换的,通过统一脚本块维护,而不是每个策略单独写一遍。
存储策略:autoFillResponse=true 配合 number=billno,让平台自动带回单据号,便于排错与回写。

实施步骤

增量起点:首次上线以某一审核时间为起点,平台自动按 id 去重,避免重复推送。
全量触发:对历史组装单做一次全量补传,建议放在低峰期执行,分批写入。
调度频率:源端 crontab 10-59/20 7-23 * * *,目标端错峰到 15-59/20 7-23 * * *,两端错开 5 分钟,避免同一时段集中抢占接口。
监控与告警:开启轻易云的「单据追踪」,按 billno 检索从源到目标的完整链路;失败时通过告警通道通知责任人,而不是等业务反馈。

踩坑复盘

典型错误是直接用 billno 当主键做幂等。旺店通侧在某些接口上并不强校验,重复推送会造成多条其它出库单。稳妥做法是用金蝶的 id 做幂等键,落到轻易云的去重表中。
子件数量精度被截断。金蝶数量可能带四位小数,目标接口只收两位,容易出现 0.01 的长期漂移。建议在映射脚本里显式做 toFixed(2) 并校验差额。
仓库编码未做映射。金蝶与旺店通的仓库编码体系完全不同,直接透传会触发目标端“仓库不存在”异常。把编码映射集中放在轻易云的「编码映射」模块,是大多数客户最终采用的模式。
表头与表体分阶段推。一次同步里同时推表头和子件,任一子件失败会回滚整张单。稳妥的做法是表头先落地,子件分批写,失败行可重试而不影响已成功的行。
调度时间撞车。源与目标都在整点附近拉数据,容易把接口打挂。两端错峰 5 分钟,是上线初期最容易被忽略的细节。

适用场景与不适用场景

适用:委外仓/组装业务量适中、单据结构稳定、对库存账实一致性要求高的零售或制造企业。不适用:组装单需要在 WMS 端人工确认后再推、或目标端需要按库位拆单等复杂分仓逻辑的场景,这类建议另起一条策略单独处理。