宜搭低代码平台与金蝶云星空ERP系统集成技术方案
一、集成背景与技术挑战
在企业信息化建设过程中，普遍存在异构系统共存的现象。以宜搭（钉钉生态低代码平台）与金蝶云星空（云端ERP系统）为例，两者分别承担着不同的业务职能：
- 宜搭：面向业务部门的敏捷应用构建，擅长流程审批、数据采集、移动办公
- 金蝶云星空：面向财务与供应链的后端管理，具备完善的ERP核心能力
系统割裂导致的技术问题包括：
- 主数据重复维护：客户、供应商、物料档案需在两端分别建档
- 单据流转断层：业务单据从宜搭发起后需人工录入ERP
- 库存状态不同步：前端查询不到ERP实时库存，影响业务决策
- 财务数据滞后：业务发生与财务凭证生成存在时间差
二、平台接口能力分析
2.1 宜搭开放能力
宜搭提供标准的数据集成接口，支持：
- 表单数据API：基于表单ID的数据查询、写入、更新操作
- 流程引擎回调：审批状态变更时的外部系统通知机制
- 数据联动：支持跨应用数据关联与外部数据源接入
其技术特性决定了宜搭更适合作为业务发起端与数据展示端，而非复杂的财务核算与库存运算。
2.2 金蝶云星空开放能力
金蝶云星空提供RESTful WebService接口（基于KDORM框架），核心接口类型包括：
| 接口类型 | 功能说明 |
|---|
| 基础资料接口 | 客户、供应商、物料、仓库档案的增删改查 |
| 业务单据接口 | 采购订单、销售订单、出入库单据、应收应付单 |
| 财务凭证接口 | 凭证生成、科目余额查询、成本核算数据获取 |
| 库存查询接口 | 即时库存、可用量、在途量查询 |
金蝶云星空的标准API支持字段扩展与弹性域，能够适配个性化的数据字段需求。
三、业务场景的技术实现
3.1 主数据同步架构
同步策略：以金蝶云星空为权威数据源（Master），宜搭为消费端（Slave），采用"一对多"静态资源映射模式。
技术实现要点：
| 金蝶字段 | 宜搭字段类型 | 映射说明 |
|---|
| FNumber（客户编码） | 单行文本 | 主键映射，建立唯一关联 |
| FName（客户名称） | 单行文本 | 直接文本映射 |
| FSpecification（规格型号） | 单行文本 | 物料属性同步 |
| FUnitID（计量单位） | 下拉选择 | 编码转名称展示 |
同步触发机制：
- 定时轮询：通过计划任务定期比对数据版本号（FModifyDate）
- 实时推送：金蝶WebHook（如有）或宜搭定时触发器拉取变更
数据一致性保障：
- 建立编码映射表，解决两端编码规则不一致问题
- 必填字段校验：确保金蝶端必填字段在宜搭表单中有值
- 重复性校验：根据编码唯一性约束防止重复写入
3.2 采购业务单据流
业务流程映射：
| 业务环节 | 宜搭角色 | 金蝶角色 | 数据流向 |
|---|
| 采购申请 | 申请单录入与审批 | 接收申请单 | 宜搭→金蝶 |
| 采购订单 | 可选录入（或金蝶发起） | 订单确认与下推 | 双向 |
| 采购入库 | 到货确认（移动端） | 入库单生成 | 宜搭→金蝶 |
| 应付确认 | 查看应付余额 | 应付单与发票 | 金蝶→宜搭 |
关键技术点：
- 单据关联：宜搭申请单需回写金蝶生成的申请单号（FBillNo），以便后续订单关联
- 状态回写：金蝶入库完成后，通过接口回调更新宜搭申请单的"入库状态"字段
- 库存更新：入库单审核后触发金蝶库存计算，宜搭通过查询接口获取最新库存
3.3 销售业务与库存联动
库存查询的技术实现：
金蝶云星空提供Query接口查询即时库存视图（T_STK_Inventroy），关键字段包括：
- 物料编码（FMaterialID）
- 仓库编码（FStockID）
- 库存数量（FQty）
- 可用量（FAvaQty，扣除预留与在途）
宜搭通过前端JS或后端代理调用该接口，实现库存校验逻辑：提交订单前校验可用量是否满足订单数量。
单据状态机同步：
| 宜搭订单状态 | 金蝶单据状态 | 同步触发条件 |
|---|
| 待确认 | 创建 | 宜搭提交审批 |
| 已确认 | 审核 | 宜搭审批通过 |
| 待发货 | 出库 | 金蝶生成出库单 |
| 已发货 | 应收 | 金蝶确认出库 |
| 已开票 | 收款 | 金蝶开票完成 |
状态变更通过事件驱动方式同步：金蝶单据审核/反审核事件触发宜搭状态更新。
3.4 财务数据集成
费用报销对接：
宜搭完成审批流后，将报销单数据推送到金蝶费用报销模块或总账凭证接口。
技术要点：
- 科目映射：根据费用类型映射会计科目（FAccountID）
- 辅助核算：部门、项目、员工等辅助账段传递
- 附件处理：宜搭附件URL需转换为金蝶可访问的存储路径或Base64编码
应收应付查询：
利用金蝶Query接口查询应收单（T_AR_RECEIVABLE）与应付单（T_AP_PAYABLE），在宜搭展示账龄分析表。
注意事项：
- 数据权限：接口调用需使用具有查询权限的代理用户
- 性能优化：大数据量查询需分页（使用Limit/Offset参数）
四、技术架构设计
4.1 集成中间层架构
推荐采用集成平台（Integration Platform）作为中间层，而非直接点对点连接。系统架构分为三层：
前端层：阿里宜搭
- 低代码应用构建平台
- 负责业务发起、数据展示、流程审批
中间层：集成平台
- API网关：统一鉴权（OAuth2.0）、限流、协议转换
- 数据转换引擎：字段映射、数据类型转换、编码转换
- 消息队列：异步机制（RabbitMQ/Redis）解耦系统，处理峰值流量
- 异常处理中心：记录失败日志，支持断点续传与手动重推
后端层：金蝶云星空
- ERP核心系统
- 负责财务核算、供应链管理、库存管理
4.2 数据映射与转换规则
字段级映射示例：
| 宜搭字段类型 | 金蝶字段 | 转换规则 |
|---|
| 日期时间 | FDate | 格式化为YYYY-MM-DD |
| 数值（元） | FAmount | 转换为Decimal(28,10)，单位统一 |
| 下拉选择 | FBaseProperty | 根据选项值映射为金蝶编码 |
| 成员（钉钉用户） | FUserID | 通过手机号/工号映射金蝶用户 |
数据校验逻辑：
- 前置校验：调用金蝶接口前验证必填字段、数据类型、长度限制
- 后置校验：写入后根据返回的FID（金蝶内码）确认写入成功
- 业务规则校验：如客户信用额度检查、库存可用量检查
4.3 安全与稳定性设计
传输安全：
- 强制HTTPS/TLS 1.2+加密传输
- 敏感凭证（ClientID/ClientSecret）采用AES-256加密存储于集成平台配置中心
- IP白名单限制：金蝶云星空后台配置允许访问的集成平台出口IP
身份认证：
- OAuth2.0 Client Credentials模式获取AccessToken
- Token有效期管理：金蝶Token默认7200秒，需实现自动刷新机制
- 代理用户权限：在金蝶中创建专用接口用户，限定操作范围（仅允许特定单据类型）
容错机制：
- 幂等性设计：同一单据重复提交时，根据唯一编号（如宜搭实例ID）去重
- 补偿事务：宜搭审批通过但金蝶写入失败时，触发回滚或告警
- 监控告警：接口响应时间、错误率、积压队列长度监控
