次数版-文件上传签署场景
1. 简介
1.1 场景简介
文件上传签署指的是通过上传已有的合同文件,从而发起合同签署流程,实现对合同的在线签署。支持自动更新签署状态,自动下载签署文件,支持多格式上传,支持单方、双方、多方签署。
1.2 应用场景
适用于不同场景下的合同/文件签署。同时适用单方、双方和多方合同签署,如内部文件签署、劳动合同签署、检测报告盖章、采购合同、项目实施合同等。
1.3 预期效果
1)在授权认证中填写授权信息,进行授权认证并获取授权信息:
2)提交文件签署申请后,签署人将收到文件签署链接的短信通知,点击链接即可进行签署:
1.4 使用说明
1)该插件包含以下 9 种执行事件:
- 授权认证
- 文件签署
- 模板签署
- 下载文件
- 获取模板
- 弹窗编辑模板
- 查询模板控件
- 撤销签署
- 获取合同链接
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 发起签署流程表单
1)新建「e 签宝合同签署-次数版」流程表单,用于填写企业授权、合同信息和签署方信息等相关内容,字段设置如下所示:
字段说明 | 字段名称 | 字段类型 | 字段解释 |
发起方企业授权 | 企业名称 | 单行文本 | 必填,请先调用授权认证后,方可以自身企业作为发起方。 |
手机号码 | 单行文本 | 必填,填写授权企业手机号。 | |
合同信息 | 合同编号 | 单行文本 | 非必填,公式编辑自动生成合同编号。 公式为:CONCATENATE("HT",TEXT(SYSTIME(),"yyMMddHHmm"),RIGHT("000"+RECNO(),3)) |
签署主题 | 单行文本 | 必填,合同签署的主题。 | |
签署文件 | 附件 | 必填,合同签署的文件,支持 pdf,docx,doc,rtf,xlsx,xls,ppt,wps 等格式; 上传的文件大小不超过 50 MB。 | |
抄送类型 | 下拉框 | 非必填,下拉框选项
合同签署完成后,如填写抄送信息,可通过短信或邮件方式通知抄送接收人。 | |
抄送通知 | 单行文本 | 非必填, 当抄送类型为短信,则填手机号;当抄送类型为邮件,则填写邮箱地址。 | |
发起方签署信息 | 签署人类型 | 下拉框 | 必填,下拉框选项:
|
签署单位 | 单行文本 | 必填,类型为个人,签署单位填姓名,企业/机构填公司全称。 | |
签署手机 | 必填。 | ||
落章关键字 | 单行文本 | 必填,若有多个落章关键字,用英文格式下的逗号(“,”)隔开。 | |
指定印章 | 非必填,如需指定印章签章,需填写「e签宝官网后台 >>用户中心 >>印章管理」中需要指定的印章编码,非授权企业不能进行指定。 | ||
签署类型 | 下拉复选框 | 必填,下拉复选框选项:
可全选,全选时同时签署单页签章和骑缝签章。 | |
签署顺序 | 单行文本 | 非必填,若不填或填写相同数字则默认同时签署,若填写数字则签署双方按数字顺序进行签署。 | |
个人签署方式 | 下拉框 | 非必填填,下拉框选项:
| |
骑缝章高度 | 数字 | 非必填,填写偏移数字,骑缝章高度不能为负。 | |
关键字X偏移 | |||
关键字Y偏移 | |||
聚合字段1 | 单行文本 | 选择公式编辑,公式为: CONCATENATE('{','"signerType":签署人类型',',"Name":签署单位',',"Account":签署手机',',"assignedSealId":指定印章',',"keywords":落章关键字',',"signFieldStyle":签署类型',',"signOrder":签署顺序',',"height":骑缝章高度',',"psnSealStyles":个人签署方式',',"positionX":关键字X偏移',',"positionY":关键字Y偏移','}') | |
接收签署方信息 | 签署人类型 | 下拉框 | 必填,下拉框选项:
|
签署单位 | 单行文本 | 必填,类型为个人,签署单位填姓名,企业/机构填公司全称 | |
签署手机 | 必填 | ||
签署类型 | 下拉复选框 | 必填,下拉复选框选项:
可全选,全选时同时签署单页签章和骑缝签章。 | |
落章关键字 | 单行文本 | 必填,若有多个落章关键字,用英文格式下的逗号(“,”)隔开。 | |
签署顺序 | 非必填,若不填或填写相同数字则默认同时签署,若填写数字则签署双方按数字顺序进行签署。 | ||
个人签署方式2 | 下拉框 | 非必填填,下拉框选项:
| |
骑缝章高度2 | 数字 | 非必填,填写偏移数字,骑缝章高度不能为负。 | |
关键字X偏移2 | |||
关键字Y偏移2 | |||
聚合字段2 | 单行文本 | 选择公式编辑,公式为: CONCATENATE('{','"signerType":签署人类型',',"Name":签署单位',',"Account":签署手机',',"keywords":落章关键字',',"signFieldStyle":签章类型',',"signOrder":签署顺序',',"height":骑缝章高度2',',"psnSealStyles":个人签署方式2',',"positionX":关键字X偏移2',',"positionY":关键字Y偏移2','}') | |
合同文件 | 签署ID | 单行文本 | 回填字段 |
签署完成合同 | 附件 | ||
签署状态 | 单行文本 | ||
签署链接 | 多行文本 | ||
签署信息聚合 | 选择公式编辑,公式为: CONCATENATE(聚合字段1,CHAR(10),聚合字段2) | ||
意愿认证 | 意愿认证 | 下拉复选框 | 非必填,下拉复选框选项:
|
扩展字段 | 单行文本 | 选择公式编辑,公式为: CONCATENATE('{','"willingnessAuthModes":意愿认证','}') | |
获取合同链接 | 合同链接 | 单行文本 | 回填字段 合同签署完成后的合同文件下载链接,链接时效较短,尽快下载使用。 |
重新获取合同链接 | 按钮 | —— |
注:
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 | 在「字段属性 >> 默认值」处设置为「数据联动」,联动设置如下:
注:此项可手动填写,手动填写时无需【撤销合同签署主题】字段 | |
撤销原因 | —— | |
撤销结果 |
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 所属企业或授权企业,不支持指定印章。 | |
签章类型 | 子表单-下拉框 | 必填,下拉复选框选项:
全选则两种签章类型同时签署。 | |
落章关键字 | 子表单-单行文本 | 必填,如有多个落章关键字,用英文格式下的逗号(“,”)隔开。 | |
个人签署方式 | 子表单-下拉框 | 非必填填,下拉框选项:
| |
骑缝章高度 | 子表单-数字 | 非必填,填写偏移数字,骑缝章高度不能为负。 | |
关键字X偏移 | |||
关键字Y偏移 | |||
人员聚合字段 | 子表单-单行文本 | 设置默认值为公式编辑,公式如下: CONCATENATE('{','"signerType":签署人列表,签署人类型',',"Name":签署人列表.签署单位',',"Account":签署人列表.签署手机',',"assignedSealId":签署人列表,指定印章',',"height":签署人列表.骑缝章高度',',"psnSealStyles":签署人列表.个人签署方式',',"positionX":签署人列表.关键字X偏移',',"positionY":签署人列表.关键字Y偏移',',"keywords":签署人列表,落章关键字',',"signfieldStyle":签署人列表,签章类型','}') | |
签署人聚合 | 单行文本 | 设置默认值为公式编辑,公式如下: JOIN(签署人列表.人员聚合字段,CHAR(10)) | |
合同文件 | 签署ID | 单行文本 | 回填字段 |
签署完成合同 | 附件 | ||
签署状态 | 单行文本 | ||
签署链接 | 单行文本 | ||
获取合同链接 | 合同链接 | 回填字段 合同签署完成后的合同文件下载链接,链接时效较短,尽快下载使用。 | |
重新获取合同链接 | 按钮 | —— | |
意愿认证 | 意愿认证 | 下拉复选框 | 非必填,下拉复选框选项:
|
扩展字段 | 单行文本 | 选择公式编辑,公式为: CONCATENATE('{','"willingnessAuthModes":意愿认证','}') |
注:
1)子表签署顺序默认为签署列表顺序;
2)子表签署流程配置和智能助手Pro 配置参考【5.智能助手配置】和【6. 流程设定】;
3)根据业务需求选择子表签署或主表签署,两种配置公式有些许差别。
7.4 签署状态说明
1)原「合同文件 >> 签署状态」字段中,返回的是签署流程的状态,经实际使用和用户反馈,已做迭代,目前版本返回签署人状态,如为多方签署,回传多个签署人状态。
2)原「合同文件 >> 签署链接」字段中,返回的仅单个签署人的签署链接,因签署链接不通用,经实际使用反馈,已做迭代,目前版本返回多个签署人签署链接。
3)「签署状态」和「签署链接」字段无需重新配置,仅返回值有变化,已安装使用用户无需更改配置,新安装用户按本文本说明配置即可。
7.5 关于打印模板文件发起签署
可尝试在发起合同签署之前,通过智能助手Pro 获取打印模板文件到表单附件字段里面,在签署时候,用获取到的附件文件发起签署即可,配置时,注意和其他智能助手Pro 做区分。
8. 联系方式
该插件为官方合作的服务商开发,若您在使用过程中有任何疑问,可通过以下方式咨询:
- 公司:成都轻如燕企业服务有限公司
- 联系人:赵鹏
- 联系电话:18583980516(微信同号)