e签宝电子签章-次数版 - 简道云

1. 简介

1.1 插件简介

e 签宝电子插件可以实现通过发起合同签署流程，对合同进行在线签署。支持自动更新签署状态，自动下载签署文件，支持多格式上传，支持单方、双方、多方签署。

1.2 应用场景

适用于不同场景下的合同/文件签署。同时适用单方、双方和多方合同签署，如内部文件签署、劳动合同签署、检测报告盖章、采购合同、项目实施合同等。

1.3 预期效果

1）在授权认证中填写授权信息，进行授权认证并获取授权信息：

2）提交文件签署申请后，签署人将收到文件签署链接的短信通知，点击链接即可进行签署：

1.4 使用说明

1）该插件包含以下 3 种执行事件：

合同签署
授权认证
下载文件

2）e 签宝次数版为付费插件，每次调用插件进行签署消耗 1 个云币。在使用插件时自动扣除云币数量，当云币余额可支付的识别次数为 0 时，将无法使用 e 签宝电子签章-次数版插件。

2.插件安装

2.1 安装插件

1）直接安装

您可点击右方链接直接安装插件：e签宝次数版插件。
安装成功后，可参考本文【3.2 配置插件】和【3.3 启用插件】，前往「开放平台 >> 插件管理」处配置并启用插件。

2）插件市场处安装

在简道云「插件市场」处，安装「e 签宝次数版」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

2.2 配置插件

1）安装后，在「插件管理」处，点击插件右侧的「设置」按钮，将简道云的 API Key 配置进去。

2）在「密钥管理 >> API Key」处获取对应 API 。

2.3 启用插件

在插件管理中，打开 e 签宝次数插件右侧开关，启用插件。

3. 表单搭建

插件体验可点击右侧链接：e签宝电子签章次数版表单，插件使用可先安装：e签宝插件模板。本文将按照示例表单进行讲解。

3.1 企业授权表单

新建「授权认证」表，用于填写企业授权相关内容，字段设置如下所示：

字段说明	字段名称	字段类型	字段设置
企业信息	授权企业	单行文本	填写企业名称
企业信息	授权手机		填写授权手机
授权信息	授权ID		返回的授权信息
授权信息	授权链接		返回的授权信息
触发动作	触发聚合		不可见，设置为公式： CONCATENATE(授权企业，授权手机)

3.2 发起签署流程表单

1）新建「e签宝合同签署-次数版」流程表单，用于填写企业授权、合同信息和签署方信息等相关内容，字段设置如下所示：

字段说明	字段名称	字段类型	字段解释
发起方企业授权	企业名称	单行文本	必填，请先调用授权认证后，方可以自身企业作为发起方。
发起方企业授权	手机号码	单行文本	必填，填写授权企业手机号。
合同信息	合同编号	单行文本	非必填，公式编辑自动生成合同编号。公式为：CONCATENATE("HT",TEXT(SYSTIME(),"yyMMddHHmm"),RIGHT("000"+RECNO(),3))
	签署主题	单行文本	必填，合同签署的主题。
	签署文件	附件	必填，合同签署的文件，支持pdf，docx，doc，rtf，xlsx，xls，ppt，wps等格式。
	抄送类型	下拉框	非必填，下拉框选项短信邮件合同签署完成后，如填写抄送信息，可通过短信或邮件方式通知抄送接收人。
	抄送通知	单行文本	非必填，当抄送类型为短信，则填手机号；当抄送类型为邮件，则填写邮箱地址。
发起方签署信息	签署人类型	下拉框	必填，下拉框选项：个人企业/机构
	签署单位	单行文本	必填，类型为个人，签署单位填姓名，企业/机构填公司全称。
	签署手机	单行文本	必填。
	落章关键字	单行文本	必填，若有多个落章关键字，用英文格式下的逗号（“,”）隔开。
	指定印章	单行文本	非必填，如需指定印章签章，需填写「e签宝官网后台 >>用户中心 >>印章管理」中需要指定的印章编码，非授权企业不能进行指定。
	签署类型	下拉复选框	必填，下拉复选框选项：单页签章骑缝签章可全选，全选时同时签署单页签章和骑缝签章。
	签署顺序	单行文本	非必填，若不填或填写相同数字则默认同时签署，若填写数字则签署双方按数字顺序进行签署。
	聚合字段1	单行文本	选择公式编辑，公式为： CONCATENATE('{','"signerType":签署人类型'，',"Name":签署单位'，',"Account":签署手机'，',"assignedSealId":指定印章',',"keywords":落章关键字',',"signFieldStyle":签章类型',',"signOrder":签署顺序','}')
接收签署方信息	签署人类型	下拉框	必填，下拉框选项：个人企业/机构
	签署单位	单行文本	必填，类型为个人，签署单位填姓名，企业/机构填公司全称
	签署手机	单行文本	必填
	签署类型	下拉复选框	必填，下拉复选框选项：单页签章骑缝签章可全选，全选时同时签署单页签章和骑缝签章。
	落章关键字	单行文本	必填，若有多个落章关键字，用英文格式下的逗号（“,”）隔开。
	签署顺序		非必填，若不填或填写相同数字则默认同时签署，若填写数字则签署双方按数字顺序进行签署。
	聚合字段2		选择公式编辑，公式为： CONCATENATE('{','"signerType":签署人类型',',"Name":签署单位',',"Account":签署手机'，","keywords":落章关键字",","signFieldStyle":签章类型',',"signOrder":签署顺序','}')
合同文件	签署ID	单行文本	回填字段
	签署完成合同	附件
	签署状态	单行文本
	签署链接	多行文本
	签署信息聚合	多行文本	选择公式编辑，公式为： CONCATENATE(聚合字段1,CHAR(10),聚合字段2)

注：

1）调用 e签宝电子签章-次数版插件，必先进行企业授权认证后，方可以自身企业作为发起方进行合同签署；

2）指定印章可支持应用ID所属企业和授权企业指定，获取印章编号参考【7.注意事项】；

3）若为单方签署，只需配置一方签署信息，公式字段仅需传聚合字段1即可；

4）若为多方签署，可新增签署方信息，并新增聚合字段3，签署信息聚合中，公式新增为CONCATENATE(聚合字段1,CHAR(10),聚合字段2,CHAR(10),聚合字段3)。

2）表单搭建完成后，在「扩展功能 >> 数据推送」处，点击「设置字段别名」：

签署 ID：设置为 flow_id；
签署链接：设置为 contract；
签署状态：设置为 status。

4. 前端事件配置

4.1 添加前端事件

进入「授权认证」表单中，在「表单属性 >> 前端事件」处点击「设置」，添加前端事件：

4.2 设置事件名称和说明

添加好前端事件后，首先设置前端事件的基础信息，即事件名称和事件说明，用于区分前端事件：

4.3 设置触发动作

设置触发动作：触发字段选择「触发聚合」字段。

4.4 设置执行动作

设置执行动作如下：

选择插件：选择「E签宝次数版-授权认证」插件；
授权企业：设置为字段值，即「授权企业」字段；
授权手机：设置为字段值，即「授权手机」字段；
点击「添加」按钮，设置字段存储关系如下所示：

将「授权 ID」的值存储到「授权 ID」中；
将「授权链接」的值存储到「授权链接」中。

设置完成后，点击「保存」。

5. 智能助手配置

5.1 新建智能助手Pro

进入「e 签宝合同签署-次数版」流程表单中，在「扩展功能 >> 智能助手」处，点击「新增智能助手」，修改智能助手 Pro 的名称为「e 签宝合同签署」，并选择触发方式为 HTTP 触发：

5.2 配置HTTP触发动作

1）复制 HHTP 触发动作中的触发地址，复制触发地址至触发数据列表中的触发地址中，等待触发结果为「success」。

2）触发结果为「success」时，返回至 HTTP 触发动作配置中，在「触发数据列表」处点击「点击获取示例数据」。

3）获取到示例数据后，设置触发配置如下：

勾选指定可触发 IP：设置 IP 地址为 118.31.35.8；
勾选自定义返回内容：设置 JSON 示例代码为{"code":"200", "msg":"success"}

注：配置时，需先获取示例数据后再设置 IP 地址和自定义返回内容，否则可能会有获取示例数据不成功的情况。

5.3 配置插件节点

添加插件节点，进行如下设置：

插件读写表单：选择表单「e签宝合同签署-次数版」；
执行插件：选择「e签宝年费版 >>下载文件」；
应用 ID：选择组合字段，勾选「插件读写表单--应用ID(ID)」；
表单 ID：选择组合字段，勾选「插件读写表单--表单ID(ID)」；
签署 ID：选择组合字段，勾选「触发数据--body_signFlowld(文本)」；
执行结果：添加「签署状态」字段，选择「文本类型」。

5.4 配置修改数据节点

添加修改数据节点，进行如下操作：

修改对象：选择表单修改数据「e 签宝合同签署-次数版」；
筛选出要修改的数据：添加「签署 ID」,勾选「触发数据--body_signFlowld」字段；
设置字段值：添加「签署状态」，勾选「插件节点--签署状态」。

6. 流程设定

进入「e 签宝合同签署-次数版」流程表单中，切换至「流程设定」处，进行流程配置。

6.1 配置流程发起节点

点击流程发起节点，发起节点设置如下：

在「节点属性 >> 节点名称」处，修改节点名称为「签署发起节点」；
在「节点属性 >> 字段权限」处，勾选部分字段的「可见」、「可编辑」权限：

6.2 配置合同审批节点

点击审批节点，在「节点属性 >> 基础属性」中进行如下操作：

在「节点名称」处，修改节点名称为「合同审批」；
在「节点负责人」处，选择审批负责人；
在「字段权限」处，勾选部分字段的「可见」、「可编辑」权限。

6.3 配置插件节点

添加插件节点，在「节点属性 >> 插件」处，设置插件节点如下所示：

选择插件：选择「e 签宝次数版 >> 合同签署」；
发起方企业：设置为字段值，即「企业名称」字段；
发起方手机：设置为字段值，即「手机号码」字段；
签署主题：设置为字段值，即「签署主题」字段；
签署文件：设置为字段值，即「签署文件」字段；
签署人信息：设置为字段值，即「签署信息聚合」字段；
抄送类型：设置为字段值，即「抄送类型」字段；
抄送通知：设置为字段值，即「抄送通知」字段；
回调地址：设置为自定义，填写智能助手 Pro 中 HTTP 触发时获取到的触发地址，获取方式参考【5.2 配置 HTTP 触发动作】。
点击「添加」按钮，设置字段存储关系如下：

将「签署 ID」的值存储到「签署 ID」中；
将「签署链接」的值存储到「签署链接」中；
将「签署状态」的值存储到「签署状态」中。

6.4 启用流程

全部设置完成后，点击右上方「启用流程」，启用流程节点。

6.5 效果演示

效果参见【1.3 预期效果】。

7. 注意事项

7.1 获取印章编号

如在签署过程中需指定印章签署，则需获取印章编号。可在完成企业授权后登录 e签宝官网进行获取，获取步骤参见：e 签宝电子签章-年费版【2.6 获取印章编号】。

7.2 签署文件数量

上传签署文件时，仅支持上传一份文件签署，多传默认调取第一个文件签署。

7.3 子表单配置签署

若在签署过程中，需使用子表单进行合同签署，则子表单设置如下所示：

字段说明	字段名称	字段类型	字段解释
发起方信息	企业名称	单行文本	必填，当需要更换合同签署发起方企业时填写，如不填写默认应用ID说属主企业。
发起方信息	手机号码	单行文本	必填
合同信息	合同编号	单行文本	非必填，公式编辑自动生成合同编号。公式为：CONCATENATE("HT",TEXT(SYSTIME(),"yyMMddHHmm"),RIGHT("000"+RECNO(),3))
	签署主题	单行文本	必填，合同签署的主题。
	签署文件	附件	必填，合同签署的文件，支持pdf，docx，doc，rtf，xlsx，xls，ppt，wps等格式。
	抄送类型	下拉框	非必填，下拉框选项短信邮件合同签署完成后，如填写抄送信息，可通过短信或邮件方式通知抄送接收人。
	抄送通知	单行文本	非必填，当抄送类型为短信，则填手机号；当抄送类型为邮件，则填写邮箱地址。
签署人信息	签署人列表	子表单	——
	签署人类型	子表单-下拉框	必填，下拉框选项：个人企业/机构
	签署单位	子表单-单行文本	必填，类型为个人，签署单位填姓名，其他填公司全称。
	签署手机	子表单-单行文本	必填
	指定印章	子表单-单行文本	非必填，如需指定印章，需填写「e签宝后台 >>用户中心 >>印章管理」中需要指定的印章编码。非应用ID所属企业或授权企业，不支持指定印章。
	签章类型	子表单-下拉框	必填，下拉复选框选项：单页签章骑缝签章全选则两种签章类型同时签署。
	落章关键字	子表单-单行文本	必填，如有多个落章关键字，用英文格式下的逗号（“,”）隔开。
	人员聚合字段	子表单-单行文本	设置默认值为公式编辑，公式如下： CONCATENATE('{','"signerType":签署人列表,签署人类型',',"Name":签署人列表.签署单位',',"Account":签署人列表.签署手机',',"assignedSealId":签署人列表,指定印章',',"keywords":签署人列表,落章关键字',',"signfieldStyle":签署人列表,签章类型','}')
	签署人聚合	单行文本	设置默认值为公式编辑，公式如下： JOIN(签署人列表.人员聚合字段,CHAR(10))
合同文件	签署ID	单行文本	回填字段
	签署完成合同	附件
	签署状态	单行文本
	签署链接	单行文本

注：

1）子表签署顺序默认为签署列表顺序；

2）子表签署流程配置和智能助手 Pro 配置参考【5.智能助手配置】和【6. 流程设定】；

3）根据业务需求选择子表签署或主表签署，两种配置公式有些许差别。

8. 联系方式

该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：

公司：成都轻如燕企业服务有限公司
联系人：赵鹏
联系电话：18583980516（微信同号）