一、方案概述
企业使用金蝶云星空承载采购、销售、库存、财务成本核算，管理账面库存、物料、仓库、客商等主数据；极风 WMS负责海外仓实物仓储作业，包含收货、拣货、打包、出库、退货上架、库存盘点等仓内执行操作。
两套系统独立使用存在业务痛点：金蝶云星空的业务计划单据需要人工导出后录入极风 WMS；极风 WMS 仓内实物作业完成后，作业结果、实物库存无法自动回传金蝶；账面库存与海外仓实物库存对账依赖人工 Excel，单据核对工作量大，容易出现录入错误、账实不一致问题。
本方案依托小懿互联 iPaaS 集成平台作为中间数据枢纽，调用金蝶云星空开放 API、极风 WMS 官方开放 API，实现两个系统之间主数据、业务单据双向数据同步。 整体实现模式：小懿互联定时调用金蝶云星空 API 抓取已审核业务单据，经过字段映射转换，调用极风 WMS 对应 API 创建仓内作业任务；同时小懿互联定时调用极风 WMS 查询 API，获取仓内已完成单据数据，清洗、校验后推送至金蝶云星空生成对应业务单据，更新账面库存。
二、对接核心目标
- 物料主数据双向协同：金蝶云星空物料档案定时同步至极风 WMS，保证两边物料编码、规格信息统一；
- 业务计划单据下发：金蝶云星空已审核单据，自动同步至极风 WMS，生成仓内作业任务，供仓库 PDA 执行；
- 仓内作业结果回传：极风 WMS 作业完成后，小懿互联定时查询极风 WMS 单据接口，抓取完成数据，回写到金蝶云星空生成库存业务单据；
- 单据唯一标识关联：金蝶单据号与极风单据外部业务编号绑定，单据双向可追溯，便于业务核对、内控审计；
- 配置化集成，字段、同步周期可在小懿互联可视化配置，减少定制开发；
- 数据校验、同步日志留存，异常单据告警，支持单据手动重推。
三、前置对接条件
- 开通金蝶云星空开放 API 权限，获取接口调用凭证；开通极风 WMS 开放 API，获取访问 Token；
- 在小懿互联维护需要的编码映射表，例如：仓库编码、业务类型编码等，保证金蝶与极风 WMS 编码对应；
- 业务规范：仅抓取金蝶状态为已审核的单据下发；仅抓取极风 WMS 状态为已完成的业务单据回传金蝶，草稿、处理中、作废单据过滤不做同步；
- 网络环境允许小懿互联平台访问金蝶云星空、极风 WMS 两方 API 服务。
四、核心对接明细总表
|----|------|---------------------|----------------|---------------------|-----------------------------------------------------|
| 序号 | 数据分类 | 来源系统单据 | 目标系统单据 | 同步流向 | 业务说明 |
| 1 | 基础资料 | 金蝶云星空 - 物料档案（已审核） | 极风 WMS - 商品档案 | 金蝶云星空 →小懿互联 →极风 WMS | 将 ERP 物料信息同步到极风 WMS 商品档案，作为仓内作业基础物料数据 |
| 2 | 业务单据 | 金蝶云星空 - 收料通知单（已审核） | 极风 WMS - 入库单 | 金蝶云星空 →小懿互联 →极风 WMS | 采购备货业务，金蝶收料通知单下发，在极风 WMS 生成入库作业任务，仓库执行收货上架 |
| 3 | 业务单据 | 极风 WMS - 入库单（已完成） | 金蝶云星空 - 采购入库单 | 极风 WMS →小懿互联 →金蝶云星空 | 极风 WMS 收货上架完成，小懿互联调用极风查询接口获取入库结果，回传金蝶生成采购入库单，增加账面库存 |
| 4 | 业务单据 | 金蝶云星空 - 发货通知单（已审核） | 极风 WMS - 出库单 | 金蝶云星空 →小懿互联 →极风 WMS | 销售履约业务，金蝶发货通知单下发，在极风 WMS 生成出库任务，仓库执行拣货打包出库 |
| 5 | 业务单据 | 极风 WMS - 出库单（已完成） | 金蝶云星空 - 销售出库单 | 极风 WMS →小懿互联 →金蝶云星空 | 极风 WMS 出库作业完成，抓取出库结果回传金蝶生成销售出库单，扣减账面海外仓库存 |
| 6 | 业务单据 | 金蝶云星空 - 退货通知单（已审核） | 极风 WMS - 退货入库单 | 金蝶云星空 →小懿互联 →极风 WMS | 客户退回海外仓场景，金蝶退货通知单下发，极风 WMS 生成退货收货作业 |
| 7 | 业务单据 | 极风 WMS - 退货入库单（已完成） | 金蝶云星空 - 销售退货单 | 极风 WMS →小懿互联 →金蝶云星空 | 极风 WMS 完成退货收货上架，回传金蝶生成销售退货单，恢复账面库存 |
| 8 | 业务单据 | 极风 WMS - 盘点单（已完成） | 金蝶云星空 - 盘点结果 | 极风 WMS →小懿互联 →金蝶云星空 | 极风 WMS 仓库盘点完成，盘点差异数据回传，在金蝶生成盘点单，更新账面库存 |
五、标准业务流转说明
5.1 物料主数据同步流程
- 小懿互联定时调用金蝶云星空物料 API，获取已审核物料档案；
- 在小懿互联中完成字段映射、数据校验，过滤无效物料；
- 调用极风 WMS 商品档案 API，新增或更新极风 WMS 商品信息；
- 物料新增、修改后，在下一轮同步周期自动更新极风 WMS 商品档案。
5.2 采购备货入库业务流程
- 业务人员在金蝶云星空创建采购订单，审核生成【收料通知单】；
- 小懿互联每 10 分钟抓取金蝶已审核收料通知单，完成字段转换；
- 调用极风 WMS 入库单 API，创建极风入库作业任务，仓库人员使用 PDA 进行收货、质检、上架操作；
- 仓内作业完成，极风 WMS 入库单状态更新为已完成；
- 小懿互联定时调用极风 WMS 查询接口，筛选已完成入库单据；
- 数据校验后推送金蝶云星空，自动生成采购入库单，增加金蝶账面库存；
- 金蝶单据号与极风单据外部编号关联，便于双向查询追溯。
5.3 销售出库业务流程
- 金蝶云星空销售订单审核，生成【发货通知单】；
- 小懿互联抓取已审核发货通知单，调用极风 WMS 出库单 API 创建仓内出库任务；
- 海外仓执行拣货、打包、出库确认，极风出库单状态变更为已完成；
- 小懿互联拉取极风已完成出库单据，推送金蝶生成销售出库单，扣减海外仓账面库存。
5.4 客户退货入库业务流程
- 客户退货业务在金蝶云星空审核生成【退货通知单】；
- 小懿互联同步单据至极风 WMS，生成退货入库单，仓库执行退货收货、质检、上架；
- 极风退货入库作业完成后，小懿互联拉取单据信息，回写金蝶生成销售退货单，恢复库存。
5.5 库存盘点同步流程
- 在极风 WMS 创建盘点任务，仓库完成实物盘点并确认盘点单；
- 小懿互联定时拉取极风 WMS 已完成盘点单及盘点差异数据；
- 数据经过校验后，推送至金蝶云星空，生成盘点单据，更新账面库存，完成账实调整。
六、小懿互联集成平台核心价值体现
- 双系统 API 连接器：封装金蝶云星空、极风 WMS 两套系统 API，统一管理接口调用、鉴权；
- 可视化字段映射管理：维护金蝶单据与极风 WMS 单据之间字段映射关系，支持配置调整，无需代码开发；
- 定时调度策略：按照预设周期轮询拉取金蝶待下发单据、轮询查询极风 WMS 已完成单据；自动过滤草稿、作废单据；
- 幂等防重复机制：使用外部业务单号作为唯一业务标识，避免重复创建极风单据、重复生成金蝶业务单据；
- 数据校验与异常告警：校验物料、仓库、数量等必填信息；接口调用失败触发告警，失败单据保存原始报文，支持一键重推；
- 全链路同步日志：记录每一次 API 请求、报文、返回结果，关联金蝶单据号与极风单据号，满足审计追溯需求；
- 灵活扩展：后续新增业务场景，直接在平台新增同步流程，调整映射配置即可。
七、实施落地步骤
- 需求调研：梳理业务范围，确认物料、仓库清单，确定入库、出库、退货、盘点业务流程，约定同步周期，完成字段映射清单。
- 环境准备：开通金蝶云星空、极风 WMS 开放 API 权限；小懿互联配置双方连接器，建立物料、仓库编码映射表。
- 联调测试：物料同步、入库、销售出库、退货入库、盘点全场景接口联调；覆盖正常单据、异常单据，验证幂等、重推逻辑。
- 试运行阶段：选取部分业务试运行，仓储、财务核对单据、库存数据准确性。
- 全量上线：试运行验证无误后正式启用。
- 运维交付：交付运维手册，培训运维人员查看同步日志、处理异常单据、手动重推。
八、方案落地业务价值
- 业务单据自动双向流转，替代人工导出 Excel 录入两套系统，减少人工操作，降低录入差错；
- 海外仓实物作业结果自动回传金蝶云星空，实时同步库存变动，减少月末账实核对工作量；
- 金蝶单据与极风单据一一关联，全链路日志可查询，满足企业业务追溯、内控审计要求；
- 业务流程标准化，仓库专注实物履约，ERP 负责业务与财务核算，实现业仓一体化；
集成采用配置化模式，后续业务变更、字段调整在小懿互联平台配置，降低后期维护成本。