轻易云
注册体验

旺店通与金蝶云星空供应链集成方案:35 个策略的架构与实施要点

· 冯潇· 集成方案库· 6 次浏览· 约 6 分钟读完
旺店通金蝶云星空供应链集成订单同步库存同步主数据映射

场景与价值

在典型的电商零售业务中,电商 OMS/WMS(以旺店通为代表)与后端 ERP(以金蝶云星空为代表)承担不同职能:旺店通负责订单接收、发货、库存执行与店铺管理,金蝶云星空负责财务核算、采购管理、组织化的库存与供应链单据流转。两套系统之间的数据若依赖人工录入或分散脚本同步,会出现单据延迟、编码不一致、库存偏差、对账困难等问题。

本方案针对供应链集成场景,设计了 35 个协同工作的数据同步策略,覆盖销售出库与退货、采购入库与退料、预入库、库存调拨、盘盈盘亏、其他出入库、退换货(退款不退货)以及基础资料同步等业务域。其核心价值在于:把跨系统单据流转收敛到一套可观测、可调度、可重试的集成流程中,使电商侧的订单执行与 ERP 侧的财务/供应链单据保持一致。

集成架构与数据流

整体架构为双向同步加主数据联查的模式。集成平台作为数据中枢,分别承担三类职责:

  • A_TO_B(旺店通 → 金蝶)共 12 个策略:把电商侧产生的执行类单据推送到 ERP,包括 ToB/ToC 销售出库、销售退货、退换货(退款不退货)、采购入库、采购退料、预入库、盘盈、盘亏、其他出库、其他入库、调拨出库、调拨入库。
  • B_TO_A(金蝶 → 旺店通)共 6 个策略:把 ERP 侧的计划类单据下发到电商侧,包括收料通知单 → 采购订单、发货通知单 → 原始订单、调拨申请单 → 调拨单。
  • QUERY_ONLY(查询策略)共 16 个:包括 KD1~KD5、Q1、Q7、BNS 分销商与客户对应关系、旺店通店铺查询等,仅做数据预加载与联查,不写入目标系统。
  • INTERNAL(系统维护)共 1 个:清理两个月前的历史数据。

执行依赖遵循「基础资料优先 → 计划类下发 → 执行类回传」的顺序:KD3 金蝶仓库、BNS 分销商客户、旺店通店铺等基础资料需要先完成预加载,才能支撑后续单据中的编码映射;金蝶调拨申请必须先下发到旺店通生成调拨单,旺店通侧的调拨出库与调拨入库再分步回写到金蝶;收料通知单先转化为旺店通采购订单,后续的采购入库才能基于该订单进行匹配。

接口清单

源平台目标平台数据对象同步方向
旺店通金蝶云星空ToB 销售出库单 / ToC 销售出库单A_TO_B
旺店通金蝶云星空ToB 销售退货单 / ToC 销售退货单A_TO_B
旺店通金蝶云星空退换货单(退款不退货)A_TO_B
旺店通金蝶云星空采购入库单 / 采购退料单A_TO_B
旺店通金蝶云星空预入库单A_TO_B
旺店通金蝶云星空盘盈单 / 盘亏单 / 其他出库单 / 其他入库单A_TO_B
旺店通金蝶云星空调拨出库单 / 调拨入库单(分步式调拨)A_TO_B
金蝶云星空旺店通收料通知单 → 采购订单B_TO_A
金蝶云星空旺店通发货通知单 → 原始订单B_TO_A
金蝶云星空旺店通调拨申请单 → 调拨单B_TO_A
金蝶云星空集成平台仓库、客户、供应商、物料、库存、辅助资料、组织等主数据QUERY_ONLY
旺店通集成平台店铺、原始订单、订单查询QUERY_ONLY

实施要点

编码映射是落地的首要工作。 物料、客户、仓库、供应商四类主数据在两侧系统各自有独立编码体系,跨系统单据同步必须依赖映射表。物料由旺店通的 spec_no/goods_no 映射到金蝶的 FMaterialId(含 _FNumber 编码),仓库由 warehouse_no 映射到 FStockId.FNumber,供应商由 provider_no 映射到 FSupplierId.FNumber,客户在 ToB/ToC 场景下还要结合 BNS 分销商与客户对应关系做二次映射。映射字段(如 F_KD_WDTSTOCK)需要提前在金蝶自定义字段中维护。

关键单据的字段映射需要逐项核对。 以 ToB/ToC 销售出库为例:order_no → FBillNo、consign_time → FDate、goods_count → FQty、sell_price → FPrice、shop_no → FStockOrgId.FNumber。采购入库需要用 outer_no 联查金蝶收料通知单以保证单据关联,盘盈盘亏只需要单号、仓库、物料、数量四类核心字段,调拨类单据需要同时带出调出仓库与调入仓库的编码映射。

增量与全量双模式并行。 主数据查询策略通常基于 FModifyDate>='{{LAST_SYNC_TIME}}' 实现增量;执行类单据在首次上线或补数据时需要切换到全量模式,全量完成后回到增量。建议在调度层面提供模式切换开关,避免上线初期因历史数据未同步完成导致单据遗漏。

异常重试与告警必须配套。 单据写入失败常见原因包括编码映射缺失、必填字段为空、库存不足、单据状态校验不通过等。建议在策略层配置有限次数的自动重试(例如 3 次,指数退避),超过阈值后进入人工处理队列,并通过企业微信或钉钉推送报错提醒。

最佳实践

  • 调度频率分层设置:基础资料查询每 15~30 分钟;销售出库/退货每 10~15 分钟;发货通知→原始订单每 15 分钟;采购入库/退料每 20 分钟;预入库每 30 分钟;盘盈盘亏每 30 分钟;调拨每 20 分钟;退换货每日 1~2 次即可;查询类策略按需或每 2 小时;历史数据清理每日 1 次。高频策略优先保证实时性,低频策略避免对源系统造成查询压力。
  • 基础资料策略先于业务策略上线:KD3 金蝶仓库、BNS 分销商客户、旺店通店铺等查询策略必须在销售、采购、调拨策略之前稳定运行,否则业务单据会因为找不到映射而失败。
  • 调拨采用分步式回写:金蝶调拨申请先下发到旺店通生成调拨单,旺店通完成实际调拨后再把调拨出库与调拨入库分别回写到金蝶,避免一次回写造成金蝶侧单据状态混乱。
  • 历史数据清理设置保留窗口:方案 35 的清理策略建议保留两个月窗口,既能控制集成平台的数据量,又能在出现对账问题时留出排查周期。
  • 上线前完成映射表的完整性与一致性校验:包括仓库、物料、供应商、客户四类编码的全量比对,发现缺失或冲突需提前在两侧系统补齐,再切换到增量同步模式。

关联文档

  • 总体集成工作流文档:本文
  • 完整方案设计:含逐策略字段映射、异常处理、调度建议的详细设计文档

接口手册节选

采购退料申请单(PUR_MRAPP)

用于在正式办理采购退料出库前预先申请并记录退料物料、数量、退料类型、退料方式、补料/扣款等信息。表单 ID 为 PUR_MRAPP,通过 executeBillQuery WebAPI 按分页查询,Target 配置为写入空操作,属于纯查询策略。关键字段包括 FBillNo(单据编号)、FDocumentStatus(单据状态)、FBusinessType(业务类型:标准采购/委外/资产采购/VMI)、FRMTYPE(退料类型:检验退料/库存退料)、FRMMODE(退料方式:退料补料/退料并扣款)、FREPLENISHMODE(补料方式)、FConfirmStatus(确认状态)等。

金蝶仓库(BD_STOCK)

用于建立旺店通仓库与金蝶仓库的编码映射关系,是出入库单、调拨单等业务单据仓库字段映射的基础。表单 ID 为 BD_STOCK,通过 executeBillQuery 查询。除基础字段 FStockId、FNumber、FName、FGroup、FUseOrgId 外,核心关联字段 F_KD_WDTSTOCK(旺店通仓库编码)用于建立金蝶仓库与旺店通仓库的一对一映射,是本方案中仓库主数据的关键映射字段。

发货通知单(SAL_DELIVERYNOTICE)

用于销售订单与发货通知单的关联追溯,是发货状态预同步的核心数据源。表单 ID 为 SAL_DELIVERYNOTICE,通过 executeBillQuery 按审批日期等条件增量筛选。除基础字段外,跨系统映射字段 F_KD_SubOrderNo(旺店通子订单号)用于建立旺店通子订单与金蝶发货通知单明细的精确关联。

关联文档

  • 完整方案设计:含逐策略字段映射、异常处理、调度建议的详细设计文档
本文为原创内容,转载请注明出处:https://www.qeasy.cloud/insights/solutions/sol-wdt-kingdee-cloud-5343

评论