跳到主要内容

动态签署方

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

流程图

企业开通动态签署方

  1. 登录 腾讯电子签控制台

  2. 企业应用管理-自建应用-应用扩展服务中选择开通动态添加签署方

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

通过设置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 端签署人认领合同:

通过接口补充

通过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的回调,具体说明请参见动态签署人领取合同通知

购买咨询
微信客服
4006-808-062
4006-808-062