雲合同電子合同產品

API 對接指南

V4.3.2

 

浙江律訊網路科技有限公司

 

一、產品概述

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

雲合同 API 囊括證書模組、使用者模組、印章模組、合同模組等四大核心基礎功能模組，以介面整合+頁面整合兩種方式為開發者提供應用間完美的解決方案，雲合同

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

整合雲合同 API4.0 後的應用可享受由雲合同提供的第三方電子簽名、電子合同服務，使用者無需下載、註冊、實名認證多個應用，並與原有業務流程完美契合。接入雲合同電子合同服務，有助於合同的簽署與管理，降低成本，提高競爭力。

二、產品功能

雲合同 API 共包括四大模組的核心功能，分別是證書模組、使用者模組、印章模組和合同模組。

1、證書模組

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

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

 

2、使用者模組

 使用者註冊：雲合同 API 同步平臺應用使用者體系，確保使用者一一對應，同時備份使用者實名資訊，確認使用者主體身份，併為對應使用者申請 CA 證書。

 資訊修改：當用戶資訊發生變更時，雲合同支援使用者基礎資訊的修改，並自動更新證書資訊。

3、印章模組

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

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

個人模版印章支援樣式：

 

字型樣式

示例

 

楷體

 

 

 

華文仿宋

 

 

 

華文楷體

 

 

 

微軟雅黑

 

 

企業模版印章支援樣式：

 

樣式編碼

示例

 

 

常規圓章

 

 

 

橢圓章

 

4、合同模組

 合同生成：雲合同 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， 也可以呼叫“合同下載”介面，自己製作合同檢視頁面。