次数版-模板合同签署场景
1. 简介
1.1 场景简介
模板签署场景是指,通过创建和编辑通用的合同模板,将常用条款、格式等标准化后,可在需要签署时快速发起模板合同的签署流程,提高合同签署效率。
1.2 应用场景
适用于签订标准化的合同/文件。如企业内部员工入职、离职时的劳动合同签署时使用人力资源模板合同,企业与供应商、合作伙伴签订框架合作协议时使用通用的合作合同模板等等。
1.3 预期效果
1)在授权认证中填写授权信息,进行授权认证并获取授权信息:
2)在模板管理表单中,创建和编辑合同模板,并获取模板控件。如下所示:
3)填写合同及合同模板信息,并提交签署申请后,签署人将收到文件签署链接的短信通知,点击链接即可进行签署:
1.4 使用说明
1)该插件包含以下 8 种执行事件:
- 授权认证
- 文件签署
- 模板签署
- 下载文件
- 获取模板
- 弹窗编辑模板
- 查询模板控件
- 撤销签署
2)e 签宝次数版为付费插件,每次调用插件进行签署消耗 1 个 云币。在使用插件时自动扣除云币数量,当云币余额可支付的识别次数为 0 时,将无法使用 e 签宝电子签章-次数版插件。
2. 插件安装及启用
2.1 安装插件
1)直接安装
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 模板管理表单
新建模板管理表单,用于模板的创建、编辑和控件获取。字段设置如下所示:
字段说明 | 字段名称 | 字段类型 | 字段设置 |
模板信息 | 模板名称 | 单行文本 | —— |
模板文件 | 附件 | 支持上传如下所示格式的文件:
注:不支持 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 | 在「字段属性 >> 默认值」处设置为「数据联动」,联动设置如下:
注:此项可手动填写,手动填写时无需【撤销合同签署主题】字段 | |
撤销原因 | —— | |
撤销结果 |
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 签宝后台模板管理不互通。
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 | 单行文本 | 回填字段 |
签署完成合同 | 附件 | ||
签署状态 | 单行文本 | ||
签署链接 | |||
合同链接 | 回填字段 合同签署完成后的合同文件下载链接,链接时效较短,尽快下载使用。 |
注:
1)子表签署顺序默认为签署列表顺序;
2)子表签署流程配置和智能助手 Pro 配置参考【5.智能助手配置】和【6. 流程设定】;
3)根据业务需求选择子表签署或主表签署,两种配置公式有些许差别。
7.4 编辑模板说明
在「模板管理表单 >> 编辑模板子标签页」下,点击「开始编辑」后,页面将弹出编辑合同模板页面,可进行如下操作:
- 拖动左侧控件库中控件至合同指定位置;
- 在右侧文本属性处设置控件基础信息,如名称、默认值、是否必填等;
- 勾选是否使用开放服务。
注:
1)控件库支持上方 1 处除【图片】以外控件,不支持下方【签署区】、【骑缝章】和【备注区】控件。若使用【日期】控件,需在右侧将日期格式设置为 yy-MM-dd。
2)若勾选了使用开放服务,则需要填写控件编码。控件编码可选择用于后续表单公示字段的匹配。
3)若使用了控件库中的「动态表格」,则点击表格,即可设置表头、列、行和单元格。
7.5 签署状态说明
1)原「合同文件 >> 签署状态」字段中,返回的是签署流程的状态,经实际使用和用户反馈,已做迭代,目前版本返回签署人状态,如为多方签署,回传多个签署人状态。
2)签署状态字段无需重新配置,仅返回值有变化,已安装使用用户无需更改配置,新安装用户按本文本说明配置即可。
8. 联系方式
该插件为官方合作的服务商开发,若您在使用过程中有任何疑问,可通过以下方式咨询:
- 公司:成都轻如燕企业服务有限公司
- 联系人:赵鹏
- 联系电话:18583980516(微信同号)