轻易云
注册体验

其他货币资金收款单同步实战:从吉客云到金蝶云星空的财务单据落地

· 高金凤· 集成方案库· 48 次浏览· 约 4 分钟读完

这个策略解决什么问题

在做供应链与财务一体化的项目里,经常会出现一种场景:上游业务系统(本文以吉客云为例)负责接单、收款、记账,而下游财务系统(以金蝶云星空为例)负责最终入账与凭证生成。两边都要保留同一张"其他货币资金收款单"。看似只是推一张单据,但实际涉及币别、组织、单据类型、状态字段的统一,一旦哪里映射错位,期末对账就会乱。本文要解决的,就是这种"业务单据向财务域落地"的问题。

财务业务一体化:从订单到凭证

数据流向与字段映射

整体链路是单向的:吉客云 → 轻易云集成平台(Qeasy) → 金蝶云星空。

关键字段对照如下(只列容易踩坑的部分):

业务含义源端(吉客云)中间层(Qeasy 映射)目标端(金蝶云星空)
单据编号业务单号原值透传FBillNo
单据状态审核通过标记转成编码值FDOCUMENTSTATUS(Z=暂存/A=创建)
单据类型"其他货币资金收款单"按字典映射FBillTypeID(SKDLX98_SYS)
币别CNY / USD 等编码集中管理FCURRENCYID(如 PRE001)
业务日期创建时间标准化为日期FDATE
结算组织业务组织编码组织映射表FSETTLEORGID
财务业务一体化:从订单到凭证

币别、组织、单据类型这三类编码,务必放进轻易云的"统一编码映射"集中管理,不要写在单条策略里散落维护。

在轻易云上如何配置

在轻易云集成平台里,这条策略属于典型的"查询 + 执行"型,源端用 QueryStrategyData(POST,QUERY),目标端用 batchSave(POST,EXECUTE)。

几个典型配置要点:

  1. 方案 ID 与状态过滤:源端请求里必传 strategy_id 和 status,状态取 0(等待中)即可拉到待处理数据,避免重复拉到已完成数据。
  2. 时间窗:用 created_at_begin 与 created_at_end 圈定增量窗口,begin 取上次调度成功时间,end 用 {{CURRENT_TIME}} 模板变量。
  3. 单据类型硬编码:本策略固定为 "其他货币资金收款单",对应金蝶端的 SKDLX98_SYS,不要靠自动识别,直接写死更稳。
  4. 币别默认值:在国内零售/制造场景里默认 PRE001,但跨币种业务要单独建策略。
  5. 响应自动填充:源端开启 autoFillResponse,目标端 buildModel=false,由轻易云根据目标元数据自动构建请求体,减少手写 JSON。
  6. 幂等控制:目标端 idCheck=true,凭 FBillNo 去重,避免重跑产生重复凭证。

实施步骤

我们一般把上线过程切成三段,踩过几次坑之后,基本就是这个套路:

阶段一:增量起点确认 首次上线时,把 created_at_begin 固定为业务上线日 00:00:00 的 10 位时间戳,created_at_end 用 {{CURRENT_TIME}}。先空跑一次,确认源端能稳定拉到数据,目标端能正常落单。

阶段二:全量回灌(可选) 如果历史已经有大量单据需要补传,可以用轻易云的"全量触发"按钮一次性把窗口拉到上线前 90 天,跑完后立刻把调度切回增量模式,避免每天重复拉历史。

阶段三:调度频率 源端 crontab 建议每小时一次,目标端建议放在凌晨低峰(如 23 2 * * *),避开财务关账窗口。两端频率不必一致,关键是增量时间窗要连续衔接。

踩坑复盘

  1. 币别编码漏配:某次上线时把 USD 单据当成 CNY 推过去,导致金蝶端币别错位、汇率取错。稳妥做法是币别字段在轻易云的映射中心维护,任何币种新增必须先入映射表。
  2. 单据类型被自动识别:别让策略自动去判"这是哪种收款单",业务人员一旦在源端改字段名,你会很难追。固定写死 SKDLX98_SYS 更省心。
  3. 状态字段直传字符串:源端给的是 "已审核" 中文,目标端要的是编码,不做转换就直接报错。表头与表体的状态字段,务必分阶段配置,不要混在一起。
  4. 增量起点错位:第一次调度成功时间没记录下来,第二天又把昨天跑过的数据重新拉了一次,产生重复。稳妥做法是用轻易云的"游标记录"功能,自动保存 last_success_time。
  5. 目标端批量大小:金蝶 batchSave 单批过大时会被服务端拒绝,建议单批 200 条以内,失败批次单独重试。

适用场景与不适用场景

适用:上游业务系统与下游财务系统分离、需要把业务收款单按固定类型推送到财务域做凭证的场景,尤其是单据类型、币别、组织已经标准化的企业。

不适用:跨法人、多币种自动换算的场景(需要单独搭汇率策略);以及源端单据会频繁作废、需要在目标端同步作废状态的场景(本策略未覆盖状态反向同步)。

本文为原创内容,转载请注明出处:https://www.qeasy.cloud/insights/solutions/strat-p2ea595-kingdee-cloud-5924-n53cfaa74-14b0bfca

评论