次数版-文件上传签署场景 - 简道云

1. 简介

1.1 场景简介

文件上传签署指的是通过上传已有的合同文件，从而发起合同签署流程，实现对合同的在线签署。支持自动更新签署状态，自动下载签署文件，支持多格式上传，支持单方、双方、多方签署。

1.2 应用场景

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

1.3 预期效果

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

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

1.4 使用说明

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

授权认证
文件签署
模板签署
下载文件
获取模板
弹窗编辑模板
查询模板控件
撤销签署
获取合同链接

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

2.插件安装

2.1 安装插件

1）直接安装

您可点击右方链接直接安装插件：e签宝次数版插件。
安装成功后，可参考本文【2.2 配置插件】和【2.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等格式；上传的文件大小不超过 50 MB。
	抄送类型	下拉框	非必填，下拉框选项短信邮件合同签署完成后，如填写抄送信息，可通过短信或邮件方式通知抄送接收人。
	抄送通知	单行文本	非必填，当抄送类型为短信，则填手机号；当抄送类型为邮件，则填写邮箱地址。
发起方签署信息	签署人类型	下拉框	必填，下拉框选项：个人企业/机构
	签署单位	单行文本	必填，类型为个人，签署单位填姓名，企业/机构填公司全称。
	签署手机	单行文本	必填。
	落章关键字	单行文本	必填，若有多个落章关键字，用英文格式下的逗号（“,”）隔开。
	指定印章	单行文本	非必填，如需指定印章签章，需填写「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。

3.3 撤销签署流程表单

新建「撤销签署」流程表单，用于撤销签署中的合同：

字段名称	字段类型	字段设置
撤销合同签署主题	单行文本	——
撤销合同签署 ID		在「字段属性 >> 默认值」处设置为「数据联动」，联动设置如下：联动表单：发起合同签署表单联动表单字段满足条件：签署主题等于撤销合同主题触发以下联动：撤销合同签署ID联动显示签署 ID 注：此项可手动填写，手动填写时无需【撤销合同签署主题】字段
撤销原因		——
撤销结果		——

4. 前端事件配置

4.1 授权认证

4.1.1 添加前端事件

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

4.1.2 设置事件名称和说明

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

4.1.3 设置触发动作

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

4.1.4 设置执行动作

设置执行动作如下：

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

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

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

4.2 重新获取合同链接

4.2.1 添加按钮执行动作

进入「e签宝合同签署次数版-文件上传」表单中，点击「重新获取合同链接」按钮字段，在「字段属性 >> 执行动作」处，点击「添加执行动作」

4.2.2 设置事件名称和说明

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

4.2.3 设置执行动作

设置执行动作如下：

选择插件：选择「 e 签宝次数版 >> 获取合同链接」；
签署ID：设置为字段值，即「签署ID」字段；
字段存储关系：点击「添加」按钮并选择添加「全部」，将「合同链接」的值存储到「合同链接」中。

全部设置完成后，点击保存。

5. 智能助手配置

5.1 新建智能助手Pro

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

5.2 配置HTTP触发动作

1）复制 HTTP 触发动作中的触发地址，复制触发地址至触发数据列表中的触发地址中，等待触发结果为「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.1.1 配置流程发起节点

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

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

6.1.2 配置合同审批节点

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

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

6.1.3 配置插件节点

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

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

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

6.1.4 启用流程

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

6.2 撤销合同流程配置

进入「撤销签署」流程表单中，切换至「流程设定」处，进行流程配置。

6.2.1 配置合同撤销发起节点

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

在「节点属性 >> 节点名称」处，修改节点名称为「撤销合同发起」；
在「节点属性 >> 字段权限」处，勾选以下 4 个字段字段的「可见」、「可编辑」权限：

「撤销合同签署」
「撤销合同主题」
「撤销合同签署ID」
「撤销原因」

6.2.2 配置审批节点

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

在「节点名称」处，修改节点名称为「撤销合同审批」；
在「节点负责人」处，选择审批负责人；
在「字段权限」处，勾选以下 3 个字段以外的字段「可见」权限：

「撤销合同签署」
「撤销合同主题」
「撤销原因」

6.2.3 配置插件节点

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

选择插件：选择「e 签宝次数版 >> 撤销签署」；
签署ID：设置为字段值，即「撤销合同签署ID」字段；
撤销原因：设置为字段值，即「撤销原因」字段。
点击「添加」按钮，将「撤销结果」的值存储到「撤销结果」中。

全部设置完成后，点击「确定」按钮。

6.2.4 启用流程

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

6.3 效果演示

效果参见【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）根据业务需求选择子表签署或主表签署，两种配置公式有些许差别。

7.4 签署状态说明

1）原「合同文件 >> 签署状态」字段中，返回的是签署流程的状态，经实际使用和用户反馈，已做迭代，目前版本返回签署人状态，如为多方签署，回传多个签署人状态。

2）签署状态字段无需重新配置，仅返回值有变化，已安装使用用户无需更改配置，新安装用户按本文本说明配置即可。

8. 联系方式

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

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