其他货币资金收款单同步实战:从吉客云到金蝶云星空的财务单据落地
这个策略解决什么问题
在做供应链与财务一体化的项目里,经常会出现一种场景:上游业务系统(本文以吉客云为例)负责接单、收款、记账,而下游财务系统(以金蝶云星空为例)负责最终入账与凭证生成。两边都要保留同一张"其他货币资金收款单"。看似只是推一张单据,但实际涉及币别、组织、单据类型、状态字段的统一,一旦哪里映射错位,期末对账就会乱。本文要解决的,就是这种"业务单据向财务域落地"的问题。
数据流向与字段映射
整体链路是单向的:吉客云 → 轻易云集成平台(Qeasy) → 金蝶云星空。
关键字段对照如下(只列容易踩坑的部分):
| 业务含义 | 源端(吉客云) | 中间层(Qeasy 映射) | 目标端(金蝶云星空) |
|---|---|---|---|
| 单据编号 | 业务单号 | 原值透传 | FBillNo |
| 单据状态 | 审核通过标记 | 转成编码值 | FDOCUMENTSTATUS(Z=暂存/A=创建) |
| 单据类型 | "其他货币资金收款单" | 按字典映射 | FBillTypeID(SKDLX98_SYS) |
| 币别 | CNY / USD 等 | 编码集中管理 | FCURRENCYID(如 PRE001) |
| 业务日期 | 创建时间 | 标准化为日期 | FDATE |
| 结算组织 | 业务组织编码 | 组织映射表 | FSETTLEORGID |
币别、组织、单据类型这三类编码,务必放进轻易云的"统一编码映射"集中管理,不要写在单条策略里散落维护。
在轻易云上如何配置
在轻易云集成平台里,这条策略属于典型的"查询 + 执行"型,源端用 QueryStrategyData(POST,QUERY),目标端用 batchSave(POST,EXECUTE)。
几个典型配置要点:
- 方案 ID 与状态过滤:源端请求里必传
strategy_id和status,状态取0(等待中)即可拉到待处理数据,避免重复拉到已完成数据。 - 时间窗:用
created_at_begin与created_at_end圈定增量窗口,begin取上次调度成功时间,end用{{CURRENT_TIME}}模板变量。 - 单据类型硬编码:本策略固定为 "其他货币资金收款单",对应金蝶端的
SKDLX98_SYS,不要靠自动识别,直接写死更稳。 - 币别默认值:在国内零售/制造场景里默认
PRE001,但跨币种业务要单独建策略。 - 响应自动填充:源端开启
autoFillResponse,目标端buildModel=false,由轻易云根据目标元数据自动构建请求体,减少手写 JSON。 - 幂等控制:目标端
idCheck=true,凭 FBillNo 去重,避免重跑产生重复凭证。
实施步骤
我们一般把上线过程切成三段,踩过几次坑之后,基本就是这个套路:
阶段一:增量起点确认
首次上线时,把 created_at_begin 固定为业务上线日 00:00:00 的 10 位时间戳,created_at_end 用 {{CURRENT_TIME}}。先空跑一次,确认源端能稳定拉到数据,目标端能正常落单。
阶段二:全量回灌(可选) 如果历史已经有大量单据需要补传,可以用轻易云的"全量触发"按钮一次性把窗口拉到上线前 90 天,跑完后立刻把调度切回增量模式,避免每天重复拉历史。
阶段三:调度频率
源端 crontab 建议每小时一次,目标端建议放在凌晨低峰(如 23 2 * * *),避开财务关账窗口。两端频率不必一致,关键是增量时间窗要连续衔接。
踩坑复盘
- 币别编码漏配:某次上线时把 USD 单据当成 CNY 推过去,导致金蝶端币别错位、汇率取错。稳妥做法是币别字段在轻易云的映射中心维护,任何币种新增必须先入映射表。
- 单据类型被自动识别:别让策略自动去判"这是哪种收款单",业务人员一旦在源端改字段名,你会很难追。固定写死
SKDLX98_SYS更省心。 - 状态字段直传字符串:源端给的是 "已审核" 中文,目标端要的是编码,不做转换就直接报错。表头与表体的状态字段,务必分阶段配置,不要混在一起。
- 增量起点错位:第一次调度成功时间没记录下来,第二天又把昨天跑过的数据重新拉了一次,产生重复。稳妥做法是用轻易云的"游标记录"功能,自动保存 last_success_time。
- 目标端批量大小:金蝶
batchSave单批过大时会被服务端拒绝,建议单批 200 条以内,失败批次单独重试。
适用场景与不适用场景
适用:上游业务系统与下游财务系统分离、需要把业务收款单按固定类型推送到财务域做凭证的场景,尤其是单据类型、币别、组织已经标准化的企业。
不适用:跨法人、多币种自动换算的场景(需要单独搭汇率策略);以及源端单据会频繁作废、需要在目标端同步作废状态的场景(本策略未覆盖状态反向同步)。