云合同電子合同產品企業API對接實戰操作指南

一、產品概述

云合同電子合同（yunhetong.com）產品 API4.0 是云合同平臺推出的最新的電子合同服務對接解決方案。云合同是一家第三方電子合同服務平臺，圍繞電子合同生態鏈：證書申請、合同生成、合同流轉、合同簽署、合同存證、滿足監管為核心建立起的產品線，為廣大用戶提供一站式安全、有效、便捷、優質的電子合同服務。

云合同 API 囊括證書模塊、用戶模塊、印章模塊、合同模塊等四大核心基礎功能模塊，以接口集成+頁面集成兩種方式為開發者提供應用間完美的解決方案，云合同

API4.0 將電子合同服務內嵌至開發者的后臺系統中，從而在業務平臺上實現電子合同功能。

集成云合同 API4.0 后的應用可享受由云合同提供的第三方電子簽名、電子合同服務，用戶無需下載、注冊、實名認證多個應用，并與原有業務流程完美契合。接入云合同電子合同服務，有助于合同的簽署與管理，降低成本，提高競爭力。

二、產品功能

云合同 API 共包括四大模塊的核心功能，分別是證書模塊、用戶模塊、印章模塊和合同模塊。

1、證書模塊

API4.0 基于行業對于電子簽名數據固化的通用做法，提供了用 CA 證書固化電子簽名數據的方式，同時提供了多 CA 通道，支持平臺方根據業務場景選擇對應的 CA 通

道、以及證書的類型，證書根據使用時間長短分為長效證書、場景證書。

2、用戶模塊

用戶注冊：云合同 API 同步平臺應用用戶體系，確保用戶一一對應，同時備份用戶實名信息，確認用戶主體身份，并為對應用戶申請 CA 證書。

信息修改：當用戶信息發生變更時，云合同支持用戶基礎信息的修改，并自動更新證書信息。

3、印章模塊

模版印章：云合同 API 提供根據用戶姓名，自動生成印章。

自定義印章：云合同 API 提供自定義印章功能，平臺方可自定義印章樣式并上傳使用。同時，用戶可通過云合同提供的手繪頁面實現在 PC 端、移動端采集用戶手寫簽名，所有簽名數據由云合同存儲并為安全負責。

個人模版印章支持樣式：

企業模版印章支持樣式：

合同生成：云合同 API 支持兩種合同生成方式，即“根據模版生成合同”和

“上傳文件生成合同”。平臺只需將合同關鍵信息以數據形式傳輸給云合同， 云合同會調用約定好的模板生成合同并返回供用戶查看。

合同簽署：云合同 API 支持兩種合同簽署方式，即“合同簽署”和“頁面簽署”。平臺用戶可選擇主動簽署，亦可將簽署權限授權給云合同，由云合同代為完成，云合同 API 將自動調用簽署者的簽名并完成合同簽署。

合同查看：云合同 API 支持用戶在線查看合同。

合同模板：平臺可以自己上傳相應的合同模板。方便快捷高效的創建合同。

合同下載：平臺可以下載帶簽名的 pdf 文件保存流轉。

三、項目對接整體流程圖

1、對接流程

項目對接整體流程如下圖所示。平臺應用在上線前需聯系對應技術支持人員進行

“應用清庫”操作。

1) 注冊云合同賬號：平臺方需登錄云合同官網（https://www.yunhetong.com），注冊一個企業賬號并完成實名認證后，聯系對接人員協助進行開戶。

2) 創建平臺應用：開發者可登錄云合同開放平臺（http://open.yunhetong.com/）創建應用（測試階段請創建測試應用，項目正式請創建正式應用），并記錄應用信息， 為后續對接工作開展做好準備工作。

3) 獲取對接資料：云合同現階段以 API 對接的方式，向平臺提供的電子合同功能。具體接口內容，請查看本指南“第五章 API 接口文檔”。

4) 梳理電子合同業務流程：開發者在閱讀完《云合同 API 接口文檔》之后，根據接口邏輯，梳理平臺現有業務流程，并在業務關鍵節點接入對應接口，即可在現有業務流程上實現電子合同功能，可參考“第四章 接口調用流程“。

5) 接口對接：在此步正式開展對接工作。如在對接中遇到問題，可以聯系技術對接人員協助解決。

6) 準備上線：項目在上線前，需聯系對接人員進行項目上線確認。此時，對接人員會協助進行“應用清庫”操作，并清理應用中的測試數據（包括測試用戶數據以及測試合同數據）。

7) 應用上線：應用正式上線。

2、官網注冊流程

四、接口調用流程

以下展示幾個典型應用場景的接口調用流程，各項業務服務可靈活調用，具體接口調用以貴平臺的業務設計為主。

1、接口調用流程——基礎場景

2、接口調用流程——合同存證場景

3、接口調用流程——頁面簽署場景

4、接口調用流程——接口意愿認證場景

5、小結

圖中序號為標準電子合同業務操作流程，灰色框為云合同提供的 API 服務。整個電子合同業務流程分為兩個階段：初始化階段、合同簽署階段。用戶僅在第一次使用平臺電子合同服務時需做一次初始化，后續可以直接從合同簽署階段開始業務。

關鍵流程節點說明如下：

1) 配置合同模版：平臺需預先登錄云合同開放平臺，并在應用里上傳合同模版，同時配置好“簽名占位符”（即簽署位置）。

2) 實名認證：云合同 API 服務完全信任平臺對平臺用戶的實名認證結果，在平臺用戶完成實名認證后，可為對應平臺用戶申請 CA 證書。同時，云合同可單獨提供實名認證增值服務。

3) 生成待簽署合同：在確認所有簽署者身份后，平臺方可調用“根據模版生成合同”或“上傳文件生成合同”接口生成待簽署合同，并調用“添加參與者”接口為該合同添加簽署者并約定簽署位置、是否采用意愿認證。

4) 簽署合同：即可在合同上加蓋平臺的印章，云合同提供“頁面簽署”和“合同簽署”兩種簽署方式。

5) 查看合同：在線查看合同，平臺可調用“合同查看”js 方法獲取合同的查看 url， 也可以調用“合同下載”接口，自己制作合同查看頁面。

一、產品概述

云合同電子合同（yunhetong.com）產品 API4.0 是云合同平臺推出的最新的電子合同服務對接解決方案。云合同是一家第三方電子合同服務平臺，圍繞電子合同生態鏈：證書申請、合同生成、合同流轉、合同簽署、合同存證、滿足監管為核心建立起的產品線，為廣大用戶提供一站式安全、有效、便捷、優質的電子合同服務。

云合同 API 囊括證書模塊、用戶模塊、印章模塊、合同模塊等四大核心基礎功能模塊，以接口集成+頁面集成兩種方式為開發者提供應用間完美的解決方案，云合同

API4.0 將電子合同服務內嵌至開發者的后臺系統中，從而在業務平臺上實現電子合同功能。

集成云合同 API4.0 后的應用可享受由云合同提供的第三方電子簽名、電子合同服務，用戶無需下載、注冊、實名認證多個應用，并與原有業務流程完美契合。接入云合同電子合同服務，有助于合同的簽署與管理，降低成本，提高競爭力。

二、產品功能

云合同 API 共包括四大模塊的核心功能，分別是證書模塊、用戶模塊、印章模塊和合同模塊。

1、證書模塊

API4.0 基于行業對于電子簽名數據固化的通用做法，提供了用 CA 證書固化電子簽名數據的方式，同時提供了多 CA 通道，支持平臺方根據業務場景選擇對應的 CA 通

道、以及證書的類型，證書根據使用時間長短分為長效證書、場景證書。

2、用戶模塊

用戶注冊：云合同 API 同步平臺應用用戶體系，確保用戶一一對應，同時備份用戶實名信息，確認用戶主體身份，并為對應用戶申請 CA 證書。

信息修改：當用戶信息發生變更時，云合同支持用戶基礎信息的修改，并自動更新證書信息。

3、印章模塊

模版印章：云合同 API 提供根據用戶姓名，自動生成印章。

自定義印章：云合同 API 提供自定義印章功能，平臺方可自定義印章樣式并上傳使用。同時，用戶可通過云合同提供的手繪頁面實現在 PC 端、移動端采集用戶手寫簽名，所有簽名數據由云合同存儲并為安全負責。

個人模版印章支持樣式：

企業模版印章支持樣式：

合同生成：云合同 API 支持兩種合同生成方式，即“根據模版生成合同”和

“上傳文件生成合同”。平臺只需將合同關鍵信息以數據形式傳輸給云合同， 云合同會調用約定好的模板生成合同并返回供用戶查看。

合同簽署：云合同 API 支持兩種合同簽署方式，即“合同簽署”和“頁面簽署”。平臺用戶可選擇主動簽署，亦可將簽署權限授權給云合同，由云合同代為完成，云合同 API 將自動調用簽署者的簽名并完成合同簽署。

合同查看：云合同 API 支持用戶在線查看合同。

合同模板：平臺可以自己上傳相應的合同模板。方便快捷高效的創建合同。

合同下載：平臺可以下載帶簽名的 pdf 文件保存流轉。

三、項目對接整體流程圖

1、對接流程

項目對接整體流程如下圖所示。平臺應用在上線前需聯系對應技術支持人員進行

“應用清庫”操作。

1) 注冊云合同賬號：平臺方需登錄云合同官網（https://www.yunhetong.com），注冊一個企業賬號并完成實名認證后，聯系對接人員協助進行開戶。

2) 創建平臺應用：開發者可登錄云合同開放平臺（http://open.yunhetong.com/）創建應用（測試階段請創建測試應用，項目正式請創建正式應用），并記錄應用信息， 為后續對接工作開展做好準備工作。

3) 獲取對接資料：云合同現階段以 API 對接的方式，向平臺提供的電子合同功能。具體接口內容，請查看本指南“第五章 API 接口文檔”。

4) 梳理電子合同業務流程：開發者在閱讀完《云合同 API 接口文檔》之后，根據接口邏輯，梳理平臺現有業務流程，并在業務關鍵節點接入對應接口，即可在現有業務流程上實現電子合同功能，可參考“第四章 接口調用流程“。

5) 接口對接：在此步正式開展對接工作。如在對接中遇到問題，可以聯系技術對接人員協助解決。

6) 準備上線：項目在上線前，需聯系對接人員進行項目上線確認。此時，對接人員會協助進行“應用清庫”操作，并清理應用中的測試數據（包括測試用戶數據以及測試合同數據）。

7) 應用上線：應用正式上線。

2、官網注冊流程

四、接口調用流程

以下展示幾個典型應用場景的接口調用流程，各項業務服務可靈活調用，具體接口調用以貴平臺的業務設計為主。

1、接口調用流程——基礎場景

2、接口調用流程——合同存證場景

3、接口調用流程——頁面簽署場景

4、接口調用流程——接口意愿認證場景

5、小結

圖中序號為標準電子合同業務操作流程，灰色框為云合同提供的 API 服務。整個電子合同業務流程分為兩個階段：初始化階段、合同簽署階段。用戶僅在第一次使用平臺電子合同服務時需做一次初始化，后續可以直接從合同簽署階段開始業務。

關鍵流程節點說明如下：

1) 配置合同模版：平臺需預先登錄云合同開放平臺，并在應用里上傳合同模版，同時配置好“簽名占位符”（即簽署位置）。

2) 實名認證：云合同 API 服務完全信任平臺對平臺用戶的實名認證結果，在平臺用戶完成實名認證后，可為對應平臺用戶申請 CA 證書。同時，云合同可單獨提供實名認證增值服務。

3) 生成待簽署合同：在確認所有簽署者身份后，平臺方可調用“根據模版生成合同”或“上傳文件生成合同”接口生成待簽署合同，并調用“添加參與者”接口為該合同添加簽署者并約定簽署位置、是否采用意愿認證。

4) 簽署合同：即可在合同上加蓋平臺的印章，云合同提供“頁面簽署”和“合同簽署”兩種簽署方式。

5) 查看合同：在線查看合同，平臺可調用“合同查看”js 方法獲取合同的查看 url， 也可以調用“合同下載”接口，自己制作合同查看頁面。

華為云APP

版權聲明：本文內容由網絡用戶投稿，版權歸原作者所有，本站不擁有其著作權，亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容，請聯系我們jiasou666@gmail.com 處理，核實后本網站將在24小時內刪除侵權內容。

版權聲明：本文內容由網絡用戶投稿，版權歸原作者所有，本站不擁有其著作權，亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容，請聯系我們jiasou666@gmail.com 處理，核實后本網站將在24小時內刪除侵權內容。