动态签署方

在某些场景下可发起不明确指定具体签署人的签署流程，待业务系统确定签署人之后再进行补充。

流程图

企业开通动态签署方

登录腾讯电子签控制台。
在企业应用管理-自建应用-应用扩展服务中选择开通动态添加签署方

发起签署流程时不指定具体签署人

通过设置ApproverInfo-ApproverOption结构体中的FillType字段为 1，表明此 approver 不确定具体签署人，同时不指定 ApproverInfo 中的姓名、电话、企业名称等能标识身份的字段。

模版发起示例：

// CreateFlow, 不指定具体签署人
{
  "Operator": {
    "UserId": "yD****************************A8"
  },
  "FlowName": "动态签署方合同",
  "Unordered": true,
  "Approvers": [
    {
      "ApproverType": 0, // 企业
      "ApproverOption": {
        "FillType": 1 // 指定B端动态签署人
      }
    },
    {
      "ApproverType": 1, // 个人
      "ApproverOption": {
        "FillType": 1 // 指定C端动态签署人
      }
    }
  ]
}

// CreateDocument, 与标准创建文档无区别
{
  "Operator": {
    "UserId": "yD****************************A8"
  },
  "FlowId": "yD****************************cW", // 上一步返回的合同ID
  "TemplateId": "yD****************************Gi"  // 模版ID
}

// StartFlow, 与标准发起流程无区别
{
  "Operator": {
    "UserId": "yD****************************A8"
  },
  "FlowId": "yD****************************cW"  // 合同ID
}

文件发起示例：

// CreateFlowByFiles, 不指定具体签署人
{
  "Operator": {
    "UserId": "yD****************************A8"
  },
  "FlowName": "动态签署方合同",
  "Unordered": true,
  "FileIds": ["yD****************************Ce"],
  "Approvers": [
    {
      "ApproverType": 0, // 企业
      "ApproverOption": {
        "FillType": 1 // 指定B端动态签署人
      },
      "SignComponents": [
        {
          // 省略签署控件
        }
      ]
    },
    {
      "ApproverType": 1, // 个人
      "ApproverRoleName": "担保人", // 自定义角色名
      "ApproverOption": {
        "FillType": 1 // 指定C端动态签署人
      },
      "SignComponents": [
        {
          // 省略签署控件
        }
      ]
    }
  ]
}

动态补充签署人

腾讯电子签支持两种方式动态补充签署人，无论哪种方式，参数中都需要传入RecipientId字段，有两种方式可以获取到 RecipientId：

通过发起签署流程时返回信息获取。（注意：模版发起从CreateDocument获取，文件发起从CreateFlowByFiles获取）

// CreateDocument返回示例
{
  "Response": {
     "Approvers": [
        {
            "ApproverRoleName": "腾讯云计算（北京）有限责任公司",
            "RecipientId": "yD****************************Lm",
            "SignId": "yD****************************pT"
        },
        {
            "ApproverRoleName": "乙方",
            "RecipientId": "yD****************************Cz",
            "SignId": "yD****************************Wy"
        }
     ],
    "DocumentId": "yD****************************gb",
    "PreviewFileUrl": "",
    "RequestId": "6a67bd48-****-****-****-3d98d1517560"
  }
}

// CreateFlowByFiles返回示例
{
"Response": {
    "Approvers": [
      {
        "ApproverRoleName": "",
        "RecipientId": "yD****************************NB",
        "SignId": ""
      },
      {
        "ApproverRoleName": "担保人",
        "RecipientId": "yD****************************Hz",
        "SignId": ""
      }
    ],
    "FlowId": "yD****************************5s",
    "PreviewUrl": "",
    "RequestId": "703c4901-****-****-****-93939f6134a1"
  }
}

通过查询合同详情接口返回的FlowApproverDetail获取。

自动补充

通过小程序自动补充

通过CreateSchemeUrl接口指定RecipientId字段获取小程序补充链接，实际签署人可通过链接进入小程序（自动）补充签署人并进行签署。示例：
入参：

{
  "Operator": {
    "UserId": "yD****************************A8"
  },
  "FlowId": "yD****************************5s",
  "RecipientId": "yD****************************Hz", // 根据RecipientId决定补充的签署节点
  "PathType": 3 // 必须为3
}

{
  "Response": {
    "RequestId": "24a62ea9-****-****-****-f30a405162cc",
    "SchemeQrcodeUrl": "https://file.test.ess.tencent.cn/bresource/resource/*****",
    "SchemeUrl": "https://test.essurl.cn/**********"
  }
}

实际签署人可通过返回中的链接或者扫描二维码进入小程序，领取合同并签署。下图为 C 端签署人认领合同：

注意：对于可明确企业，只是具体经办人不确定的B端签署场景，可以在获取签署链接时传入「企业名称」把企业固定下来：

{
  "Operator": {
    "UserId": "yD****************************A8"
  },
  "FlowId": "yD****************************7A",
  "RecipientId": "yD****************************sz", // 根据RecipientId决定补充的签署节点
  "OrganizationName": "企业名称",  // 企业如果未认证，领取人会先认证企业；领取人如果未加入企业，会先要求加入企业
  "PathType": 3 // 必须为3
}

通过H5自动补充

目前仅支持个人签署方通过H5领取指定为动态（个人）签署方的合同，且仅支持走批量领取流程(CreateBatchQuickSignUrl)。示例：

入参：

{
  "Operator": {
    "UserId": "yD****************************A8"
  },
  "FlowIds": [
    "yD****************************5s",
    "yD****************************td"
  ],
  "FlowApproverInfo": {
    "ApproverType": 1
  },
  "FlowBatchUrlInfo": {
    "FlowBatchApproverInfos": [
      {
        "FlowId": "yD****************************5s",
        "RecipientId": "yD****************************Hz"
      },
      {
        "FlowId": "yD****************************td",
        "RecipientId": "yD****************************4c"
      }
    ]
  }
}

{
    "Response": {
        "FlowApproverUrlInfo": {
            "ApproverMobile": "",
            "ApproverName": "",
            "ApproverType": 1,
            "ExpirationTime": "2024-10-15 20:06:42",
            "LongUrl": "https://quick.beta.qian.tencent.cn/guide?Code=yDCjeUUckp42jckkUEQgXHgw5Ysi85jO&CodeType=QUICK&DeviceStore=1&shortKey=yDCjeU8pFEpRDbVZKP79&token=**********",
            "SignScene": 0,
            "SignUrl": "https://test.essurl.cn/**********"
        },
        "RequestId": "a2a5a1e4-****-****-****-f7ec38fe7a81"
    }
}

通过接口补充

通过CreateFlowApprovers接口的 Approvers 字段，并指定FillApproverType为 1 补充签署人。在实践中需业务方自行开发表单录入签署人信息，如果有多个动态签署方可批量补充。补充完成后的合同和普通合同无异，小程序/PC/H5 均可签署。示例：

{
  "Operator": {
    "UserId": "yD****************************A8"
  },
  "FlowId": "yD****************************5s",
  "Approvers": [
    {
      "RecipientId": "yD****************************NB",
      "OrganizationName": "腾讯云计算（北京）有限责任公司",
      "ApproverName": "典子谦",
      "ApproverMobile": "188********"
    },
    {
      "RecipientId": "yD****************************Hz",
      "ApproverName": "张三",
      "ApproverMobile": "186********"
    }
  ],
  "FillApproverType": 1 // 表明补充动态签署人
}

回调

无论选择以上哪种方式补充签署方后，均会收到类型为ReceiveFlow的回调，具体说明请参见动态签署人领取合同通知。

流程图​

企业开通动态签署方​

发起签署流程时不指定具体签署人​

动态补充签署人​

自动补充​

通过小程序自动补充​

通过H5自动补充​

通过接口补充​

回调​

流程图