指定签署顺序

更新时间:2025-11-20 16:14:19

基础介绍

开发者可通过指定签署方的顺序值(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
          }
        }
      ]
    }
  ]
}
我要纠错