金蝶组装单子件出库 → 旺店通其他出库单:实战同步方案

这个策略解决什么问题(场景与价值)

某零售企业的仓配链路里,组装单子件出库长期依赖人工在两套系统之间搬运:金蝶云·星空旗舰版产生组装单后,仓管要把子件的行项目、数量、仓库再录入旺店通生成其他出库单,出错后还得到处核对。我们用轻易云数据集成平台(Qeasy)承接,把这部分交给调度自动跑,人工只处理异常,链路一断就有提示。

数据流向与字段映射(源 → 中间层 → 目标)

源端从金蝶拉组装单列表,中间层按时间窗与状态过滤,目标端写入旺店通其他出库单。关键字段对照:

源(金蝶)	含义	目标(旺店通)	含义	处理要点
billno	单据编号	outer_no	外部单号	拼接 billno+仓库编码,确保唯一,作为幂等键
id	主键	—	—	用于去重与断点续传
仓库编码	出库仓库	warehouse_no	仓库编码	来源实体编码表,与货品编码统一在映射中心维护
备注	业务说明	remark	备注	透传 comment,便于追溯
子件行项目	明细数组	goods_list	货品详情	中间层按子件逐行展开
—	—	is_check	是否审核	固定传 1,直接已审核,避免下游二次操作
—	—	reason	出库原因	写死"组装出库",统一口径

在轻易云上如何配置

进入轻易云 Qeasy 控制台,新建一个集成策略,挂到"供应链-业务单据"域下。源端选 Kingdee.QJB 适配器,API 用 /kapi/v2/dtog/im/im_assembbill/getList,POST 分页拉取,pageSize 视数据量调到 20-50;目标端选 Wangdiantong.QJB,API 用 wms.stockout.Other.createOther,POST 执行。两边适配器里的鉴权信息我们建议放平台共享资源池,不在策略里硬编。

字段映射上,编码类(仓库、货品、原因)统一在"编码映射中心"集中维护,不要散落在每条策略里——这是轻易云客户的常见做法,后续新增仓库或货品时只改一处。表头与表体建议分阶段:先把表头跑通,再开放 goods_list,最后接 is_check 与 reason,逐段上线、逐段验证。

实施步骤

增量起点:策略首次启用时,用业务日期倒推 7-30 天作为起点拉取存量数据,idCheck 打开,避免重复写入。之后以单据最后修改时间为增量锚点。
调度频率:源端 crontab 10-59/20 7-23 * * * 表示每小时 10/30/50 分启动;目标端 15-59/20 7-23 * * * 错开 5 分钟,避免上下游并发冲突。夜间 0-7 点业务量低,可暂停。
全量触发:重大业务节点(如月末结账、系统升级)用全量按钮重新刷一遍,以源端 billno 为锚覆盖。
监控:轻易云会按轮次记录拉取/写入/失败条数,异常件落到重试队列,人工每日巡检。

踩坑复盘

outer_no 不去重,会重复建单。典型错误是直接把 billno 当 outer_no,多仓库出库时下游会出多条。稳妥做法是 billno 拼上仓库编码后做哈希或拼接,作为全局幂等键。
分页参数没限速,源端限流。pageSize 一次拉 200,源端接口直接 429。建议起步 20,观察响应时间再逐步上调。
goods_list 行数被截断。目标端接口对单次明细行数有上限,常见是 100 行。中间层必须按行分批,否则整单丢失。
is_check 传 0,下游卡在待审核。不少工程师照搬字段名传了 0,下游仓库作业员没看到任务。组装单场景应直送已审核,即传 1。
时间窗没考虑跨天。源端按"当日 0 点到现在"过滤,夜里 0 点切换瞬间会丢单。稳妥做法是用滚动时间窗,以最后成功时间为锚。

适用场景与不适用场景

适用:组装/拆解场景下,子件需要从 ERP 出库到 WMS,业务单据在两个系统分别流转。需要稳定节奏、防重、自动审核。不适用:跨组织调拨、需要审批流的复杂出库,以及需要实时秒级响应的拣货作业——这类建议走事件触发而非轮询。