基础介绍
签署场景里可以指定会签或者或签两种模式(如不单独指定,默认发起的签署流程都是会签模式)。关于会签和或签,这里以一个审批签署流程为例做具体的场景说明:
会签:指同一个审批节点设置多个人,如ABC三人,三人会收到审批,需全部同意之后,审批才可到下一审批节点。可以理解为会签指的是一定会签。
或签:指同一个审批节点设置多个人,如ABC三人,三人会同时收到审批,只要其中任意一人审批即可到下一审批节点。可以理解为或签指的是有可能签。
效果展示
签署后效果展示
测试文件下载:合同审批流程.docx
签署详情展示案例
图1:签署1和签署2属于指定顺序的会签,签署3的两个之间选一个人签署就属于或签。
(图1)
图2:签署1中两个人属于无顺序的会签,签署2的两个之间选一个人签署就属于或签。
(图2)
签署操作演示
API接口
API接口(点击直接跳转相关API文档) | API描述 | 是否必需 |
此接口用来发起签署,发起成功后会返回签署流程标识:signFlowId。 | 必需 | |
此接口获取签署方签署页面链接,可用于签署或预览。 | 按需 |
基于文件发起签署接口代码案例
相关参数
- signTaskType(签署任务类型:0 - 会签,1 - 或签)
- signOrder(设置签署方的签署顺序,按序签时传入顺序值 1 - 255,不需要顺序签可以指定相同顺序值,或者不指定该参数)
注意:会签可以相同的签署顺序也可以是不同的顺序,但是或签必须是相同的顺序,且会签的任务和或签的任务不能在同一个顺序内。
代码案例
案例说明:张三、李四进行无顺序的会签,王财、吴总二选一进行或签
{
"docs": [
{
"fileId": "请设置待签署文件的fileId",
"fileName": "请设置待签署文件的文件名称.pdf"
}
],
"signFlowConfig": {
"signFlowTitle": "此场景演示个人用户三方签署",
"autoStart": true,
"autoFinish": true,
"noticeConfig": {
"noticeTypes": "1"
},
"notifyUrl": "请设置异步回调地址,以http/https开头",
"redirectConfig": {
"redirectUrl": "请设置重定向跳转地址,例如:https://www.esign.cn/"
}
},
"signers": [
{
"psnSignerInfo": {
"psnAccount": "请设置个人用户:张三的手机号/邮箱",
"psnInfo":{
"psnName":"张三"
}
},
"signConfig": {
"forcedReadingTime": 3,
"signOrder": 1,
"signTaskType": 0
},
"signerType": 0,
"signFields": [
{
"customBizNum": "自定义编码001",
"fileId": "请设置待签署文件的fileId",
"normalSignFieldConfig": {
"signFieldPosition": {
"positionPage": "1",
"positionX": 233,
"positionY": 584
},
"signFieldStyle": 1
}
}
]
},
{
"psnSignerInfo": {
"psnAccount": "请设置个人用户:李四的手机号/邮箱",
"psnInfo":{
"psnName":"李四"
}
},
"signConfig": {
"forcedReadingTime": 3,
"signOrder": 1,
"signTaskType": 0
},
"signerType": 0,
"signFields": [
{
"customBizNum": "自定义编码002",
"fileId": "请设置待签署文件的fileId",
"normalSignFieldConfig": {
"signFieldPosition": {
"positionPage": "1",
"positionX": 340,
"positionY": 584
},
"signFieldStyle": 1
}
}
]
},
{
"psnSignerInfo": {
"psnAccount": "请设置个人用户:王财的手机号/邮箱",
"psnInfo":{
"psnName":"王财"
}
},
"signConfig": {
"forcedReadingTime": 3,
"signOrder": 2,
"signTaskType": 1
},
"signerType": 0,
"signFields": [
{
"mustSign": false,
"customBizNum": "自定义编码003",
"fileId": "请设置待签署文件的fileId",
"normalSignFieldConfig": {
"signFieldPosition": {
"positionPage": "1",
"positionX": 233,
"positionY": 531
},
"signFieldStyle": 1
}
}
]
},
{
"psnSignerInfo": {
"psnAccount": "请设置个人用户:吴总的手机号/邮箱",
"psnInfo":{
"psnName":"吴总"
}
},
"signConfig": {
"forcedReadingTime": 3,
"signOrder": 2,
"signTaskType": 1
},
"signerType": 0,
"signFields": [
{
"mustSign": false,
"customBizNum": "自定义编码003",
"fileId": "请设置待签署文件的fileId",
"normalSignFieldConfig": {
"signFieldPosition": {
"positionPage": "1",
"positionX": 233,
"positionY": 531
},
"signFieldStyle": 1
}
}
]
}
]
}