签批控件

使用场景

特性：在签署合同的时候，使用签批控件进行签署。如下图：

⚠️ 签批控件分为主子控件的概念1. 主控件： SIGN_VIRTUAL_COMBINATION 是个虚拟的控件，只是表示下面的子控件为签批控件的组合。 2. 子控件：其中包括 SIGN_SIGNATURE （签名控件) (必须包含) ， SIGN_DATE （日期控件，通常跟签名控件一起出现)(可选)， SIGN_SELECTOR（审批意见) (可选)， SIGN_MULTI_LINE_TEXT（批注附言)(可选)每一种类的子控件只能有一个。

适用场景：签署方在签署的时候，需要进行批注。
使用限制：签批控件的子组件必须包含签名控件。

使用包含签批控件的模板发起合同

接下来的示例默认您对通过模板发起签署流程已经熟悉，如您未阅读过此部分，建议先了解如何通过模版发起签署流程。

登录腾讯电子签控制台。
在模板中，配置一个包含签批控件的模板。
保存模板。
在合同中，选择模板发起合同，使用刚才创建的模板进行发起，即可发起一份包含签批控件的合同。

使用文件发起一份包含签批控件的合同

接下来的示例默认您对通过文件发起签署流程已经熟悉，如您未阅读过此部分，建议先了解如何通过文件发起签署流程。

调用创建签署流程接口（CreateFlowByFiles）创建签署流程，如：此示例为一份 B2C 合同，B 端签署人有两个签署控件（签字和审批控件）， C 端签署人只有审批控件

 {
 "Operator": {
     "UserId": "yDRCLUUgygq2xun5UuO4zjEwg0vjoimj"
 },
 "FlowName": "文件发起签批控件",
 "Approvers": [
     {
         "ApproverType": 0,
         "OrganizationName": "典子谦示例企业",
         "Required": true,
         "ApproverName": "典子谦",
         "ApproverMobile": "13200000000",
         "NotifyType": "NONE",
         "RecipientId": "yDR4yUUgyg1q0y4tUuoJSJ78uOg0ZjBM",
         "SignComponents": [
             {
                 "ComponentId": "ComponentId_1",
                 "ComponentPosY": 260,
                 "ComponentWidth": 100,
                 "FileIndex": 0,
                 "ComponentType": "SIGN_SIGNATURE",
                 "ComponentPage": 1,
                 "ComponentPosX": 160,
                 "ComponentHeight": 100,
                 "Relation":"ComponentId_2"
             },
             {
                 "ComponentId": "ComponentId_2",
                 "ComponentPosY": 360,
                 "ComponentWidth": 100,
                 "FileIndex": 0,
                 "ComponentType": "SIGN_DATE",
                 "ComponentPage": 1,
                 "ComponentPosX": 160,
                 "ComponentHeight": 50,
                 "Relation":"ComponentId_1"
             },
             {
                 "ComponentId": "ComponentId_26",
                 "ComponentExtra": "{\"Children\":[\"ComponentId_29\",\"ComponentId_27\",\"ComponentId_28\",\"ComponentId_30\"]}", //这里写子签批控件， 最多支持4种，且子控件类型不能重复。
                 "ComponentHeight": 211,
                 "ComponentName": "签批1",
                 "ComponentPage": 1,
                 "ComponentPosX": 180,
                 "ComponentPosY": 478,
                 "ComponentType": "SIGN_VIRTUAL_COMBINATION",
                 "ComponentWidth": 210,
                 "ComponentRequired": false
             },
             {
                 "ComponentExtra": "{\"Date\":true,\"isAfterCut\":true}",
                 "ComponentHeight": 43,
                 "ComponentId": "ComponentId_27",
                 "ComponentName": "个人签名/印章",
                 "ComponentPage": 1,
                 "ComponentPosX": 185,
                 "ComponentPosY": 478,
                 "ComponentRequired": true,
                 "ComponentType": "SIGN_SIGNATURE",
                 "ComponentWidth": 119,
                 "Relation": "ComponentId_28"
             },
             {
                 "ComponentExtra": "{\"Format\":\"yyyy年m月d日\",\"Gaps\":\"2,2\",\"FontSize\":12,\"FontAlign\":\"Center\",\"Font\":\"黑体\"}",
                 "ComponentHeight": 20,
                 "ComponentId": "ComponentId_28",
                 "ComponentName": "签署日期",
                 "ComponentPage": 1,
                 "ComponentPosX": 185,
                 "ComponentPosY": 541,
                 "ComponentRequired": true,
                 "ComponentType": "SIGN_DATE",
                 "ComponentWidth": 119,
                 "Relation": "ComponentId_27"
             },
             {
                 "ComponentId": "ComponentId_29",
                 "ComponentExtra": "{\"Values\":[\"审批通过\",\"审批不通过\"],\"FontSize\":12,\"FontAlign\":\"Left\",\"Font\":\"黑体\",\"MultiSelect\":false}", //Values可以自定义，
                 "ComponentHeight": 20,
                 "ComponentName": "审批意见",
                 "ComponentPage": 1,
                 "ComponentPosX": 180,
                 "ComponentPosY": 567,
                 "ComponentRequired": true,
                 "ComponentType": "SIGN_SELECTOR",
                 "ComponentWidth": 210
             },
             {
                 "ComponentExtra": "{\"FontSize\":12,\"FontAlign\":\"Left\",\"VerticalAlign\":\"Top\",\"Font\":\"黑体\"}",
                 "ComponentHeight": 54,
                 "ComponentId": "ComponentId_30",
                 "ComponentName": "批注附言",
                 "ComponentPage": 1,
                 "ComponentPosX": 180,
                 "ComponentPosY": 635,
                 "ComponentRequired": true,
                 "ComponentType": "SIGN_MULTI_LINE_TEXT",
                 "ComponentWidth": 210
             }
         ]
     },
     {
         "ApproverType": 1,
         "Required": true,
         "ApproverName": "何规",
         "ApproverMobile": "18888888888",
         "NotifyType": "NONE",
         "RecipientId": "yDR4yUUgyg1q0y4tUuoJSJ78uOg0ZjBM",
         "SignComponents": [
             {
                 "ComponentExtra": "{\"Children\":[\"ComponentId_19\",\"ComponentId_17\",\"ComponentId_18\",\"ComponentId_20\"]}",//这里写子签批控件， 最多支持4种，且子控件类型不能重复。
                 "ComponentHeight": 211,
                 "ComponentId": "ComponentId_16",
                 "ComponentName": "签批1",
                 "ComponentPage": 1,
                 "ComponentPosX": 280,
                 "ComponentPosY": 478,
                 "ComponentType": "SIGN_VIRTUAL_COMBINATION",
                 "ComponentWidth": 210
             },
             {
                 "ComponentExtra": "{\"Values\":[\"审批通过\",\"审批不通过\"],\"FontSize\":12,\"FontAlign\":\"Left\",\"Font\":\"黑体\",\"MultiSelect\":false}",//Values可以自定义，
                 "ComponentHeight": 20,
                 "ComponentId": "ComponentId_19",
                 "ComponentName": "审批意见",
                 "ComponentPage": 1,
                 "ComponentPosX": 280,
                 "ComponentPosY": 567,
                 "ComponentRequired": true,
                 "ComponentType": "SIGN_SELECTOR",
                 "ComponentWidth": 210
             },
             {
                 "ComponentExtra": "{\"Date\":true,\"isAfterCut\":true}",
                 "ComponentHeight": 43,
                 "ComponentId": "ComponentId_17",
                 "ComponentName": "个人签名/印章",
                 "ComponentPage": 1,
                 "ComponentPosX": 285,
                 "ComponentPosY": 478,
                 "ComponentRequired": true,
                 "ComponentType": "SIGN_SIGNATURE",
                 "ComponentWidth": 119,
                 "Relation": "ComponentId_18"
             },
             {
                 "ComponentExtra": "{\"Format\":\"yyyy年m月d日\",\"Gaps\":\"2,2\",\"FontSize\":12,\"FontAlign\":\"Center\",\"Font\":\"黑体\"}",
                 "ComponentHeight": 20,
                 "ComponentId": "ComponentId_18",
                 "ComponentName": "签署日期",
                 "ComponentPage": 1,
                 "ComponentPosX": 285,
                 "ComponentPosY": 541,
                 "ComponentRequired": true,
                 "ComponentType": "SIGN_DATE",
                 "ComponentWidth": 119,
                 "Relation": "ComponentId_17"
             },
             {
                 "ComponentExtra": "{\"FontSize\":12,\"FontAlign\":\"Left\",\"VerticalAlign\":\"Top\",\"Font\":\"黑体\"}",
                 "ComponentHeight": 54,
                 "ComponentId": "ComponentId_20",
                 "ComponentName": "批注附言",
                 "ComponentPage": 1,
                 "ComponentPosX": 280,
                 "ComponentPosY": 635,
                 "ComponentRequired": true,
                 "ComponentType": "SIGN_MULTI_LINE_TEXT",
                 "ComponentWidth": 210
             }
         ]
     }
 ],
 "FileIds": [
     "yDRSRUUgygj6qnwfUuO4zjEwc193c2hH"
 ],
 "Unordered":true
 }

记录下响应体中的 FlowId，即此处的yDCm3UU0a5b1y7UiQSZKIFoKjfpS35yJ。

 {
     "Response": {
         "Approvers": [
             {
                 "ApproverRoleName": "",
                 "RecipientId": "yDCm3UU0a5b1a5UiQSZKRiiwiBL2jO6C",
                 "SignId": "yDCm3UU0a5b1y4UiQSZKRSacGyaALNPR"
             },
             {
                 "ApproverRoleName": "",
                 "RecipientId": "yDCm3UU0a5b1yiUiQSZKED1MCsiOvy9u",
                 "SignId": "yDCm3UU0a5b1yuUiQSZKS8iB9RDjFHDw"
             }
         ],
         "FlowId": "yDCm3UU0a5b1y7UiQSZKIFoKjfpS35yJ",
         "PreviewUrl": "",
         "RequestId": "s1726213176993331673"
     }
 }

- `UserId` 为发起方经办人的用户 ID，访问 [腾讯电子签控制台](https://qian.tencent.com) 获取。
- `FlowName` 为合同名称。
- `Approvers` 指定签署方信息。
- `ApproverType` 签署方类型。

审批控件类型解释

审批控件属于一种特殊的签署控件。由一个虚拟组合控件(ComponentType 为SIGN_VIRTUAL_COMBINATION)，最多四个不同类型的子控件。其中包括 SIGN_SIGNATURE （签名控件) (必须包含) ， SIGN_DATE （日期控件，通常跟签名控件一起出现)(可选)， SIGN_SELECTOR（审批意见) (可选)， SIGN_MULTI_LINE_TEXT（批注附言)(可选)

SIGN_VIRTUAL_COMBINATION 签批

component_type	component_extra	描述
SIGN_VIRTUAL_COMBINATION	必须包含 Children children中包含的子Component的ComponentId，保证唯一即可	子控件的集合

SIGN_SIGNATURE 签名

component_type	component_extra	描述
SIGN_SIGNATURE	无	普通签名控件，子控件中必须项

SIGN_DATE 日期

component_type	component_extra	描述
SIGN_DATE	无可以定义日期格式	日期控件，如果需要和签名控件分开可以添加 \"isAfterCut\":true，子控件中非必须项

SIGN_SELECTOR 审批意见

component_type	component_extra	描述
SIGN_SELECTOR	Values 必须包含，表示审批的意见	审批意见的值，单个审批意见的字数长度不能超过这个签署控件的宽度，子控件中非必须项

SIGN_MULTI_LINE_TEXT 批注附言

component_type	component_extra	描述
SIGN_MULTI_LINE_TEXT	无	批注附言子控件中非必须项

示例 1 四个子控件都有的签批控件

"SignComponents": [
    {
      "ComponentExtra": "{\"Children\":[\"ComponentId_29\",\"ComponentId_27\",\"ComponentId_28\",\"ComponentId_30\"]}",
      "ComponentHeight": 211,
      "ComponentId": "ComponentId_26",
      "ComponentName": "签批1",
      "ComponentPage": 1,
      "ComponentPosX": 180,
      "ComponentPosY": 478,
      "ComponentType": "SIGN_VIRTUAL_COMBINATION",
      "ComponentWidth": 210
    },
    {
      "ComponentExtra": "{\"Values\":[\"审批通过\",\"审批不通过\"],\"FontSize\":12,\"FontAlign\":\"Left\",\"Font\":\"黑体\",\"MultiSelect\":false}",
      "ComponentHeight": 20,
      "ComponentId": "ComponentId_29",
      "ComponentName": "审批意见",
      "ComponentPage": 1,
      "ComponentPosX": 180,
      "ComponentPosY": 567,
      "component_required": true,
      "ComponentType": "SIGN_SELECTOR",
      "ComponentWidth": 210
    },
    {
      "ComponentExtra": "{\"Date\":true,\"isAfterCut\":true}",
      "ComponentHeight": 43,
      "ComponentId": "ComponentId_27",
      "ComponentName": "个人签名/印章",
      "ComponentPage": 1,
      "ComponentPosX": 185,
      "ComponentPosY": 478,
      "ComponentType": "SIGN_SIGNATURE",
      "ComponentWidth": 119,
      "relation": "ComponentId_28"
    },
    {
      "ComponentExtra": "{\"Format\":\"yyyy年m月d日\",\"Gaps\":\"2,2\",\"FontSize\":12,\"FontAlign\":\"Center\",\"Font\":\"黑体\",\"isAfterCut\":true}",
      "ComponentHeight": 20,
      "ComponentId": "ComponentId_28",
      "ComponentName": "签署日期",
      "ComponentPage": 1,
      "ComponentPosX": 185,
      "ComponentPosY": 541,
      "ComponentType": "SIGN_DATE",
      "ComponentWidth": 119,
      "relation": "ComponentId_27"
    },
    {
      "ComponentExtra": "{\"FontSize\":12,\"FontAlign\":\"Left\",\"VerticalAlign\":\"Top\",\"Font\":\"黑体\"}",
      "ComponentHeight": 54,
      "ComponentId": "ComponentId_30",
      "ComponentName": "批注附言",
      "ComponentPage": 1,
      "ComponentPosX": 180,
      "ComponentPosY": 635,
      "ComponentType": "SIGN_MULTI_LINE_TEXT",
      "ComponentWidth": 210
    }
  ]

签批控件

示例 2：仅有签名和审批意见的签批控件。

"SignComponents": [
    {
      "ComponentExtra": "{\"Children\":[\"ComponentId_29\",\"ComponentId_27\"]}",
      "ComponentHeight": 211,
      "ComponentId": "ComponentId_26",
      "ComponentName": "签批1",
      "ComponentPage": 1,
      "ComponentPosX": 180,
      "ComponentPosY": 478,
      "ComponentType": "SIGN_VIRTUAL_COMBINATION",
      "ComponentWidth": 210
    },
    {
      "ComponentExtra": "{\"Values\":[\"审批通过\",\"审批不通过\"],\"FontSize\":12,\"FontAlign\":\"Left\",\"Font\":\"黑体\",\"MultiSelect\":false}",
      "ComponentHeight": 20,
      "ComponentId": "ComponentId_29",
      "ComponentName": "审批意见",
      "ComponentPage": 1,
      "ComponentPosX": 180,
      "ComponentPosY": 567,
      "ComponentType": "SIGN_SELECTOR",
      "ComponentWidth": 210
    },
    {
      "ComponentExtra": "{\"Date\":true,\"isAfterCut\":true}",
      "ComponentHeight": 43,
      "ComponentId": "ComponentId_27",
      "ComponentName": "个人签名/印章",
      "ComponentPage": 1,
      "ComponentPosX": 185,
      "ComponentPosY": 478,
      "ComponentType": "SIGN_SIGNATURE",
      "ComponentWidth": 119
    }
  ]

签批控件展示2

使用场景​

使用包含签批控件的模板发起合同​

使用文件发起一份包含签批控件的合同​

审批控件类型解释​

SIGN_VIRTUAL_COMBINATION 签批​

SIGN_SIGNATURE 签名​

SIGN_DATE 日期​

SIGN_SELECTOR 审批意见​

SIGN_MULTI_LINE_TEXT 批注附言​