次数版-模板合同签署场景 - 简道云

1. 简介

1.1 场景简介

模板签署场景是指，通过创建和编辑通用的合同模板，将常用条款、格式等标准化后，可在需要签署时快速发起模板合同的签署流程，提高合同签署效率。

1.2 应用场景

适用于签订标准化的合同/文件。如企业内部员工入职、离职时的劳动合同签署时使用人力资源模板合同，企业与供应商、合作伙伴签订框架合作协议时使用通用的合作合同模板等等。

1.3 预期效果

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

2）在模板管理表单中，创建和编辑合同模板，并获取模板控件。如下所示：

3）填写合同及合同模板信息，并提交签署申请后，签署人将收到文件签署链接的短信通知，点击链接即可进行签署：

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 模板管理表单

新建模板管理表单，用于模板的创建、编辑和控件获取。字段设置如下所示：

字段说明	字段名称	字段类型	字段设置
模板信息	模板名称	单行文本	——
模板信息	模板文件	附件	支持上传如下所示格式的文件： docx、doc、rtf、xlsx、xls、ppt、wps 注：不支持 pdf 格式
模板编辑	——	多标签页	设置多标签页显示如下：创建模板编辑模板获取控件
	是否创建模板	按钮	字段放置在创建模板标签页下
	模板编号	单行文本	字段放置在创建模板标签页下
	是否编辑模板	按钮	字段放置在编辑模板标签页下
	是否获取控件	按钮	字段放置在获取控件标签页下
	模板控件	子表单
	控件 ID	子字段-单行文本
	控件Key
	控件名称
	控件类型
	是否必填

3.3 发起签署流程表单

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

字段说明	字段名称	字段类型	字段解释
发起方企业授权	企业名称	单行文本	必填，请先调用授权认证后，方可以自身企业作为发起方。
发起方企业授权	手机号码	单行文本	必填，填写授权企业手机号。
合同信息	合同编号	单行文本	非必填，公式编辑自动生成合同编号。公式为：CONCATENATE("HT",TEXT(SYSTIME(),"yyMMddHHmm"),RIGHT("000"+RECNO(),3))
	签署主题	单行文本	必填，合同签署的主题。
	模板编号		必填，填写【模板管理】表单中创建模板获取的模板编号。
	合同模板内容		非必填，公式编辑如下所示： CONCATENATE('{','"2575bd37e4aa40bfb21b1455778fc7f8":甲方地址',',"47895d98292f4d2cbe881dfe6ee87ab4":['+TEXT(附加项目.聚合字段)+']',',"date":起始日期',',"2097fa346771436ab625cfbb9e6f635b":联系方式','}')
	签署文件	附件	必填，合同签署的文件，支持pdf，docx，doc，rtf，xlsx，xls，ppt，wps等格式；上传的文件大小不超过 50 MB。
	抄送类型	下拉框	非必填，下拉框选项短信邮件合同签署完成后，如填写抄送信息，可通过短信或邮件方式通知抄送接收人。
	抄送通知	单行文本	非必填，当抄送类型为短信，则填手机号；当抄送类型为邮件，则填写邮箱地址。
合同模板信息	甲方地址	单行文本	非必填
	起始日期	日期时间
	联系方式	单行文本
	附件项目	子表单	——
	服务项目	子字段-单行文本	非必填
	数量
	金额
	总计
	聚合字段		在「字段属性 >> 默认值」处，设置公式编辑如下： CONCATENATE('{','"column1":附加项目.服务项目,"column2":附加项目.数量,"column3":附加项目.金额,"column4":附加项目.总计','}') 注：column1、column2……为固定参数。
发起方签署信息	签署人类型	下拉框	必填，下拉框选项：个人企业/机构
	签署单位	单行文本	必填，类型为个人，签署单位填姓名，企业/机构填公司全称。
	签署手机	单行文本	必填。
	落章关键字	单行文本	必填，若有多个落章关键字，用英文格式下的逗号（“,”）隔开。
	指定印章	单行文本	非必填，如需指定印章签章，需填写「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)。

5）「合同模板内容」字段中：公式结构为「控件 ID 或控件 Key + 表单字段」，此处可填写控件 ID，也可填写控件 Key（获取方式参加本文档【4.2获取控件前端事件配置】）。

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

签署 ID：设置为 flow_id；
签署完成合同：设置为 contract；
签署状态：设置为 status。

3.4 撤销签署流程表单

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

字段名称	字段类型	字段设置
撤销合同签署主题	单行文本	——
撤销合同签署 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 添加按钮执行动作

进入「模板管理」表单中，点击「是否创建模板」按钮字段，在「字段属性 >> 执行动作」处，点击「添加执行动作」：

4.2.2 设置事件名称和说明

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

4.2.3 设置执行动作

设置执行动作如下：

插件：选择「 e 签宝次数版 >> 获取模板」；
模板底稿：设置为字段值，即「模板文件」字段；
模板名称：设置为字段值，即「模板名称」字段；
字段存储关系：点击「添加」按钮，并选择添加「全部」，并将「模板编号」的值存储到「模板编号」中。

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

4.3 编辑模板

4.3.1 添加按钮执行动作

进入「模板管理」表单中，点击「是否编辑模板」按钮字段，在「字段属性 >> 执行动作」处，点击「添加执行动作」：

4.3.2 设置事件名称和说明

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

4.3.3 设置执行动作

设置执行动作如下：

插件：选择「 e 签宝次数版 >> 弹窗编辑模板」；
模板编号：设置为字段值，即「模板编号」字段；

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

4.4 获取控件

4.4.1 添加按钮执行动作

进入「模板管理」表单中，点击「是否获取控件」按钮字段，在「字段属性 >> 执行动作」处，点击「添加执行动作」：

4.4.2 设置事件名称和说明

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

4.4.3 设置执行动作

设置执行动作如下：

选择插件：选择「 e 签宝次数版 >> 查询模板控件」；
模板编号：设置为字段值，即「模板编号」字段；
字段存储关系：点击「添加」按钮，并选择添加「全部」，并分别回填至如下所示的表单字段中。

将「模板控件.控件 ID」的值存储到「模板控件.控件 ID」中；
将「模板控件.控件名称」的值存储到「模板控件.控件名称」中；
将「模板控件.控件类型」的值存储到「模板控件.控件类型」中；
将「模板控件.是否必填」的值存储到「模板控件.是否必填」中；
将「模板控件.控件 Key」的值存储到「模板控件.控件 Key」中；

子字段填充方式：选择「直接填充到对应子字段」。

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

注：

1）首次创建模板需按顺序进行，先创建模板，再编辑模板，再获取模板控件。

2）管理模板，可在表单数据编辑处进行，如需修改模板，可直接点击编辑模板，再获取控件，此时模板编号不变。

3）如需替换已创建的模板文件，可重新点击创建模板按钮，此时模板编号会发生变化。

4）此模板管理和 e 签宝后台模板管理不互通。

4.5 重新获取合同链接

4.5.1 添加按钮执行动作

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

4.5.2 设置事件名称和说明

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

4.5.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 配置合同审批节点

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

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

「合同模板内容」
「附件项目.聚合信息」
「聚合字段 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	单行文本	回填字段
	签署完成合同	附件
	签署状态	单行文本
	签署链接	单行文本
获取合同链接	合同链接	单行文本	回填字段合同签署完成后的合同文件下载链接，链接时效较短，尽快下载使用。
获取合同链接	重新获取合同链接	按钮	——