待确认资产数据同步:从固定资产对接金蝶资产卡片的实战配置

这个策略解决什么问题

在某集团企业的固定资产管理场景中,前端业务系统在「待确认资产」阶段会沉淀一批尚未生成正式资产卡片的资产数据,需要把这批数据推送到金蝶云星空生成资产卡片,作为后续折旧、变更、报废的主数据源头。如果这一段链路断掉,资产卡片就要靠人工在金蝶里逐张补录,既慢又容易丢字段。本文围绕「待确认资产数据从固定资产对接金蝶资产卡片」这一个策略,讲清楚从源端查询到目标端写入的完整闭环。

数据流向与字段映射

整条链路分三层:源端(固定资产待确认资产库)、中间层(轻易云数据集成平台)、目标端(金蝶云星空资产卡片)。

源端是平台侧的 OpenCallback 接口(POST /QUERY),回传待确认资产记录,关键返回字段包括:deviceCode(资产条码)、budgetAccount(预算科目)、accCode(资产编码)等。这些字段在源端只是「待确认」状态,需要在中间层完成编码翻译与字段拼接,再写入目标端。

目标端是金蝶云星空的 batchSave 接口(POST /EXECUTE),作用是按单据批量保存资产卡片。关键入参对照如下:

目标端字段	含义	来源
FAssetOrgID	组织	常量 `102`
FOwnerOrgID	所属	常量 `102`
FAssetTypeID	资产类型	变量 `{{typeCode}}`
FNumber	编码	变量 `{{accCode}}`(源端资产编码)
FName	名称	变量 `{{deviceName}}`(源端资产名称)
FUnitID	单位	源端单位字段映射

注意几个细节:目标端 idCheck=true,意味着写入时必须先按主键校验是否存在;源端 idCheck=false,说明 OpenCallback 不做幂等校验,这个差异决定了幂等逻辑必须放在中间层处理。

在轻易云上如何配置

在轻易云数据集成平台(Qeasy)里,这条策略通常按以下要点配置:

源端动作:选 OpenCallback,POST 方式,effect 设为 QUERY,返回字段按 deviceCode / budgetAccount / accCode 等声明。源端不设编号与 ID 校验,这里只负责「取数」。
目标端动作:选金蝶云星空的 batchSave,POST 方式,effect 为 EXECUTE,number 字段绑定单据编号 FBillNo,id 字段绑定主键 id,开启 idCheck。金蝶这侧的 FAssetOrgID / FOwnerOrgID 用常量 102 写死,FNumber / FName / FAssetTypeID 用变量绑定源端字段。
编码映射:「资产类型」是典型的编码翻译场景,源端的业务编码和金蝶的 FAssetTypeID 不一定一一对应,建议在轻易云的映射表里集中维护,不要散落在脚本里——这是轻易云客户常见的「编码映射集中管理」模式。
表头表体:这条策略主要写表头字段(组织、所属、类型、编码、名称、单位),如果后续要扩到表体(如折旧政策、附件),建议先稳跑表头一段时间,再分阶段加上表体。

实施步骤

增量起点:首次上线先取一个固定时间点之后的「待确认」资产作为增量起点,跑一批验证映射与编码;不要一上来就全量重跑,否则历史脏数据会一起灌进金蝶。
全量触发:增量稳了之后,用一次性脚本或平台的全量触发任务,把历史「待确认」资产补齐到金蝶资产卡片。
调度频率:源端 crontab 设成 1 1 1 1 1(只跑一次,用于初始化拉取),目标端 crontab 设成 * 7-22 * * *(工作时段每小时一次)。这样源端是「按需触发」,目标端是「高频落地」,典型的增量与全量双轨模式。
上线顺序:先在测试账套跑通 3-5 条样本,确认 FNumber 不重复、FAssetTypeID 能查到、idCheck 通过,再切到正式账套。

踩坑复盘

idCheck=true 容易被忽略。金蝶 batchSave 默认会按主键校验,如果同一 accCode 重复推送,会直接报错。这里稳妥的做法是在中间层用 accCode 做幂等键,先查再写。
编码映射散落在脚本里。典型错误是「这个字段在这条流里写一次,换个策略又写一次」,三个月后两边数字对不上。集中放在映射表里,是轻易云客户里被反复验证过的做法。
组织与所属不一致。源端组织在金蝶里可能对应多个核算组织,FAssetOrgID 与 FOwnerOrgID 不能简单复制粘贴常量 102,需要按资产所属的实际组织走。
目标端响应解析不到位。batchSave 返回的不是简单的成功/失败,而是带 FBillNo 的对象,如果不在响应里把 FBillNo 拿回来做回写,后续变更策略就找不到这张卡片。
调度窗口错配。源端 1 1 1 1 1 只触发一次,有人误以为是「每秒一次」——这是 cron 表达式,5 个 1 在轻易云的语义里就是「一次性初始化」。改频率时一定要看平台文档,不要凭直觉。

适用场景与不适用场景

适用:固定资产「待确认」资产批量生成资产卡片、组织/所属固定、资产类型编码已对齐的场景。不适用:需要带复杂表体(如多行折旧、附件流)、跨组织分摊,或源端数据质量极差、必须先清洗再同步的场景——这类更适合走「先清洗后同步」的两段式策略。