方案定位
金蝶与旺店通单据协同方案是一套配置驱动的 ERP 单据自动协同引擎，覆盖金蝶云星空与旺店通 ERP 之间的调拨推送、销售回传、退款回传、动态路由拆分和月度采购汇总五大业务场景。
核心设计理念：不将任何组织编码、表单 ID、字段映射写死在代码中，所有业务规则通过配置中心管理，新增、停用、调整组织只需维护配置，无需重新开发接口。配套管理后台提供权限控制、配置在线管理和监控看板，确保系统可观测、可管控。
核心价值
01 全链路自动化调拨、销售出库、退换退款单据自动推送与回传，零人工干预，每笔单据从源系统到目标系统全程可追溯。02 配置驱动组织、表单 formId、字段映射、状态码、仓库货品全部配置化。新增组织 3 步配置即可上线，无需一行代码变更。**03 幂等可靠每条业务流通过唯一幂等键控制，避免重复推单。失败自动重试（指数退避），超限告警，确保数据一致性。04 管控闭环管理后台提供三级权限（管理员/操作员/观察者）、配置变更审批流、监控看板和审计日志，确保每一次配置变更受控、可追溯、可回滚。
方案覆盖范围
| 业务场景 | 源系统 | 目标系统 | 核心能力 |
|---|---|---|---|
| 分布式调拨推送 | 金蝶 | 旺店通 | 金蝶调出/调入单 → 旺店通调出/调入单 + 其他入库单 |
| 销售出库回传 | 旺店通 | 金蝶 | 已完成出库单 → 销售订单或赠品补发单 |
| 退还管理回传 | 旺店通 | 金蝶 | 退货退款/退款不退货 → 销售退货单/其他出库单/应收单 |
| 源组织动态拆分 | 金蝶源组织 | 多目标组织 | 按客户主体字段路由，单据自动分发到目标组织 |
| 月度采购汇总 | 目标组织 | 金蝶 | 销售订单 + 赠品补发单按月汇总 → 采购订单 |
核心设计原则
原则一：配置即代码。formId、组织编码、字段映射、状态码、仓库货品映射全部存储在配置中心，不写死在业务代码中。配置变更即时生效，无需重新部署。
原则二：幂等至上。每个业务流通过「源系统 + 源单号 + 业务类型」组成唯一幂等键，无论重试多少次，目标系统只会生成一条对应单据。
原则三：全链路可观测。每笔推送记录源单号、目标单号、推送结果、错误信息和重试次数，异常可追溯、可定位、可补偿。
文档导航
| 章节 | 说明 | 进入 |
|---|---|---|
| 项目背景与价值 | 行业趋势、业务痛点、ROI 分析 | 项目背景与价值 → |
| 系统架构设计 | 三层架构、数据流、组件职责 | 系统架构设计 → |
| 业务流转方案 | 5 大业务场景详细流程 | 业务流转方案 → |
| 动态配置能力 | 6 大配置类型与变更流程 | 动态配置能力 → |
| 权限与角色管理 | 三级权限模型、用户管理、安全策略 | 权限与角色管理 → |
| 配置动态调整 | 管理后台架构、变更审批流、即时生效 | 配置动态调整 → |
| 监控与日志看板 | 仪表盘、同步日志、异常告警、数据报表 | 监控与日志看板 → |
| 实施计划 | 10 阶段 25 天里程碑计划 | 实施计划 → |
| 确认事项与 FAQ | 上线前检查清单与常见问题 | 确认事项与 FAQ → |
最后更新