tencentcloud-sdk-python 3.0.1060__py2.py3-none-any.whl → 3.0.1063__py2.py3-none-any.whl

tencentcloud/essbasic/v20210526/essbasic_client.py

@@ -173,7 +173,7 @@ class EssbasicClient(AbstractClient):
         """该接口用于发起合同后，生成个人用户的批量签署链接, 暂时不支持企业端签署。
         **注意**：
         1. 该接口目前仅支持签署人类型是**个人签署方的批量签署场景**(ApproverType=PERSON)。
-        2. 该接口可生成批量签署链接的C端签署人**必须仅有手写签名和时间类型的签署控件**，**不支持填写控件** 。
+        2. 该接口可生成批量签署链接的C端签署人**必须仅有手写签名(控件类型为SIGN_SIGNATURE)和时间类型的签署控件**，**不支持填写控件** 。
         3. 请确保C端签署人在批量签署合同中**为待签署状态**，如需顺序签署请待前一位参与人签署完成后，再创建该C端用户的签署链接。
         4. 该签署链接**有效期为30分钟**，过期后将失效，如需签署可重新创建批量签署链接 。
         5. 该接口返回的签署链接适用于APP集成的场景，支持APP打开或浏览器直接打开，**不支持微信小程序嵌入**。
@@ -653,10 +653,21 @@ class EssbasicClient(AbstractClient):
 
     def ChannelCreateFlowSignReview(self, request):
         """提交企业流程审批结果
-        目前存在两种审核操作，签署审核，发起审核
-        签署审核：通过接口（CreateFlowsByTemplates或ChannelCreateFlowByFiles或ChannelCreatePrepareFlow）发起签署流程后，若指定了参数 NeedSignReview 为true,则可以调用此接口，指定operate=SignReview，提交企业内部签署审批结果；若签署流程状态正常，且本企业存在签署方未签署，同一签署流程可以多次提交签署审批结果，签署时的最后一个“审批结果”有效
-
-        发起审核：通过接口ChannelCreatePrepareFlow指定发起后需要审核，则可以通过调用此接口，指定operate=CreateReview，提交企业内部审批结果，可多次提交，当通过后，后续提交结果无效
+        **当前存在两种审核操作：**
+        <ul>
+        <li>签署审核
+        <ul>
+        <li>在通过接口<ul><li>CreateFlowsByTemplates</li><li>ChannelCreateFlowByFiles</li><li>ChannelCreateFlowGroupByTemplates</li><li>ChannelCreateFlowGroupByFiles</li><li>ChannelCreatePrepareFlow</li></ul> 发起签署流程时，通过指定NeedSignReview为true，则可以调用此接口，并指定operate=SignReview，以提交企业内部签署审批结果</li>
+        <li>在通过接口<ul><li>CreateFlowsByTemplates</li><li>ChannelCreateFlowByFiles</li><li>ChannelCreateFlowGroupByTemplates</li><li>ChannelCreateFlowGroupByFiles</li></ul>发起签署流程时，通过指定签署人ApproverNeedSignReview为true，则可以调用此接口，并指定operate=SignReview，并指定RecipientId，以提交企业内部签署审批结果</li>
+        </ul>
+        </li>
+        <li>发起审核
+         <ul>
+        <li>通过接口ChannelCreatePrepareFlow指定发起后需要审核，那么可以调用此接口，并指定operate=CreateReview，以提交企业内部审批结果。可以多次提交审批结果，但一旦审批通过，后续提交的结果将无效
+        </li>
+        </ul>
+        </li>
+        </ul>
 
         :param request: Request instance for ChannelCreateFlowSignReview.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateFlowSignReviewRequest`
@@ -1596,6 +1607,34 @@ class EssbasicClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def CreateFlowGroupSignReview(self, request):
+        """1. 在使用[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByFiles)或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates)创建合同组签署流程时，若指定了参数以下参数为true,则可以调用此接口提交企业内部签署审批结果,即使是自动签署也需要进行审核通过才会进行签署。
+          - [FlowInfo.NeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowinfo)
+          - [FlowFileInfo.NeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowfileinfo)
+          - [FlowApproverInfo.ApproverNeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowapproverinfo)
+
+        2. 同一合同组，同一签署人可以多次提交签署审批结果，签署时的最后一个“审批结果”有效。
+
+        :param request: Request instance for CreateFlowGroupSignReview.
+        :type request: :class:`tencentcloud.essbasic.v20210526.models.CreateFlowGroupSignReviewRequest`
+        :rtype: :class:`tencentcloud.essbasic.v20210526.models.CreateFlowGroupSignReviewResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("CreateFlowGroupSignReview", params, headers=headers)
+            response = json.loads(body)
+            model = models.CreateFlowGroupSignReviewResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def CreateFlowsByTemplates(self, request):
         """接口（CreateFlowsByTemplates）用于使用模板批量创建签署流程。当前可批量发起合同（签署流程）数量为1-20个。
         如若在模板中配置了动态表格, 上传的附件必须为A4大小
@@ -1883,7 +1922,8 @@ class EssbasicClient(AbstractClient):
 
 
     def DescribeChannelSealPolicyWorkflowUrl(self, request):
-        """生成渠道子客用印申请审批小程序链接，链接类型（通过H5唤起小程序或通过APP跳转的方式查看）
+        """制定渠道分支客户的印刷申请审批微型应用程序链接，链接模式（通过H5触发微型应用程序或通过APP跳转进行查看）。
+        此刻，代理参数中的OpenId 必须为审批者的openId，生成的链接必须由该用户启动，其他用户则无审批权限。
 
         :param request: Request instance for DescribeChannelSealPolicyWorkflowUrl.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.DescribeChannelSealPolicyWorkflowUrlRequest`

tencentcloud/essbasic/v20210526/models.py

@@ -1905,6 +1905,8 @@ class ChannelCreateBatchCancelFlowUrlResponse(AbstractModel):
     def __init__(self):
         r"""
         :param _BatchCancelFlowUrl: 批量撤销合同的URL链接, 需要在手机端打开, 有效期24小时
+
+注：<font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
         :type BatchCancelFlowUrl: str
         :param _FailMessages: 与入参的FlowIds数组一致,   成功生成到撤销链接中,则为"",   不能撤销合同则为失败原因
         :type FailMessages: list of str
@@ -1991,7 +1993,8 @@ class ChannelCreateBatchQuickSignUrlRequest(AbstractModel):
 <li>**4**：系统签名</li></ul>
 注：
 <ul><li>默认情况下，签名类型为手写签名</li>
-<li>您可以传递多种值，表示可用多种签名类型。</li></ul>
+<li>您可以传递多种值，表示可用多种签名类型。</li>
+<li>该参数会覆盖您合同中的签名类型，若您在发起合同时限定了签名类型(赋值签名类型给ComponentTypeLimit)，请将这些签名类型赋予此参数</li></ul>
         :type SignatureTypes: list of int
         :param _ApproverSignTypes: 指定批量签署合同的认证校验方式，可传递以下值：
 <ul><li>**1**：人脸认证(默认)，需进行人脸识别成功后才能签署合同</li>
@@ -2333,13 +2336,17 @@ class ChannelCreateBatchSignUrlResponse(AbstractModel):
         r"""
         :param _SignUrl: 批量签署链接，以短链形式返回，短链的有效期参考回参中的 ExpiredTime。
 
-注: `非小程序和APP集成使用`
+注: 
+1. 非小程序和APP集成使用
+2. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
         :type SignUrl: str
         :param _ExpiredTime: 链接过期时间以 Unix 时间戳格式表示，从生成链接时间起，往后7天有效期。过期后短链将失效，无法打开。
         :type ExpiredTime: int
         :param _MiniAppPath: 从客户小程序或者客户APP跳转至腾讯电子签小程序进行批量签署的跳转路径
 
-注: `小程序和APP集成使用`
+注: 
+1. 小程序和APP集成使用
+2. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
         :type MiniAppPath: str
         :param _RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -3788,23 +3795,29 @@ class ChannelCreateFlowSignReviewRequest(AbstractModel):
         r"""
         :param _Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 必填。
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
-        :param _FlowId: 签署流程编号
+        :param _FlowId: 合同流程ID，为32位字符串。
+<ul><li>建议开发者妥善保存此流程ID，以便于顺利进行后续操作。</li>
+<li>可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。</li></ul>
         :type FlowId: str
         :param _ReviewType: 企业内部审核结果
-PASS: 通过
-REJECT: 拒绝
-SIGN_REJECT:拒签(流程结束)
+<ul><li>PASS: 审核通过</li>
+<li>REJECT: 审核拒绝</li>
+<li>SIGN_REJECT:拒签(流程结束)</li></ul>
         :type ReviewType: str
-        :param _ReviewMessage: 审核原因 
-当ReviewType 是REJECT 时此字段必填,字符串长度不超过200
+        :param _ReviewMessage: 审核结果原因
+<ul><li>字符串长度不超过200</li>
+<li>当ReviewType 是拒绝（REJECT） 时此字段必填。</li>
+<li>当ReviewType 是拒绝（SIGN_REJECT） 时此字段必填。</li></ul>
         :type ReviewMessage: str
-        :param _RecipientId: 签署节点审核时需要指定，给个人审核时必填。
+        :param _RecipientId: 审核节点的签署人标志，用于指定当前审核的签署方
+<ul><li>**如果签署审核节点是个人， 此参数必填**。</li></ul>
         :type RecipientId: str
-        :param _OperateType: 操作类型，默认：SignReview；SignReview:签署审核，CreateReview：发起审核
-注：接口通过该字段区分操作类型
-该字段不传或者为空，则默认为SignReview签署审核，走签署审核流程
-若想使用发起审核，请指定该字段为：CreateReview
-若发起个人审核，则指定该字段为：SignReview
+        :param _OperateType: 流程审核操作类型，取值如下：
+<ul><li>**SignReview**：（默认）签署审核</li>
+<li>**CreateReview**：发起审核</li>
+<li>注意：`该字段不传或者为空，则默认为SignReview签署审核，走签署审核流程`</li></ul>
+
+
         :type OperateType: str
         """
         self._Agent = None
@@ -8455,7 +8468,7 @@ class CommonFlowApprover(AbstractModel):
 
 注: `签署方为第三方子客企业时会被置为NONE,   不会发短信通知`
         :type NotifyType: str
-        :param _ApproverOption: 签署人配置
+        :param _ApproverOption: 签署人配置，用于控制签署人相关属性
         :type ApproverOption: :class:`tencentcloud.essbasic.v20210526.models.CommonApproverOption`
         :param _SignComponents: 使用PDF文件直接发起合同时，签署人指定的签署控件；<br/>使用模板发起合同时，指定本企业印章签署控件的印章ID: <br/>通过ComponentId或ComponenetName指定签署控件，ComponentValue为印章ID。
         :type SignComponents: list of Component
@@ -9861,9 +9874,11 @@ class CreateConsoleLoginUrlResponse(AbstractModel):
         r"""
         :param _ConsoleUrl: 跳转链接, 链接的有效期根据企业,员工状态和终端等有区别, 可以参考下表
 <table> <thead> <tr> <th>子客企业状态</th> <th>子客企业员工状态</th> <th>Endpoint</th> <th>链接有效期限</th> </tr> </thead>  <tbody> <tr> <td>企业未激活</td> <td>员工未认证</td> <td>PC/PC_SHORT_URL</td> <td>5分钟</td>  </tr>  <tr> <td>企业未激活</td> <td>员工未认证</td> <td>CHANNEL/APP</td> <td>一年</td>  </tr>  <tr> <td>企业已激活</td> <td>员工未认证</td> <td>PC/PC_SHORT_URL</td> <td>5分钟</td>  </tr> <tr> <td>企业已激活</td> <td>员工未认证</td> <td>PC/CHANNEL/APP</td> <td>一年</td>  </tr>  <tr> <td>企业已激活</td> <td>员工已认证</td> <td>PC</td> <td>5分钟</td>  </tr>  <tr> <td>企业已激活</td> <td>员工已认证</td> <td>CHANNEL/APP</td> <td>一年</td>  </tr> </tbody> </table>
+
 注： 
-`1.链接仅单次有效，每次登录需要需要重新创建新的链接`
-`2.创建的链接应避免被转义，如：&被转义为\u0026；如使用Postman请求后，请选择响应类型为 JSON，否则链接将被转义`
+1. <font color="red">链接仅单次有效</font>，每次登录需要需要重新创建新的链接
+2. 创建的链接应避免被转义，如：&被转义为\u0026；如使用Postman请求后，请选择响应类型为 JSON，否则链接将被转义
+3. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
 
         :type ConsoleUrl: str
         :param _IsActivated: 子客企业是否已开通腾讯电子签，
@@ -9925,6 +9940,138 @@ class CreateConsoleLoginUrlResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class CreateFlowGroupSignReviewRequest(AbstractModel):
+    """CreateFlowGroupSignReview请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+此接口下面信息必填。
+<ul>
+<li>渠道应用标识:  Agent.AppId</li>
+<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
+<li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
+</ul>
+第三方平台子客企业和员工必须已经经过实名认证
+        :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
+        :param _FlowGroupId:   合同(流程)组的合同组Id，为32位字符串，通过接口[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByFiles) 或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates)创建合同组签署流程时返回。
+        :type FlowGroupId: str
+        :param _ReviewType: 提交的审核结果，审核结果有下面三种情况
+<ul><li><b>PASS</b>: 审核通过，合同流程可以继续执行签署等操作</li>
+<li><b>REJECT</b>: 审核拒绝，合同流程不会变动</li>
+<li><b>SIGN_REJECT</b>:拒签，合同流程直接结束，合同状态变为**合同拒签**</li></ul>
+        :type ReviewType: str
+        :param _ApproverInfo: 需要进行签署审核的签署人的个人信息或企业信息，签署方的匹配方式按照以下规则:
+
+个人：二选一（选择其中任意信息组合即可）
+<ul><li>姓名+证件类型+证件号</li>
+<li>姓名+手机号</li></ul>
+
+企业：二选一  （选择其中任意信息组合即可）
+<ul><li>企业名+姓名+证件类型+证件号</li>
+<li>企业名+姓名+手机号</li></ul>
+        :type ApproverInfo: :class:`tencentcloud.essbasic.v20210526.models.NeedReviewApproverInfo`
+        :param _ReviewMessage: 审核不通过的原因，该字段的字符串长度不超过200个字符。
+
+注：`当审核类型（ReviewType）为审核拒绝（REJECT）或拒签（SIGN_REJECT）时，审核结果原因字段必须填写`
+
+        :type ReviewMessage: str
+        """
+        self._Agent = None
+        self._FlowGroupId = None
+        self._ReviewType = None
+        self._ApproverInfo = None
+        self._ReviewMessage = None
+
+    @property
+    def Agent(self):
+        return self._Agent
+
+    @Agent.setter
+    def Agent(self, Agent):
+        self._Agent = Agent
+
+    @property
+    def FlowGroupId(self):
+        return self._FlowGroupId
+
+    @FlowGroupId.setter
+    def FlowGroupId(self, FlowGroupId):
+        self._FlowGroupId = FlowGroupId
+
+    @property
+    def ReviewType(self):
+        return self._ReviewType
+
+    @ReviewType.setter
+    def ReviewType(self, ReviewType):
+        self._ReviewType = ReviewType
+
+    @property
+    def ApproverInfo(self):
+        return self._ApproverInfo
+
+    @ApproverInfo.setter
+    def ApproverInfo(self, ApproverInfo):
+        self._ApproverInfo = ApproverInfo
+
+    @property
+    def ReviewMessage(self):
+        return self._ReviewMessage
+
+    @ReviewMessage.setter
+    def ReviewMessage(self, ReviewMessage):
+        self._ReviewMessage = ReviewMessage
+
+
+    def _deserialize(self, params):
+        if params.get("Agent") is not None:
+            self._Agent = Agent()
+            self._Agent._deserialize(params.get("Agent"))
+        self._FlowGroupId = params.get("FlowGroupId")
+        self._ReviewType = params.get("ReviewType")
+        if params.get("ApproverInfo") is not None:
+            self._ApproverInfo = NeedReviewApproverInfo()
+            self._ApproverInfo._deserialize(params.get("ApproverInfo"))
+        self._ReviewMessage = params.get("ReviewMessage")
+        memeber_set = set(params.keys())
+        for name, value in vars(self).items():
+            property_name = name[1:]
+            if property_name in memeber_set:
+                memeber_set.remove(property_name)
+        if len(memeber_set) > 0:
+            warnings.warn("%s fileds are useless." % ",".join(memeber_set))
+        
+
+
+class CreateFlowGroupSignReviewResponse(AbstractModel):
+    """CreateFlowGroupSignReview返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._RequestId = None
+
+    @property
+    def RequestId(self):
+        return self._RequestId
+
+    @RequestId.setter
+    def RequestId(self, RequestId):
+        self._RequestId = RequestId
+
+
+    def _deserialize(self, params):
+        self._RequestId = params.get("RequestId")
+
+
 class CreateFlowOption(AbstractModel):
     """创建合同个性化参数
 
@@ -10717,6 +10864,9 @@ class CreateSignUrlsRequest(AbstractModel):
 注: `GenerateType为"CHANNEL"时必填`
         :type OrganizationOpenId: str
         :param _OpenId: 第三方平台子客企业员工的标识OpenId，GenerateType为"CHANNEL"时可用，指定到具体参与人, 仅展示已经实名的经办人信息
+
+注： 
+如果传进来的<font color="red">OpenId已经实名并且加入企业， 则忽略Name，IdCardType，IdCardNumber，Mobile这四个入参</font>（会用此OpenId实名的身份证和登录的手机号覆盖）
         :type OpenId: str
         :param _AutoJumpBack: Endpoint为"APP" 类型的签署链接，可以设置此值；支持调用方小程序打开签署链接，在电子签小程序完成签署后自动回跳至调用方小程序
         :type AutoJumpBack: bool
@@ -12280,7 +12430,6 @@ class DescribeTemplatesRequest(AbstractModel):
 
 设置为true之后， 返回参数PreviewUrl，为模板的H5预览链接,  有效期5分钟。可以通过浏览器打开此链接预览模板，或者嵌入到iframe中预览模板。
 
-注: `此功能为白名单功能，使用前请联系对接的客户经理沟通。`
         :type WithPreviewUrl: bool
         :param _WithPdfUrl: 是否获取模板的PDF文件链接。
 
@@ -13449,6 +13598,9 @@ class FlowApproverInfo(AbstractModel):
         :param _OpenId: 第三方平台子客企业员工的唯一标识，长度不能超过64，只能由字母和数字组成
 
 当签署方为同一第三方平台下的员工时，该字段若不指定，则发起【待领取】的流程
+
+注： 
+如果传进来的<font color="red">OpenId已经实名并且加入企业， 则忽略Name，IdCardType，IdCardNumber，Mobile这四个入参</font>（会用此OpenId实名的身份证和登录的手机号覆盖）
         :type OpenId: str
         :param _OrganizationOpenId: 同应用下第三方平台子客企业的唯一标识，定义Agent中的ProxyOrganizationOpenId一样，签署方为非发起方企业场景下必传，最大长度64个字符
         :type OrganizationOpenId: str
@@ -13494,7 +13646,14 @@ class FlowApproverInfo(AbstractModel):
         :param _ApproverOption: 可以控制签署方在签署合同时能否进行某些操作，例如拒签、转交他人、是否为动态补充签署人等。
 详细操作可以参考开发者中心的ApproverOption结构体。
         :type ApproverOption: :class:`tencentcloud.essbasic.v20210526.models.ApproverOption`
-        :param _ApproverNeedSignReview: 当前签署方进行签署操作是否需要企业内部审批，true 则为需要
+        :param _ApproverNeedSignReview: 发起方企业的签署人进行签署操作前，是否需要企业内部走审批流程，取值如下：
+<ul><li>**false**：（默认）不需要审批，直接签署。</li>
+<li>**true**：需要走审批流程。当到对应参与人签署时，会阻塞其签署操作，等待企业内部审批完成。</li></ul>
+企业可以通过ChannelCreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
+<ul><li>如果企业通知腾讯电子签平台审核通过，签署方可继续签署动作。</li>
+<li>如果企业通知腾讯电子签平台审核未通过，平台将继续阻塞签署方的签署动作，直到企业通知平台审核通过。</li></ul>
+
+注：`此功能可用于与企业内部的审批流程进行关联，支持手动、静默签署合同`
         :type ApproverNeedSignReview: bool
         :param _ApproverVerifyTypes: 指定个人签署方查看合同的校验方式,可以传值如下:
 <ul><li>  **1**   : （默认）人脸识别,人脸识别后才能合同内容</li>
@@ -13878,10 +14037,12 @@ class FlowApproverUrlInfo(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _SignUrl: 签署短链接。</br>
+        :param _SignUrl: 签署短链接。
+
 注意:
-- 该链接有效期为**30分钟**，同时需要注意保密，不要外泄给无关用户。
-- 该链接不支持小程序嵌入，仅支持**移动端浏览器**打开。
+1. 该链接有效期为**30分钟**，同时需要注意保密，不要外泄给无关用户。
+2. 该链接不支持小程序嵌入，仅支持**移动端浏览器**打开。
+3. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
         :type SignUrl: str
         :param _ApproverType: 签署人类型。
 - **PERSON**: 个人
@@ -13890,10 +14051,12 @@ class FlowApproverUrlInfo(AbstractModel):
         :type Name: str
         :param _Mobile: 签署人手机号。
         :type Mobile: str
-        :param _LongUrl: 签署长链接。</br>
+        :param _LongUrl: 签署长链接。
+
 注意:
-- 该链接有效期为**30分钟**，同时需要注意保密，不要外泄给无关用户。
-- 该链接不支持小程序嵌入，仅支持**移动端浏览器**打开。
+1. 该链接有效期为**30分钟**，同时需要注意保密，不要外泄给无关用户。
+2. 该链接不支持小程序嵌入，仅支持**移动端浏览器**打开。
+3. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
 注意：此字段可能返回 null，表示取不到有效值。
         :type LongUrl: str
         """
@@ -15341,6 +15504,114 @@ class ModifyExtendedServiceResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class NeedReviewApproverInfo(AbstractModel):
+    """需要进行签署审核的签署人信息
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _ApproverType: 签署方经办人的类型，支持以下类型
+<ul><li> ORGANIZATION 企业（含企业自动签）</li>
+<li>PERSON 个人（含个人自动签）</li></ul>
+        :type ApproverType: str
+        :param _ApproverName: 签署方经办人的姓名。 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
+        :type ApproverName: str
+        :param _ApproverMobile: 签署方经办人手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。 请确认手机号所有方为此合同签署方。
+        :type ApproverMobile: str
+        :param _ApproverIdCardType: 签署方经办人的证件类型，支持以下类型
+<ul><li>ID_CARD 居民身份证  (默认值)</li>
+<li>HONGKONG_AND_MACAO 港澳居民来往内地通行证</li>
+<li>HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)</li>
+<li>OTHER_CARD_TYPE 其他证件</li></ul>
+
+注: `其他证件类型为白名单功能，使用前请联系对接的客户经理沟通。`
+        :type ApproverIdCardType: str
+        :param _ApproverIdCardNumber: 签署方经办人的证件号码，应符合以下规则
+<ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
+<li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+<li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
+        :type ApproverIdCardNumber: str
+        :param _OrganizationName: 组织机构名称。
+请确认该名称与企业营业执照中注册的名称一致。
+如果名称中包含英文括号()，请使用中文括号（）代替。
+如果签署方是企业签署方(approverType = 0 或者 approverType = 3)， 则企业名称必填。
+
+        :type OrganizationName: str
+        """
+        self._ApproverType = None
+        self._ApproverName = None
+        self._ApproverMobile = None
+        self._ApproverIdCardType = None
+        self._ApproverIdCardNumber = None
+        self._OrganizationName = None
+
+    @property
+    def ApproverType(self):
+        return self._ApproverType
+
+    @ApproverType.setter
+    def ApproverType(self, ApproverType):
+        self._ApproverType = ApproverType
+
+    @property
+    def ApproverName(self):
+        return self._ApproverName
+
+    @ApproverName.setter
+    def ApproverName(self, ApproverName):
+        self._ApproverName = ApproverName
+
+    @property
+    def ApproverMobile(self):
+        return self._ApproverMobile
+
+    @ApproverMobile.setter
+    def ApproverMobile(self, ApproverMobile):
+        self._ApproverMobile = ApproverMobile
+
+    @property
+    def ApproverIdCardType(self):
+        return self._ApproverIdCardType
+
+    @ApproverIdCardType.setter
+    def ApproverIdCardType(self, ApproverIdCardType):
+        self._ApproverIdCardType = ApproverIdCardType
+
+    @property
+    def ApproverIdCardNumber(self):
+        return self._ApproverIdCardNumber
+
+    @ApproverIdCardNumber.setter
+    def ApproverIdCardNumber(self, ApproverIdCardNumber):
+        self._ApproverIdCardNumber = ApproverIdCardNumber
+
+    @property
+    def OrganizationName(self):
+        return self._OrganizationName
+
+    @OrganizationName.setter
+    def OrganizationName(self, OrganizationName):
+        self._OrganizationName = OrganizationName
+
+
+    def _deserialize(self, params):
+        self._ApproverType = params.get("ApproverType")
+        self._ApproverName = params.get("ApproverName")
+        self._ApproverMobile = params.get("ApproverMobile")
+        self._ApproverIdCardType = params.get("ApproverIdCardType")
+        self._ApproverIdCardNumber = params.get("ApproverIdCardNumber")
+        self._OrganizationName = params.get("OrganizationName")
+        memeber_set = set(params.keys())
+        for name, value in vars(self).items():
+            property_name = name[1:]
+            if property_name in memeber_set:
+                memeber_set.remove(property_name)
+        if len(memeber_set) > 0:
+            warnings.warn("%s fileds are useless." % ",".join(memeber_set))
+        
+
+
 class OccupiedSeal(AbstractModel):
     """持有的电子印章信息
 
@@ -17463,6 +17734,8 @@ class SignUrlInfo(AbstractModel):
     def __init__(self):
         r"""
         :param _SignUrl: 签署链接，过期时间为90天
+
+注：<font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
 注意：此字段可能返回 null，表示取不到有效值。
         :type SignUrl: str
         :param _Deadline: 合同过期时间戳，单位秒
@@ -18317,21 +18590,20 @@ class TemplateInfo(AbstractModel):
         :type Description: str
         :param _Components: 模板的填充控件列表
         :type Components: list of Component
-        :param _Recipients: 模板中的签署参与方列表
+        :param _Recipients: 此模块需要签署的各个参与方的角色列表。RecipientId标识每个参与方角色对应的唯一标识符，用于确定此角色的信息。
         :type Recipients: list of Recipient
-        :param _SignComponents: 模板中的签署控件列表
+        :param _SignComponents: 此模版中的签署控件列表
         :type SignComponents: list of Component
         :param _TemplateType: 模板类型：1-静默签；3-普通模板
         :type TemplateType: int
         :param _IsPromoter: 是否是发起人 ,已弃用
         :type IsPromoter: bool
-        :param _Creator: 模板的创建者信息，电子签系统用户ID
+        :param _Creator: 模板的创建者名字
         :type Creator: str
         :param _CreatedOn: 模板创建的时间戳，格式为Unix标准时间戳（秒）
         :type CreatedOn: int
         :param _PreviewUrl: 模板的H5预览链接,有效期5分钟。
 可以通过浏览器打开此链接预览模板，或者嵌入到iframe中预览模板。
-（此功能开放需要联系客户经理）
 注意：此字段可能返回 null，表示取不到有效值。
         :type PreviewUrl: str
         :param _PdfUrl: 第三方应用集成-模板PDF文件链接，有效期5分钟。
@@ -18348,13 +18620,14 @@ class TemplateInfo(AbstractModel):
 1-平台自动设置子客模板
 注意：此字段可能返回 null，表示取不到有效值。
         :type ChannelAutoSave: int
-        :param _TemplateVersion: 模板版本，全数字字符。
-默认为空，初始版本为yyyyMMdd001。
+        :param _TemplateVersion: 模板版本，由全数字字符组成。
+默认为空，模板版本号由日期和序号组成，初始版本为yyyyMMdd001，yyyyMMdd002表示第二个版本，以此类推。
 注意：此字段可能返回 null，表示取不到有效值。
         :type TemplateVersion: str
-        :param _Available: 模板可用状态：
-1启用（默认）
-2停用
+        :param _Available: 模板可用状态的取值通常为以下两种：
+
+<ul><li>1：启用（默认），表示模板处于启用状态，可以被用户正常使用。</li>
+<li>2：停用，表示模板处于停用状态，禁止用户使用该模板。</li></ul>
 注意：此字段可能返回 null，表示取不到有效值。
         :type Available: int
         """

tencentcloud/faceid/v20180301/models.py

@@ -5144,7 +5144,7 @@ class IntentionActionResult(AbstractModel):
 -301: "意愿核验不通过"   
 -800: "前端不兼容错误"    
 -801: "用户未授权摄像头和麦克风权限"   
--802: "获取视频流失败"   
+-802: "核验流程异常中断，请勿切屏或进行其他操作"   
 -803: "用户主动关闭链接/异常断开链接"   
 -998: "系统数据异常"   
 -999: "系统未知错误，请联系人工核实"   
@@ -5320,7 +5320,7 @@ class IntentionQuestionResult(AbstractModel):
 -301: "意愿核验不通过"   
 -800: "前端不兼容错误"    
 -801: "用户未授权摄像头和麦克风权限"   
--802: "获取视频流失败"   
+-802: "核验流程异常中断，请勿切屏或进行其他操作"   
 -803: "用户主动关闭链接/异常断开链接"   
 -998: "系统数据异常"   
 -999: "系统未知错误，请联系人工核实"   

tencentcloud/iotcloud/v20210408/errorcodes.py

@@ -221,6 +221,9 @@ LIMITEXCEEDED_PRODUCTEXCEEDLIMIT = 'LimitExceeded.ProductExceedLimit'
 # Topic数量超出限制。
 LIMITEXCEEDED_TOPICPOLICYEXCEEDLIMIT = 'LimitExceeded.TopicPolicyExceedLimit'
 
+# TDMQ缺少内网接入点，无法转发，请咨询TDMQ产品
+OPERATIONDENIED_GETTDMQPROINTERNALENDPOINTFAIL = 'OperationDenied.GetTDMQProInternalEndpointFail'
+
 # CA证书不存在。
 RESOURCENOTFOUND_CACERTNOTEXIST = 'ResourceNotFound.CACertNotExist'
 

tencentcloud/iss/v20230517/errorcodes.py

@@ -320,6 +320,9 @@ INVALIDPARAMETERVALUE_OUTOFTIMERANGE = 'InvalidParameterValue.OutOfTimeRange'
 # 通道数量一次最多添加5000路
 INVALIDPARAMETERVALUE_PLANCHANNELSEXCEEDSRANGE = 'InvalidParameterValue.PlanChannelsExceedsRange'
 
+# 计划名称不能重复
+INVALIDPARAMETERVALUE_PLANNAMEREPEAT = 'InvalidParameterValue.PlanNameRepeat'
+
 # 一个取回任务最多添加32个设备通道
 INVALIDPARAMETERVALUE_RETRIEVETASKCHANNELSEXCEEDSRANGE = 'InvalidParameterValue.RetrieveTaskChannelsExceedsRange'
 
@@ -490,3 +493,6 @@ UNSUPPORTEDOPERATION_SCALEANDPOSBOTHEXIST = 'UnsupportedOperation.ScaleAndPosBot
 
 # StreamType和Resolution参数不支持同时下发
 UNSUPPORTEDOPERATION_STREAMTYPEORRESOLUTION = 'UnsupportedOperation.StreamTypeOrResolution'
+
+# 该地域未开通内网服务
+UNSUPPORTEDOPERATION_UNOPENEDINTRANETSERVICESINREGION = 'UnsupportedOperation.UnopenedIntranetServicesInRegion'