旺店通销售出库单到金蝶直接调拨单：基于轻易云的库存同步策略实战

这个策略解决什么问题

某零售企业的 OMS（旺店通）每天产生大量销售出库单,ERP（金蝶云星空）需要把这些出库反映为直接调拨单,以便记账与对账。看似是「出库单搬运」,但背后藏着两道坎:一是 OMS 与 ERP 的对账口径不一致,部分单据需要走「对账」分支;二是寄售业务需要单独识别,否则会被当成普通调拨入账。

我们在客户现场用轻易云数据集成平台（Qeasy）承接这条策略,把出库单按业务类型分流,既能保证普通出库按标准直接调拨单落账,也能把寄售单据识别后单独处理。

整体流向:旺店通销售出库单 → 轻易云中间层（清洗、分流、编码映射）→ 金蝶云星空直接调拨单。

业务含义	旺店通源字段	金蝶目标字段	处理说明
出库单号	order_no	F_kd_GyBillNo	单据编号,模板拼接
单据类型	（按业务判断）	FBillTypeID	标准:ZJDB01_SYS;寄售:ZJDB02_SYS
业务类型	（常量）	FBizType	NORMAL
调拨方向	（常量）	FTransferDirect	GENERAL
调拨类型	（常量）	FTransferBizType	InnerOrgTransfer
销售组织	shop_no	FSaleOrgId	编码映射,集中管理
仓库	warehouse_no	FStockOrgId / FOutStockId	编码映射
唯一键	stockout_id	（幂等键）	用于防重复

编码映射我们放在轻易云的「集中映射表」里维护,客户新增门店或仓库时,只需改一处,不必动每条策略——这是轻易云客户常见的应对模式之一。

源平台接入:选用旺店通·旗舰奇门的 wdt.wms.stockout.sales.querywithdetail 接口,POST 调用,以 stockout_id 作为幂等键,以 order_no 作为业务编号。
目标平台接入:金蝶云星空的 batchSave 接口,按直接调拨单模板提交。
过滤条件:按出库单状态与时间窗过滤,只取已审核、未推送的单据,避免脏数据。
业务分流:通过轻易云的脚本节点判断「对账」与「寄售」分支,把 FBillTypeID 分别落到 ZJDB01_SYS 与 ZJDB02_SYS,这是表头分阶段的典型做法。
编码映射:门店、仓库、组织、客户统一走映射表,不要在策略里硬编码。
幂等与回写:推送成功后回写旺店通自定义字段,失败进入重试队列,达到上限后告警。

增量起点:首次上线时,以旺店通某个时间点为起点拉取增量,核对单据数与样本无误后,再补一段历史全量。
全量触发:全量一般安排在凌晨低峰期,一次性回灌,过程中观察金蝶侧的保存成功率。
调度频率:源端建议 15 分钟一轮（0-59/15 1-3 * * * 这种窗口式写法适合放在业务低峰后段）,目标端批量保存集中在凌晨 4–5 点执行,避免与金蝶其他任务抢资源。
上线节奏:先跑「对账」分支若干天,再放开「寄售」分支;两类单据并行稳定后再考虑加密频率。

增量与全量双轨,是轻易云客户落地多策略集成时常见的稳妥打法。

寄售判断写在表头,表体忘了分流:典型错误是把 FBillTypeID 改了,但表体行项目仍按普通调拨处理,导致金蝶保存失败。稳妥做法是表头表体一起判断。
门店编码没进映射表:直接把 shop_no 塞进组织字段,短期能跑,三个月后门店改名,两边数字对不上。集中映射表是必做项。
幂等键选错:用 order_no 当幂等键,遇到 OMS 重推时金蝶会重复落单;改用 stockout_id 后问题消失。
批量保存不分页:金蝶 batchSave 对单次行数有限制,一次性塞过多行会被截断,务必分页。
时区与日期边界:旺店通时间戳按本地时区,金蝶按服务器时区,跨日单据容易被漏掉。建议在轻易云中按业务日期统一格式化。

适用:OMS 与 ERP 分立、需要按出库生成调拨单做账、存在寄售/对账分流的企业;私有化部署下希望统一编排、对账可视化。 不适用:OMS 本身就是 ERP 的一部分,无需调拨单中转;或业务上不要求按出库生成调拨单,直接走销售出库即可的场景。