简介

最近更新时间:2019-07-04 17:14:44

电子合同服务 API 升级到 3.0 版本。全新的 API 接口文档更加规范和全面,统一的参数风格和公共错误码,统一的 SDK/CLI 版本与 API 文档严格一致,给您带来简单快捷的使用体验。支持全地域就近接入让您更快连接腾讯云产品。

电子合同(Digital Contract)是腾讯云联合合作伙伴依照电子签名法、行业监管合规要求等,采用RSA、ECC、国密等标准签名算法,提供的包括合同签约、合同管理、取证、公证、法律咨询等在内的一站式电子合同服务解决方案,以降低业务的合同签署、管理、存储等合同管理成本,有效解决互联网协议签署的难题。

API使用流程

说明

下面对电子合同API使用流程和一些常见问题进行介绍。在开通电子合同服务之后,后续的大致流程分为以下步骤:

  1. 创建账户
  2. 添加签章
  3. 创建合同
  4. 签署合同
  5. 下载合同

下面对各步骤进行详细介绍。

创建账户

创建账户按照账户类型分为企业开户(CreateEnterpriseAccount)和个人开户(CreatePersonalAccount)。

首先得创建一个属于自己的企业账户,用于创建合同时添加自己的签署信息,一般情况下在开通服务过程中会自动产生一个企业账户;然后针对自己的用户添加相关的账户信息,一般是个人账户。

对于不需要的账户可以通过调用删除帐号(DeleteAccount)接口来进行管理。

注意:应始终保证有一个属于自己的企业账户存在,否则在一些接口的调用中可能会出问题。

添加签章

签章与账户关联,用于签署步骤时使用,即最后在合同上签署区域盖章或者签名图片。用户通过新增签章(CreateSeal)接口添加签章,申请完签章之后,用户应自行保管签章id。可通过删除签章(DeleteSeal)来对之前不用的签章进行管理。

注意:每个账户限制只能有三个签章,已有三个签章时再次调用新增签章接口会报错。

创建合同

用户根据自身业务需求产生的一份pdf格式的合同,利用通过上传创建合同(CreateContractByUpload)接口上传该文件。该接口为异步接口,调用之后返回一个任务id,通过轮询获取任务状态(DescribeTaskStatus)接口来查询任务状态。任务执行成功,会返回一个合同id,用户需保存该合同id,用于后续的签署步骤。

签署合同

验证

在签署合同之前,需要发送验证码(SendVcode)和检测验证码(CheckVcode)。

签署

验证流程结束后,可通过两个接口进行签署,按坐标签署合同(SignContractByCoordinate)和按关键字签署合同(SignContractByKeyword)。

无论哪个接口,都涉及到坐标的取值问题。坐标原点为页面左下角,单位为磅,1mm≈2.83磅,一般A4纸的尺寸是210mm297mm,通过换算,即可得出相关坐标。

按关键字签署中的坐标是以关键字的字符中心为原点,按提供的坐标确定签名域的范围。

下载合同

在签署完成之后,可以利用下载合同(DownloadContract)接口来下载已签署完成的合同。该接口为异步接口,会返回一个任务id,通过轮询获取任务状态(DescribeTaskStatus)接口来查询任务状态,任务执行成功后会返回合同下载地址,用户利用该地址下载合同文件。