金蝶云星空到吉客云的辅助单位同步：单策略实战教程

这个策略解决什么问题

辅助单位是供应链里最容易被忽略、却最容易出事的基础资料。某零售企业的仓库在金蝶云星空里维护着箱、托、件等多套计量单位，吉客云的采购和销售单据依赖另一套单位体系。当两边各管各的、单位换算关系不一致时，采购员录单报错、库存数量漂移、报表对账对不齐，问题往往要拖到月底才暴露。这条策略的目标很简单：把金蝶云星空作为单位主数据的唯一来源，增量同步到吉客云，让前端业务系统始终用一份权威的换算关系。

数据流向与字段映射

数据流向：金蝶云星空（源）→ 轻易云数据集成平台（中间层）→ 吉客云（目标）。中间层不落库，只做字段转换、编码映射和增量标记。

核心字段对照（典型示例）：

编码映射我们通常集中在轻易云的「映射表」里统一管理，而不是散落在脚本里。这样新增单位时，只改一处，不用动策略本身。

在轻易云上如何配置

在轻易云数据集成平台里，这条策略的配置分四块：

1. 源系统连接：选用金蝶云星空适配器，配置账套信息（脱敏后只保留环境标识）、接口路径指向辅助单位查询接口，过滤条件带上 FUsed 和最近修改时间。
2. 目标系统连接：选用吉客云适配器，配置授权信息和目标组织编码，写入接口选用辅助单位主数据接口。
3. 字段映射：除了上表中的常规字段，重点处理换算分子分母——金蝶里可能为 0 或空值，要先做空值兜底再推送，避免吉客云接口校验失败。
4. 运行策略：增量模式按 FModifyDate 游标推进，全量模式一次性补齐历史数据；失败重试和告警通知按项目标准接企业微信或邮件。

实施步骤

一次实际项目里，我们通常分三阶段推进：

• 阶段一：全量触发（首次上线）。在轻易云上手动跑一次全量同步，把历史上所有辅助单位都推到吉客云。跑完后两边对账，重点核对换算关系是否正确，尤其是分子分母为 1:1 的“伪辅助单位”。
• 阶段二：增量起点切换。全量完成后，把同步模式切到增量，起点取本次全量跑完时的最大 FModifyDate。这一步最容易出岔——如果起点写早了一秒，会重复推送；写晚了一秒，会漏数。
• 阶段三：调度频率固化。辅助单位变更频率不高，我们一般设每 15 分钟一次；如果业务确认当天基本不改动，也可以压到每小时一次或定时每天跑几次。轻易云的调度器支持 cron 表达式，按业务节奏配即可。

稳妥的做法是：上线后两周内保留手动重跑入口，便于纠错；之后关闭，转入纯调度运行。

踩坑复盘

1. 换算方向反了。金蝶里“1 箱 = 24 件”和“1 件 = 0.0417 箱”是两个方向，分子分母写反，前端算库存直接翻车。配置时一定要和业务方在表上逐条核对示例数据。
2. 空值与零值混淆。金蝶的换算分子分母在未维护时是空，吉客云接口要求非空整数。我们用轻易云的字段清洗做了空值兜底（默认 1）和类型强转，否则批量推送会成片失败。
3. 基本单位被当成辅助单位推过去。典型错误是把所有单位都推过去，吉客云端出现重复记录。稳妥的做法是在源端过滤里加 FIsBaseUnit = 0，只推真正意义上的辅助单位。
4. 增量起点与全量重叠。前面提到的“写早一秒重复、写晚一秒漏数”，在轻易云里可以通过开启「按主键去重」选项缓解，但仍建议人工核一次起点时间戳。
5. 授权过期未告警。金蝶或吉客云的接口 token 过期后，策略不会立刻报错，而是表现为长时间无数据。轻易云可以配「连续 N 个周期无数据触发告警」，比单纯看错误日志靠谱得多。

适用场景与不适用场景

适用：金蝶作为单位主数据唯一来源、吉客云作为前端业务系统、单位变更频率低但要求一致性的供应链集成场景。不适用：两侧单位体系需要双向维护、或单位换算本身由业务前端动态计算（不走主数据）的场景。