动态签署方

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

流程图

企业开通动态签署方

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

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

通过设置FlowApproverInfo-ApproverOption结构体中的FillType字段为 1，表明此 approver 不确定具体签署人，同时不指定 FlowApproverInfo 中的姓名、电话、企业 ID 等能标识身份的字段。以模版发起签署流程为例：

{
  "Agent": {
    "ProxyOperator": {
      "OpenId": "OpenId-1"
    },
    "ProxyOrganizationOpenId": "OrganizationOpenId-1",
    "AppId": "yD****************************YD"
  },
  "FlowInfos": [
    {
      "FlowName": "动态签署方合同",
      "FlowApprovers": [
        {
          "ApproverType": "ORGANIZATION",
          "ApproverOption": {
            "FillType": 1 // 指定B端动态签署人
          }
        },
        {
          "ApproverType": "PERSON",
          "ApproverRoleName": "担保人", // 自定义角色名
          "ApproverOption": {
            "FillType": 1 // 指定C端动态签署人
          }
        }
      ],
      "TemplateId": "yD****************************fQ"
    }
  ]
}

动态补充签署人

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

通过发起签署流程时返回信息获取（模版发起从CreateFlowsByTemplates获取，文件发起从ChannelCreateFlowByFiles获取）。以模版发起返回为例：

{
  // 省略部分返回数据
  "FlowApprovers": [
    {
      "Approvers": [
        {
          "ApproverRoleName": "",
          "RecipientId": "yD****************************Gt",
          "SignId": "yD****************************z6"
        },
        {
          "ApproverRoleName": "担保人",
          "RecipientId": "yD****************************7F",
          "SignId": "yD****************************B3"
        }
      ],
      "FlowId": "yD****************************8B"
    }
  ]
}

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

自动补充

通过小程序自动补充

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

{
  "Agent": {
    "ProxyOperator": {
      "OpenId": "OpenId-1"
    },
    "ProxyOrganizationOpenId": "OrganizationOpenId-1",
    "AppId": "yD****************************YD"
  },
  "FlowIds": ["yD****************************8B"],
  "RecipientIds": [
    "yD****************************7F" // 根据RecipientId决定补充的签署节点
  ],
  "GenerateType": "RECIPIENT"
}

{
  "Response": {
    "ErrorMessages": [],
    "RequestId": "6f82bbcd-****-****-****-228803541337",
    "SignUrlInfos": [
      {
        // 省略部分返回
        "SignQrcodeUrl": "https://file.test.ess.tencent.cn/bresource/******",
        "SignUrl": "https://test.essurl.cn/**********"
      }
    ]
  }
}

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

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

需要注意的是，传入的子客企业必须已经认证，且合同领取人必须已加入该企业。（可通过CreateConsoleLoginUrl接口进行子客认证并加入领取人）

{
  "Agent": {
    "ProxyOperator": {
      "OpenId": "OpenId-1"
    },
    "ProxyOrganizationOpenId": "OrganizationOpenId-1",
    "AppId": "yD****************************YD"
  },
  "FlowIds": ["yD****************************8B"],
  "OrganizationOpenId": "OrganizationOpenId", // 此OpenId标识的子客企业必须已经认证，且合同领取人必须已加入该企业
  "RecipientIds": ["yD****************************Re"],
  "GenerateType": "RECIPIENT"
}

通过 H5 自动补充

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

入参：

{
  "Agent": {
    "ProxyOperator": {
      "OpenId": "OpenId-1"
    },
    "ProxyOrganizationOpenId": "OrganizationOpenId-1",
    "AppId": "yD****************************YD"
  },
  "FlowApproverInfo": {
    "ApproverType": "PERSON" // 仅支持个人签署方
  },
  "FlowIds": ["yD****************************8B"],
  "FlowBatchUrlInfo": {
    "FlowBatchApproverInfos": [
      {
        "FlowId": "yD****************************8B",
        "RecipientId": "yD****************************7F" // 根据RecipientId决定补充的签署节点
      }
    ]
  }
}

{
  "Response": {
    "FlowApproverUrlInfo": {
      "ApproverType": "PERSON",
      "ExpirationTime": "2024-10-15 16:02:30",
      "LongUrl": "https://quick.beta.qian.tencent.cn/guide?Code=yDCjeUUckp4ri1oqUxieyO5umuuxksCK&CodeType=QUICK&DeviceStore=1&shortKey=yDCjnU8pFEpQ7juT3381&token=**********",
      "Mobile": "",
      "Name": "",
      "SignScene": "",
      "SignUrl": "https://test.essurl.cn/**********"
    },
    "RequestId": "33201c82-****-****-****-cb47ea0364c4"
  }
}

通过接口补充

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

{
  "Agent": {
    "ProxyOperator": {
      "OpenId": "OpenId-1"
    },
    "ProxyOrganizationOpenId": "OrganizationOpenId-1",
    "AppId": "yD****************************YD"
  },
  "FlowId": "yD****************************8B",
  "Approvers": [
    {
      "RecipientId": "yD****************************Gt",
      "OrganizationOpenId": "OrganizationOpenId-1",
      "OpenId": "OpenId-2"
    },
    {
      "RecipientId": "yD****************************7F",
      "ApproverName": "张三",
      "ApproverMobile": "188********"
    }
  ],
  "FillApproverType": 1
}

回调

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

流程图​

企业开通动态签署方​

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

动态补充签署人​

自动补充​

通过小程序自动补充​

通过 H5 自动补充​

通过接口补充​

回调​

流程图