客户主数据跨系统同步实战:从纷享销客到金蝶云星空的新增策略落地
这个策略解决什么问题
某零售企业在做供应链集成时,有一个绕不开的环节:客户主数据。门店或销售团队在 CRM 里新增了一个客户档案,如果不推送到 ERP,后续的订单、应收、对账全都对不上号。
我们这次只聚焦其中一种情况:新增。CRM 里新建客户 → 自动推到 ERP 的客户档案里。看似简单,但编码映射没设计好,三个月后两边数字一对不上,业务部门就会拿着工单找过来。
数据流向与字段映射
源系统是 CRM(纷享销客侧),目标系统是 ERP(金蝶云星空侧),中间经过轻易云数据集成平台做协议适配和字段转换。
| 业务含义 | 源端(CRM) | 中间层 | 目标端(ERP) |
|---|---|---|---|
| 客户编码 | 客户编号(自生成) | 不改写,直接透传 | 客户代码(必填,主键) |
| 客户名称 | 客户名称 | 透传 | 客户名称 |
| 客户分类 | 客户类型枚举值 | 编码映射集中管理 | 客户分组代码 |
| 信用额度 | 信用额度(数值) | 透传,统一单位 | 信用额度 |
| 默认币别 | 币种代码(CNY) | 标准化为 ISO 4217 编码 | 币别代码 |
| 创建时间 | 系统时间戳 | 转 ERP 时区 | 创建日期 |
核心思路是:客户编码从源端原样透传,轻易云不做改写,两边用同一套主键;枚举型字段(客户分类)用集中映射表维护,不写死在脚本里。
在轻易云上如何配置
整个策略在轻易云数据集成平台里配置,核心要点有三块:
1. 源端取数适配器
源端是 CRM 的客户对象。配置时把分页大小设成 200 左右,单次不要拉太多,不然触发限流。增量起点用 CRM 侧的创建时间字段,初始值给一个比当前业务日期早一点的日期,跑一次全量兜底。
2. 目标端写入适配器
目标端是 ERP 的客户档案新增接口。关键配置:
- 写入模式选单条新增(不勾批量),ERP 这边对并发新增比较敏感,稳妥起见一条一条来;
- 失败重试设 3 次,间隔 30 秒,够覆盖一般的网络抖动。
3. 字段映射与转换
这一步是踩坑最多的地方。建议把映射拆成三层:
- 透传层:名称、编码、联系电话等直接映射;
- 编码映射层:客户分类、币别、行业代码这些枚举值,在轻易云的「编码映射」模块集中维护,不要写死在脚本里;
- 派生层:创建时间按 ERP 时区转换、组织机构根据当前操作员的归属自动填充。
实施步骤
我们一般分三阶段上线,避免一上来就拉全量把两边系统打爆。
阶段一:全量兜底(上线前) 脚本一次性把 CRM 历史客户全量推到 ERP,跑完之后人工抽 20 条核对。这一步在轻易云里用一个临时任务跑,跑完停掉。
阶段二:增量起点切换(上线当天) 全量跑完确认无误后,把增量起点切到上线那一刻的时间戳。从这一刻起,CRM 新建的客户才会进队列。这条策略(crontab)按 5 分钟一次轮询,既接近实时,又不会对源系统造成压力。
阶段三:异常监控(上线后第一周) 头一周每天看一次失败队列,轻易云会把写不进 ERP 的记录挂到异常表里,常见的失败原因无非三种:必填字段为空、编码重复、组织机构未授权。每一种都要有兜底处理逻辑,而不是简单重跑。
踩坑复盘
讲几个我们实际项目里翻过车的点,后来都写进了客户的运行规范里。
坑 1:客户编码在两边各自生成。 这是最常见的错误。两边各跑一套编码规则,三个月后必然对不上。稳妥的做法是:CRM 侧生成后原样透传到 ERP,轻易云不做改写,两边共用一个主键。
坑 2:枚举值硬编码在脚本里。 客户分类在 CRM 里有 8 种,在 ERP 里对应 12 种,业务部门随时可能加。写死的话改一次脚本要发版一次。稳妥的做法是:用轻易云的「编码映射」模块统一管,加新值在界面上点一下就行。
坑 3:时区没统一。 CRM 在公有云,ERP 在另一个时区。创建时间字段直接透传,ERP 里看到的可能是未来时间。稳妥的做法是:在轻易云的派生字段里按 ERP 时区转一次。
坑 4:没区分新增和修改。 本次只讲新增,但要注意:同一条策略里如果同时配新增和修改,很容易出现「修改」把「新增」的脏数据覆盖掉的情况。建议把新增和修改拆成两条独立策略,sequence 字段标记清楚先后顺序。
坑 5:第一次全量没做断点。 几万条客户一次性拉过来,中间网络抖一下就要从头来。稳妥的做法是:轻易云的全量任务天然支持断点续跑,但你要确保源端接口支持按主键分段拉取。
适用场景与不适用场景
适用:CRM 作为客户主数据入口、ERP 作为下游业务系统;客户量在十万级以内;业务对实时性要求不高(分钟级可接受)。
不适用:客户主数据归 ERP 管,CRM 只是引用;双向同步且两边都会改同一字段;客户量在百万级以上需要专用中间库。