科技背景
📚 簡道雲知識庫

簡道雲 知識庫

全方位學習資源

一站式:從入門到精通的完整學習路徑

全覆蓋:涵蓋所有功能模組與整合場景

實戰導向:結合真實業務場景的教學案例

📚 學習資源 📖 實戰案例 🔧 技術文件 💡 經驗分享

📚 知識庫分類導航

快速定位您需要的學習資源

🔍 精選文章推薦

最受歡迎的學習資源

簡道雲許可權體系設計最佳實踐

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介面實現與其他系統的資料同步,也可以使用集簡雲等第三方整合平台進行無代碼整合。