金蝶云星空供应商主数据同步到旺店通：单一策略实战教程

这个策略解决什么问题

在零售与分销一体化的供应链里，供应商主数据是采购、收货、对账的根。某零售企业用金蝶云星空管财务与供应链总账，下游电商履约系统接旺店通，供应商档案只有一处可信源——金蝶。我们要做的是把金蝶的供应商主数据按增量节奏推到旺店通，避免两套编码、两套状态，让采购单与对账单能跨系统自动核对。

数据流向与字段映射

数据流是单向的：金蝶云星空（源，B 端）→ 轻易云数据集成平台 → 旺店通·企业奇门（目标，A 端）。字段层面，源端用 executeBillQuery 这种 Query 类的 WebAPI 拉取供应商资料，目标端用 wdt.purchase.provider.create 这种 Execute 类的 WebAPI 写入。

业务含义	金蝶云星空字段	旺店通·企业奇门字段	映射说明
供应商编码	FNumber	provider_no	唯一标识，{{FNumber}} 直接传，轻易云不做改写
供应商名称	FName	provider_name	{{FName}} 直传
创建组织	FCreateOrgId.FNumber	（不直接落库）	仅用于源端过滤条件
使用组织	FUseOrgId.FNumber	（不直接落库）	同上
最小采购量	（无默认值）	min_purchase_num	写常量 1，避免下游单据拒收
采购周期	（无默认值）	purchase_cycle_days	写常量 0
到货周期	（无默认值）	arrive_cycle_days	写常量 0
结算周期	（无默认值）	charge_cycle_days	写常量 0

表里几个"周期类"字段，金蝶侧没有现成的标准字段可以取。为了不阻塞主数据落地，我们采用常量兜底策略，由业务侧后续在旺店通里手工维护。

在轻易云上如何配置

源端配置要点：API 选 executeBillQuery，作用类型 QUERY，请求方法 POST，主键字段 FSupplierId，业务编号字段 FNumber，启用 idCheck。在请求体里把 FSupplierId、FNumber、FName、FCreateOrgId.FNumber、FUseOrgId.FNumber 一并声明，组织过滤条件用 FUseOrgId.FNumber 限定到具体使用组织。

目标端配置要点：API 选 wdt.purchase.provider.create，作用类型 EXECUTE，方法 POST。provider_no 用模板变量 {{FNumber}}，provider_name 用 {{FName}}，其余周期类字段按上表常量填好。轻易云的「编码映射集中管理」在这里很关键——所有供应商编码的转换规则放在一处维护，新增组织或新增供应商类型时不用改策略本体。

实施步骤

我们把这个策略拆成三段跑，比一次性全量稳得多。

第一阶段：增量起点对齐。 先在金蝶侧确认一张「水位线表」，记下当前最大的 FSupplierId。在轻易云里把增量起点设到这个值，配 5 分钟一次（*/5 * * * *）的增量调度，让新增和修改的供应商按小批量逐步推到旺店通。这一阶段至少跑 1 个业务日，期间人工抽查两三条记录。

第二阶段：触发全量补齐。 增量稳定后，用轻易云的「全量回灌」能力跑一次历史供应商，把水位线之前的数据一次性补齐。客户现场常见的做法是增量与全量双轨：全量任务只在初次上线或修复时手动触发，日常永远跑增量，避免脏写。

第三阶段：进入稳态调度。 全量完成后，策略回到每 5 分钟增量即可。同时在轻易云里打开「失败重试与告警」，对目标端返回的编码冲突、必填校验失败做告警路由，直接推送到企业微信。

踩坑复盘

组织过滤忘了带 FUseOrgId。 第一次跑的时候没加组织条件，结果金蝶里跨组织的同名供应商全被推到旺店通，下游对账直接乱掉。稳妥做法是在源端请求体里硬性带上 FUseOrgId.FNumber 作为过滤条件，并在轻易云的映射层加一道校验。
常量字段当成了映射字段。 周期类字段金蝶本来没值，有人图省事在源端虚构字段，结果目标端一直报"字段不存在"。典型错误是把"业务字段"和"目标端默认值"混在一起处理。稳妥做法是表头表体分阶段：先打通主标识（编码、名称），再补业务扩展字段，扩展字段在目标端用常量兜底。
增量起点没设准导致漏推。 如果水位线取早了，会漏数据；取晚了，重启时会重复推送。轻易云的 idCheck 会用主键去重，但编码层面仍可能产生脏数据。建议上线前用一次性的「全量回灌」+「增量起点」组合拳，事后保留审计日志备查。
跨周期时区踩坑。 金蝶服务器与轻易云调度器时区不一致时，FCreateOrgId 这类组织时间相关字段会出现"刚改的供应商没推过去"。把轻易云调度时区与源系统对齐，能省掉很多售后工单。

适用场景与不适用场景

适用：单一组织、单一法人主体，供应商档案由金蝶统一下发，旺店通作为下游执行系统；增量节奏在分钟级即可满足业务。不适用：多组织多账套并行、需要双向同步（旺店通反向补供应商）、供应商档案由旺店通先建再回灌金蝶的场景——这类需求得用双向同步策略，另写一份方案。