采购入库单(委外)同步方案:从金蝶云星辰到旺店通的实战配置

这个策略解决什么问题

委外加工业务中,原材料发给供应商、加工完成后成品入库这一环节,需要在ERP与WMS之间建立稳定的单据通道。某零售企业在实际项目中就遇到过这类问题:金蝶云星辰里审核完委外入库单,旺店通侧库存却迟迟不更新,委外仓的入库数对不上,3个月后盘点才发现两边数字偏差很大。我们用轻易云数据集成平台(Qeasy)承接了这条策略,把金蝶云星辰的委外采购入库单增量推送到旺店通·企业奇门,核心是把「委外仓出入库单」这一特殊单据类型打通,避免和标准采购入库单混在一起处理。

数据流向与字段映射

数据流向是单向的:金蝶云星辰V2 → 轻易云DataHub → 旺店通·企业奇门。源端用 QUERY 类型的 GET 接口 /jdy/v2/scm/pur_inbound 拉单,目标端用 WebAPI 类型的 POST 接口 wdt.vip.wms.stockinout.order.push 推送。

主表关键字段对照如下:

源字段(金蝶)	目标字段(旺店通)	映射类型	转换规则
bill_no	api_outer_no	DIRECT	直接映射,作为外部单号去重
material_entity.material_entity_stock_number	warehouse_no	DIRECT	取明细第一行的仓库编码
—	order_type	CONSTANT	固定值 "2",表示入库
—	auto_check	CONSTANT	固定值 "1",推送后自动审核
material_entity	goods_list	ARRAY	明细数组整体映射

明细行按行循环处理,典型映射包括:material_number → spec_no、qty → num、tax_price → tax_price、batch_no → batch_no、producedate → production_date、validdate → expire_date 等。仓库编码需要从明细行提取,这是金蝶云星辰的数据结构特点,主表本身不带仓库字段。

在轻易云上如何配置

在轻易云平台上配置这条策略时,我们通常分三块来做:源端接口、目标端接口、字段映射。

源端接口配置:API 选 /jdy/v2/scm/pur_inbound,方法 GET,分页大小默认 10(最大 100)。关键入参包括 enable=1(只查可用单据)、bill_status=C(只拉已审核)、modify_start_time 与 modify_end_time 用时间戳毫秒值做增量窗口。

目标端接口配置:API 选 wdt.vip.wms.stockinout.order.push,方法 POST。两个固定常量直接写死:order_type=2、auto_check=1。api_outer_no 引用 {{bill_no}},warehouse_no 引用明细首行的 {{material_entity.material_entity_stock_number}}。

编码映射集中管理:仓库编码和物料编码的对照关系,很多客户会单独建一张主数据映射表(放在轻易云的「编码映射」节点里),而不是散落在每条策略里。这样新增委外仓或物料时,只需要维护一张表,所有引用它的策略自动生效。表头表体的映射我们建议分阶段配置:先把主表跑通,再处理明细。

实施步骤

第一步:增量起点确定。策略上线前,先用全量方式把历史已审核单据回灌一次,记录回灌结束时刻 T0 作为增量起点。轻易云的「全量触发」按钮可以一键完成历史数据初始化,跑完后自动切换到增量模式。

第二步:调度频率配置。业务场景是白天作业密集、夜间基本不动,所以采用 */10 8-22 * * * 的调度规则:每天 8 点到 22 点,每 10 分钟拉取一次。这样既能保证时效性,又不会在夜间空跑浪费资源。

第三步:运行监控与异常处理。上线后第一周重点盯三类异常:仓库编码找不到(说明仓库主数据没同步)、物料编码找不到(物料主数据缺失)、委外仓类型不匹配(旺店通里仓库被误配成普通仓)。轻易云的运行监控面板可以按错误类型聚合,定位起来比较快。

第四步:增量与全量双轨运行。日常按增量跑(基于 modify_start_time/modify_end_time),但保留全量回灌能力。轻易云客户常见的应对模式是:每周日凌晨跑一次「近 7 天全量比对」,作为增量的对账校验,避免漏单。

踩坑复盘

仓库编码取错位置。金蝶云星辰的主表没有仓库字段,仓库编码藏在明细行的 material_entity_stock_number 里。如果按常规思路从主表取,推送过去就是空值。这里容易翻车,稳妥的做法是明确写「取明细第一行」。
委外仓与普通仓混用。同一份策略如果不做业务类型过滤,会把标准采购入库单也推到委外仓接口,导致旺店通报错或库存错乱。委外采购入库单与标准采购入库单应该通过 transtype 区分,或者干脆分成两条策略跑(P4-236 跑标准、P4-238 跑委外)。
重复推送导致单据更新而非新建。旺店通以 api_outer_no 作为外部单号去重,重复推送同一张单据时是更新原单而不是报错。如果源端单据有变更但状态没改(比如只改了备注),增量时间戳可能捕捉不到,造成两边数据漂移。
批次管理字段缺失。当物料启用批次管理时,必须传 batch_no、production_date、expire_date 三个字段,缺一个旺店通就拒收。这类校验很严,集成测试阶段需要把启用批次的物料单独跑一遍。
auto_check 误关闭。auto_check 默认是 1(自动审核),如果不小心改成 0,入库单推过去后停留在待审核状态,库存不会更新,业务侧会以为集成挂了。

适用场景与不适用场景

适用场景:有委外加工业务的企业,需要在 ERP(此处为金蝶云星辰)与 WMS(此处为旺店通·企业奇门)之间同步委外采购入库单,且目标 WMS 支持委外仓出入库单 API。

不适用场景:纯自有工厂入库(应走标准采购入库单策略)、目标 WMS 不支持委外仓类型(需要先用主数据策略初始化仓库)、源 ERP 不带业务类型字段(无法区分委外与标准,建议先做主数据治理)。