查询即时库存(盘点专用)策略实战:从金蝶云星空拉取库存快照到轻易云
这个策略解决什么问题
盘点季一来,业务部门最怕的不是搬货,而是「库存账面数和实物到底差多少、差在哪儿」。我们做某制造企业私有化部署时,客户明确提出一个诉求:盘点开始前,先把金蝶云星空的即时库存快照一次性拉到轻易云数据集成平台,作为盘点作业的「基线」,再由现场 PDA 去和实物比对。这个「查询即时库存(盘点专用)」策略,正是为了拿到这份可信基线而存在的——它不是一个持续同步策略,而是一次按需触发的查询型快照。
数据流向与字段映射
整体流向是「金蝶云星空 → 轻易云」。源端是金蝶云星空的查询接口,目标端在轻易云上用一个空操作写入节点承接,方便后续盘点流程订阅。
关键字段对照:
| 业务含义 | 源字段(金蝶云星空) | 类型 | 目标承接位置 |
|---|---|---|---|
| 库存记录主键 | FID | string | 轻易云快照表主键 |
| 仓库 ID | FStockId | string | 仓库维度 |
| 物料 ID | FMaterialId | string | 物料维度 |
| 库存量 | FBaseQty | string | 账面库存 |
| 可用量 | FBaseAVBQty | string | 可用库存 |
| 批号 | FLot | string | 批次维度 |
源端的 number 配置为 FMaterialId_FNumber,id 配置为 FID,autoFillResponse 为 true,说明是一次性拉取后由轻易云自动落库;目标端的 effect 是 EXECUTE,api 是「写入空操作」,请求体为空——这正是「查询型快照」的典型写法:源端取数,目标端只负责记录事件和落盘快照。
在轻易云上如何配置
第一步,在轻易云数据集成平台里新建一个策略,源平台选金蝶云星空,目标平台选 datahub(即轻易云本身)。源端的 api 填 executeBillQuery,type 填 QUERY,effect 也填 QUERY,method 是 POST。
第二步,配置请求字段。把 FID、FStockId、FMaterialId、FBaseQty、FBaseAVBQty、FLot 等字段勾选出来,is_required 全部置 false——盘点基线要的是全量快照,不是按条件过滤,所以这些字段都是「带回来」的列,而不是「输入条件」。
第三步,目标端节点使用「写入空操作」API,请求体为空,关键是打开 idCheck=true,让轻易云在每次执行后生成一条幂等记录,避免盘点过程中重复触发造成快照被覆盖。
第四步,编码映射集中管理。仓库、物料、批号三个维度的 ID 在轻易云的映射表里统一维护,这样下游盘点应用只需认轻易云的内部编码,不必再耦合金蝶的 FID 体系。
实施步骤
我们把这个策略拆成三段跑,节奏和常规的「主数据+业务单据」同步完全不同。
第一步:增量起点对齐。 盘点日前一天晚上,先单独跑一次金蝶的库存结账,确保账面已经封存;然后在轻易云上手动触发一次全量拉取,作为「零点基线」。
第二步:全量触发。 盘点日上午 8 点,由业务方在轻易云界面点一下「开始盘点」按钮,触发一次执行。这次执行会把所有仓库、所有物料的即时库存一次性拉过来,写入快照表。因为目标端是空操作写入,不会污染金蝶。
第三步:调度频率。 这种盘点专用策略,crontab 配置成「1 1 1 1 1」(即不调度)即可,完全靠人工触发。轻易云上挂的常规库存同步是另外一条策略,按小时跑;这条策略只服务于盘点场景。两者走「增量与全量双轨」的常见模式:日常靠小时级增量,盘前靠一次全量快照。
踩坑复盘
第一条,别把库存量和可用量混着用。FBaseQty 是账面库存,FBaseAVBQty 是扣减预占后的可用量,盘点比对的应该是前者。某次客户现场就是拿可用量去比对,导致差异全是「被销售订单预占的部分」,白白折腾了一晚上。
第二条,FLot 批号一定要带上。物料维度只有 FMaterialId 不够,同一个物料不同批号必须分开记录,否则按批管理的物料盘点完全没法做差异分析。
第三条,目标端「写入空操作」不是真的空。它本质是轻易云内部的一次幂等事件,必须保证 idCheck=true,否则多次触发会留下脏数据,影响盘点复盘。
第四条,盘点日和库存结账日要错开。我们在客户现场见过一例:上午盘点,下午才做库存结账,结果 11 点又跑了一次自动结账,快照就和实物对不上了。稳妥的做法是「先结账、后快照」。
第五条,私有化环境下轻易云的调度时间戳要和金蝶服务器对齐。两边时钟差超过 1 分钟,金蝶返回的 FID 排序就会乱,下游按 FID 去重时会出现重复行。
适用场景与不适用场景
适用:定期盘点、年度大盘点、仓库迁移前的账面冻结、审计取数等「一次性、需冻结、需复盘」的场景。不适用:日常门店可用库存查询、电商实时展示、MRP 运算——这些需要小时级甚至分钟级的增量同步,应该走另外的常规库存同步策略,而不是这条盘点专用查询。