SpringBoot集成E签宝合同签署服务

背景

因为业务需要和购买课程的学员签署合同，因而需要引入E签宝进行合同签署。

官方指南

根据官方指南，主要的接入流程分为生成合同和发起签署。但个人认为应该分成创建合同模板，生成合同，发起合同签署三步。这里的生成合同和发起签署应该都归属于发起签署。

一、身份认证

请求头格式说明文档
在业务接入之前，需要先接入签名。这个官网就有例子，直接使用推荐的方式即可。

具体怎么生成签名也有详细的指南，跟着操作即可。甚至有代码例子可以直接使用。
签名生成文档

二、创建签署模板

登录E签宝模板管理后台

• 创建模板
  

• 上传签署底文件，也就是没填充关键参数的文件，签署方需要有一个是固定填充的（一般是自己公司），另一方作为签署方
  

• 设置内容填充框。后台会解析pdf文件作为底文件，可以在上面增加内容填充框。如左上角是我们填充的，可以通过右下角的编码来定位哪一个框，左侧第二个框是签署方签署的时候填充他们的信息的。
  

• 回到模板管理，开启模板，并复制模板编号。后续可以根据模板编号来确定使用哪一个模板，然后传递所需要的合同参数【上一步的框】即可生成合同签署链接给签署方签署。

三、发起签署

2.1、通过签署模板创建签署文件

有两个版本生成签署文件的接口，以前的采用的是V1旧版本的，后面新开发的业务采用了V3新版本，初次接入建议使用V3新版本。

1.通过模板创建文件文档V1

• 通过传入模板id和所需的模板参数去生成合同签署文件，可以查看文件，后续签署根据返回的fieldId确定签署文件
  
  

2.通过签署模板创建签署文件V3

• 和V1差不多，不过参数通过数组的方式传递，可以更加清楚是控件id还是控件key
  
  

2.2、通过签署文件发起签署

1.直接签署

利用上一步生成的fieldId可以直接生成合同，该方式是系统直接生成签署合同，不会发短信，也不需要人脸认证。

2.人脸识别实名签署

调用该接口，传入前面生成的签署文件fieldId发起签署，E签宝会给用户发送签署短信。

设置回调地址，判断签署方签署情况，设置通知类型，一般使用短信通知，也就是1

记得填写签署方手机号，如果对方是个人。

调用成功会返回一个流程id，记得保存，如果签署方没有收到短信，就需要根据流程id去重新发送短信获取直接查询获取签署链接。

用户通过短信链接跳转E签宝进行人脸识别签署合同。签署完成E签宝回调通知。