一、为什么要“再集成”
做过制造业 IT 的都知道,金蝶云星空管账、泛微京桥通管流程,两套系统单独用都很香,但一旦要跑通“采购-入库-对账-付款”闭环,就会出现三大裂缝:
- 主数据重复:物料、供应商在两边各建一次,编码口径对不上。
- 单据断点:PO 在云星空,审批在京桥通,收货单在仓库 PDA,财务靠 Excel 缝缝补补。
- 逆向流程黑洞:退货单没有原 PO 号,月底对账才发现多付了一笔。
于是我们画了下面这张图(来自项目真实蓝图),把“单据”翻译成“事件流”,用轻易云做数据总线,让两套系统说同一种语言。
—
二、整体架构图
┌──────────┐ ┌────────────┐ ┌────────────┐
│ 金蝶云星空 │<----->│ 轻易云集成平台 │<----->│ 泛微·京桥通 │
└──────────┘ └────────────┘ └────────────┘
- 南向:云星空开放物料、供应商、PO、收货、退货、付款 API。
- 北向:京桥通开放流程引擎、表单、权限接口。
- 中台:轻易云做字段映射、ID 转换、异常重试、日志审计。
—
三、关键集成点拆解
集成场景 | 触发时机 | 字段映射示例 | 异常兜底策略 |
物料主数据同步 | 京桥通“新增物料”流程归档 | 编码、名称、单位、成本要素、采购目录 | 重复编码 → 回写审批意见“已存在” |
供应商主数据同步 | 京桥通“新增供应商”流程归档 | 编码、名称、银行账户、付款条件、税率 | 银行账户格式校验失败 → 流程退回 |
PO 下发 | 京桥通 PO 流程审批通过 | PO 号、行号、数量、单价、税率 | PO 号冲突 → 自动在云星空加后缀 |
收货单回传 | 云星空“采购入库单”审核 | 收货单号、实收数量、批次 | 行号对不上 → 写异常队列人工处理 |
发票核验完成 | 税务平台返回发票状态 | 发票号、金额、税额、校验码 | 核验失败 → 京桥通表单置红并通知采购 |
付款申请 | 三单匹配成功 | PO 号、本次付款金额、付款方式 | 超预算 → 自动触发预算追加流程 |
付款单状态回写 | 网银/银企直联返回结果 | 付款单号、状态、流水号 | 付款失败 → 钉钉群 @财务主管 |
退货单联动 | 京桥通“退货申请”审批通过 | 原 PO 号、退货数量、含税金额 | 退货单未找到原 PO → 流程直接终止 |
—
四、落地步骤(可直接抄作业)
环境准备
- 云星空:打开 WebAPI 权限,新建集成用户,只给“查询/写入采购单据”最小权限。
- 京桥通:在集成中心新建“轻易云”第三方应用,拿到 appKey / appSecret。
- 轻易云:创建两条通道,一条“主数据 MQ”,一条“业务单据 MQ”,开启重试(3 次,指数退避)。
字段映射脚本(伪代码)
{
"source": "kingdee_supplier",
"target": "jqt_supplier",
"fields": [
{"from": "FNumber", "to": "supplierCode"},
{"from": "FName", "to": "supplierName"},
{"from": "FBankAccount", "to": "bankAccount", "regex": "^[0-9]{1,30}$"}
],
"conflict": "skip"
}
异常队列处理
轻易云内置一张 integration_exception
表,结构:
id | source | target | error_msg | retry_times | created_time
财务每天早 8 点收到邮件摘要,点链接即可跳转到异常单据。
灰度策略
- 第一周:只同步“新增物料”和“新增供应商”,观察 3 天无异常再开 PO。
- 第二周:打开“收货单→付款申请”链路,但付款申请仍手工确认。
- 第三周:全自动,财务只盯异常队列。
—
五、踩过的坑 & 解决姿势
坑 | 现象 | 根因 | 解决 |
云星空 API 限流 | 连续 200 次调用报 429 | 默认 100 req/min | 轻易云加令牌桶限速,削峰填谷 |
京桥通下拉框联动 | 新增物料类别选不到 | 类别缓存未刷新 | 强制在流程提交前调用刷新接口 |
退货单行号重复 | 对账差异 | 原 PO 行被拆分,行号不唯一 | 用“PO 行号 + 原行 ID”做复合键 |
—
六、性能与运维指标
- 单据平均同步时延:物料 1min,PO 1 min,收货单 2min (含图片 OCR)。
- 异常率:<0.3%(连续 90 天统计,约 2.7 万张单据)。
- 容灾:轻易云双节点 + MySQL 主从,RPO=5 min,RTO=15 min。
—
七、一句话总结
把“单据”翻译成“事件”,让系统之间用事件对话,而不是靠人传话——这就是京桥通与云星空深度集成的全部秘密。
八、金蝶云星空&泛微京桥通对接流程图
