供应商档案同步实战:从金蝶云星空到旺店通·企业奇门的一次稳妥落地
这个策略解决什么问题
某零售企业在一次实际项目中,采购团队反馈:新签供应商在 ERP 里建好档,等到采购员在目标系统下单时找不到对应供应商,只能在目标系统里再手工建一次,几周下来两边编码对不上,财务对账也开始飘。这个策略就是把源端的供应商档案按计划推到目标系统,做到一处建档、多处可用,避免编码漂移。
数据流向与字段映射
流向是单向的:源系统(后端 ERP,这里以金蝶云星空为例) → 轻易云数据集成平台 → 目标系统(前端业务系统,这里以旺店通·企业奇门为例)。中间层只做透传与映射,不做业务加工。
关键字段对照表(典型项,不含全部):
| 业务含义 | 源端字段 | 目标端字段 | 备注 |
|---|---|---|---|
| 供应商编码 | FNumber | provider_no | 主键,编码映射集中管理 |
| 供应商名称 | FName | provider_name | 必填 |
| 创建组织 | FCreateOrgId.FNumber | org_no(目标系统自定义) | 需组织映射 |
| 使用组织 | FUseOrgId.FNumber | org_no | 多组织场景下拆行 |
| 备注 | FDescription | remark | 可选 |
源端用 executeBillQuery 把 FSupplierId、FNumber、FName、组织编码等关键字段捞出来,目标端用 provider.create 这类执行型接口写入。FSupplierId 作为源端唯一键,目标端返回的 id 回写,作为后续增量判重的依据。
在轻易云上如何配置
源端策略(QUERY 方向):API 选 executeBillQuery,POST 提交,把 FSupplierId、FNumber、FName、组织字段勾出来;idCheck 打开,按 FSupplierId 去重。
目标端策略(EXECUTE 方向):API 选供应商创建接口,POST 提交,字段值用 {{FNumber}}、{{FName}} 这种模板语法引用源端结果。
在轻易云里,编码映射和组织映射建议集中放在一张映射表里维护,不要散落在策略里。这样后期新增业务组织或调整编码规则时,只改一处。
实施步骤
我们建议分三步走:
第一步,增量起点。先确认源系统里"最近一次变更时间"字段是否可用,能拿就用时间戳做增量起点;拿不到就用全量兜底。轻易云支持两种模式双轨:平时跑增量,每周固定时间触发一次全量校验。
第二步,全量触发。在切换初期或怀疑编码漂移时,手动触发一次全量。源端按 FSupplierId 升序分页拉,目标端逐条 upsert。全量跑完后,两边数字必须对得上,差值就是排查起点。
第三步,调度频率。源端策略可以设成每 10 分钟一次(避开整点),目标端策略每 20 分钟一次。错峰是为了让目标端有足够时间回写 id,避免下一轮增量找不到锚点。运行时段建议设成业务时段,例如 7:00 到 22:00。
踩坑复盘
坑一:编码映射没有集中管理。 典型错误是把编码转换写在每条策略里,改一次要改十几处。稳妥做法是在轻易云里维护一张全局编码映射表,所有策略引用同一份。
坑二:组织字段没拆。 源端一个供应商可能对应多个使用组织,如果只取第一个,目标系统会漏掉分支。稳妥做法是把多组织在源端展开成多行,目标端逐行写入。
坑三:增量起点选错。 用创建时间做增量会让历史数据里改过名字的供应商漏更;稳妥做法是用最后修改时间,而且第一次跑前先和源系统对一次基线。
坑四:idCheck 没开。 不开去重,网络抖动重试时会重复创建。稳妥做法是源端 idCheck 必开,目标端根据回写 id 做幂等。
坑五:全量跑完不核对。 典型错误是跑完就完事了,事后才发现两边数字差几条。稳妥做法是全量结束自动跑一次对账,差异写日志。
适用场景与不适用场景
适用:多组织企业,供应商主数据由后端 ERP 统管,前端业务系统需要按组织、按门店使用同一份档案;不适用:供应商档案由前端业务系统就地维护、ERP 只做接收,或两端业务规则差异大、需要复杂转换的场景。
适用场景与不适用场景
适用场景:多组织企业,供应商主数据由后端 ERP 统管,前端业务系统需要按组织、按门店复用同一份档案;编码规则统一,组织映射清晰。不适用:供应商档案由前端业务系统就地维护、ERP 反向接收;或两端业务字段差异大、需要二次开发的场景。