小满OKKICRM付款单同步至金蝶云星辰预付款单：单策略实战教程

这个策略解决什么问题

某零售/贸易企业在 CRM 里录完付款单后，需要把同一笔付款以「预付款单」的形式落到财务系统，便于后续核销与账期管理。表面看只是把一张单据推过去，实际上涉及单据类型映射、方向判断、币种换算、核销关系重建。我们用轻易云数据集成平台承接，整个链路在公有云上跑通，源到目标只走一条策略链路，链路短、好排障。

数据流向与字段映射

源系统为小满 OKKI CRM，目标系统为金蝶云星辰，中间层是轻易云集成平台。关键字段对照如下：

我们在中间层做了三件事：方向归一化（CRM 里的「收/付」统一映射成财务系统的入/出标识）、币种代码统一（避免大小写差异导致下游校验失败）、关联订单回写字段的预留，便于以后做核销追溯。

在轻易云上如何配置

进入轻易云数据集成平台，新建一个「同步策略」，源端选小满 OKKI CRM 的付款单接口，目标端选金蝶云星辰的预付款单保存接口。几个典型配置要点：

1. 触发方式：源端按「修改时间增量」触发，避免每次拉全量；目标端走「按单据写入」。
2. 映射器：用轻易云的拖拽式字段映射器做上述对照表，方向、币种这类业务字段建议在「转换脚本」里集中维护，方便以后统一改。
3. 编码映射集中管理：客户/供应商、币种、科目这类主数据，建议放在轻易云的「编码映射」公共组件里管理，不直接写在策略里。这是轻易云客户最常见的应对模式——下次再加新策略时直接复用。
4. 异常处理：源端单据金额为 0、币种为空、关联订单缺失，这三类要单独走告警分支，不要静默丢弃。
5. 日志与对账：开启轻易云的消息回执日志，目标端保存失败时把原始 payload 落到「失败队列」，方便后续手工补偿。

实施步骤

我们通常按三段式上线：

• 阶段一：增量起点。先用「最近 7 天修改时间」拉一轮增量，验证映射、方向、币种、关联字段都对得上；这一步先不上调度，手工触发。
• 阶段二：全量触发。把时间窗口拉大到「最近 90 天」，跑一次全量回灌，确认财务侧能完整接收；同时检查两边单据数量、金额汇总是否一致。
• 阶段三：调度频率。日常上线后，源端每 5 分钟拉一次增量，目标端写入做并发节流（轻易云默认是 5 并发，对金蝶星辰这种云财务是安全值）；夜间低峰再跑一次兜底全量，做差异补偿。

这是「增量与全量双轨」的典型做法——日常靠增量追平，夜里靠全量兜底，月底对账几乎不用人工介入。

踩坑复盘

1. 方向字段最容易翻车。CRM 里「收/付」是业务视角，财务系统里是「预付/预收」，方向完全反过来。我们第一次上线时没做归一化脚本，结果全推成了预收单，财务端整月对不上账。稳妥的做法是在中间层单独建一个 direction 字段做转换，不要直接用源字段值。
2. 币种代码大小写。OKKI 传出来是「CNY」，星辰要求「CNY」，看起来一样，但金蝶星辰对部分币种是大小写敏感的（USD vs usd）。建议在映射里加一个 UPPER() 转换脚本。
3. 关联订单回写缺失。如果不在目标单上预留 FSourceBillNo，后续核销时财务需要手工补关联字段，效率很低。我们现在固定在中间层补这个字段。
4. token 过期未感知。星辰的 token 有效期是有限的，轻易云平台上要做 token 临近过期的告警，否则会整批写入失败。
5. 不要把表头表体塞同一个策略。付款单这种单据，如果后面要带明细行（分摊到多个订单），建议「表头同步」和「表体同步」拆成两个阶段策略，先表头后表体，便于失败重试。这是轻易云客户常见的应对模式。

适用场景与不适用场景

适用：CRM 与财务系统分立、付款/预收业务需要跨系统留痕、有核销追溯诉求的中大型企业。不适用：单据业务逻辑高度定制、需要复杂审批流前置的场景（应走工作流而非同步策略）。