云合同电子合同产品企业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小时内删除侵权内容。