金蝶云星空·旗舰版 × 聚水潭跨境业务一体化集成方案
一、项目背景
聚水潭在跨境业务场景下，需要把前端平台（Amazon、eBay、Shopee 等）的订单、售后、库存账实时同步到金蝶云星空·旗舰版的财务与供应链模块，实现「订单流-物流-资金流-票据流」四流合一。本方案采用「轻易云集成平台」作为 ESB 中间层，以「低代码 + 标准 API + 可编排」方式完成跨境业务闭环。
二、整体集成蓝图
1. 系统角色
• 聚水潭：跨境订单中心（OMS）+ 仓储中心（WMS）
• 金蝶云星空·旗舰版：财务核算中心（ERP）
• 轻易云集成平台：数据总线、路由、监控、异常重试
2. 数据流向
聚水潭 → 轻易云 → 金蝶：订单、退货、采购、调拨、盘点等业务单据
金蝶 → 轻易云 → 聚水潭：物料、供应商、店铺、仓库、库存余额等主数据
三、跨境业务集成流程拆解
01 物料主数据同步（流程图节点 01）
场景：保证跨境 SKU 在金蝶与聚水潭两端编码一致，避免报关、退税时的税号与品名差错。
触发：金蝶组织 100 下新增/修改「成品物料」→ 实时推送到聚水潭商品库。
关键字段：物料编码、海关编码（HS Code）、英文品名、申报单价、毛净重、品牌、是否带电。
异常策略：
• 物料编码冲突：轻易云执行「编码映射表」自动转换；若无映射，抛异常工单至主数据管理员。
• 必填字段缺失：轻易云在校验节点中断流程，钉钉通知「物料负责人」补录。
02 销售&售后业务（节点 03、04）
场景：跨境订单在平台发货后，需在 30 分钟内同步到金蝶生成「销售出库单」；退货逆向同理。
触发：聚水潭订单状态 = 已发货 / 已退货 → 轻易云轮询 1 分钟一次。
关键字段：
• 订单维度：平台单号、店铺、买家 ID、成交费、平台佣金、FBA 物流单号。
• 商品维度：SKU、数量、成交单价、关税、运费、折扣。
• 财务维度：本位币金额、汇率（按发货当日央行中间价）、税费分录模板。
异常策略：
• 汇率获取失败 → 使用「备用汇率接口」；若也失败，则延迟 5 分钟重试，最多 3 次。
• 金蝶库存不足 → 自动创建「待检库存」单据，冻结数量并通知采购加急补货。
03 采购业务（节点 05、06）
场景：跨境 FBA 补仓、海外仓备货，由金蝶发起采购订单，入库后同步到聚水潭更新可用库存。
触发：金蝶采购订单审核 → 生成「采购入库单」→ 轻易云监听新增事件。
关键字段：采购订单号、供应商、预计到货日期、采购价、关税税率、物流方式。
异常策略：
• 采购退货 → 金蝶「采购退货单」同步聚水潭后，自动冲减库存并回写退货原因。
• 汇率差异 → 金蝶以「财务汇率」记账，聚水潭以「业务汇率」展示，差异写入「汇兑损益」科目。
04 库内作业（节点 07-12）
场景：海外仓/保税仓内部调拨、盘点盈亏、其他出入库，需要同步到金蝶总账。
关键流程：
• 直接调拨（节点 09、10）：金蝶「直接调拨单」分两步：出库（源仓库）→ 入库（目的仓库）。
轻易云拆分单据，保证聚水潭库存实时扣减与增加。
• 盘点（节点 11、12）：聚水潭「盘亏单/盘盈单」同步生成金蝶「其他出库单/入库单」。
盘点差异 > ±2% 触发「库存重估」流程，自动生成成本调整单。
四、主数据映射策略
| 聚水潭 | 金蝶云星空 | 映射规则 | 备注 |
|---|---|---|---|
| 店铺 | 客户 | 1:1 | 客户编码 = 店铺代码 |
| 仓库 | 仓库 | 1:1 | 仓库编码 = 仓库代码 |
| 供应商 | 供应商 | 1:1 | 供应商编码 = 供应商代码 |
| SKU | 物料 | 1:1 | 物料编码 = SKU |
五、接口清单（核心 6 个 API）
| 序号 | 接口路径 | 数据方向 | 业务场景 | 源系统 | 目标系统 |
|---|---|---|---|---|---|
| 1 | /kdcloud/material/sync | 金蝶 → 轻易云 → 聚水潭 | 物料主数据同步 | 金蝶云星空·旗舰版 | 聚水潭 |
| 2 | /jushuitan/order/outbound | 聚水潭 → 轻易云 → 金蝶 | 销售出库单同步 | 聚水潭 | 金蝶云星空·旗舰版 |
| 3 | /jushuitan/order/refund | 聚水潭 → 轻易云 → 金蝶 | 销售退货单同步 | 聚水潭 | 金蝶云星空·旗舰版 |
| 4 | /kdcloud/purchase/inbound | 金蝶 → 轻易云 → 聚水潭 | 采购入库单同步 | 金蝶云星空·旗舰版 | 聚水潭 |
| 5 | /kdcloud/purchase/return | 金蝶 → 轻易云 → 聚水潭 | 采购退货单同步 | 金蝶云星空·旗舰版 | 聚水潭 |
| 6 | /kdcloud/inventory/adjust | 金蝶 → 轻易云 → 聚水潭 | 库存调整/盘点差异同步 | 金蝶云星空·旗舰版 | 聚水潭 |
六、异常监控与运维
• 轻易云「流程看板」：实时展示单据积压量、重试次数、失败原因。
• 钉钉群机器人：关键异常 30 秒内推送。
• 日志保留 90 天，支持按「平台单号 / 金蝶单据号 / SKU」多维检索。
七、上线 checklist
[ ] 主数据映射表一次性初始化
[ ] 历史库存期初导入（按仓库维度）
[ ] 跨境税率模板配置（国家+HS Code）
[ ] 平台店铺授权刷新 Token
[ ] 财务科目映射（收入、成本、运费、平台费、关税）
[ ] 灰度：先选 1 个店铺 + 1 个仓库跑 3 天
八、结语
通过「金蝶云星空·旗舰版 + 轻易云 + 聚水潭」三位一体方案，企业可在 2-3 周内完成跨境业务财务闭环，库存准确率提升到 99.5% 以上，关务合规风险降低 80%，并为后续 9810、9710 出口退税提供完整的数据链路。