合同签署场景 - 简道云

在开始使用插件前，您可线点击下方图片安装应用模板。

1. 简介

1.1 场景简介

插件可实现在简道云中一键发起电子合同签署流程，对合同进行在线签署，为企业提供功能齐全、可覆盖合同签署前/中/后生命周期的电子合同签署功能，让合同签署更安全、高效。

签署前：可适用单方/双方/多方等不同签署场景，支持获取简道云打印模板文件或上传文件两种方式发起签署。
签署中：自动更新各签署方的签署状态和签署链接，方便企业实时把控各签署方签署进度。
签署后：自动归档签署完成的合同文件/下载地址，合同归档更便携。

1.2 应用场景

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

1.3 预期效果

提交文件签署申请后，签署人将收到文件签署链接的短信通知，点击链接即可进行签署。以文件上传签署场景为例，效果如下：

1.4 使用说明

1）该插件包含 5 种执行事件，如下所示：

授权认证
合同签署
下载文件
撤销签署
获取合同链接

2）该插件为付费插件，在简道云「开放平台 >> 插件市场」，找到「e 签宝年费版」插件，点击插件进行购买或试用。

注：

1）年费是指购买插件的费用，并非指合同进行无限签署。

2）该插件有无简道云 API 版都能发起合同签署。

2. 插件安装及配置

2.1 安装插件

1）直接安装

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

2）插件市场处安装

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

2.2 配置插件

1）安装后，在「插件管理」处，点击插件右侧的「设置」按钮，将 e 签宝电子签章 - 年费版【2.5 获取应用 ID 和应用 secret】中获取到的「应用 ID」和「应用 Secret」配置进去。

注：该插件有无简道云 API 版都可用。如有，则可将简道云 API Key 填写进去。

2）有 API 权限的用户在「密钥管理 >> API Key」处获取对应 API 。

2.3 启用插件

在插件管理中，打开 e 签宝年费版右侧开关，启用插件。

3. 表单搭建

插件使用可先安装：e 签宝年费版插件模板。安装后仅需按提示完成参数初始化，即可快速测试使用。
也可参考下方文档手动搭建，完成表单搭建、流程设定和智能助手Pro 设置即可测试使用。如需使用进阶功能，可参考下方【6.1进阶功能设置】自定义新增。

3.1 发起签署流程表单

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

字段说明	字段名称	字段类型	字段解释
发起方授权信息	发起方名称	单行文本	非必填，填写授权认证表单中的授权信息。如授权为企业，填写企业全称，授权为个人，则填写个人实名姓名。应用ID所属企业之外的企业发起签署，则需完成授权认证后，以授权后的企业或个人作为发起方。
	发起方手机号码	单行文本	非必填，填写授权企业或个人的手机号。
	发起类型	下拉框	非必填，下拉框选项：企业个人注：自定义默认为企业发起
合同信息	签署主题	单行文本	必填，合同签署的主题。
合同信息	待签署文件	附件	必填，合同签署的文件，支持 pdf，docx，doc，rtf，xlsx，xls，ppt，wps 等格式；上传的文件大小不超过 50 MB。文件名不可包含特殊字符，如:/:"<>\|?以及所有emoji表情等。注：使用简道云打印模板文件发起签署，此项设为非必填。*
签署方1信息	签署方类型	下拉框	必填，下拉框选项：个人企业/机构
	签署名称	单行文本	必填，类型为个人填姓名，类型为企业/机构填公司全称。
	签署方手机号/邮箱	单行文本	必填。可手机短信接收签署信息，也可填写邮箱接收签署信息。
	落章关键字	单行文本	非必填，若有多个落章关键字，用英文格式下的逗号（“,”）隔开。注： 1）单页签章时落章关键字必填。 2）落章关键字尽量准确，否则会多处识别。
	签署类型	下拉复选框	必填，下拉复选框选项：单页签章骑缝签章可全选，全选时同时签署单页签章和骑缝签章。
	聚合字段1	单行文本	选择公式编辑，公式为： CONCATENATE('{','"signerType":签署方类型',',"Name":签署名称',',"Account":签署方手机号/邮箱',',"keywords":落章关键字',',"signFieldStyle":签署类型','}')
签署方2信息	签署方类型2	下拉框	必填，下拉框选项：个人企业/机构
	签署名称2	单行文本	必填，类型为个人填姓名，类型为企业/机构填公司全称
	签署方手机号/邮箱2	单行文本	必填
	签署类型2	下拉复选框	必填，下拉复选框选项：单页签章骑缝签章可全选，全选时同时签署单页签章和骑缝签章。
	落章关键字2	单行文本	必填，若有多个落章关键字，用英文格式下的逗号（“,”）隔开。注： 1）单页签章时落章关键字必填。 2）落章关键字尽量准确，否则会多处识别。
	聚合字段2	单行文本	选择公式编辑，公式为： CONCATENATE('{','"signerType":签署方类型2',',"Name":签署名称2',',"Account":签署方手机号/邮箱2',',"keywords":落章关键字2',',"signFieldStyle":签章类型2','}')
合同文件	签署ID	单行文本	回填字段
	签署完成合同	附件
	文件ID	单行文本
	签署状态	单行文本
	签署链接	多行文本
	签署信息聚合	多行文本	选择公式编辑，公式为： CONCATENATE(聚合字段1,CHAR(10),聚合字段2)
获取合同链接	合同链接	单行文本	回填字段，用于接收签署完成合同下载链接，此链接时效较短，尽快下载使用，如失效可参考【6.3 重新获取合同链接】重新获取。注：此项无API用户配置即可，请注意和签署

注：

1）示例为双方签署场景，若为多方签署，可根据实际使用新增签署方信息。例：三方签署时，新增签署方3 信息中的字段和公式，并在「签署信息聚合」的公式中，新增公式为：CONCATENATE(聚合字段1,CHAR(10),聚合字段2,CHAR(10),聚合字段3)

2）如有单据签署（即单方签署）需求，可只传聚合字段1到插件的签署方信息聚合中；

3）【发起方授权信息】为非必填项，填写「授权认证」表单中授权的授权信息。

3.2 设置字段别名

注：仅有 API 权限用户需要设置。

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

签署 ID：设置为 flow_id；
签署完成合同：设置为 contract；

4. 流程设定

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

4.1 发起签署流程配置

4.1.1 配置流程发起节点

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

在「节点属性 >> 节点名称」处，修改节点名称为「签署发起节点」；
在「节点属性 >> 字段权限」处，除「公式字段」其他字段均可根据实际使用需求勾选可见、可编辑权限。

4.1.2 配置合同审批节点

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

在「节点名称」处，修改节点名称为「合同审批」；
在「节点负责人」处，选择审批负责人；
在「字段权限」处，除「公式字段」字段，其余字段均可根据实际审批需求设为可见、可编辑字段。

4.1.3 配置插件节点

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

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

将「签署 ID」的值存储到「签署 ID」中；
将「签署链接」的值存储到「签署链接」中；
将「签署状态」的值存储到「签署状态」中；
将「文件 ID」的值存储到「文件ID」中；
将「错误信息」的值存储到「错误信息」中。

注：

1）发起类型：可使用字段值勾选表单字段，也可自定义勾选，需根据实际发起类型勾选为「企业」或「个人」。

2）「抄送类型」、「抄送通知」、「扩展字段」和字段存储关系里的「错误信息」均为进阶参数设置所需，可结合实际使用，按需设置。

4.1.4 启用流程

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

5. 智能助手配置

此项设置用于更新各签署方状态和接收返回的合同文件/合同文件下载地址，设置完成后在成功发起合同后自动执行。

5.1 新建智能助手

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

5.2 配置HTTP触发

如安装使用应用模板，因 HTTP 触发地址不同，故需参考本节点顺序，重新触发 HTTP 地址，触发时注意触发返回「success」后「点击获取示例数据」再设置「IP 地址和自定义返回内容」。

1）复制 HTTP 触发动作中的触发地址，复制触发地址至合同签署触发发数据列表（点击此处）中的触发地址中，等待触发结果为「success」。

注：合同签署触发发数据列表用于模拟推送一条测试数据，以便成功获取示例数据。

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

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

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

注：配置时，需按上述节点顺序操作，否则可能会有触发不成功或获取示例数据不成功的情况，如不用触发地址则需成功发起一条合同签署流程，3 分钟内获取示例数据方可成功。

5.3 配置插件节点

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

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

添加「签署状态」字段，选择「文本类型」；
添加「合同链接」字段，选择「文本类型」。

注：

1）「合同链接」仅无简道云 API 权限的用户配置，有 API 权限的用户可自定义选择是否设置。

2）安装使用应用模板，因应用 ID、表单 ID 等参数每个表单均不同，下载后需手动勾选。

5.4 配置修改数据节点

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

修改对象：选择表单修改数据「e 签宝合同签署-年费版」；
筛选出要修改的数据：添加「签署 ID」,勾选「触发数据--body_signFlowld」字段；
设置字段值：

添加「签署状态」，勾选「插件节点--签署状态」；
添加「合同链接」，勾选「插件节点--合同链接」。

5.5 效果演示

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

6. 注意事项

6.1 进阶功能设置说明

6.1.1 签署方进阶功能参数设置

1）参数设置

签署方进阶功能设置参考下表，使用时分如下两步设置：

先在表单中新增参数字段；
再在「聚合字段」公式中添加新增字段的公式内容，公式参考下方【聚合公式示例】字段。

如需多个签署方均使用，则需在各签署方下分别新增字段和公式内容。

功能场景	字段名称	参数代码	字段格式	字段说明
签署顺序	签署顺序	signOrder	单行文本	填写数字1 2 3...，不填/填写相同数字，默认同时签署。
落章方式	自由签章	freeMode	下拉框	下拉框选项为：是否自由签章指印章可自由拖动，并不限制签署位置、签章类型（单页、骑缝）和签章个数，自由签章为是时落章关键字不生效。
	自动落章	autoSign		下拉框选项为：是否注：自动落章只支持企业，且目前仅应用ID所属企业支持自动落章。
	指定印章	assignedSealId		填写印章 ID。获取方式参考下方【注 2）指定印章】注：自动落章为「是」时，此项必填。
个人签署信息	个人签署方式	psnSealStyles	下拉框	当签署人为个人时生效，下拉框选项：姓名印章手写签名 AI 校验
落章位置	关键字 X 偏移	positionX	单行文本	默认落章关键字靠左位置落章，可填写 x 偏移量调整位置，单位为 px。填写数值同文件大小、字体比例、落章关键字数量都有关联，下方数值仅供参考，具体需结合文件测试。参考数值填写：60 px（标准A4纸，宋体小四字体，4 个落章关键字）
	关键字 Y 偏移	positionY	单行文本	默认落章关键字靠上位置落章，可填写 y 偏移量调整位置，单位为 px。填写数值同文件大小、字体比例、落章关键字数量都有关联，下方数值仅供参考，具体需结合文件测试。参考数值填写：15 px（标准A4纸，宋体小四字体，4 个落章关键字）
	骑缝章模式	acrossPageMode	下拉框	下拉框选项为：全部页码指定页码默认全部页码，指定页码时可填写骑缝签章页码。
	骑缝签章页码	positionMutilPage	单行文本	填写页码范围：如 2-3，不支持填写单一数字。骑缝签章，且骑缝章模式选择“指定页码”时生效，若上传多份文件，页码范围对多份文件均生效。
	骑缝章高度	height	单行文本	默认骑缝高度 300px，落标准 A4 纸中偏下位置，多签署方自动高于 150px 间隔。也可填写骑缝章高度指定位置，单位为 px。参考数值：300-350px。
	移动签章区	movableSignField	下拉框	下拉框选项为：是否落章关键字定位落章模式下，签署页面是否可移动签章区。
印章日期	显示印章日期	showSignDate		下拉框选项为： 0 （表示不显示） 1 （表示显示，格式固定，可移动日期位置）
印章日期	印章日期格式	dateFormat		下拉框选项为： yyyy 年 MM 月 dd 日 yyyy-MM-dd yyyy/MM/dd yyyy-MM-dd HH:mm:ss 注：可选择印章日期的格式，不选默认 yyyy 年 MM 月 dd 日
认证签署	签署意愿认证	willingnessAuthModes	下拉复选框	可指定签署合同时签署方的意愿认证方式，下拉框选项为：签署密码短信验证码快捷刷脸支付宝刷脸不填默认签署密码/短信验证码。
聚合公式示例（添加到签署人信息的聚合公式中）	下方为签署方进阶功能公式参考： CONCATENATE('{',' "assignedSealId":指定印章,"height":骑缝章高度,"positionX":关键字x偏移,"positionY":关键字y偏移,"freeMode":自由签章,"showSignDate":显示印章日期,"signOrder":签署顺序,"psnSealStyles":个人签署方式,"acrossPageMode":骑缝章模式,"positionMutilPage":骑缝章页码,"willingnessAuthModes":意签署意愿认证,"movableSignField":移动签章区,"dateFormat":印章日期格式,"autoSign":自动落章','}')

注：

1）意愿认证方式中，如勾选签署密码，首次可在签署过程设置签署密码，也可提前登录 e 签宝官网进行设置，路径如下：登录 e 签宝官网，在右侧「账户管理 >> 基本信息 >> 密码设置 >> 签署密码」处进行设置。

2）指定印章：在发起签署时，可以指定印章签署，在表单中「指定印章」字段中填写印章 ID。

印章 ID 可登录 e 签宝官网进行获取，点击「印章 >> 详情 >> 复制印章 ID」。
印章管理员/用印员设置，也可登录 e 签宝官网进行获取，点击「印章 >> 授权」在授权页进行相关操作。

6.1.2 签署流程扩展功能参数设置

签署流程扩展功能参考下方表格，使用时需在表单中新增所需功能字段，并在「扩展功能」的公式中添加对应的公式内容，公式参考下方【扩展字段公式示例】字段。

功能场景	字段名称	参数代码	字段格式	字段说明
抄送	抄送类型	——	下拉框	下拉框选项短信邮件如填写抄送信息，合同签署完成后可通过短信或邮件方式通知抄送接收人。
抄送	抄送手机号/邮箱	——	单行文本	当抄送类型为短信，则填手机号；当抄送类型为邮件，则填写邮箱地址。
签署时效	签署截止日期	signFlowExpireTime	日期时间	年-月-日，默认为 90 天，可自定义签署截止时间。
跳转地址	跳转地址	redirectUrl	单行文本	合同签署完成后跳转页面网址，填写地址需符合 https /http 协议地址格式。
报错模式	报错模式	debug	下拉框	下拉框选项为： true false 默认为 false，表示插件节点正常报错。填写 true时，插件节点不会报错，报错信息返回错误信息字段，并且签署 ID 返回为 999999。
报错模式	错误信息	——	单行文本
扩展字段公式示例	下方为签署流程扩展功能公式参考： CONCATENATE('{','"debug":报错模式,"signFlowExpireTime":签署截止日期,"redirectUrl":指定跳转地址','}')

注：抄送指不参与签署的机构或者个人，流程结束后将收到通知，允许查看签署文件。插件节点设置如下：

抄送类型，为字段值，勾选为「抄送类型」字段；
抄送通知，为字段值，勾选为「抄送手机/邮箱」字段。

6.2 撤销签署设置说明

撤销签署可结合实际业务设置在合同签署表单的「前端事件」中或「扩展功能>>自定义按钮」中，建议安装使用应用模板，直接使用或参考设置。

1）在扩展功能>>自定义按钮中新建自定义按钮：

设置按钮名称为：撤销合同；
设置显示位置为：针对单条数据的操作；
设置执行动作为：执行智能助手并新增智能助手。

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

选择插件：选择「e 签宝年费版 >> 撤销签署」；
签署ID：设置为字段值，即「触发数据——签署ID」字段；
撤销原因：设置为字段值，即「触发数据——撤销原因」字段；
执行结果中，添加撤销结果，设置为「文本」。

3）新增修改数据节点，筛选出要修改的数据：

添加条件为：「签署ID」等于任意一个「触发数据——签署ID」；
设置字段值为：「撤销结果」等于节点字段值「插件节点——撤销结果」。

6.3 重新获取合同链接设置说明

注：此项为非必须配置项，无 API 权限的用户可设置，用于签署完成合同下载链接失效后，重新获取合同下载链接。

1）在扩展功能>>自定义按钮中新建自定义按钮：

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

2）插件节点设置为：

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

选择插件：选择「e 签宝年费版 >> 重新获取合同链接」；
签署类型：设置为字段值，即「触发数据——签署类型」；
签署ID：设置为字段值，即「触发数据——签署 ID」字段。

3）新增修改数据节点，筛选出要修改的数据：

添加条件为：「签署ID」等于任意一个「触发数据——签署 ID」；
设置字段值为：「签署完成合同-下载链接」等于节点字段值「插件节点——合同链接」。

6.4 关于授权认证的说明

非应用 ID 所属企业发起时需完成授权认证。

用途：非应用ID所属企业完成授权认证后，方可以授权企业发起合同签署。
如何授权：建议安装右侧 e 签宝电子签章-年费版插件应用模板，直接使用模板中的【授权认证】表单完成授权，先点击：「获取授权链接」，获取链接后再点击到链接里面完成授权。
注意事项：不同企业/手机号需分别授权。

注：

1）仅非应用ID所属企业作为发起方时需要授权，合同接收方（签署方）不需要进行授权。

2）发起方指在平台中发起合同签约的一方，即合同的归属方，有权限查看签署的文件，在收到的签署通知中会显示：XXX（发起方）通知您签署 XXXX 合同。

6.5 关于打印模板文件发起签署的说明

1）可尝试在发起合同签署之前，通过智能助手Pro 获取打印模板文件到表单附件字段里面或直接传给插件发起签署，在签署时候，用获取到的附件文件发起签署即可，配置时，注意和其他智能助手Pro 做区分。

2）如需参考获取合同签署文件配置方式，可安装 e 签宝年费版插件模板。合同签署和单据签署表单中的「获取打印模板文件」智能助手，示例仅做参考，实际使用请结合企业业务。

注：也可以参考打印模板相关帮助文档自行设置：打印模板文件的制作方法、生成打印模板文件的方法。

6.6 不固定签署方配置的思路说明

部分签署场景中，每次发起签署可能不固定签署方数量，此时可以把签署方信息配置到子表中，签署时，在子表中添加签署方来实现。配置参考如下：

1）其他表单字段，和原【3.1 发起签署流程表单】中保持一致，仅需将签署方相关信息，配置调整到子表单中即可。

2）如有使用到签署方相关个性化参数设置，可参考【6.1 进阶功能设置说明】，将对应参数添加到下方子表单中。

字段说明	字段名称	字段类型	字段设置
签署方列表	签署方类型	子表单-下拉框	必填，下拉框选项：个人企业/机构
	签署单位	子表单-单行文本	必填，类型为个人，签署单位填姓名，企业/机构填公司全称。
	签署手机/邮箱	子表单-单行文本	必填。可手机短信接收签署信息，也可填写邮箱接收签署信息。
	落章关键字	子表单-单行文本	非必填，若有多个落章关键字，用英文格式下的逗号（“,”）隔开。注： 1）单页签章时落章关键字必填。 2）落章关键字尽量准确，否则会多处识别。
	签署类型	子表单-下拉复选框	必填，下拉复选框选项：单页签章骑缝签章可全选，全选时同时签署单页签章和骑缝签章。
	签署信息聚合字段	子表单-单行文本	设置默认值为公式编辑，公式如下： CONCATENATE('{','"signerType":签署方列表,签署方类型',',"Name":签署方列表.签署单位',',"Account":签署方列表.签署手机',',"keywords":签署方列表,落章关键字',',"signFieldStyle":签署方列表,签章类型','}')
	签署方信息聚合	多行文本	设置默认值为公式编辑，公式如下： JOIN(签署方列表.人员聚合字段,CHAR(10))

7. 联系方式

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

公司：成都轻如燕企业服务有限公司
联系人：赵鹏
联系电话：18583980516（微信同号）
电子合同业务交流群：二维码如下