科技背景
📚 简道云知识库

简道云 知识库

全方位学习资源

一站式:从入门到精通的完整学习路径

全覆盖:涵盖所有功能模块与集成场景

实战导向:结合真实业务场景的教学案例

📚 学习资源 📖 实战案例 🔧 技术文档 💡 经验分享

📚 知识库分类导航

快速定位您需要的学习资源

🔍 精选文章推荐

最受欢迎的学习资源

简道云权限体系设计最佳实践

2023-12-15

深入解析简道云权限体系的设计原理与实践案例,帮助管理员构建高效、安全的权限管理体系。

立即阅读

数据可视化仪表盘设计指南

2023-12-10

从数据源选择到图表配置,全方位指导如何设计专业的数据可视化仪表盘,提升数据分析效率。

立即阅读

简道云与金蝶ERP集成实战

2023-12-05

详细介绍简道云与金蝶云星空、K3等产品的API集成方案,包含配置步骤与常见问题解决方案。

立即阅读

🎯 金蝶产品对接

涵盖金蝶云星空、金蝶云·星辰、金蝶K3/KIS等产品线

☁️

金蝶云星空

企业级核心产品线,支持多业务线深度对接

企业级

基础准备

开放平台账号申请流程

金蝶开放平台账号注册入口:https://open.kingdee.com/

企业主体认证步骤、开发者角色分配、权限管理

第三方账号授权配置

AppKey/SecretKey获取步骤、OAuth 2.0授权流程、IP白名单配置

各业务线API权限配置步骤

财务/供应链/生产模块分别说明,标注需管理员账号授权的关键节点

沙箱环境搭建指南

测试账号申请入口、测试账号与生产账号权限差异、数据初始化

分业务线对接专题

财务线
  • 凭证生成接口对接
  • 应收应付核销接口
  • 外币核算与汇率同步
  • 多账套数据同步方案
供应链线
  • 物料主数据同步
  • 采购订单对接
  • 销售订单对接
  • 库存数据同步
生产制造线
  • 生产报工数据同步
  • 生产任务单对接
  • 工序数据校验
  • 生产进度可视化
人力资源线
  • 员工信息同步
  • 考勤数据对接
  • 薪资数据同步
  • 请假加班对接

常见问题

报错提示:"应收单生成失败,往来单位不存在"

关联配置:金蝶账号往来单位查询权限配置步骤

排查逻辑:

  • 用管理员账号登录金蝶开放平台,校验当前开发者账号是否开通"往来单位查询"权限
  • 核对简道云客户/供应商名称与金蝶往来单位编码、名称一致性
  • 检查账号是否绑定对应业务账套,避免跨账套调用

解决方案:通过金蝶开放平台控制台为账号补充往来单位查询权限,同步字段映射表修正名称/编码差异,重新绑定目标账套

报错提示:"凭证生成失败,科目无操作权限"

关联配置:凭证接口科目操作权限分配

排查逻辑:

  • 确认开发者账号是否被管理员分配目标会计科目(如费用类、资产类)的操作权限
  • 检查账号权限范围是否限定指定账套,是否存在账套绑定错误
  • 验证科目是否启用,是否存在停用状态导致调用失败

解决方案:用金蝶管理员账号调整账号科目权限,确保对应账套与科目权限匹配,启用目标科目后重新调用接口

金蝶云·星辰

小微企业专属,支持无代码/低代码对接方案

小微企业

核心聚焦

财务凭证、轻供应链对接(适配小微企业需求),简化技术内容,重点提供"无代码/低代码"对接方案(如集简云配置步骤)

第三方账号配置

集简云账号注册入口

https://www.jijyun.cn/,集简云官方平台

账号企业认证

小微企业简化认证流程,附指引

金蝶云·星辰账号与集简云账号授权绑定

分步截图,含授权范围选择,如仅开放财务数据权限

简道云账号与集简云账号关联

通过集简云"应用中心"添加简道云应用,完成账号授权

无代码对接步骤

以"简道云报销单→金蝶云·星辰凭证"为例
1

配置集简云流程:选择触发应用"简道云"→绑定账号→选择表单

2

选择执行应用"金蝶云·星辰"→绑定账号→选择"生成凭证"接口

3

配置字段映射,测试运行

4

上线监控,确保数据同步稳定

🖥️

金蝶K3/KIS

传统本地化部署产品线,支持EAI接口适配

本地化部署

核心补充

  • EAI接口适配方案(XML格式转换为JSON的代码示例)
  • 内网部署网络权限配置(端口开放、IP白名单设置)
  • 本地账号与简道云账号对接(通过EAI接口配置工具)
  • 账号权限管控(本地账号需分配"EAI接口调用"权限)
  • 多账号轮换机制(针对高频调用场景,规避接口限流)

安全要点

本地账号密码加密存储

在适配层代码中对账号密码进行MD5加密,避免明文传输

账号操作日志留存

记录每个账号的接口调用时间、操作内容,便于审计追溯

🎯 用友产品对接

涵盖用友U8、用友YonSuite、用友NC等产品线

🏭

用友U8

制造业/中小企业核心产品线,支持深度业务适配

制造业/中小企业

基础准备

U8 API服务部署

内网/外网模式配置差异,外网模式需绑定固定公网IP,关联用友开放平台账号

第三方账号配置

用友开放平台账号注册入口、企业认证步骤、AppKey/SecretKey获取、OAuth 2.0认证流程详解

费控插件安装步骤

附版本要求、安装后验证方法,需用用友管理员账号登录系统完成插件激活

Token管理

Token获取、有效期管理(默认1小时)、刷新逻辑,集成账号密钥自动读取功能

分业务线对接专题

生产制造线
  • 生产报工数据同步
  • 工序数据校验规则
  • 生产任务单状态联动逻辑
  • 生产进度可视化
财务线
  • 应收款核销接口适配要点
  • 多账套数据同步方案
  • 外币应收款对接(外贸企业)
  • 凭证自动生成与审核

常见问题

报错提示:"Token已过期,认证失败"

关联配置:Token管理:有效期与刷新逻辑

排查逻辑:

  • 检查当前Token是否超过1小时有效期(用友U8默认时效)
  • 验证Token刷新逻辑是否正常,是否存在刷新失败未捕获异常
  • 确认账号SecretKey是否变更,导致刷新Token失败

解决方案:重新调用Token获取接口生成新Token,优化代码中Token刷新机制(添加异常捕获与重试),核对账号SecretKey一致性,若密钥变更需重新配置

报错提示:"应付单审核失败,无对应数据权限"

关联配置:用友U8账号数据权限设置

排查逻辑:

  • 检查账号是否被分配指定供应商的数据权限,是否存在跨供应商审核场景
  • 验证账号所属角色是否具备"应付单审核"操作权限,而非仅"录入"权限
  • 确认U8系统管理中是否限制账号操作范围(如部门、账套)

解决方案:通过U8系统管理账号为当前账号分配对应供应商数据权限,调整角色权限至"审核"级别,明确账号操作账套与部门范围

🚀

用友YonSuite

SaaS中型企业产品线,支持无代码集成与低代码定制

SaaS中型企业

核心聚焦

无代码集成(集简云)与低代码定制结合,分业务线提供同步规则配置教程(附截图,标注关键配置项)

第三方账号联动

用友YonSuite账号注册/登录入口

https://www.yonsuite.com/,用友YonSuite官方平台

账号与集简云授权绑定

选择授权业务范围,如供应链、财务,参考集简云×YonSuite授权指南

集简云账号同时关联简道云与YonSuite账号

确保数据流转链路通畅,参考集简云多账号关联教程

多账号权限协同

YonSuite账号需具备数据读取/写入权限,集简云账号需具备流程配置权限

亮点模块

YonSuite智能财务凭证与简道云报表联动方案

支持自动生成财务报表,实时同步至简道云仪表盘,实现财务数据可视化

多组织数据权限管控配置

支持按组织分配账号权限,避免跨组织数据泄露,适配集团企业多组织架构

🏢

用友NC

集团级产品线,支持多组织架构数据适配

集团级

核心补充

  • 多组织架构数据适配(组织编码映射、跨组织数据筛选逻辑)
  • 集团级费用审批与NC多组织凭证生成对接方案
  • NC账号与简道云多组织联动配置(支持按组织分配账号权限)
  • 集团与子公司数据同步权限划分
  • 接口调用频率限制规避方案

注意事项

  • NC系统因架构复杂,需提前规划数据权限与组织映射关系
  • 集团与子公司的财务数据同步需遵循严格的合规性要求
  • 多组织架构下,需确保凭证生成不出现跨组织数据污染

🔧 技术原理篇

第三方集成核心技术逻辑

🌐 集成底层协议与技术支撑

🌐

HTTP/HTTPS协议

作为第三方集成最基础的通信协议,通过请求-响应模式实现简道云与外部系统的数据交互。

  • HTTP为明文传输,适用于非敏感数据
  • HTTPS基于SSL/TLS加密,适用于财务、海关等敏感数据场景
  • 配置人员无需理解加密细节,开发人员需掌握请求头构造、参数编码等细节
📡

MQTT/OPC UA/LoRaWAN协议

适用于IoT设备、实时数据同步场景的通信协议。

  • MQTT:轻量级发布/订阅协议,适用于车间机床数据采集
  • OPC UA:工业控制系统专属标准化协议,支持复杂工艺参数传输
  • LoRaWAN:低功耗广域网协议,适用于远距离、分散式IoT设备场景

📄 数据格式与解析原理

📊
JSON格式

轻量级键值对数据格式,为第三方API主流返回格式。

  • 结构灵活且易于解析
  • 适配简道云表单字段的扁平/嵌套需求
📑
XML格式

标签化数据格式,多用于传统ERP、海关系统。

  • 结构严谨但解析复杂度高于JSON
  • 开发人员需通过XPath/XSLT工具解析
📦
二进制格式

适用于附件、图片等文件同步。

  • 通过Base64编码转换为字符串格式传输
  • 开发人员需处理编码/解码逻辑

🔒 身份认证与安全机制原理

🔑

核心认证方式

  • AppID/Secret认证:第三方平台为开发者分配唯一标识与密钥,通过密钥计算签名或获取访问令牌
  • OAuth2.0认证:授权码模式,适用于需用户授权的场景,核心流程为"简道云请求授权码→通过授权码获取访问令牌→通过令牌调用API"
  • IP白名单+密钥认证:高安全级场景采用的双重认证机制,仅允许指定IP访问,同时通过密钥验证请求来源
🛡️

数据安全防护

  • 签名验证:通过对请求参数与密钥进行哈希计算,生成签名串,第三方系统验证签名一致性以确认数据未被篡改
  • 数据加密:敏感数据传输前需加密,对称加密(AES)适用于大量数据加密,非对称加密(RSA)适用于密钥传输
  • 最小权限原则:从权限设计层面降低安全风险,集成时仅申请必要权限

🏗️ 集成架构模式与适配逻辑

↔️

单向集成vs双向集成

  • 单向集成:数据从第三方系统→简道云或简道云→第三方系统,架构简单,仅需单方向请求与数据解析
  • 双向集成:数据双向同步,需设计数据一致性机制,避免数据冲突
🛠️

无代码/低代码集成架构

  • 无代码集成:基于简道云+集简云可视化工具,底层封装协议、认证、数据解析逻辑
  • 低代码集成:针对非标准化API、复杂逻辑场景,开发人员通过代码扩展实现定制化集成

📱 第三方平台集成原理适配案例

💼
办公平台集成

微信/钉钉等办公平台的集成原理。

  • 基于OAuth2.0授权+WebHook回调
  • 微信服务号通过AppID/Secret获取访问令牌
💾
ERP系统集成

金蝶/用友等ERP系统的集成原理。

  • 基于HTTP/HTTPS协议+AppID/Secret认证
  • 需处理嵌套数据解析与财务字段格式转换
🔌
IoT设备集成

物联网设备的集成原理。

  • 基于多协议适配实现设备数据全场景捕获
  • 开发人员负责全协议层对接、数据解析

❓ 常见问题解答

快速解决您的疑问

如何快速上手简道云?

建议从新手入门课程开始,掌握基础的表单设计和流程配置,然后通过实际业务场景练习,逐步提升到高级功能的应用。

如何设计高效的业务流程?

首先梳理业务需求,明确流程节点和审批角色,然后在简道云中配置对应的表单和流程规则,最后进行测试和优化。

如何实现系统间的数据同步?

可以通过简道云的API接口实现与其他系统的数据同步,也可以使用集简云等第三方集成平台进行无代码集成。