产品介绍
电子签名 SaaS API 标准版是e签宝提供的一种电子签名开放服务能力。
企业开发者在自己的业务系统中可以通过调用电子签名 SaaS API 标准版产品所提供的接口实现在电子文件中签名。
快速理解参考下图:

产品特点
- 电子签名 SaaS API 标准版的实名、意愿、签署页面由e签宝提供,大大减少企业开发者的开发量;
- 电子签名 SaaS API 标准版默认对签署后文件进行存证,出证的时候e签宝可以提供签署的文件、账户对应的数字证书;
- 电子签名 SaaS API 标准版支持多个端的签署,包括H5、WEB、APP、支付宝小程序、微信小程序以及钉钉微应用。无论在手机上、PC上还是平板上都可轻松完成签署,最大程度提高文档签署效率
适用场景
- 支持在通过移动端、H5、PC端、微信公众号/小程序中进行文件在线签署;
- 企业开发者希望集成e签宝的签署、实名和意愿认证页面
名称解释
签署流程:整个签署过程中,所有的签署行为都要归属于同一个签署流程,签署流程中跟进不同状态的流转完成全部的签署行为
签署文档:待签署的文档,可以是合同、各种文书以及证明材料
签署区:一个签署区是一个签署盖章区域位置,包含印章的位置、文档、盖章主体人、印章图片等属性
流程参与人:流程参与人是指参与流程的查看和管理工作的人,可以是抄送人或管理员,不包含需要具体执行签署的人
签署人:真正执行签署的人员
文档模板:用于生成签署文档的模板,通过内容字段填充,可以批量生成待签署文档
用印审批:指企业用印时,当经办人没有用印权限时会开启审批流程,审批流程同意后自动完成签署
流程归档:指签署流程完成后,对流程进行关闭和存档的操作,存档后流程不可修改
平台自动盖章:平台指在e签宝官网注册企业账号并完成企业实名且直接开通/对接e签宝各服务接口的企业账户。平台自动盖章是指平台方的章自动的盖上去,无需人工手动操作。
签署人签署完成回调:一个签署流程中,有多个签署任务,其中一个签署任务完成就会触发签署人签署完成回调
流程结束回调:整个签署流程的状态不能再继续进行了,触发流程结束回调通知
骑缝章:顾名思义,就是将印章盖到文件边缝,对于一些重要文件,为了防止文件打印出来后缺页、加页情况发生,可以加盖骑缝章;如下图

(该图片为网络图片,侵权删)
接入方式
电子签名 SaaS API 标准版服务提供一组Web API接口,企业开发者可以通过HTTP方式调用接口进行电子签名。
业务流程
1、创建签署账户
企业开发者获取到签署人的真实身份信息(名称和证件号)后可以通过调用电子签名 SaaS API 标准版中的【签署方账户API】为个人客户或企业客户代为申请CA数字证书,签署账号创建成功时返回AccountId(签署账号标识)。
创建账号成功之后系统后自动为您生成一个默认印章。
开发者在对接过程中,需注意:
开发者可以将签署账号标识AccountId在本地进行保存,日后该签署人再次进行文件签署时就不需要重新创建签署账号,可以直接使用已获取的AccountId签署文件。
2、生成待签署PDF文件
e签宝提供了三种方式生成待签署文件,如下:
方式一:通过上传方式生成待签署文件:
方式二:通过上传方式创建一个模板,然后根据模板创建待签署文件:
- 【获取模板文件上传地址】接口先获取上传模板文档链接和模板templateId(templatedId请妥善保存,注意模板文件上传成功之后templatedId才可使用);
- 【文件流上传方法】把模板文件以文件流的方式上传;
- 【添加填写控件】接口可添加文本域等填充域;
- 【查询模板详情】接口可查询到该模板文档设置的所有的文本域的key或者id,方便后续填充文本域
- 【填充内容生成PDF】接口可根据模板templatedId生成文件,并得到文件预览、下载地址和文件fileId
方式三:在e签宝官网中获取模板id,通过模板创建文件生成待签署文件:
【填充内容生成PDF】接口可根据模板templatedId生成文件,并得到文件预览、下载地址和文件fileId
3、一步发起签署(步骤3和4选择其中一种方式对接)
调用【一步发起签署】接口,设置签署文件,签署附件,签署区等信息
4、分步发起签署(步骤3和4选择其中一种方式对接)
4.1 创建签署流程
【签署流程创建】接口创建一个签署流程,该接口可配置后续接收流程状态变化异步通知的地址、配置签署的通知方式,支持短信和邮件(这里要注意下,这里通知的短信和邮件是通知到创建账号时填写的手机号或者邮箱里面),接口调用成功会返回签署流程flowId,请妥善保存
4.2 签署流程关联待签署PDF文件
【流程文档添加】接口会把签署文件和签署流程关联起来,注意如果签署流程没有关联文档,是无法进行后续接口调用的
4.3 设置签署区
可设置两种签署区:
(1)平台方自动签署区
平台自动盖章默认签署人是对接的企业,盖章的印章id必须在e签宝官网获取,沙箱环境获取印章id方式:沙箱服务-沙箱账号-印章管理; 正式环境在管理后台:用户中心-印章管理,进行配置。签署区创建完成,流程开启后,系统将自动完成“对接平台自动盖章签署区”的盖章,对接平台可全程无感完成本次签署。
(2)签署方手动盖章签署区
手动盖章签署区只针对签署方去添加,平台自身签署只能通过平台自动签署区去添加。手动签署过程中,签署主体是个人时,支持手绘和模板印章两种印章方式去落章;签署主体是企业时,只支持模板印章实现落章。
4.4 开启签署流程
【签署流程开启】接口调用成功后,签署任务会自动按照签署区的设置开始流转;
签署流程上,每次签署任务完成时,则会触发【签署人签署完成回调通知】
5、签署人签署,做实名和意愿认证
实名和意愿认证是用户在访问e签宝的签署链接的时候,做完印章预提交之后的一次认证;
合法的电子签名要求有实名认证,意愿认证,签名未改和原文未改,意愿认证是四要素之一;意愿认证是代表客户本人知情并愿意签署
开发者在对接过程中,需注意:
如果当前签署区是企业经办人代企业主体进行手动盖章签署,会先校验该经办人是否有用印权限,如果具备用印权限即可签署成功;如果没有,则会通知企业有用印权限的人员,用印员审批通过后才能签署成功。
6、签署流程归档
【签署流程归档】接口调用成功之后,整个签署流程变成完成状态,触发【流程结束回调通知】
7、验签
必要性:
1、在文件签署后调用这个接口验签一下,如果验签失败可以说明签署文件异常需要重新签署;
2、客户移动签署后文件后调用这个接口验签一下,如果验签失败可以说明文件移动后出现破损;
3、文件签署后调用这个接口验签一下,可以供客户自己判断文件中指定的签署人和实际签署人的数字证书是否一致;