合同上传签署场景 - 简道云

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

1. 简介

1.1 场景简介

e 签宝电子签章次数版支持在简道云一键提交发起在线合同签署流程，可通过简道云生成打印模板文件或上传文件方式发起签署，支持单方/双方/多方签署，并能自动更新各签署方签署状态和签署链接，签署完成后自动归档合同文件或下载地址。

1.2 应用场景

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

1.3 预期效果

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

1.4 使用说明

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

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

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

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

3）授权认证

使用 e 签宝-次数版均需先进行企业授权认证，再发起合同签署/单据签署。建议安装上方插件应用模板，直接使用模板中的【授权认证】表单完成授权，目前授权为长期有效，不同企业和类型仅需授权一次。

注：仅发起方需要授权，此处的发起方指在平台中发起合同签约的一方，即合同的归属方。合同发起方有权限查看签署的文件，签署通知中会显示：XXX（发起方）通知您签署... 合同。

2.插件安装

2.1 安装插件

1）直接安装

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

2）插件市场处安装

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

2.2 配置插件

1）安装后，在「插件管理」处，点击插件右侧的「设置」按钮，将简道云的 API Key 配置进去。该插件有无简道云 API 版都可用。如有，则可将简道云 API Key 填写进去。

2）在「密钥管理 >> API Key」处获取对应 API 。

2.3 启用插件

在插件管理中，打开 e 签宝次数插件右侧开关，启用插件。

3. 表单搭建

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

3.1 发起签署流程表单

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

字段说明	字段名称	字段类型	字段解释
发起方信息	发起方名称	单行文本	必填，填写授权认证表单中的授权信息。如授权为企业，填写企业全称，授权为个人，则填写个人实名姓名。请先调用授权认证后，方可以自身企业或个人作为发起方。
	发起方手机号码	单行文本	必填，填写授权企业或个人的手机号。
	发起类型	下拉框	非必填，下拉框选项：企业个人注：该参数在插件中为必填参数，自定义默认为企业发起。若参数配置设置为字段值勾选，则字段为必填。
合同信息	签署主题	单行文本	必填，合同签署的主题。
合同信息	待签署文件	附件	必填，合同签署的文件，支持 pdf，docx，doc，rtf，xlsx，xls，ppt，wps 等格式；上传的文件大小不超过 50 MB。注： 1）如用生成打印模板文件发起签署，此项可设为非必填。 2）文件数量：仅支持上传一份文件签署，多传默认调取第一份文件发起签署，多个文件放在一份文件里面算一个文件。
签署方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)
获取合同链接	合同链接	单行文本	回填字段，用于接收签署完成合同下载链接，此链接时效较短，尽快下载使用，如失效可点击重新获取合同链接。注：此项无API用户配置即可，请注意和签署链接字段区分开。
获取合同链接	重新获取合同链接	按钮	用于签署完成合同下载链接时效时，点击后重新获取。注：此项无API用户配置即可，且是合同签署完成后使用，请勿提交表单时点击。

注：

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

2）如有单据签署（即单方签署）需求，参考下方【6.2 单据签署配置说明】进行设置；

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 新建智能助手Pro

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

注：配置时，需按上述节点顺序操作，否则可能会有触发不成功或获取示例数据不成功的情况。

5.3 配置插件节点

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

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

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

注：

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

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

3）签署类型需根据实际签署类型勾选为「单据签署」或「合同签署」。

5.4 配置修改数据节点

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

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

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

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

6. 注意事项

6.1 进阶功能设置说明

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

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

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

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

功能场景	字段名称	参数代码	字段格式	字段说明
签署顺序	签署顺序	signOrder	单行文本	填写数字1 2 3...，不填/填写相同数字，默认同时签署。
落章方式	自由签章	freeMode	下拉框	下拉框选项为：是否自由签章指印章可自由拖动，并不限制签署位置、签章类型（单页、骑缝）和签章个数，自由签章为是时落章关键字不生效。
	指定印章	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":印章日期格式','}')

注：

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

2）指定印章：在发起签署时，可以指定印章签署，在表单中「指定印章」字段中填写印章 ID。印章 ID 可登录 e 签宝官网进行获取，点击「印章 >> 详情 >> 复制印章 ID」。

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

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

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

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

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

6.2 单据签署配置说明

单据签署即为单方签署，单据签署和合同签署的设置区别不大，仅需保留一方签署方信息即可。

6.2.1 表单创建

可参考【3.1 发起签署流程表单】表单搭建，仅保留一方签署人信息或保留聚合字段 1 即可。

6.2.2 插件配置

插件节点配置与合同签署类似，仅插件函数勾选有区别，单据文件签署函数配置如下

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

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

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

注：

1）单据签署进阶功能设置，同样可参考上方【6.1 进阶功能设置】，其中「单据签署-意愿认证」仅支持签署密码和短信验证码。

2）其他设置如「智能助手Pro >> HTTP 触发」和「撤销签署」等配置方式类似，均可参考本文档示例进行设置。

3）使用单据签署，在「智能助手Pro >> 合同下载」中，需将「签署类型」勾选为单据签署，否则会影响后续使用。

6.3 撤销签署设置说明

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

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

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

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

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

选择插件：选择「e 签宝次数版 >> 撤销签署」；
签署类型：设置为自定义，选择合同签署（若为单据签署则选择单据签署）；
签署ID：设置为字段值，即「触发数据——签署ID」字段；
撤销原因：设置为字段值，即「触发数据——撤销原因」字段；
执行结果中，添加撤销结果，设置为「文本」。

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

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

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

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

6.4.1 添加按钮执行动作

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

6.4.2 设置事件名称和说明

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

6.4.3 设置执行动作

设置执行动作如下：

选择插件：选择「 e 签宝次数版 >> 重新获取合同链接」；
签署类型：设置为自定义，勾选「合同签署」；（如实际使用为单据签署，此处需勾选单据签署。）
签署 ID：设置为字段值，即「签署 ID」字段；
字段存储关系：点击「添加」按钮并选择添加「全部」，将「合同链接」的值存储到「合同链接」中。

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

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

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

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

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

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

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

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

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

7. 联系方式

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

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