基础介绍
开发者可通过指定签署方的顺序值(signOrder)来控制签署流程:
- 有序签署:当各签署方顺序值不同且依次递增时,系统将按顺序执行签署流程,即前一方完成签署后,后一方方可操作。
- 无序签署:当不指定顺序值,或顺序值重复时,所有签署方可同时进行签署。
注:顺序值从1开始依次递增,数值越小优先级越高。
效果展示
有序签署
指定签署顺序的情况下,签署详情页面会展示具体的签署方顺序,需要上一个签署方签署完成后,下一个签署方才会收到签署通知,这时才可以操作签署。

无序签署
没有指定签署顺序或者签署顺序指定相同值的情况下,流程中签署顺序相同值的签署方可以同时签署。

未轮到签署,接口获取签署链接时查看效果

API接口
API接口(点击直接跳转相关API文档) | API描述 | 是否必需 |
此接口用来发起签署,发起成功后会返回签署流程标识:signFlowId。 | 必需 | |
此接口获取签署方签署页面链接,可用于签署或预览。 | 按需 |
基于文件发起签署接口代码案例
相关参数
- signOrder 设置签署方的签署顺序,按序签时支持传入顺序值 1 - 255(值小的先签署);同时签时,允许值重复。

指定签署顺序相关代码
(signers中signConfig中配置signOrder)
{
"docs": [
{
"fileId": "请设置待签署文件的fileId",
"fileName": "请设置待签署文件的文件名称.pdf"
}
],
"signFlowConfig": {
"signFlowTitle": "请设置当前签署任务的主题:此场景演示平台自身、个人用户双方签署",
"autoFinish": true,
"noticeConfig": {
"noticeTypes": "1,2"
},
"notifyUrl": "请设置异步回调地址,以http/https开头",
"redirectConfig": {
"redirectUrl": "请设置重定向跳转地址,例如:https://www.esign.cn/"
}
},
"signers": [
{
"signConfig": {
"signOrder": 1
},
"signerType": 1,
"signFields": [
{
"customBizNum": "自定义编码001",
"fileId": "请设置待签署文件的fileId",
"normalSignFieldConfig": {
"autoSign": true,
"signFieldStyle": 1,
"signFieldPosition": {
"positionPage": "3",
"positionX": 200,
"positionY": 200
}
}
}
]
},
{
"psnSignerInfo": {
"psnAccount": "请设置个人用户的手机号/邮箱",
"psnInfo": {
"psnName": "个人用户的姓名"
}
},
"signConfig": {
"signOrder": 2
},
"signerType": 0,
"signFields": [
{
"customBizNum": "自定义编码002",
"fileId": "请设置待签署文件的fileId",
"normalSignFieldConfig": {
"signFieldPosition": {
"positionPage": "3",
"positionX": 480,
"positionY": 200
},
"signFieldStyle": 1
}
}
]
}
]
}