轻易云
注册体验

供应商档案同步实战:从金蝶云星空到旺店通·企业奇门的一次稳妥落地

· 许创贵· 集成方案库· 10 次浏览· 约 4 分钟读完
旺店通金蝶云星空供应商主数据基础资料同步旺店通·企业奇门轻易云供应链集成

这个策略解决什么问题

某零售企业在一次实际项目中,采购团队反馈:新签供应商在 ERP 里建好档,等到采购员在目标系统下单时找不到对应供应商,只能在目标系统里再手工建一次,几周下来两边编码对不上,财务对账也开始飘。这个策略就是把源端的供应商档案按计划推到目标系统,做到一处建档、多处可用,避免编码漂移。

数据流向与字段映射

流向是单向的:源系统(后端 ERP,这里以金蝶云星空为例) → 轻易云数据集成平台 → 目标系统(前端业务系统,这里以旺店通·企业奇门为例)。中间层只做透传与映射,不做业务加工。

关键字段对照表(典型项,不含全部):

业务含义源端字段目标端字段备注
供应商编码FNumberprovider_no主键,编码映射集中管理
供应商名称FNameprovider_name必填
创建组织FCreateOrgId.FNumberorg_no(目标系统自定义)需组织映射
使用组织FUseOrgId.FNumberorg_no多组织场景下拆行
备注FDescriptionremark可选

源端用 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 反向接收;或两端业务字段差异大、需要二次开发的场景。

本文为原创内容,转载请注明出处:https://www.qeasy.cloud/insights/solutions/strat-wdt-kingdee-cloud-6361-n65cd58b8-e2d3271a

评论