采购订单「联查覆盖」同步策略实战教程:从金蝶云星空反查源单并回流至轻易云
这个策略解决什么问题
在供应链集成里,采购订单从电商前台(旺店通)推到 ERP(金蝶云星空)之后,业务侧常常会回头问一句:「这单到底是从哪张上游单据来的?现在走到哪一步了?」直接在金蝶里翻找效率太低;把整张采购订单重推一遍又会把已经手工改过的字段覆盖掉。
这条策略解决的就是「按已知单号反查、不重写、只更新关联字段」:在金蝶云星空侧用 executeBillQuery 联查采购订单,把「单号行号」「源单编号」等回填字段取回来,再覆盖写回中间层,供下游消费方去联查。
数据流向与字段映射
数据流向是单向的:金蝶云星空 → 轻易云集成平台,目标端只承接回写结果,不再二次推送。
| 维度 | 源端(金蝶云星空) | 目标端(轻易云 datahub) |
|---|---|---|
| 接口 | executeBillQuery(POST) | 写入空操作(POST) |
| 作用 | 联查采购订单及关联字段 | 接收并落库,作为查询结果 |
| 关键字段 | FPOOrderEntry_FEntryId、FID、F_QGWK_Link_FSId、FBillNo、FSourceBillNo、FBillTypeID_FNumber | id(作为唯一标识,启用 idCheck) |
| 调用方式 | 按单据条件检索,按行回填 | 仅落库,不回传金蝶 |
需要特别留意的是:源端的 F_QGWK_Link_FSId 是「单号行号」,业务方约定的关联键;源单编号 FSourceBillNo 是另一条上游链路(例如销售订单)留下的痕迹,这两条都要带回中间层,后续做溯源才不会断。
在轻易云上如何配置
在轻易云数据集成平台里,这条策略走的是「单条策略独立调度」,而不是链路编排,所以源端和目标端是分开配置的两张卡片。
源端卡片(读金蝶):平台选择 Kingdee.Cloud,接口选 executeBillQuery,业务对象绑 F_QGWK_Link_FSId,响应里勾上 autoFillResponse,这样金蝶返回的字段会自动铺到结果集里,不用手写映射表。请求参数里把 FPOOrderEntry_FEntryId、FID、FBillNo、FSourceBillNo 都点开,is_required 全部置 false——因为是联查,不是新增,缺一两个字段不能直接报错。
目标端卡片(写轻易云):平台选 datahub(轻易云集成平台自身),接口是 写入空操作,这种「空操作」不是为了真的写业务表,而是让本次回写被纳入调度结果、留痕到日志表。idCheck 置为 true,确保同一张采购订单不会被联查结果覆盖成两条。
轻易云在客户现场最常见的一种做法是:编码映射集中管理——金蝶 FNumber 到旺店通货品编码的对照表,统一放在轻易云的映射中心,所有策略共用。这样金蝶侧物料编码一改,采购订单联查里带出来的 FBillTypeID_FNumber 也能自动对得上号,不用每条策略单独维护一份对照关系。
实施步骤
第一步:增量起点确认。第一次上线前,要先冻结一批采购订单号,跑一次全量联查,作为后续增量的比对基线。轻易云上可以在源端卡片里加一个 F_QGWK_Link_FSId != null 的过滤,避免把没有回填键的脏数据带回来。
第二步:全量触发。建议用轻易云的「手动执行 + 全量模式」跑一次完整联查,观察返回行数和目标端落库数是否一致;不一致时优先看源端是否有分页,以及金蝶侧 executeBillQuery 的单次返回上限。
第三步:调度频率切换。源端 crontab 是 */55 9-21 * * *,即业务时段每 55 分钟一次,非业务时段不跑,避免夜间被金蝶的备份任务挤掉。目标端 crontab 是 */30 0-8 1 1 1,看着像是一年只跑一次的低频任务,实际上它依赖源端落库后才执行,起到「每日清账」的作用。
第四步:上线观察。前三天每天抽 5 单人工核对 FSourceBillNo 是否回填正确,确认无误后再交给业务方自助查询。
踩坑复盘
- idCheck 忘开。第一版上线时没勾
idCheck,同一条采购订单被联查结果写了两次,下游去重逻辑直接把它判成脏数据。这里容易翻车:空操作接口不是没风险,「空」只代表不写业务表,不代表不写结果表。 - 把 is_required 设成 true。联查场景下,请求参数本就是用来挑字段的,全部必填会把一次普通回查变成「缺字段就报错」的故障。稳妥的做法是联查类接口一律非必填。
- 回写时机错配。如果源端跑完才几分钟,目标端就急着写,容易出现「源单编号还没回填」的空值。客户现场的做法是源端跑完,人工延迟 5 分钟再触发目标端,或者在轻易云里加一个「源端完成后等 N 分钟」的步骤。
- 单据编号当主键。典型错误是用 FBillNo 当主键去做 idCheck,结果同一张单据的不同行被识别成不同记录。采购订单必须按「单号 + 行号」联合判重,F_QGWK_Link_FSId 字段正是为这个目的设计的。
- 跨年单据日期处理。采购订单的创建日期跨年时,金蝶返回的时间格式会出现「YYYY」和「YY」混用,联查回来的字符串字段最好在轻易云里统一转一次,避免下游做日期比对时踩雷。
适用场景与不适用场景
适用:采购订单已落金蝶、需要回查源单/关联单据、只需更新关联字段不能重写整单、单据量稳定且业务时段集中。
不适用:需要把金蝶字段反推回旺店通做修改(这要走「回写策略」而非联查)、单据量极大需要分钟级实时(联查接口有调用频率天花板)、或者采购订单尚未生成(此时源端没有可联查的对象)。