电子签名 SaaS API 非标版 产品介绍

更新时间:2021/09/27 03:51:51

产品介绍

电子签名 SaaS API 非标版是e签宝提供的一种电子签名开放服务能力。

企业开发者在自己的业务系统中可以通过调用电子签名服务 SaaS API 非标版所提供的接口实现在电子文件中签名。

快速理解参考下图:

产品特点

  • 电子签名服务 SaaS API 非标版默认不做强制实名认证,允许企业开发者单独对接e签宝实名认证服务进行组合使用;但也可支持实名认证。
  • 电子签名服务 SaaS API 非标版默认对签署后文件进行存证,出证的时候E签宝可以提供签署的文件、账户对应的数字证书;如果您同时对接E签宝的实名认证产品或者开启了强制实名,那么出证的时候也可以同时出具实名认证相关信息;
  • 电子签名服务 SaaS API 非标版签署和意愿认证页面由E签宝提供,企业开发者可以减少开发工作量;
  • 电子签名服务 SaaS API 非标版支持多个端的签署,包括H5、WEB、APP、支付宝小程序、微信小程序以及钉钉微应用。无论在手机上、PC上还是平板上都可轻松完成签署,最大程度提高文档签署效率


适用场景

  • 支持在通过移动端、H5、PC端、微信公众号/小程序中进行文件在线签署;
  • 企业开发者希望集成E签宝的签署和意愿认证页面


名称解释

签署流程:整个签署过程中,所有的签署行为都要归属于同一个签署流程,签署流程中跟进不同状态的流转完成全部的签署行为

签署文档:待签署的文档,可以是合同、各种文书以及证明材料

签署区:一个签署区是一个签署盖章区域位置,包含印章的位置、文档、盖章主体人、印章图片等属性

流程参与人:流程参与人是指参与流程的查看和管理工作的人,可以是抄送人或管理员,不包含需要具体执行签署的人

签署人:真正执行签署的人员

文档模板:用于生成签署文档的模板,通过内容字段填充,可以批量生成待签署文档

用印审批:指企业用印时,当经办人没有用印权限时会开启审批流程,审批流程同意后自动完成签署

流程归档:指签署流程完成后,对流程进行关闭和存档的操作,存档后流程不可修改

平台自动盖章:平台指在e签宝官网注册企业账号并完成企业实名且直接开通/对接e签宝各服务接口的企业账户。平台自动盖章是指平台方的章自动的盖上去,无需人工手动操作。

签署方自动盖章:签署方指平台方自己的个人客户或企业客户。签署方自动盖章是指个人客户和企业客户的章自动盖上去,无需签署方本人的操作;注意这种签署方式因没有体现签署方本人的意愿,签署文件的法律风险较大,建议线下签署签署方授权平台方通过接口操作自动盖章的协议

静默签署:用户可全程无感完成本次签署

签署人签署完成回调:一个签署流程中,有多个签署任务,其中一个签署任务完成就会触发签署人签署完成回调

流程结束回调:整个签署流程的状态不能再继续进行了,触发流程结束回调通知

骑缝章:顾名思义,就是盖章时圧到文件边缝,对于一些重要文件,为了防止文件打印出来后缺页、加页情况发生,可以加盖骑缝章;如下图

(该图片为网络图片,侵权删)

接入方式

电子签名服务 SaaS API 非标版服务提供一组Web API接口,企业开发者可以通过HTTP方式调用接口进行电子签名

业务流程

1、签署人实名认证(可选)

企业开发者对签署人身份进行认证时可以单独调用e签宝的实名认证服务,也可以采用其他第三方身份认证服务。

如果使用e签宝-身份认证服务则需要企业开发者妥善保存身份认证后接口返回的结果,以便日后查询签署人身份认证详情。

如果使用其他第三方身份认证服务则需要企业开发者妥善保存身份认证的过程信息,以便日后举证时提供相关信息。

开发者在对接过程中,需注意:

电子签名服务 SaaS API 非标版的接口API中,创建签署账号时,只校验证件信息的格式是否正确,不会对姓名和证件信息的真实性做校验。

如果签署账号不通过e签宝的认证服务进行实名认证,其签署方的账号真实性需要由开发者来进行保证,出证时,e签宝不会提供关于签署方账号真实性的证据报告。


2、创建签署账户

      企业开发者获取到签署人的真实身份信息(名称和证件号)后可以通过调用电子签名服务 SaaS API 非标版中的【签署方账户API】为个人客户或企业客户代为申请CA数字证书,签署账号创建成功时返回AccountId(签署账号标识)。

      创建账号成功之后系统后自动为您生成一个默认印章。

开发者在对接过程中,需注意:

开发者可以将签署账号标识AccountId在本地进行保存,日后该签署人再次进行文件签署时就不需要重新创建签署账号,可以直接使用已获取的AccountId签署文件。

      

3、创建印章

      企业开发者获取到签署人的签署账户标识AccountId后可以调用电子签名服务 SaaS API 非标版中的【创建印章接口为个人或企业客户生成印章图片,模板印章创建时返回印章数据sealId

      支持根据图片base64生成印章。

开发者在对接过程中,需注意:

开发者可以将印章数据sealId在本地进行保存,日后该签署人再次进行文件签署时就不需要重新创建印章图片,可以直接使用已获取的印章数据sealId签署文件。

4、生成待签署PDF文件

e签宝提供了三种方式生成待签署文件,如下:

方式一:通过上传方式生成待签署文件:

  1. 获取文件上传地址】接口先获取上传文档链接uploadUrl和文件fileId(fileId请妥善保存,注意文件上传成功之后fileId才可使用);
  2. 文件流上传方法】把文件以文件流的方式上传;


方式二:通过上传方式创建一个模板,然后根据模板创建待签署文件:

  1. 获取模板文件上传地址】接口先获取上传模板文档链接和模板templateId(templatedId请妥善保存,注意模板文件上传成功之后templatedId才可使用);
  2. 文件流上传方法】把模板文件以文件流的方式上传;
  1. 添加填写控件】接口可添加文本域等填充域;
  2. 查询模板详情】接口可查询到该模板文档设置的所有的文本域的key或者id,方便后续填充文本域
  1. 填充内容生成PDF】接口可根据模板templatedId生成文件,并得到文件预览、下载地址和文件fileId


方式三:在E签宝官网中获取模板id,通过模板创建文件生成待签署文件:

填充内容生成PDF】接口可根据模板templatedId生成文件,并得到文件预览、下载地址和文件fileId


5、一步发起签署(步骤5和6选择其中一种方式对接)

调用【一步发起签署】接口,设置签署文件,签署附件,签署区设置等信息

6、分步发起签署(步骤5和6选择其中一种方式对接

6.1 创建签署流程

签署流程创建】接口创建一个签署流程,该接口可配置后续接收流程状态变化异步通知的地址、配置签署的通知方式,支持短信和邮件(这里要注意下,这里通知的短信和邮件是通知到创建账号时填写的手机号或者邮箱里面),接口调用成功会返回签署流程flowId,请妥善保存。

6.2 签署流程关联待签署PDF文件

流程文档添加】接口会把签署文件和签署流程关联起来,注意如果签署流程没有关联文档,是无法进行后续接口调用的。

6.3 设置签署区

可设置三种签署区:

(1)平台自动签署区

平台自动盖章默认签署人是对接的企业,盖章的印章id必须在E签宝官网获取,沙箱环境获取印章id方式:沙箱服务-沙箱账号-印章管理; 正式环境在管理后台:用户中心-印章管理,进行配置。签署区创建完成,流程开启后,系统将自动完成“对接平台自动盖章签署区”的盖章,对接平台可全程无感完成本次签署。

(2)签署方自动盖章签署区

添加此类签署区之前,要盖章的账号需先完成账号静默签署

签署区创建完成,流程开启后,系统将自动完成“用户自动盖章签署区”的盖章。用户可全程无感完成本次签署

(3)签署方手动盖章签署区

手动盖章签署区只针对签署方去添加,平台自身签署只能通过平台自动签署区去添加。手动签署过程中,签署主体是个人时,支持手绘和模板印章两种印章方式去落章;签署主体是企业时,只支持模板印章实现落章。

6.4 开启签署流程

签署流程开启】接口调用成功后,签署任务会自动按照签署区的设置开始流转;签署流程上,每次签署任务完成时,则会触发【签署人签署完成回调通知】。

7、签署人签署,做意愿认证

意愿认证是用户在访问E签宝的签署链接的时候,做完印章预提交之后的一次认证;

合法的电子签名要求有实名认证,意愿认证,签名未改和原文未改,意愿认证是四要素之一意愿认证是代表客户本人知情并愿意签署。


8、签署流程归档

签署流程归档】接口调用成功之后,整个签署流程变成完成状态,触发【流程结束回调通知】。

9、PDF验签

必要性:

1、在文件签署后调用这个接口验签一下,如果验签失败可以说明签署文件异常需要重新签署;

2、客户移动签署后文件后调用这个接口验签一下,如果验签失败可以说明文件移动后出现破损;

3、文件签署后调用这个接口验签一下,可以供客户自己判断文件中指定的签署人和实际签署人的数字证书是否一致;