tccli 3.0.1203.1__py2.py3-none-any.whl → 3.0.1205.1__py2.py3-none-any.whl

tccli/services/ess/v20201111/api.json

@@ -1,5 +1,12 @@
 {
   "actions": {
+    "ArchiveDynamicFlow": {
+      "document": "该接口用于结束动态签署流程，若当前合同还存在签署方未签署，无法结束。",
+      "input": "ArchiveDynamicFlowRequest",
+      "name": "结束动态签署合同",
+      "output": "ArchiveDynamicFlowResponse",
+      "status": "online"
+    },
     "BindEmployeeUserIdWithClientOpenId": {
       "document": "此接口（BindEmployeeUserIdWithClientOpenId）用于将电子签系统员工UserId与客户系统员工OpenId进行绑定。\n\n此OpenId只在 [更新企业员工信息 ](https://qian.tencent.com/developers/companyApis/staffs/UpdateIntegrationEmployees)、[移除企业员工](https://qian.tencent.com/developers/companyApis/staffs/DeleteIntegrationEmployees) 等场景下可以使用",
       "input": "BindEmployeeUserIdWithClientOpenIdRequest",
@@ -84,6 +91,13 @@
       "output": "CreateDocumentResponse",
       "status": "online"
     },
+    "CreateDynamicFlowApprover": {
+      "document": "此接口（CreateDynamicFlowApprover）用来补充动态合同的签署人信息。<br/>\n适用场景：使用CreateFlowByFiles指定：OpenDynamicSignFlow=true发起的合同，可以使用该接口补充后续签署人。<br/>",
+      "input": "CreateDynamicFlowApproverRequest",
+      "name": "补充动态签署合同的签署人信息",
+      "output": "CreateDynamicFlowApproverResponse",
+      "status": "online"
+    },
     "CreateEmbedWebUrl": {
       "document": "本接口（CreateEmbedWebUrl）用于创建可嵌入web页面的URL（此web页面可以通过iframe方式嵌入到贵方系统的网页中），支持以下类型的Web链接创建：\n1. 创建印章\n2. 创建模板\n3. 修改模板\n4. 预览模板\n5. 预览合同流程\n\n预览模板的嵌入页面长相如下：\n![image](https://qcloudimg.tencent-cloud.cn/raw/57bdda4a884e3f5b2de12d5a282a3651.png)\n\n预览合同流程的嵌入页面长相如下：\n![image](https://qcloudimg.tencent-cloud.cn/raw/dc7af994e2f6da56bdad5975e927de34.png)",
       "input": "CreateEmbedWebUrlRequest",
@@ -787,7 +801,7 @@
         },
         {
           "disabled": false,
-          "document": "签署方经办人的证件类型，支持以下类型，样式可以参考<a href=\"https://qian.tencent.com/developers/partner/id_card_support/\" target=\"_blank\">常见个人证件类型介绍</a>\n<ul><li>ID_CARD 中国大陆居民身份证  (默认值)</li>\n<li>HONGKONG_AND_MACAO 港澳居民来往内地通行证</li>\n<li>HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)</li>\n<li>OTHER_CARD_TYPE 其他证件</li></ul>\n\n\n\n\n注: `其他证件类型为白名单功能，使用前请联系对接的客户经理沟通。`",
+          "document": "签署方经办人的证件类型，支持以下类型，样式可以参考<a href=\"https://qian.tencent.com/developers/partner/id_card_support/\" target=\"_blank\">常见个人证件类型介绍</a>\n<ul><li>ID_CARD 中国大陆居民身份证  (默认值)</li>\n<li>HONGKONG_AND_MACAO 港澳居民来往内地通行证</li>\n<li>HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)</li>\n<li>OTHER_CARD_TYPE 其他证件</li></ul>\n\n\n\n\n注: \n1. <b>其他证件类型为白名单功能</b>，使用前请联系对接的客户经理沟通。\n2. 港澳居民来往内地通行证 和  港澳台居民居住证 类型的签署人<b>至少要过一次大陆的海关</b>才能使用。",
           "example": "ID_CARD",
           "member": "string",
           "name": "ApproverIdCardType",
@@ -1083,6 +1097,99 @@
       ],
       "usage": "in"
     },
+    "ArchiveDynamicApproverData": {
+      "document": "动态签署2.0合同参与人信息",
+      "members": [
+        {
+          "disabled": false,
+          "document": "签署参与人在本流程中的编号ID(每个流程不同)，可用此ID来定位签署参与人在本流程的签署节点，也可用于后续创建签署链接等操作。 注意：不指定该字段时默认为发起方\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "06f2bc0f1772d8deac2f92b5df61a5ac",
+          "member": "string",
+          "name": "SignId",
+          "output_required": false,
+          "required": false,
+          "type": "string",
+          "value_allowed_null": true
+        },
+        {
+          "disabled": false,
+          "document": "签署方经办人在模板中配置的参与方ID，与控件绑定，是控件的归属方，ID为32位字符串。 模板发起合同时，该参数为必填项。 文件发起合同是，该参数无需传值。 如果开发者后序用合同模板发起合同，建议保存此值，在用合同模板发起合同中需此值绑定对应的签署经办人 。\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "yDwhSUUckp3lqxlpUu6Ni3SvjJPoxxxx",
+          "member": "string",
+          "name": "RecipientId",
+          "output_required": false,
+          "required": false,
+          "type": "string",
+          "value_allowed_null": true
+        }
+      ],
+      "usage": "both"
+    },
+    "ArchiveDynamicFlowRequest": {
+      "document": "ArchiveDynamicFlow请求参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "执行本接口操作的员工信息。\n注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`",
+          "example": "无",
+          "member": "UserInfo",
+          "name": "Operator",
+          "required": true,
+          "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "合同流程ID, 为32位字符串。\n\n可登录腾讯电子签控制台，[点击查看FlowId在控制台中的位置](https://qcloudimg.tencent-cloud.cn/raw/0a83015166cfe1cb043d14f9ec4bd75e.png)",
+          "example": "yDwFmUUckpstqfvzUE1h3jo1f3cqjkGm",
+          "member": "string",
+          "name": "FlowId",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "代理企业和员工的信息。\n在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。",
+          "example": "无",
+          "member": "Agent",
+          "name": "Agent",
+          "required": false,
+          "type": "object"
+        }
+      ],
+      "type": "object"
+    },
+    "ArchiveDynamicFlowResponse": {
+      "document": "ArchiveDynamicFlow返回参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "合同流程ID",
+          "example": "yDwFmUUckpstqfvzUE1h3jo1f3cqjkGm",
+          "member": "string",
+          "name": "FlowId",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "动态签署人的参与人信息",
+          "example": "无",
+          "member": "ArchiveDynamicApproverData",
+          "name": "Approvers",
+          "output_required": false,
+          "type": "list",
+          "value_allowed_null": false
+        },
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "AuthInfoDetail": {
       "document": "企业扩展服务授权列表详情",
       "members": [
@@ -2960,6 +3067,89 @@
       ],
       "type": "object"
     },
+    "CreateDynamicFlowApproverRequest": {
+      "document": "CreateDynamicFlowApprover请求参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "执行本接口操作的员工信息。使用此接口时，必须填写userId。支持填入集团子公司经办人 userId 代发合同。注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`",
+          "example": "无",
+          "member": "UserInfo",
+          "name": "Operator",
+          "required": true,
+          "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "合同流程ID，为32位字符串",
+          "example": "无",
+          "member": "string",
+          "name": "FlowId",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "合同流程的参与方列表，最多可支持50个参与方，可在列表中指定企业B端签署方和个人C端签署方的联系和认证方式等信息，具体定义可以参考开发者中心的ApproverInfo结构体。如果合同流程是有序签署，Approvers列表中参与人的顺序就是默认的签署顺序，请确保列表中参与人的顺序符合实际签署顺序。",
+          "example": "无",
+          "member": "ApproverInfo",
+          "name": "Approvers",
+          "required": true,
+          "type": "list"
+        },
+        {
+          "disabled": false,
+          "document": "代理企业和员工的信息。在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。",
+          "example": "无",
+          "member": "Agent",
+          "name": "Agent",
+          "required": false,
+          "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "个人自动签名的使用场景包括以下, 个人自动签署(即ApproverType设置成个人自动签署时)业务此值必传：<ul><li> **E_PRESCRIPTION_AUTO_SIGN**：电子处方单（医疗自动签）  </li><li> **OTHER** :  通用场景</li></ul>注: `个人自动签名场景是白名单功能，使用前请与对接的客户经理联系沟通。`",
+          "example": "E_PRESCRIPTION_AUTO_SIGN",
+          "member": "string",
+          "name": "AutoSignScene",
+          "required": false,
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
+    "CreateDynamicFlowApproverResponse": {
+      "document": "CreateDynamicFlowApprover返回参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "合同流程ID，为32位字符串",
+          "example": "无",
+          "member": "string",
+          "name": "FlowId",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "补充动态合同签署人的结果数组",
+          "example": "无",
+          "member": "DynamicFlowApproverResult",
+          "name": "DynamicFlowApproverList",
+          "output_required": false,
+          "type": "list",
+          "value_allowed_null": false
+        },
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "CreateEmbedWebUrlRequest": {
       "document": "CreateEmbedWebUrl请求参数结构体",
       "members": [
@@ -3535,6 +3725,15 @@
           "name": "FlowDisplayType",
           "required": false,
           "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "是否开启动态签署合同：\n<ul><li> **true**：开启动态签署合同，可在签署过程中追加签署人（必须满足：1，发起方企业开启了模块化计费能力；2，发起方企业在企业应用管理中开启了动态签署人2.0能力）    。</li>\n<li> **false**：不开启动态签署合同。</li></ul>",
+          "example": "true",
+          "member": "bool",
+          "name": "OpenDynamicSignFlow",
+          "required": false,
+          "type": "bool"
         }
       ],
       "type": "object"
@@ -9657,6 +9856,45 @@
       ],
       "type": "object"
     },
+    "DynamicFlowApproverResult": {
+      "document": "动态添加签署人的结果信息",
+      "members": [
+        {
+          "disabled": false,
+          "document": "签署方角色编号\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "无",
+          "member": "string",
+          "name": "RecipientId",
+          "output_required": false,
+          "required": false,
+          "type": "string",
+          "value_allowed_null": true
+        },
+        {
+          "disabled": false,
+          "document": "签署方唯一编号\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "无",
+          "member": "string",
+          "name": "SignId",
+          "output_required": false,
+          "required": false,
+          "type": "string",
+          "value_allowed_null": true
+        },
+        {
+          "disabled": false,
+          "document": "签署方当前状态\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "无",
+          "member": "int64",
+          "name": "ApproverStatus",
+          "output_required": false,
+          "required": false,
+          "type": "int",
+          "value_allowed_null": true
+        }
+      ],
+      "usage": "both"
+    },
     "EmbedUrlOption": {
       "document": "个性化参数",
       "members": [

tccli/services/ess/v20201111/examples.json

@@ -1,5 +1,25 @@
 {
   "actions": {
+    "ArchiveDynamicFlow": [
+      {
+        "document": "所有签署方都签署完成，并且不再新增签署方时，结束该动态签署合同",
+        "input": "POST / HTTP/1.1\nHost: ess.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: ArchiveDynamicFlow\n<公共请求参数>\n\n{\n    \"Operator\": {\n        \"ClientIp\": \"1.1.1.1\",\n        \"UserId\": \"yDxZtUyKQD2JuqUuO4zjERYGxxxxxxxx\"\n    },\n    \"FlowId\": \"yDCmVUUckpufezuiUxQQFiT8Exxxxxxxx\"\n}",
+        "output": "{\n    \"Response\": {\n        \"Approvers\": [\n            {\n                \"SignId\": \"yDCmDUUckpuf0hsfUuvalvQtaxxxxxxx\",\n                \"RecipientId\": \"yDCmDUUckpuf0hseUuvalvQRmxxxxxx\"\n            }\n        ],\n        \"FlowId\": \"yDCmDUUckpuf0hsmUuvalvQyxxxxxxxxx\",\n        \"RequestId\": \"abc\"\n    }\n}",
+        "title": "结束动态签署合同"
+      },
+      {
+        "document": "未签署完成前归档",
+        "input": "POST / HTTP/1.1\nHost: ess.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: ArchiveDynamicFlow\n<公共请求参数>\n\n{\n    \"Operator\": {\n        \"UserId\": \"yDwf3UUckps8dvveUEfH3DjvMmg3ZkjQ\"\n    },\n    \"FlowId\": \"yDCjFUUckp4jkz76UoofpTx3iZ3A3C3x\"\n}",
+        "output": "{\n    \"Response\": {\n        \"Error\": {\n            \"Code\": \"OperationDenied\",\n            \"Message\": \"当前合同状态不支持归档合同,请检查后重试\"\n        },\n        \"RequestId\": \"34ded0a6-e679-4af7-a07e-ca457e388499\"\n    }\n}",
+        "title": "归档失败"
+      },
+      {
+        "document": "所有签署方签署完成后，结束动态合同",
+        "input": "POST / HTTP/1.1\nHost: ess.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: ArchiveDynamicFlow\n<公共请求参数>\n\n{\n    \"Operator\": {\n        \"UserId\": \"yDwf3UUckps8dvveUEfH3DjvMmg3ZkjQ\"\n    },\n    \"FlowId\": \"yDCjFUUckp48fiwyUyh7ukYEdXdSyJps\"\n}",
+        "output": "{\n    \"Response\": {\n        \"Approvers\": [\n            {\n                \"RecipientId\": \"yDCjFUUckp48fiwbUyh7ukYE1kRDNNN4\",\n                \"SignId\": \"yDCjFUUckp48fiwwUyh7ukYvjx5PR1e2\"\n            }\n        ],\n        \"FlowId\": \"yDCjFUUckp48fiwyUyh7ukYEdXdSyJps\",\n        \"RequestId\": \"ca0fd107-4337-4650-8236-aa3e4561f7ef\"\n    }\n}",
+        "title": "归档合同"
+      }
+    ],
     "BindEmployeeUserIdWithClientOpenId": [
       {
         "document": "传入UserId和OpenId，绑定成功。",
@@ -234,6 +254,44 @@
         "title": "创建电子文档并填充图片控件"
       }
     ],
+    "CreateDynamicFlowApprover": [
+      {
+        "document": "补充企业自动签签署人",
+        "input": "POST / HTTP/1.1\nHost: ess.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateDynamicFlowApprover\n<公共请求参数>\n\n{\n    \"Operator\": {\n        \"UserId\": \"操作人id\"\n    },\n    \"FlowId\": \"合同id\",\n    \"AutoSignScene\": \"\",\n    \"Approvers\": [\n        {\n            \"ApproverType\": 3,\n            \"OrganizationName\": \"发起方企业\",\n            \"PreReadTime\": 3,\n            \"SignComponents\": [\n                {\n                    \"ComponentPosX\": 160,\n                    \"ComponentPosY\": 160,\n                    \"ComponentWidth\": 100,\n                    \"ComponentHeight\": 100,\n                    \"FileIndex\": 0,\n                    \"ComponentType\": \"SIGN_SEAL\",\n                    \"ComponentValue\": \"yDCHZUUckpa9v4i1UuSIlP8KougrzLuQ\",\n                    \"ComponentPage\": 1\n                }\n            ]\n        }\n    ]\n}",
+        "output": "{\n    \"Response\": {\n        \"DynamicFlowApproverList\": [\n            {\n                \"ApproverStatus\": 1,\n                \"RecipientId\": \"yDCjFUUckp48f6hcUyh7ukYyfaIqHqnR\",\n                \"SignId\": \"yDCjFUUckp48f6hiUyh7ukYBjxSiGXzB\"\n            }\n        ],\n        \"FlowId\": \"yDCjFUUckp48f680Uyh7ukYy5JFb80ux\",\n        \"RequestId\": \"s1728544317709049372\"\n    }\n}",
+        "title": "补充企业自动签签署人"
+      },
+      {
+        "document": "二要素形式补充签署人",
+        "input": "POST / HTTP/1.1\nHost: ess.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateDynamicFlowApprover\n<公共请求参数>\n\n{\n    \"Operator\": {\n        \"UserId\": \"操作人id\"\n    },\n    \"FlowId\": \"合同id\",\n    \"Approvers\": [\n        {\n            \"ApproverType\": 0,\n            \"OrganizationName\": \"企业名称\",\n            \"ApproverName\": \"签署人姓名\",\n            \"ApproverMobile\": \"签署人手机号\",\n            \"PreReadTime\": 3,\n            \"SignComponents\": [\n                {\n                    \"ComponentPosX\": 260,\n                    \"ComponentPosY\": 260,\n                    \"ComponentWidth\": 100,\n                    \"ComponentHeight\": 100,\n                    \"FileIndex\": 0,\n                    \"ComponentType\": \"SIGN_SEAL\",\n                    \"ComponentPage\": 1\n                }\n            ]\n        }\n    ]\n}",
+        "output": "{\n    \"Response\": {\n        \"DynamicFlowApproverList\": [\n            {\n                \"ApproverStatus\": 1,\n                \"RecipientId\": \"yDCjFUUckp48f6hcUyh7ukYyfaIqHqnR\",\n                \"SignId\": \"yDCjFUUckp48f6hiUyh7ukYBjxSiGXzB\"\n            }\n        ],\n        \"FlowId\": \"yDCjFUUckp48f680Uyh7ukYy5JFb80ux\",\n        \"RequestId\": \"s1728544317709049372\"\n    }\n}",
+        "title": "二要素形式补充企业签署人"
+      },
+      {
+        "document": "二要素补充个人签署人",
+        "input": "POST / HTTP/1.1\nHost: ess.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateDynamicFlowApprover\n<公共请求参数>\n\n{\n    \"Operator\": {\n        \"UserId\": \"操作人id\"\n    },\n    \"FlowId\": \"合同id\",\n    \"Approvers\": [\n        {\n            \"ApproverType\": 1,\n            \"ApproverName\": \"签署人姓名\",\n            \"ApproverMobile\": \"签署人手机号\",\n            \"PreReadTime\": 3,\n            \"SignComponents\": [\n                {\n                    \"ComponentPosX\": 260,\n                    \"ComponentPosY\": 260,\n                    \"ComponentWidth\": 100,\n                    \"ComponentHeight\": 100,\n                    \"FileIndex\": 0,\n                    \"ComponentType\": \"SIGN_SEAL\",\n                    \"ComponentPage\": 1\n                }\n            ]\n        }\n    ]\n}",
+        "output": "{\n    \"Response\": {\n        \"DynamicFlowApproverList\": [\n            {\n                \"ApproverStatus\": 1,\n                \"RecipientId\": \"yDCjFUUckp48f6hcUyh7ukYyfaIqHqnR\",\n                \"SignId\": \"yDCjFUUckp48f6hiUyh7ukYBjxSiGXzB\"\n            }\n        ],\n        \"FlowId\": \"合同id\",\n        \"RequestId\": \"s1728544317709049372\"\n    }\n}",
+        "title": "二要素补充个人签署人"
+      },
+      {
+        "document": "补充个人自动签签署人",
+        "input": "POST / HTTP/1.1\nHost: ess.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateDynamicFlowApprover\n<公共请求参数>\n\n{\n    \"Operator\": {\n        \"UserId\": \"操作人id\"\n    },\n    \"FlowId\": \"合同id\",\n    \"AutoSignScene\": \"E_PRESCRIPTION_AUTO_SIGN\",\n    \"Approvers\": [\n        {\n            \"ApproverType\": 7,\n            \"ApproverName\": \"签署人姓名\",\n            \"ApproverMobile\": \"签署人手机号\",\n            \"PreReadTime\": 3,\n            \"SignComponents\": [\n                {\n                    \"ComponentPosX\": 360,\n                    \"ComponentPosY\": 360,\n                    \"ComponentWidth\": 100,\n                    \"ComponentHeight\": 100,\n                    \"FileIndex\": 0,\n                    \"ComponentType\": \"SIGN_SIGNATURE\",\n                    \"ComponentPage\": 1\n                }\n            ]\n        }\n    ]\n}",
+        "output": "{\n    \"Response\": {\n        \"DynamicFlowApproverList\": [\n            {\n                \"ApproverStatus\": 1,\n                \"RecipientId\": \"yDCjFUUckp48f6hcUyh7ukYyfaIqHqnR\",\n                \"SignId\": \"yDCjFUUckp48f6hiUyh7ukYBjxSiGXzB\"\n            }\n        ],\n        \"FlowId\": \"合同id\",\n        \"RequestId\": \"s1728544317709049372\"\n    }\n}",
+        "title": "补充个人自动签签署人"
+      },
+      {
+        "document": "补充或签签署人",
+        "input": "POST / HTTP/1.1\nHost: ess.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateDynamicFlowApprover\n<公共请求参数>\n\n{\n    \"Operator\": {\n        \"UserId\": \"操作人id\"\n    },\n    \"FlowId\": \"合同id\",\n    \"AutoSignScene\": \"\",\n    \"Approvers\": [\n        {\n            \"ApproverType\": 0,\n            \"OrganizationName\": \"企业名称\",\n            \"CustomApproverTag\": \"唯一标志\",\n            \"PreReadTime\": 3,\n            \"SignComponents\": [\n                {\n                    \"ComponentPosX\": 333,\n                    \"ComponentPosY\": 333,\n                    \"ComponentWidth\": 100,\n                    \"ComponentHeight\": 100,\n                    \"FileIndex\": 0,\n                    \"ComponentType\": \"SIGN_SEAL\",\n                    \"ComponentPage\": 1\n                }\n            ]\n        }\n    ]\n}",
+        "output": "{\n    \"Response\": {\n        \"DynamicFlowApproverList\": [\n            {\n                \"ApproverStatus\": 1,\n                \"RecipientId\": \"yDCjFUUckp48f6hcUyh7ukYyfaIqHqnR\",\n                \"SignId\": \"yDCjFUUckp48f6hiUyh7ukYBjxSiGXzB\"\n            }\n        ],\n        \"FlowId\": \"合同id\",\n        \"RequestId\": \"s1728544317709049372\"\n    }\n}",
+        "title": "补充或签签署人"
+      },
+      {
+        "document": "补充动态签署人",
+        "input": "POST / HTTP/1.1\nHost: ess.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateDynamicFlowApprover\n<公共请求参数>\n\n{\n    \"Operator\": {\n        \"UserId\": \"操作人id\"\n    },\n    \"FlowId\": \"合同id\",\n    \"AutoSignScene\": \"\",\n    \"Approvers\": [\n        {\n            \"ApproverType\": 0,\n            \"ApproverOption\": {\n                \"FillType\": 1\n            },\n            \"PreReadTime\": 3,\n            \"SignComponents\": [\n                {\n                    \"ComponentPosX\": 60,\n                    \"ComponentPosY\": 360,\n                    \"ComponentWidth\": 100,\n                    \"ComponentHeight\": 100,\n                    \"FileIndex\": 0,\n                    \"ComponentType\": \"SIGN_SEAL\",\n                    \"ComponentPage\": 1\n                }\n            ]\n        }\n    ]\n}",
+        "output": "{\n    \"Response\": {\n        \"DynamicFlowApproverList\": [\n            {\n                \"ApproverStatus\": 1,\n                \"RecipientId\": \"yDCjFUUckp48f6hcUyh7ukYyfaIqHqnR\",\n                \"SignId\": \"yDCjFUUckp48f6hiUyh7ukYBjxSiGXzB\"\n            }\n        ],\n        \"FlowId\": \"合同id\",\n        \"RequestId\": \"s1728544317709049372\"\n    }\n}",
+        "title": "补充动态签署人"
+      }
+    ],
     "CreateEmbedWebUrl": [
       {
         "document": "\t\n获取合同详情嵌入WEB链接",

tccli/services/essbasic/essbasic_client.py

@@ -3867,6 +3867,58 @@ def doChannelCreateUserAutoSignSealUrl(args, parsed_globals):
     FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
 
 
+def doCreateChannelSubOrganizationActive(args, parsed_globals):
+    g_param = parse_global_arg(parsed_globals)
+
+    if g_param[OptionsDefine.UseCVMRole.replace('-', '_')]:
+        cred = credential.CVMRoleCredential()
+    elif g_param[OptionsDefine.RoleArn.replace('-', '_')] and g_param[OptionsDefine.RoleSessionName.replace('-', '_')]:
+        cred = credential.STSAssumeRoleCredential(
+            g_param[OptionsDefine.SecretId], g_param[OptionsDefine.SecretKey], g_param[OptionsDefine.RoleArn.replace('-', '_')],
+            g_param[OptionsDefine.RoleSessionName.replace('-', '_')], endpoint=g_param["sts_cred_endpoint"]
+        )
+    elif os.getenv(OptionsDefine.ENV_TKE_REGION)             and os.getenv(OptionsDefine.ENV_TKE_PROVIDER_ID)             and os.getenv(OptionsDefine.ENV_TKE_WEB_IDENTITY_TOKEN_FILE)             and os.getenv(OptionsDefine.ENV_TKE_ROLE_ARN):
+        cred = credential.DefaultTkeOIDCRoleArnProvider().get_credentials()
+    else:
+        cred = credential.Credential(
+            g_param[OptionsDefine.SecretId], g_param[OptionsDefine.SecretKey], g_param[OptionsDefine.Token]
+        )
+    http_profile = HttpProfile(
+        reqTimeout=60 if g_param[OptionsDefine.Timeout] is None else int(g_param[OptionsDefine.Timeout]),
+        reqMethod="POST",
+        endpoint=g_param[OptionsDefine.Endpoint],
+        proxy=g_param[OptionsDefine.HttpsProxy.replace('-', '_')]
+    )
+    profile = ClientProfile(httpProfile=http_profile, signMethod="HmacSHA256")
+    if g_param[OptionsDefine.Language]:
+        profile.language = g_param[OptionsDefine.Language]
+    mod = CLIENT_MAP[g_param[OptionsDefine.Version]]
+    client = mod.EssbasicClient(cred, g_param[OptionsDefine.Region], profile)
+    client._sdkVersion += ("_CLI_" + __version__)
+    models = MODELS_MAP[g_param[OptionsDefine.Version]]
+    model = models.CreateChannelSubOrganizationActiveRequest()
+    model.from_json_string(json.dumps(args))
+    start_time = time.time()
+    while True:
+        rsp = client.CreateChannelSubOrganizationActive(model)
+        result = rsp.to_json_string()
+        try:
+            json_obj = json.loads(result)
+        except TypeError as e:
+            json_obj = json.loads(result.decode('utf-8'))  # python3.3
+        if not g_param[OptionsDefine.Waiter] or search(g_param['OptionsDefine.WaiterInfo']['expr'], json_obj) == g_param['OptionsDefine.WaiterInfo']['to']:
+            break
+        cur_time = time.time()
+        if cur_time - start_time >= g_param['OptionsDefine.WaiterInfo']['timeout']:
+            raise ClientError('Request timeout, wait `%s` to `%s` timeout, last request is %s' %
+            (g_param['OptionsDefine.WaiterInfo']['expr'], g_param['OptionsDefine.WaiterInfo']['to'],
+            search(g_param['OptionsDefine.WaiterInfo']['expr'], json_obj)))
+        else:
+            print('Inquiry result is %s.' % search(g_param['OptionsDefine.WaiterInfo']['expr'], json_obj))
+        time.sleep(g_param['OptionsDefine.WaiterInfo']['interval'])
+    FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
+
+
 def doGenerateOrganizationSeal(args, parsed_globals):
     g_param = parse_global_arg(parsed_globals)
 
@@ -6866,6 +6918,7 @@ ACTION_MAP = {
     "ChannelGetTaskResultApi": doChannelGetTaskResultApi,
     "DescribeSubOrganizations": doDescribeSubOrganizations,
     "ChannelCreateUserAutoSignSealUrl": doChannelCreateUserAutoSignSealUrl,
+    "CreateChannelSubOrganizationActive": doCreateChannelSubOrganizationActive,
     "GenerateOrganizationSeal": doGenerateOrganizationSeal,
     "DescribeFileIdsByCustomIds": doDescribeFileIdsByCustomIds,
     "DescribeTemplates": doDescribeTemplates,

tccli/services/essbasic/v20210526/api.json

@@ -343,6 +343,13 @@
       "output": "CreateChannelOrganizationInfoChangeUrlResponse",
       "status": "online"
     },
+    "CreateChannelSubOrganizationActive": {
+      "document": "激活或续期子客企业， 在激活状态下，企业可以正常发起合同；在非激活状态下，企业仅能查看和签署合同。\n\n**1. 激活**：使用一个许可证将子客企业从未激活状态转变为激活状态。**激活状态的有效期为一年，一年后将自动回到未激活状态**。\n\n**2. 续期**：使用一个许可证将已激活的子客企业的有效期延长一年。只有处于激活状态的子企业才能进行续期操作（**若处于非激活状态，则需先激活**）。您可以使用多个许可证对同一子客企业进行多次续费。\n\n\n该接口的效果同：**【企业应用管理】 -> 【子客企业管理】 -> 【激活】或者【续期】**\n\n![image](https://qcloudimg.tencent-cloud.cn/raw/cd63761ca6e814c64b4ecf131555b74e.png)\n\n\n如果不想调用此接口或者页面点击进行激活或续期，可以在【应用扩展服务】中打开自动激活或续期，在许可证充足的情况下会自动激活或续期子客企业\n\n![image](https://qcloudimg.tencent-cloud.cn/raw/2ccb37ef6bde463c15c39fdda789216f.png)",
+      "input": "CreateChannelSubOrganizationActiveRequest",
+      "name": "激活或者续期子企业",
+      "output": "CreateChannelSubOrganizationActiveResponse",
+      "status": "online"
+    },
     "CreateConsoleLoginUrl": {
       "document": "此接口（CreateConsoleLoginUrl）用于创建第三方平台子客企业控制台Web/移动登录链接。支持web控制台、电子签小程序和H5链接。登录链接是进入子客web企业控制台的唯一入口。\n\nWeb链接访问后，会根据子客企业(**Agent中ProxyOrganizationOpenId表示**)和员工(**Agent中OpenId表示**)的状态，进入不同的流程，主要情况分类如下：\n<table>\n<thead>\n<tr>\n<th>子客企业状态</th>\n<th>子客企业员工状态</th>\n<th>点击链接进入的流程</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>企业未激活</td>\n<td>员工未认证</td>\n<td>进入企业激活流程，首次完成企业激活流程的员工会成为超管</td>\n</tr>\n<tr>\n<td>企业已激活</td>\n<td>员工未认证</td>\n<td>进入员工认证并加入企业流程</td>\n</tr>\n<tr>\n<td>企业已激活</td>\n<td>员工已认证</td>\n<td>进入子客企业Web控制台</td>\n</tr>\n</tbody>\n</table>\n如果是企业激活流程，需要注意如下情况：\n\n1. 若在激活过程中，**更换用户OpenID重新生成链接，之前的认证会被清理**。因此不要在企业认证过程生成多个链接给多人同时操作，会导致认证过程互相影响。\n2. 若您认证中发现信息有误需要重新认证，**可通过更换用户OpenID重新生成链接的方式，来清理掉已有的流程**。\n\n系统的渠道企业, 应用, 子客企业, 子客员工的组织形式\n![image](https://qcloudimg.tencent-cloud.cn/raw/77677faeea26c9d7f37474597c81fe01.png)\n\n\n<font color=\"red\">相关视频指引</font> <br>\n1. <a href=\"https://dyn.ess.tencent.cn/guide/apivideo/essbasic-createconsoleloginin.mp4\" target=\"_blank\">【生成子客登录链接】代码编写 &  子企业认证示例</a><br>",
       "input": "CreateConsoleLoginUrlRequest",
@@ -5110,6 +5117,28 @@
           "required": false,
           "type": "string",
           "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "子企业激活状态。值如下：\n<ul>\n  <li>**0**： 未激活</li>\n  <li>**1**： 已激活</li>\n</ul>",
+          "example": "0",
+          "member": "int64",
+          "name": "ActiveStatus",
+          "output_required": false,
+          "required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "账号过期时间，时间戳",
+          "example": "无",
+          "member": "int64",
+          "name": "LicenseExpireTime",
+          "output_required": false,
+          "required": false,
+          "type": "int",
+          "value_allowed_null": false
         }
       ],
       "usage": "both"
@@ -6191,6 +6220,51 @@
       ],
       "type": "object"
     },
+    "CreateChannelSubOrganizationActiveRequest": {
+      "document": "CreateChannelSubOrganizationActive请求参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。\n\n此接口下面信息必填。\n<ul>\n<li>渠道应用标识:  Agent.AppId</li>\n<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>\n<li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>\n</ul>\n第三方平台子客企业和员工必须已经经过实名认证",
+          "example": "无",
+          "member": "Agent",
+          "name": "Agent",
+          "required": true,
+          "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "要进行激活或者续期的子客企业OrganizationOpenId列表，请确保所有列出的子客企业均已完成认证。",
+          "example": "无",
+          "member": "string",
+          "name": "SubOrganizationOpenIds",
+          "required": false,
+          "type": "list"
+        },
+        {
+          "disabled": false,
+          "document": "操作类型，可以选择如下：\n\n**false**：（默认）激活子客企业\n**true**：续期子客企业\n",
+          "example": "无",
+          "member": "bool",
+          "name": "Renew",
+          "required": false,
+          "type": "bool"
+        }
+      ],
+      "type": "object"
+    },
+    "CreateChannelSubOrganizationActiveResponse": {
+      "document": "CreateChannelSubOrganizationActive返回参数结构体",
+      "members": [
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "CreateConsoleLoginUrlRequest": {
       "document": "CreateConsoleLoginUrl请求参数结构体",
       "members": [

tccli/services/essbasic/v20210526/examples.json

@@ -782,6 +782,20 @@
         "title": "创建超管变更链接（小程序链接）"
       }
     ],
+    "CreateChannelSubOrganizationActive": [
+      {
+        "document": "org_zhangsan和org_lisi两个企业已经是激活态，现在花费两个许可证给两个子客企业分别再续期1年",
+        "input": "POST / HTTP/1.1\nHost: essbasic.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateChannelSubOrganizationActive\n<公共请求参数>\n\n{\n    \"Agent\": {\n        \"AppId\": \"yDwhxUUckp3gl8j5UuFX33LSNozpRsbi\",\n        \"ProxyOrganizationOpenId\": \"org_dianziqian\",\n        \"ProxyOperator\": {\n            \"OpenId\": \"n9527\"\n        }\n    },\n    \"SubOrganizationOpenIds\": [\n        \"org_zhangsan\",\n        \"org_lisi\"\n    ],\n    \"Renew\": true\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"00f08f1c-3823-44c3-8cd1-4e66a0587ab4\"\n    }\n}",
+        "title": "子客续期"
+      },
+      {
+        "document": "org_zhangsan和org_lisi两个企业现在是非激活态（可能是过期，也可能是没有激活过），现在花费两个许可证激活这两个子客企业",
+        "input": "POST / HTTP/1.1\nHost: essbasic.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateChannelSubOrganizationActive\n<公共请求参数>\n\n{\n    \"Agent\": {\n        \"AppId\": \"yDwhxUUckp3gl8j5UuFX33LSNozpRsbi\",\n        \"ProxyOrganizationOpenId\": \"org_dianziqian\",\n        \"ProxyOperator\": {\n            \"OpenId\": \"n9527\"\n        }\n    },\n    \"SubOrganizationOpenIds\": [\n        \"org_zhangsan\",\n        \"org_lisi\"\n    ]\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"00f08f1c-3823-44c3-8cd1-4e66a0587ab4\"\n    }\n}",
+        "title": "子客激活"
+      }
+    ],
     "CreateConsoleLoginUrl": [
       {
         "document": "如果<b>典子谦示例企业的员工张三已经完成了认证和加入企业</b>，  此时给典子谦示例企业的员工张三生成登录的PC控制台的链接\n\n典子谦示例企业的定义标识为：org_dianziqian\n员工张三定义员工标识为：n9527\n",

tccli/services/lke/v20231130/api.json

@@ -1975,7 +1975,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "文件类型。支持的文件类型：PDF、DOCX、DOC、XLS、XLSX、PPT、PPTX、PNG、JPG、JPEG、CSV",
+          "document": "文件类型。支持的文件类型：PDF、DOC、DOCX、PPT、PPTX、MD、TXT、XLS、XLSX、CSV、PNG、JPG、JPEG、BMP、GIF、WEBP、HEIC、EPS、ICNS、IM、PCX、PPM、TIFF、XBM、HEIF、JP2",
           "example": "PDF",
           "member": "string",
           "name": "FileType",