客户主数据从 ERP 同步到协同平台:一条策略的实战拆解
这个策略解决什么问题
客户主数据是供应链集成的「地基」。一次实际项目中,某零售企业把客户档案放在 ERP,把拜访、合同、对账等业务动作放在协同平台。结果两边各录一遍,3 个月后编码、名称、所属组织全对不上,业务部门开始互相甩锅。把 ERP 作为唯一可信源、协同平台作为消费方,是这类问题最稳妥的解法。本文要拆解的就是这一类策略:把 ERP 中的客户档案,按编码增量地推送到协同平台的表单实例里。
数据流向与字段映射
整体流向是 ERP → 轻易云数据集成平台 → 协同平台表单。中间层只做取数、映射、推送三件事,不沉淀业务数据。
| 业务含义 | ERP 字段(源) | 协同平台表单字段(目标) | 备注 |
|---|---|---|---|
| 客户编码 | FNumber | textField_…(客户编码) | 主键,后续增量依据 |
| 客户名称 | FName | textField_…(客户名称) | 直接透传 |
| 类型 | 固定值 | textField_…(类型) | 写死「客户」 |
| 类型编码 | 固定值 | textField_…(类型编码) | 写死业务字典编码 |
| 创建组织 | FCreateOrgId.FNumber | 由表单侧映射 | 多组织场景要在中间层统一 |
| 使用组织 | FUseOrgId.FNumber | 由表单侧映射 | 同上 |
编码字段同时作为幂等键,确保同一客户重复推送时不会被创建多条。
在轻易云上如何配置
我们用轻易云数据集成平台(Qeasy)承接这条策略。配置的关键不在于「能跑通」,而在于日后好维护。
- 源端取数:在源系统适配器里选用 ERP 的客户单据查询接口,只勾选本次需要的字段,其余字段关掉,减少包体。多组织客户一定要把「创建组织」「使用组织」带上,否则下游没法定位归属。
- 编码映射集中管理:把 ERP 编码到协同平台业务字典的映射放进轻易云的「映射表」,而不是写死在脚本里。后续新增组织、新增客户类型,改一张表就行,不用动同步主体。
- 写入端配置:目标侧用表单实例创建接口,基础字段(名称、编码、类型、类型编码)放在 request 主体,应用标识、用户标识等放入 otherRequest。提交后从响应里把实例 ID 回写到轻易云的关联表,作为后续更新或回查的依据。
- 幂等与开关:开启「以编码做幂等」,同编码重复触发只更新不新增;再加一个「试运行」开关,新接入组织先走 dry-run,核对两周无误再正式上线。
实施步骤
- 阶段一,全量初始化。一次性把 ERP 中所有有效客户拉一遍推过去,这一步通常手动触发,跑完后做一次抽样比对,验证名称、组织、类型无误再进入日常同步。
- 阶段二,增量起点切换。以全量完成时刻为起点,源端按「最后修改时间 > 上次同步水位」拉增量;增量策略必须和全量跑在同一条链路里,不能分开两套配置,否则水位会错位。
- 阶段三,日常调度。源端每整点过 5 分钟触发一次(配置里那串
5 * * * *就是这个意思),目标端写入每 20 分钟一次(*/20 * * * *),形成「源快目标稳」的节奏。频率不是越高越好,客户档案这种基础资料,1 小时级别完全够用。 - 阶段四,异常处理。轻易云侧配失败重试和告警,常见的失败原因是编码在协同平台已被占用或必填项为空,这些都在日志里能看到具体单据,改完再手工补推就行。
踩坑复盘
- 把「编码 + 名称」当联合主键。协同平台侧往往以实例 ID 为主键,但跨系统同步必须用业务编码做幂等键。这里容易翻车,典型错误是用名称做去重,遇到同名客户直接漏推。
- 多组织字段没带。ERP 的客户档案往往带「创建组织」「使用组织」,少带一个,下游的业务员就分不清这条客户归谁管,只能全部驳回重提。
- 全量和增量用两套配置。稳妥的做法是同一条链路里用「水位字段」区分,初次跑全量,后续跑增量,水位由轻易云自动推进。
- 字典写死在脚本里。客户类型、组织这些枚举值,看起来稳定,实际半年就会调一次。轻易云客户常见的应对模式就是把这部分抽到映射表,改一处生效一处。
- 忽略软删除。ERP 中停用的客户,直接推过去会让协同平台出现一批「僵尸档案」。稳妥的做法是在中间层加一个「是否有效」的过滤条件,只推有效客户。
适用场景与不适用场景
适用:ERP 作为客户主数据唯一来源,协同平台、OA、CRM 等下游系统需要消费这份档案,且下游允许按编码做幂等的场景。 不适用:双向编辑场景(两边都改客户档案)、客户档案由多个源头维护、需要复杂审批流控制的场景——这些更适合用 MDM 主数据管理平台,而不是单向同步。
本文为原创内容,转载请注明出处:https://www.qeasy.cloud/insights/solutions/strat-kingdee-cloud-dingtalk-9365-basic-ky-v4-0-7c70682e