旺店通与金蝶云星空供应链集成方案:35 个策略的架构与实施要点
场景与价值
在典型的电商零售业务中,电商 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(旺店通子订单号)用于建立旺店通子订单与金蝶发货通知单明细的精确关联。
关联文档
- 完整方案设计:含逐策略字段映射、异常处理、调度建议的详细设计文档