tccli 3.0.1276.1__py2.py3-none-any.whl → 3.0.1278.1__py2.py3-none-any.whl

tccli/services/ess/v20201111/api.json

@@ -168,6 +168,13 @@
       "output": "CreateFlowEvidenceReportResponse",
       "status": "online"
     },
+    "CreateFlowForwards": {
+      "document": "该接口用于将合同中本企业当前经办人转为本企业其他员工进行操作。\n\n注意：\n1. 转交的目标经办人需要已经加入企业，且完成实名。\n2. 仅企业拥有`超管`、`法人`或者`合同管理员`角色的员工才有调用本接口的权限。如果使用主带子方式调用，请确保您已经加入子企业，且账号在子企业中担任任一上述角色。\n3. 仅支持当前经办人为待签署或待填写状态时进行转交操作。\n4. 若原合同有填写控件，且当前经办人已经完成填写，则不支持进行转交。\n5. 若当前经办人已签署完成，或者处于签署流程中，则不支持进行转交。",
+      "input": "CreateFlowForwardsRequest",
+      "name": "变更本企业待签合同的经办人",
+      "output": "CreateFlowForwardsResponse",
+      "status": "online"
+    },
     "CreateFlowGroupByFiles": {
       "document": "此接口（CreateFlowGroupByFiles）可用于通过多个文件创建合同组签署流程。使用该接口需要先依赖[多文件上传](https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles)接口返回的FileIds。\n\n- 该接口允许通过PDF资源ID一次性创建多个合同，这些合同被组织在一个合同组中。\n- 每个签署方将收到一个签署链接，通过这个链接可以访问并签署合同组中的所有合同。\n- 合同组中的合同必须作为一个整体进行签署，不能将合同组拆分成单独的合同进行逐一签署。\n\n<img src=\"https://qcloudimg.tencent-cloud.cn/raw/a63074a0293c9ff5bf6c0bb74c0d3b20.png\"   width=\"400\" />\n\n### 2. 适用场景\n\n该接口适用于需要一次性完成多份合同签署的情况，多份合同一般具有关联性，用户以目录的形式查看合同。\n\n\n### 3. 合同额度的扣减与返还\n- **扣减时机**：合同一旦发起，相关的合同额度就会被扣减，合同组下面的每个合同都要扣减一个合同额度。\n- **返还条件**：只有在合同被撤销且没有任何签署方签署过，或者只有自动签署的情况下，合同额度才会被返还。\n- **不返还的情况**：如果合同已过期、被拒签、签署完成或已解除，合同额度将不会被返还。\n\n### 4.合同组暂不支持抄送功能",
       "input": "CreateFlowGroupByFilesRequest",
@@ -4134,6 +4141,80 @@
       ],
       "type": "object"
     },
+    "CreateFlowForwardsRequest": {
+      "document": "CreateFlowForwards请求参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "执行本接口操作的员工信息。注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`",
+          "example": "无",
+          "member": "UserInfo",
+          "name": "Operator",
+          "required": true,
+          "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "合同对应参与方需要修改的目标经办人。其UserId可在企业控制台中组织管理里面找到。或者使用获取员工信息接口得到。\n\n注意：`需要保证目标经办人已经加入企业且已实名`",
+          "example": "无",
+          "member": "string",
+          "name": "TargetUserId",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "企业签署方的合同及对应签署方",
+          "example": "无",
+          "member": "FlowForwardInfo",
+          "name": "FlowForwardInfos",
+          "required": true,
+          "type": "list"
+        },
+        {
+          "disabled": false,
+          "document": "代理企业和员工的信息。在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。",
+          "example": "无",
+          "member": "Agent",
+          "name": "Agent",
+          "required": false,
+          "type": "object"
+        }
+      ],
+      "type": "object"
+    },
+    "CreateFlowForwardsResponse": {
+      "document": "CreateFlowForwards返回参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "失败的合同id以及错误详情",
+          "example": "无",
+          "member": "FlowForwardResult",
+          "name": "FailedFlows",
+          "output_required": false,
+          "type": "list",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "成功的合同id",
+          "example": "无",
+          "member": "string",
+          "name": "SuccessFlows",
+          "output_required": false,
+          "type": "list",
+          "value_allowed_null": false
+        },
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "CreateFlowGroupByFilesRequest": {
       "document": "CreateFlowGroupByFiles请求参数结构体",
       "members": [
@@ -10735,23 +10816,23 @@
       "members": [
         {
           "disabled": false,
-          "document": "员工在电子签的userId\n注意：此字段可能返回 null，表示取不到有效值。",
+          "document": "员工在电子签的userId",
           "example": "yDxVwUyKQWho8CUuO4zjEyQOAgwvr4Zy",
           "member": "string",
           "name": "UserId",
           "output_required": true,
           "type": "string",
-          "value_allowed_null": true
+          "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "员工在第三方平台的openId\n注意：此字段可能返回 null，表示取不到有效值。",
+          "document": "员工在第三方平台的openId",
           "example": "n9527",
           "member": "string",
           "name": "OpenId",
           "output_required": true,
           "type": "string",
-          "value_allowed_null": true
+          "value_allowed_null": false
         },
         {
           "disabled": false,
@@ -11847,6 +11928,56 @@
       ],
       "usage": "out"
     },
+    "FlowForwardInfo": {
+      "document": "合同转交相关信息",
+      "members": [
+        {
+          "disabled": false,
+          "document": "合同流程ID，为32位字符串。此接口的合同流程ID需要由[创建签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow)接口创建得到。",
+          "example": "yDCVNUUckpw3nnnyUVScgTvSA1IaZgM7",
+          "member": "string",
+          "name": "FlowId",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "签署方经办人在合同中的参与方ID，为32位字符串。",
+          "example": "yDtwEUUckp7f8w6uUuBHsZJd9KcpXpMH",
+          "member": "string",
+          "name": "RecipientId",
+          "required": true,
+          "type": "string"
+        }
+      ],
+      "usage": "in"
+    },
+    "FlowForwardResult": {
+      "document": "转交合同结果",
+      "members": [
+        {
+          "disabled": false,
+          "document": "合同流程ID为32位字符串。您可以登录腾讯电子签控制台，在 \"合同\" -> \"合同中心\" 中查看某个合同的FlowId（在页面中展示为合同ID）。[点击查看FlowId在控制台中的位置](https://qcloudimg.tencent-cloud.cn/raw/0a83015166cfe1cb043d14f9ec4bd75e.png)。",
+          "example": "yDwFmUUckpstqfvzUE1h3jo1f3cqjkGm",
+          "member": "string",
+          "name": "FlowId",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "如果失败，返回的错误细节。",
+          "example": "合同目标转出参与方非本企业员工，请检查",
+          "member": "string",
+          "name": "ErrorDetail",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        }
+      ],
+      "usage": "out"
+    },
     "FlowGroupApproverInfo": {
       "document": "合同组相关信息，指定合同组子合同和签署方的信息，用于补充动态签署人。",
       "members": [
@@ -12633,13 +12764,13 @@
       "members": [
         {
           "disabled": false,
-          "document": "意愿核身结果详细数据，与每段点头确认过程一一对应\n注意：此字段可能返回 null，表示取不到有效值。",
+          "document": "意愿核身结果详细数据，与每段点头确认过程一一对应",
           "example": "无",
           "member": "IntentionActionResultDetail",
           "name": "Details",
           "output_required": false,
           "type": "list",
-          "value_allowed_null": true
+          "value_allowed_null": false
         }
       ],
       "usage": "out"

tccli/services/ess/v20201111/examples.json

@@ -275,13 +275,13 @@
       },
       {
         "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            \"ApproverType\": 0,\n            \"OrganizationName\": \"企业名称\",\n            \"ApproverName\": \"签署人姓名\",\n            \"ApproverMobile\": \"签署人手机号\",\n            \"PreReadTime\": 3,\n            \"SignComponents\": [{\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    ]\n}\n",
+        "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            \"ApproverType\": 1,\n            \"ApproverName\": \"签署人姓名\",\n            \"ApproverMobile\": \"签署人手机号\",\n            \"PreReadTime\": 3,\n            \"SignComponents\": [{\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    ]\n}",
+        "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": "二要素补充个人签署人"
       },
@@ -612,6 +612,14 @@
         "title": "错误示例：流程未签署完，请求出证失败"
       }
     ],
+    "CreateFlowForwards": [
+      {
+        "document": "将当前合同经办人转为其他员工",
+        "input": "POST / HTTP/1.1\nHost: ess.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateFlowForwards\n<公共请求参数>\n\n{\n    \"TargetUserId\": \"yDCkSUUck******************BQnKvKPVf\",\n    \"FlowForwardInfos\": [\n        {\n            \"FlowId\": \"yDtSPUU**********************PHG7JhZM\",\n            \"RecipientId\": \"yDtSPUU******************os8flxcvLpj\"\n        },\n        {\n            \"FlowId\": \"yDtSPUU**********************PHG7s8flx\",\n            \"RecipientId\": \"yDtSPUU******************oSPUxSP\"\n        }\n    ],\n    \"Operator\": {\n        \"UserId\": \"yDtSPUU******************p4z5lt9UuY\",\n        \"ClientIp\": \"116.211.195.11\"\n    }\n}",
+        "output": "{\n    \"Response\": {\n        \"FailedFlows\": [\n            {\n                \"ErrorDetail\": \"转发人状态非待签署或待填写，禁止转发\",\n                \"FlowId\": \"yDtSPUU**********************PHG7JhZM\"\n            }\n        ],\n        \"RequestId\": \"s1740641173120185806\",\n        \"SuccessFlows\": [\n            \"yDtSPUU**********************PHG7s8flx\"\n        ]\n    }\n}",
+        "title": "将当前合同经办人转为其他员工"
+      }
+    ],
     "CreateFlowGroupByFiles": [
       {
         "document": "1. 子合同1为B2B合同（Approvers中包含两个ApproverInfo元素）；\n2. 子合同1的发起方企业自动签署（ApproverType设置为3，SIGN_SEAL对应签署控件的ComponentValue设置为自动签署使用的印章Id）；\n3. 子合同2为普通B2B合同（Approvers中包含两个ApproverInfo元素，且ApproverType都是0）；\n4. 子合同3为普通B2C合同（Approvers中包含两个ApproverInfo元素，C端签署人的ApproverType为1）。",
@@ -1381,7 +1389,7 @@
       },
       {
         "document": "",
-        "input": "POST / HTTP/1.1\nHost: ess.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeExtendedServiceAuthDetail\n<公共请求参数>\n\n{\n    \"Operator\": {\n        \"UserId\": \"yDwf3UUckps8dvveUEfH3DjvMmg3ZkjQ\"\n    },\n    \"ExtendServiceType\": \"OPEN_SERVER_SIGN\",\n    \"Agent\": {},\n    \"Limit\": 10,\n    \"Offset\": 0\n}",
+        "input": "POST / HTTP/1.1\nHost: ess.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeExtendedServiceAuthDetail\n<公共请求参数>\n\n{\n    \"Operator\": {\n        \"UserId\": \"yDwf3UUckps8dvveUEfH3DjvMmg3ZkjQ\"\n    },\n    \"ExtendServiceType\": \"BATCH_SIGN\",\n    \"Agent\": {},\n    \"Limit\": 10,\n    \"Offset\": 0\n}",
         "output": "{\n    \"Response\": {\n        \"AuthInfoDetail\": {\n            \"AuthOrganizationTotal\": 0,\n            \"AuthUserTotal\": 1,\n            \"HasAuthOrganizationList\": [],\n            \"HasAuthUserList\": [\n                {\n                    \"BelongTo\": \"CurrentOrg\",\n                    \"MainOrganizationId\": \"\",\n                    \"UserId\": \"yDxjKxxxxxxxx4zjESzn1dvkm5\"\n                }\n            ],\n            \"Name\": \"批量签署\",\n            \"Type\": \"BATCH_SIGN\"\n        },\n        \"RequestId\": \"d03c95cb-82f4-488a-a832-4ced6e367a54\"\n    }\n}",
         "title": "查询企业扩展服务授权详情-批量签署"
       }

tccli/services/essbasic/essbasic_client.py

@@ -4491,6 +4491,58 @@ def doUploadFiles(args, parsed_globals):
     FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
 
 
+def doCreateFlowForwards(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.CreateFlowForwardsRequest()
+    model.from_json_string(json.dumps(args))
+    start_time = time.time()
+    while True:
+        rsp = client.CreateFlowForwards(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 doChannelCreateFlowSignUrl(args, parsed_globals):
     g_param = parse_global_arg(parsed_globals)
 
@@ -7346,6 +7398,7 @@ ACTION_MAP = {
     "DescribeTemplates": doDescribeTemplates,
     "ChannelCancelUserAutoSignEnableUrl": doChannelCancelUserAutoSignEnableUrl,
     "UploadFiles": doUploadFiles,
+    "CreateFlowForwards": doCreateFlowForwards,
     "ChannelCreateFlowSignUrl": doChannelCreateFlowSignUrl,
     "VerifySubOrganization": doVerifySubOrganization,
     "ArchiveFlow": doArchiveFlow,

tccli/services/essbasic/v20210526/api.json

@@ -413,6 +413,13 @@
       "output": "CreateFlowBlockchainEvidenceUrlResponse",
       "status": "online"
     },
+    "CreateFlowForwards": {
+      "document": "该接口用于将合同中本企业当前经办人转为本企业其他员工进行操作。\n\n注意：\n1. 转交的目标经办人需要已经加入企业，且完成实名。\n2. 仅企业拥有`超管`或`法人角色`的员工才有调用本接口的权限。\n3. 仅支持当前经办人为待签署或待填写状态时进行转交操作。\n4. 若原合同有填写控件，且当前经办人已经完成填写，则不支持进行转交。\n5. 若当前经办人已签署完成，或者处于签署流程中，则不支持进行转交。",
+      "input": "CreateFlowForwardsRequest",
+      "name": "变更本企业待签合同的经办人",
+      "output": "CreateFlowForwardsResponse",
+      "status": "online"
+    },
     "CreateFlowGroupSignReview": {
       "document": "1. 在使用[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByFiles)或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates)创建合同组签署流程时，若指定了参数以下参数为true,则可以调用此接口提交企业内部签署审批结果,即使是自动签署也需要进行审核通过才会进行签署。\n  - [FlowInfo.NeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowinfo)\n  - [FlowFileInfo.NeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowfileinfo)\n  - [FlowApproverInfo.ApproverNeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowapproverinfo) \n\n2. 同一合同组，同一签署人可以多次提交签署审批结果，签署时的最后一个“审批结果”有效。",
       "input": "CreateFlowGroupSignReviewRequest",
@@ -7271,6 +7278,71 @@
       ],
       "type": "object"
     },
+    "CreateFlowForwardsRequest": {
+      "document": "CreateFlowForwards请求参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "合同对应参与方需要修改的目标经办人对应的OpenId。\n\n注意：`需要保证目标经办人已经加入企业且已实名`",
+          "example": "无",
+          "member": "string",
+          "name": "TargetOpenId",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "企业签署方的合同及对应签署方",
+          "example": "无",
+          "member": "FlowForwardInfo",
+          "name": "FlowForwardInfos",
+          "required": true,
+          "type": "list"
+        },
+        {
+          "disabled": false,
+          "document": "关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。此接口下面信息必填。<ul><li>渠道应用标识:  Agent.AppId</li><li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li><li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li></ul>第三方平台子客企业和员工必须已经经过实名认证",
+          "example": "无",
+          "member": "Agent",
+          "name": "Agent",
+          "required": true,
+          "type": "object"
+        }
+      ],
+      "type": "object"
+    },
+    "CreateFlowForwardsResponse": {
+      "document": "CreateFlowForwards返回参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "失败的合同id以及错误详情",
+          "example": "无",
+          "member": "FlowForwardResult",
+          "name": "FailedFlows",
+          "output_required": false,
+          "type": "list",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "成功的合同id",
+          "example": "yDtSPUUckpxlb************Hyr2w74",
+          "member": "string",
+          "name": "SuccessFlows",
+          "output_required": false,
+          "type": "list",
+          "value_allowed_null": false
+        },
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "CreateFlowGroupSignReviewRequest": {
       "document": "CreateFlowGroupSignReview请求参数结构体",
       "members": [
@@ -10462,6 +10534,56 @@
       ],
       "usage": "in"
     },
+    "FlowForwardInfo": {
+      "document": "合同转交相关信息",
+      "members": [
+        {
+          "disabled": false,
+          "document": "合同流程ID，为32位字符串。此接口的合同流程ID需要由[创建签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow)接口创建得到。",
+          "example": "yDCVNUUckpw3nnnyUVScgTvSA1IaZgM7",
+          "member": "string",
+          "name": "FlowId",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "签署方经办人在合同中的参与方ID，为32位字符串。",
+          "example": "yDtwEUUckp7f8w6uUuBHsZJd9KcpXpMH",
+          "member": "string",
+          "name": "RecipientId",
+          "required": true,
+          "type": "string"
+        }
+      ],
+      "usage": "in"
+    },
+    "FlowForwardResult": {
+      "document": "转交合同结果",
+      "members": [
+        {
+          "disabled": false,
+          "document": "合同流程ID为32位字符串。您可以登录腾讯电子签控制台，在 \"合同\" -> \"合同中心\" 中查看某个合同的FlowId（在页面中展示为合同ID）。[点击查看FlowId在控制台中的位置](https://qcloudimg.tencent-cloud.cn/raw/0a83015166cfe1cb043d14f9ec4bd75e.png)。",
+          "example": "yDwFmUUckpstqfvzUE1h3jo1f3cqjkGm",
+          "member": "string",
+          "name": "FlowId",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "如果失败，返回的错误细节。",
+          "example": "合同目标转出参与方非本企业员工",
+          "member": "string",
+          "name": "ErrorDetail",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        }
+      ],
+      "usage": "out"
+    },
     "FlowGroupApproverInfo": {
       "document": "合同组相关信息，指定合同组子合同和签署方的信息，用于补充动态签署人。",
       "members": [

tccli/services/essbasic/v20210526/examples.json

@@ -922,6 +922,14 @@
         "title": "生成合同区块链存证证书查看二维码/链接"
       }
     ],
+    "CreateFlowForwards": [
+      {
+        "document": "将当前合同经办人转为其他员工",
+        "input": "POST / HTTP/1.1\nHost: essbasic.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateFlowForwards\n<公共请求参数>\n\n{\n    \"Agent\": {\n        \"AppId\": \"yDwhxUUckp3gl8j5UuFX33LSNozpRsbi\",\n        \"ProxyOrganizationOpenId\": \"org_dianziqian\",\n        \"ProxyOperator\": {\n            \"OpenId\": \"n9527\"\n        },\n        \"ProxyAppId\": \"\"\n    },\n    \"TargetOpenId\": \"open_id_1\",\n    \"FlowForwardInfos\": [\n        {\n            \"FlowId\": \"yDtSPUU**********************PHG7JhZM\",\n            \"RecipientId\": \"yDtSPUU******************os8flxcvLpj\"\n        },\n        {\n            \"FlowId\": \"yDtSPUU**********************PHG7s8flx\",\n            \"RecipientId\": \"yDtSPUU******************oSPUxSP\"\n        }\n    ]\n}",
+        "output": "{\n    \"Response\": {\n        \"FailedFlows\": [\n            {\n                \"ErrorDetail\": \"转发人状态非待签署或待填写，禁止转发\",\n                \"FlowId\": \"yDtSPUU**********************PHG7JhZM\"\n            }\n        ],\n        \"RequestId\": \"s1740641173120185806\",\n        \"SuccessFlows\": [\n            \"yDtSPUU**********************PHG7s8flx\"\n        ]\n    }\n}",
+        "title": "将当前合同经办人转为其他员工"
+      }
+    ],
     "CreateFlowGroupSignReview": [
       {
         "document": "1.签署审核通过企业签署人（ApproverType 设置为PERSON）\n2.使用 姓名 + 手机号 定位合同组内所有子合同的该签署人\n3.拒绝（阻断）该签署人的签署操作 （ReviewType 设置为REJECT）",

tccli/services/ims/v20201229/api.json

@@ -889,6 +889,52 @@
       ],
       "usage": "out"
     },
+    "OcrHitInfo": {
+      "document": "ocr关键词命中位置信息",
+      "members": [
+        {
+          "disabled": false,
+          "document": "标识模型命中还是关键词命中",
+          "example": "Model",
+          "member": "string",
+          "name": "Type",
+          "output_required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "命中关键词",
+          "example": "啦啦",
+          "member": "string",
+          "name": "Keyword",
+          "output_required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "自定义词库名称",
+          "example": "测试词库1",
+          "member": "string",
+          "name": "LibName",
+          "output_required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "位置信息",
+          "example": "无",
+          "member": "Positions",
+          "name": "Positions",
+          "output_required": true,
+          "type": "list",
+          "value_allowed_null": false
+        }
+      ],
+      "usage": "out"
+    },
     "OcrResult": {
       "document": "用于返回OCR结果检测详情",
       "members": [
@@ -1057,6 +1103,42 @@
           "output_required": true,
           "type": "string",
           "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "关键词命中位置信息",
+          "example": "{\"Type\": \"Keyword\",   \"Keyword\": \"国家\",  \"LibName\": \"\", \"Positions\": [  {  \"Start\": 0,   \"End\": 2   }    ]    }",
+          "member": "OcrHitInfo",
+          "name": "HitInfos",
+          "output_required": false,
+          "type": "list",
+          "value_allowed_null": false
+        }
+      ],
+      "usage": "out"
+    },
+    "Positions": {
+      "document": "标识命中的违规关键词位置信息",
+      "members": [
+        {
+          "disabled": false,
+          "document": "关键词起始位置",
+          "example": "0",
+          "member": "int64",
+          "name": "Start",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "关键词结束位置",
+          "example": "10",
+          "member": "int64",
+          "name": "End",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
         }
       ],
       "usage": "out"