tccli 3.0.1133.1__py2.py3-none-any.whl → 3.0.1134.1__py2.py3-none-any.whl

tccli/services/ess/v20201111/api.json

@@ -98,6 +98,13 @@
       "output": "CreateFlowApproversResponse",
       "status": "online"
     },
+    "CreateFlowBlockchainEvidenceUrl": {
+      "document": "获取区块链存证报告查看链接/二维码接口\n\n适用场景：企业员工可以通过此接口生成合同区块链存证报告的查看链接/二维码，以供他人扫码打开腾讯电子签小程序查看。\n\n[点击查看区块链存证报告样式](https://qcloudimg.tencent-cloud.cn/raw/47d5e9c2ffa90ad4e27b3cd14095aa08.jpg)\n\n注：\n<ul><li>1. 二维码下载链接过期时间为5分钟，请尽快下载保存。二维码/短链的过期时间为<font color=\"red\">7天</font>，超过有效期则不可用。</li>\n<li>2. 合同状态需为<font color=\"red\">签署完成</font> 、<font color=\"red\">已解除</font>才能生成报告查看二维码/短链。</li>\n<li>3. 调用接口时，需确保接口调用身份拥有此合同的访问数据权限或为合同参与方。</li>\n<li>4. 通过扫码或者点击链接，用户无需登录或者鉴权即可查看对应合同的区块链存证报告，请妥善保管好二维码或链接。</li></ul>",
+      "input": "CreateFlowBlockchainEvidenceUrlRequest",
+      "name": "获取签署存证证书查看二维码",
+      "output": "CreateFlowBlockchainEvidenceUrlResponse",
+      "status": "online"
+    },
     "CreateFlowByFiles": {
       "document": "此接口（CreateFlowByFiles）用来通过上传后的pdf资源编号来创建待签署的合同流程。<br/>\n适用场景：适用非制式的合同文件签署。一般开发者自己有完整的签署文件，可以通过该接口传入完整的PDF文件及流程信息生成待签署的合同流程。<br/>\n\n<table>\n\t<thead>\n\t\t<tr>\n\t\t\t<th>签署人类别</th>\n\t\t\t<th>需要提前准备的信息</th>\n\t\t</tr>\n\t</thead>\n\t<tbody>\n\t\t<tr>\n\t\t\t<td>自己企业的员工签署（未认证加入或已认证加入）</td>\n\t\t\t<td>签署企业的名字、员工的真实名字、员工的触达手机号、员工的证件号（证件号非必传）</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>自己企业的员工签署（已认证加入）</td>\n\t\t\t<td>签署企业的名字、员工在电子签平台的ID（UserId）</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>其他企业的员工签署</td>\n\t\t\t<td>签署企业的名字、员工的真实名字、员工的触达手机号、员工的证件号（证件号非必传）</td>\n\t\t</tr>\n\t\t<tr>\n\t\t\t<td>个人（自然人）签署</td>\n\t\t\t<td>个人的真实名字、个人的触达手机号、个人的身份证（证件号非必传）</td>\n\t\t</tr>\n\t</tbody>\n</table>\n\n\n\n该接口需要依赖[上传文件](https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles)接口生成pdf资源编号（FileIds）进行使用。（如果非pdf文件需要调用[创建文件转换任务](https://qian.tencent.com/developers/companyApis/templatesAndFiles/CreateConvertTaskApi)接口转换成pdf资源）<br/>\n\n\n![image](https://qcloudimg.tencent-cloud.cn/raw/f097a74b289e3e1acd740936bdfe9843.png)\n\n注：\n-  合同**发起后就会扣减合同的额度**, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（**过期，拒签，签署完成，解除完成等状态不会返还额度**）\n- **静默（自动）签署不支持合同签署方存在填写**功能\n\n\n<font color=\"red\">相关视频指引</font> <br>\n1. <a href=\"https://dyn.ess.tencent.cn/guide/apivideo/ess_uploadfiles.mp4\" target=\"_blank\">上传用于合同发起的PDF文件代码编写示例</a><br>\n2.  <a href=\"https://dyn.ess.tencent.cn/guide/apivideo/ess-CreateFlowByFiles.mp4\" target=\"_blank\">用PDF文件创建签署流程编写示例</a><br>",
       "input": "CreateFlowByFilesRequest",
@@ -189,6 +196,13 @@
       "output": "CreateIntegrationUserRolesResponse",
       "status": "online"
     },
+    "CreateLegalSealQrCode": {
+      "document": "该接口用于获取创建法人章的二维码<br/>\n\n**注意**\n1. 该二维码**有效期为7天**，过期后将失效，可重新创建 。",
+      "input": "CreateLegalSealQrCodeRequest",
+      "name": "获取创建法人章二维码",
+      "output": "CreateLegalSealQrCodeResponse",
+      "status": "online"
+    },
     "CreateMultiFlowSignQRCode": {
       "document": "此接口（CreateMultiFlowSignQRCode）用于创建一码多签签署码。\n\n**适用场景**:\n签署人可通过扫描二维码补充签署信息进行实名签署。常用于提前不知道签署人的身份信息场景，例如：劳务工招工、大批量员工入职等场景。\n\n**注意**:\n1. 本接口适用于**发起方没有填写控件的 B2C或者单C模板**,  若是B2C模板,还要满足以下任意一个条件\n    - 模板中配置的签署顺序是无序\n    - B端企业的签署方式是静默签署\n    - B端企业是非首位签署\n2. 通过一码多签签署码发起的合同，合同涉及到的回调消息可参考文档[合同发起及签署相关回调\n]( https://qian.tencent.com/developers/company/callback_types_contracts_sign)\n3. 用户通过一码多签签署码发起合同时，因企业额度不足导致失败 会触发签署二维码相关回调,具体参考文档[签署二维码相关回调](https://qian.tencent.com/developers/company/callback_types_commons#%E7%AD%BE%E7%BD%B2%E4%BA%8C%E7%BB%B4%E7%A0%81%E7%9B%B8%E5%85%B3%E5%9B%9E%E8%B0%83)\n\n签署码的样式如下图:\n\n![image](https://qcloudimg.tencent-cloud.cn/raw/27317cf5aacb094fb1dc6f94179a5148.png )",
       "input": "CreateMultiFlowSignQRCodeRequest",
@@ -2878,6 +2892,81 @@
       ],
       "type": "object"
     },
+    "CreateFlowBlockchainEvidenceUrlRequest": {
+      "document": "CreateFlowBlockchainEvidenceUrl请求参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "执行本接口操作的员工信息。\n注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`",
+          "example": "无",
+          "member": "UserInfo",
+          "name": "Operator",
+          "required": true,
+          "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "合同流程ID，为32位字符串。\n建议开发者妥善保存此流程ID，以便于顺利进行后续操作。\n可登录腾讯电子签控制台，在 \"合同\"->\"合同中心\" 中查看某个合同的FlowId(在页面中展示为合同ID)。",
+          "example": "无",
+          "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"
+    },
+    "CreateFlowBlockchainEvidenceUrlResponse": {
+      "document": "CreateFlowBlockchainEvidenceUrl返回参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "二维码图片下载链接，下载链接有效时间5分钟，请尽快下载保存。",
+          "example": "https://file.test.ess.tencent.cn/bresource/resource/resource/0/0.JPG?hkey=5d92f0db15e6bbba6aea641f64c5c06d7914ff197f4b2b099ab565a5733",
+          "member": "string",
+          "name": "QrCode",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "查看短链，可直接点击短链查看报告。",
+          "example": "https://test.essurl.cn/SR04UBxxxx",
+          "member": "string",
+          "name": "Url",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "二维码和短链的过期时间戳，过期时间默认为生成链接后7天。",
+          "example": "无",
+          "member": "uint64",
+          "name": "ExpiredOn",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "CreateFlowByFilesRequest": {
       "document": "CreateFlowByFiles请求参数结构体",
       "members": [
@@ -4371,6 +4460,61 @@
       ],
       "type": "object"
     },
+    "CreateLegalSealQrCodeRequest": {
+      "document": "CreateLegalSealQrCode请求参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "执行本接口操作的员工信息。\n注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`",
+          "example": "无",
+          "member": "UserInfo",
+          "name": "Operator",
+          "required": false,
+          "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "代理企业和员工的信息。\n在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。",
+          "example": "无",
+          "member": "Agent",
+          "name": "Agent",
+          "required": false,
+          "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "机构信息，暂未开放",
+          "example": "无",
+          "member": "OrganizationInfo",
+          "name": "Organization",
+          "required": false,
+          "type": "object"
+        }
+      ],
+      "type": "object"
+    },
+    "CreateLegalSealQrCodeResponse": {
+      "document": "CreateLegalSealQrCode返回参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "二维码图片base64值",
+          "example": "”xxxx“",
+          "member": "string",
+          "name": "QrcodeBase64",
+          "output_required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "CreateMultiFlowSignQRCodeRequest": {
       "document": "CreateMultiFlowSignQRCode请求参数结构体",
       "members": [

tccli/services/ess/v20201111/examples.json

@@ -340,6 +340,14 @@
         "title": "错误示例， B2B签署，补充签署流程本企业企业签署人使用了姓名和手机号进行补充报错"
       }
     ],
+    "CreateFlowBlockchainEvidenceUrl": [
+      {
+        "document": "拥有访问权限的员工生成合同区块链存证报告查看二维码/链接",
+        "input": "POST / HTTP/1.1\nHost: ess.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateFlowBlockchainEvidenceUrl\n<公共请求参数>\n\n{\n    \"Operator\": {\n        \"UserId\": \"yDR0fUUgyg*********jE1RTDui4pB\"\n    },\n    \"FlowId\": \"yDCANUUc************SI8fHrn0LCd\"\n}",
+        "output": "{\n    \"Response\": {\n        \"ExpiredOn\": 1719463451,\n        \"QrCode\": \"https://file.test.ess.tencent.cn/bresource/resource/resource/0/0.JPG?hkey=5d92f0db15e6bbba6aea641f64c5c06d7914ff197f4b2b0*********27ec738d02a519c7a9f\",\n        \"RequestId\": \"s1718858684971\",\n        \"Url\": \"https://test.essurl.cn/SR0*****HF9B\"\n    }\n}",
+        "title": "生成合同区块链存证报告查看二维码/链接"
+      }
+    ],
     "CreateFlowByFiles": [
       {
         "document": "1. 处方单场景的\"典子谦\"医生需要自动签(典子谦参与人的ApproverType设置成7, 并且AutoSignScene设置成E_PRESCRIPTION_AUTO_SIGN表明是处方单场景)\n2. 处方单的患者张三需要手工签署(张三参与人的ApproverType设置成1)\n3. 双方签署方的签署控件都是通过关键字生成(典子谦签署区GenerateMode设置成KEYWORD并且ComponentId设置成关键字\"处方医生\", 张三签署区GenerateMode设置成KEYWORD并且ComponentId设置成关键字\"患者签名\" )\n4. 不给合同签署方发送短信  (NotifyType设置成NONE)",
@@ -696,6 +704,14 @@
         "title": "示例-普通企业绑定角色"
       }
     ],
+    "CreateLegalSealQrCode": [
+      {
+        "document": "获取创建法人章二维码",
+        "input": "POST / HTTP/1.1\nHost: ess.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateLegalSealQrCode\n<公共请求参数>\n\n{\n    \"Operator\": {\n        \"UserId\": \"yDwfsUUckpsqt647UE6uSrk1ZWhYH56z\"\n    }\n}",
+        "output": "{\n    \"Response\": {\n        \"QrcodeBase64\": \"xxxxxxxxx\",\n        \"RequestId\": \"3c140219-cfe9-470e-b241-907877d6fb03\"\n    }\n}",
+        "title": "获取创建法人章二维码"
+      }
+    ],
     "CreateMultiFlowSignQRCode": [
       {
         "document": "创建一码多扫流程签署二维码，指定固定的用户才能扫码签署。",

tccli/services/essbasic/essbasic_client.py

@@ -2151,6 +2151,58 @@ def doCreateChannelFlowEvidenceReport(args, parsed_globals):
     FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
 
 
+def doCreateLegalSealQrCode(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.CreateLegalSealQrCodeRequest()
+    model.from_json_string(json.dumps(args))
+    start_time = time.time()
+    while True:
+        rsp = client.CreateLegalSealQrCode(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 doChannelVerifyPdf(args, parsed_globals):
     g_param = parse_global_arg(parsed_globals)
 
@@ -3139,7 +3191,7 @@ def doDescribeFlowFiles(args, parsed_globals):
     FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
 
 
-def doDescribeFlow(args, parsed_globals):
+def doCreateFlowBlockchainEvidenceUrl(args, parsed_globals):
     g_param = parse_global_arg(parsed_globals)
 
     if g_param[OptionsDefine.UseCVMRole.replace('-', '_')]:
@@ -3168,11 +3220,11 @@ def doDescribeFlow(args, parsed_globals):
     client = mod.EssbasicClient(cred, g_param[OptionsDefine.Region], profile)
     client._sdkVersion += ("_CLI_" + __version__)
     models = MODELS_MAP[g_param[OptionsDefine.Version]]
-    model = models.DescribeFlowRequest()
+    model = models.CreateFlowBlockchainEvidenceUrlRequest()
     model.from_json_string(json.dumps(args))
     start_time = time.time()
     while True:
-        rsp = client.DescribeFlow(model)
+        rsp = client.CreateFlowBlockchainEvidenceUrl(model)
         result = rsp.to_json_string()
         try:
             json_obj = json.loads(result)
@@ -5843,6 +5895,58 @@ def doDestroyFlowFile(args, parsed_globals):
     FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
 
 
+def doDescribeFlow(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.DescribeFlowRequest()
+    model.from_json_string(json.dumps(args))
+    start_time = time.time()
+    while True:
+        rsp = client.DescribeFlow(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 doChannelCreateUserRoles(args, parsed_globals):
     g_param = parse_global_arg(parsed_globals)
 
@@ -6573,6 +6677,7 @@ ACTION_MAP = {
     "DescribeChannelSealPolicyWorkflowUrl": doDescribeChannelSealPolicyWorkflowUrl,
     "ChannelCreateOrganizationModifyQrCode": doChannelCreateOrganizationModifyQrCode,
     "CreateChannelFlowEvidenceReport": doCreateChannelFlowEvidenceReport,
+    "CreateLegalSealQrCode": doCreateLegalSealQrCode,
     "ChannelVerifyPdf": doChannelVerifyPdf,
     "GetDownloadFlowUrl": doGetDownloadFlowUrl,
     "ChannelDescribeOrganizationSeals": doChannelDescribeOrganizationSeals,
@@ -6592,7 +6697,7 @@ ACTION_MAP = {
     "ModifyExtendedService": doModifyExtendedService,
     "SendSignInnerVerifyCode": doSendSignInnerVerifyCode,
     "DescribeFlowFiles": doDescribeFlowFiles,
-    "DescribeFlow": doDescribeFlow,
+    "CreateFlowBlockchainEvidenceUrl": doCreateFlowBlockchainEvidenceUrl,
     "ChannelCreateBatchQuickSignUrl": doChannelCreateBatchQuickSignUrl,
     "ChannelDisableUserAutoSign": doChannelDisableUserAutoSign,
     "CreateBatchOrganizationRegistrationTasks": doCreateBatchOrganizationRegistrationTasks,
@@ -6644,6 +6749,7 @@ ACTION_MAP = {
     "ChannelDescribeEmployees": doChannelDescribeEmployees,
     "CreateUserAndSeal": doCreateUserAndSeal,
     "DestroyFlowFile": doDestroyFlowFile,
+    "DescribeFlow": doDescribeFlow,
     "ChannelCreateUserRoles": doChannelCreateUserRoles,
     "RejectFlow": doRejectFlow,
     "ModifyUser": doModifyUser,

tccli/services/essbasic/v20210526/api.json

@@ -343,6 +343,13 @@
       "output": "CreateConsoleLoginUrlResponse",
       "status": "online"
     },
+    "CreateFlowBlockchainEvidenceUrl": {
+      "document": "获取区块链存证报告查看链接/二维码接口\n\n适用场景：企业员工可以通过此接口生成合同区块链存证报告的查看链接/二维码，以供他人扫码打开腾讯电子签小程序查看。\n\n[点击查看区块链存证报告样式](https://qcloudimg.tencent-cloud.cn/raw/47d5e9c2ffa90ad4e27b3cd14095aa08.jpg)\n\n注：\n<ul><li>1. 二维码下载链接过期时间为5分钟，请尽快下载保存。二维码/短链的过期时间为<font color=\"red\">7天</font>，超过有效期则不可用。</li>\n<li>2. 合同状态需为<font color=\"red\">签署完成</font> 、<font color=\"red\">已解除</font>才能生成报告查看二维码/短链。</li>\n<li>3. 调用接口时，需确保接口调用身份拥有此合同的访问数据权限或为合同参与方。</li>\n<li>4. 通过扫码或者点击链接，用户无需登录或者鉴权即可查看对应合同的区块链存证报告，请妥善保管好二维码或链接。</li></ul>",
+      "input": "CreateFlowBlockchainEvidenceUrlRequest",
+      "name": "获取签署存证证书查看二维码",
+      "output": "CreateFlowBlockchainEvidenceUrlResponse",
+      "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",
@@ -357,6 +364,13 @@
       "output": "CreateFlowsByTemplatesResponse",
       "status": "online"
     },
+    "CreateLegalSealQrCode": {
+      "document": "此接口用于获取创建法人章二维码图片base64",
+      "input": "CreateLegalSealQrCodeRequest",
+      "name": "获取创建法人章二维码",
+      "output": "CreateLegalSealQrCodeResponse",
+      "status": "online"
+    },
     "CreatePartnerAutoSignAuthUrl": {
       "document": "创建他方自动签授权链接，通过该链接可进入小程序进行合作方企业的自动签授权，若当前企业未开通企业自动签，通过该链接会先引导开通本企业自动签。\n该接口效果同控制台： 企业设置-> 扩展服务 -> 企业自动签署 -> 合作企业方授权\n\n\n\n注: \n1. <font color='red'>所在企业的超管、法人才有权限调用此接口</font>(Agent.ProxyOperator.OpenId 需要传递超管或者法人的OpenId)\n2. 已经在授权中或者授权成功的企业，无法重复授权",
       "input": "CreatePartnerAutoSignAuthUrlRequest",
@@ -6199,6 +6213,72 @@
       ],
       "type": "object"
     },
+    "CreateFlowBlockchainEvidenceUrlRequest": {
+      "document": "CreateFlowBlockchainEvidenceUrl请求参数结构体",
+      "members": [
+        {
+          "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"
+        },
+        {
+          "disabled": false,
+          "document": "合同流程ID，为32位字符串。建议开发者妥善保存此流程ID，以便于顺利进行后续操作。可登录腾讯电子签控制台，在 \"合同\"->\"合同中心\" 中查看某个合同的FlowId(在页面中展示为合同ID)。",
+          "example": "无",
+          "member": "string",
+          "name": "FlowId",
+          "required": true,
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
+    "CreateFlowBlockchainEvidenceUrlResponse": {
+      "document": "CreateFlowBlockchainEvidenceUrl返回参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "二维码图片下载链接，下载链接有效时间5分钟，请尽快下载保存。",
+          "example": "https://file.test.ess.tencent.cn/bresource/resource/resource/0/0.JPG?hkey=5d92f0db15e6bbba6aea641f64c5c06d7914ff197f4b2b099ab565a5733",
+          "member": "string",
+          "name": "QrCode",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "查看短链，可直接点击短链查看报告。",
+          "example": "https://test.essurl.cn/SR04UBxxxx",
+          "member": "string",
+          "name": "Url",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "二维码和短链的过期时间戳，过期时间默认为生成链接后7天。",
+          "example": "无",
+          "member": "uint64",
+          "name": "ExpiredOn",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "CreateFlowGroupSignReviewRequest": {
       "document": "CreateFlowGroupSignReview请求参数结构体",
       "members": [
@@ -6463,6 +6543,61 @@
       ],
       "type": "object"
     },
+    "CreateLegalSealQrCodeRequest": {
+      "document": "CreateLegalSealQrCode请求参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容\n此接口下面信息必填。\n<ul>\n<li>渠道应用标识:  Agent.AppId</li>\n<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>\n<li>第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId</li>\n</ul>注:\n`1. 企业激活时， 此时的Agent.ProxyOrganizationOpenId将会是企业激活后企业的唯一标识，建议开发者保存企业ProxyOrganizationOpenId，后续各项接口调用皆需要此参数。 `\n`2. 员工认证时， 此时的Agent.ProxyOperator.OpenId将会是员工认证加入企业后的唯一标识，建议开发者保存此员工的OpenId，后续各项接口调用皆需要此参数。 `\n`3. 同渠道应用(Agent.AppId)下，企业唯一标识ProxyOrganizationOpenId需要保持唯一，员工唯一标识OpenId也要保持唯一 (而不是企业下唯一)。 `",
+          "example": "无",
+          "member": "Agent",
+          "name": "Agent",
+          "required": false,
+          "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "操作人信息",
+          "example": "无",
+          "member": "UserInfo",
+          "name": "Operator",
+          "required": false,
+          "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "企业信息",
+          "example": "无",
+          "member": "OrganizationInfo",
+          "name": "Organization",
+          "required": false,
+          "type": "object"
+        }
+      ],
+      "type": "object"
+    },
+    "CreateLegalSealQrCodeResponse": {
+      "document": "CreateLegalSealQrCode返回参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "二维码图片base64值",
+          "example": "无",
+          "member": "string",
+          "name": "QrcodeBase64",
+          "output_required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "CreatePartnerAutoSignAuthUrlRequest": {
       "document": "CreatePartnerAutoSignAuthUrl请求参数结构体",
       "members": [
@@ -7848,7 +7983,7 @@
       "members": [
         {
           "disabled": false,
-          "document": "合同详情页面是否展示合同控件信息\n<br/>true:允许在合同详情页展示控件\n<br/>false:不允许在合同详情页展示控件\n<br/>默认false,在合同详情页不展示控件",
+          "document": "合同详情预览，允许展示控件信息\n<ul>\n<li><b>true</b>：允许在合同详情页展示控件</li>\n<li><b>false</b>：（默认）不允许在合同详情页展示控件</li>\n</ul>",
           "example": "true",
           "member": "bool",
           "name": "ShowFlowDetailComponent",
@@ -7857,7 +7992,7 @@
         },
         {
           "disabled": false,
-          "document": "模版预览页面是否展示空间信息\n<br/>true:允许在模版预览页展示控件\n<br/>false:不允许在模版预览页展示控件\n<br/>默认false,在模版预览页不展示控件",
+          "document": "模板预览，允许展示模板控件信息\n<ul><li> <b>true</b> :允许在模板预览页展示控件</li>\n<li> <b>false</b> :（默认）不允许在模板预览页展示控件</li></ul>",
           "example": "true",
           "member": "bool",
           "name": "ShowTemplateComponent",

tccli/services/essbasic/v20210526/examples.json

@@ -746,6 +746,14 @@
         "title": "生成到模板详情的控制台链接"
       }
     ],
+    "CreateFlowBlockchainEvidenceUrl": [
+      {
+        "document": "拥有访问权限的员工生成合同区块链存证报告查看二维码/链接",
+        "input": "POST / HTTP/1.1\nHost: essbasic.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateFlowBlockchainEvidenceUrl\n<公共请求参数>\n\n{\n    \"Agent\": {\n        \"ProxyOperator\": {\n            \"OpenId\": \"ianc_1111\"\n        },\n        \"ProxyOrganizationOpenId\": \"ABC_organization_open_id\",\n        \"AppId\": \"16fd2f7d7*****f8d501d57b5ec\"\n    },\n    \"FlowId\": \"yDCANUUckp******7SI8fHrn0LCd\"\n}",
+        "output": "{\n    \"Response\": {\n        \"ExpiredOn\": 1719463451,\n        \"QrCode\": \"https://file.test.ess.tencent.cn/bresource/resource/resource/0/0.JPG?hkey=5d92f0db15e6bbba6aea641f64c5c06d7914ff197f4b2b099ab565a5733**************3a5b2d692827ec738d02a519c7a9f\",\n        \"RequestId\": \"s17188843684971\",\n        \"Url\": \"https://test.essurl.cn/SR0****F9B\"\n    }\n}",
+        "title": "生成合同区块链存证报告查看二维码/链接"
+      }
+    ],
     "CreateFlowGroupSignReview": [
       {
         "document": "1.签署审核通过企业签署人（ApproverType 设置为PERSON）\n2.使用 姓名 + 手机号 定位合同组内所有子合同的该签署人\n3.拒绝（阻断）该签署人的签署操作 （ReviewType 设置为REJECT）",
@@ -786,6 +794,14 @@
         "title": "创建含有动态签署人流程，签署方不指定具体的签署人"
       }
     ],
+    "CreateLegalSealQrCode": [
+      {
+        "document": "获取创建法人章二维码",
+        "input": "POST / HTTP/1.1\nHost: essbasic.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateLegalSealQrCode\n<公共请求参数>\n\n{\n    \"Agent\": {\n        \"ProxyOrganizationOpenId\": \"org_dianziqian\",\n        \"ProxyOperator\": {\n            \"OpenId\": \"n9527\"\n        },\n        \"AppId\": \"yDwfwUUgygormhg1UuS2eARxjMT0mxAw\"\n    }\n}",
+        "output": "{\n    \"Response\": {\n        \"QrcodeBase64\": \"xxxxxxxxx\",\n        \"RequestId\": \"3c140219-cfe9-470e-b241-907877d6fb03\"\n    }\n}",
+        "title": "获取创建法人章二维码"
+      }
+    ],
     "CreatePartnerAutoSignAuthUrl": [
       {
         "document": "",