tencentcloud-sdk-python 3.0.977__py2.py3-none-any.whl → 3.0.978__py2.py3-none-any.whl

tencentcloud/ess/v20201111/models.py

@@ -251,6 +251,10 @@ class ApproverInfo(AbstractModel):
 
 注：`此功能可用于与企业内部的审批流程进行关联，支持手动、静默签署合同`
         :type ApproverNeedSignReview: bool
+        :param _AddSignComponentsLimits: [用PDF文件创建签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowByFiles)时,如果设置了外层参数SignBeanTag=1(允许签署过程中添加签署控件),则可通过此参数明确规定合同所使用的签署控件类型（骑缝章、普通章法人章等）和具体的印章（印章ID）或签名方式。
+
+注：`限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章（通过传递ComponentValue,支持多个），他方企业或个人只支持限制控件类型。`
+        :type AddSignComponentsLimits: list of ComponentLimit
         """
         self._ApproverType = None
         self._ApproverName = None
@@ -270,6 +274,7 @@ class ApproverInfo(AbstractModel):
         self._ApproverVerifyTypes = None
         self._ApproverSignTypes = None
         self._ApproverNeedSignReview = None
+        self._AddSignComponentsLimits = None
 
     @property
     def ApproverType(self):
@@ -415,6 +420,14 @@ class ApproverInfo(AbstractModel):
     def ApproverNeedSignReview(self, ApproverNeedSignReview):
         self._ApproverNeedSignReview = ApproverNeedSignReview
 
+    @property
+    def AddSignComponentsLimits(self):
+        return self._AddSignComponentsLimits
+
+    @AddSignComponentsLimits.setter
+    def AddSignComponentsLimits(self, AddSignComponentsLimits):
+        self._AddSignComponentsLimits = AddSignComponentsLimits
+
 
     def _deserialize(self, params):
         self._ApproverType = params.get("ApproverType")
@@ -442,6 +455,12 @@ class ApproverInfo(AbstractModel):
         self._ApproverVerifyTypes = params.get("ApproverVerifyTypes")
         self._ApproverSignTypes = params.get("ApproverSignTypes")
         self._ApproverNeedSignReview = params.get("ApproverNeedSignReview")
+        if params.get("AddSignComponentsLimits") is not None:
+            self._AddSignComponentsLimits = []
+            for item in params.get("AddSignComponentsLimits"):
+                obj = ComponentLimit()
+                obj._deserialize(item)
+                self._AddSignComponentsLimits.append(obj)
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -1863,6 +1882,66 @@ UpperRight-右下角。
         
 
 
+class ComponentLimit(AbstractModel):
+    """签署控件的类型和范围限制条件，用于控制文件发起后签署人拖拽签署区时可使用的控件类型和具体的印章或签名方式。
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _ComponentType: 控件类型，支持以下类型
+<ul><li>SIGN_SEAL : 印章控件</li>
+<li>SIGN_PAGING_SEAL : 骑缝章控件</li>
+<li>SIGN_LEGAL_PERSON_SEAL : 企业法定代表人控件</li>
+<li>SIGN_SIGNATURE : 用户签名控件</li></ul>
+        :type ComponentType: str
+        :param _ComponentValue: 签署控件类型的值(可选)，用与限制签署时印章或者签名的选择范围
+
+1.当ComponentType 是 SIGN_SEAL 或者 SIGN_PAGING_SEAL 时可传入企业印章Id（支持多个）
+
+2.当ComponentType 是 SIGN_SIGNATURE 时可传入以下类型（支持多个）
+
+<ul><li>HANDWRITE : 手写签名</li>
+<li>OCR_ESIGN : OCR印章（智慧手写签名）</li>
+<li>ESIGN : 个人印章</li>
+<li>SYSTEM_ESIGN : 系统印章</li></ul>
+
+3.当ComponentType 是 SIGN_LEGAL_PERSON_SEAL 时无需传递此参数。
+        :type ComponentValue: list of str
+        """
+        self._ComponentType = None
+        self._ComponentValue = None
+
+    @property
+    def ComponentType(self):
+        return self._ComponentType
+
+    @ComponentType.setter
+    def ComponentType(self, ComponentType):
+        self._ComponentType = ComponentType
+
+    @property
+    def ComponentValue(self):
+        return self._ComponentValue
+
+    @ComponentValue.setter
+    def ComponentValue(self, ComponentValue):
+        self._ComponentValue = ComponentValue
+
+
+    def _deserialize(self, params):
+        self._ComponentType = params.get("ComponentType")
+        self._ComponentValue = params.get("ComponentValue")
+        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 CreateBatchCancelFlowUrlRequest(AbstractModel):
     """CreateBatchCancelFlowUrl请求参数结构体
 
@@ -5352,20 +5431,25 @@ class CreatePersonAuthCertificateImageRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Operator: 操作人信息
+        :param _Operator: 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
         :param _UserName: 个人用户名称
         :type UserName: str
-        :param _IdCardType: 身份证件类型取值：
-ID_CARD 身居民身份证
-PASSPORT 护照
-HONGKONG_AND_MACAO 港澳居民来往内地通行证
-FOREIGN_ID_CARD 外国人永久居留身份证
-HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)
+        :param _IdCardType: 证件类型，支持以下类型
+<ul><li> ID_CARD  : 居民身份证 (默认值)</li>
+<li> PASSPORT  : 护照</li>
+<li> FOREIGN_ID_CARD  : 外国人永久居留身份证</li>
+<li> HONGKONG_AND_MACAO  : 港澳居民来往内地通行证</li>
+<li> HONGKONG_MACAO_AND_TAIWAN  : 港澳台居民居住证(格式同居民身份证)</li></ul>
         :type IdCardType: str
-        :param _IdCardNumber: 身份证件号码
+        :param _IdCardNumber: 证件号码，应符合以下规则
+<ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
+<li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+<li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
         :type IdCardNumber: str
-        :param _Agent: 代理企业和员工的信息。 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        :param _Agent: 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
         """
         self._Operator = None
@@ -5442,18 +5526,25 @@ class CreatePersonAuthCertificateImageResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _AuthCertUrl: 个人用户证明证书的下载链接
+        :param _AuthCertUrl: 个人用户认证证书图片下载URL，`有效期为5分钟`，超过有效期后将无法再下载。
         :type AuthCertUrl: str
-        :param _ImageCertId: 证书图片上的证书编号，20位数字
+        :param _ImageCertId: 个人用户认证证书的编号, 为20位数字组成的字符串,  由腾讯电子签下发此编号 。
+该编号会合成到个人用户证书证明图片。
+
+注: `个人用户认证证书的编号和证明图片绑定, 获取新的证明图片编号会变动`
 注意：此字段可能返回 null，表示取不到有效值。
         :type ImageCertId: str
-        :param _SerialNumber: 图片证明对应的CA证书序列号
+        :param _SerialNumber: CA供应商下发给用户的证书编号，在证书到期后自动续期后此证书编号会发生变动，且不会合成到个人用户证书证明图片中。
+
+注意：`腾讯电子签接入多家CA供应商以提供容灾能力，不同CA下发的证书编号区别较大，但基本都是由数字和字母组成，长度在200以下。`
 注意：此字段可能返回 null，表示取不到有效值。
         :type SerialNumber: str
-        :param _ValidFrom: CA证书颁发时间戳
+        :param _ValidFrom: CA证书颁发时间，格式为Unix标准时间戳（秒）   
+该时间格式化后会合成到个人用户证书证明图片
 注意：此字段可能返回 null，表示取不到有效值。
         :type ValidFrom: int
-        :param _ValidTo: CA证书有效截止时间戳
+        :param _ValidTo: CA证书有效截止时间，格式为Unix标准时间戳（秒）
+该时间格式化后会合成到个人用户证书证明图片
 注意：此字段可能返回 null，表示取不到有效值。
         :type ValidTo: int
         :param _RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
@@ -6085,16 +6176,16 @@ class CreateReleaseFlowRequest(AbstractModel):
         :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
         :param _NeedRelievedFlowId: 待解除的签署流程编号（即原签署流程的编号）。
         :type NeedRelievedFlowId: str
-        :param _ReliveInfo: 解除协议内容。
+        :param _ReliveInfo: 解除协议内容, 包括解除理由等信息。
         :type ReliveInfo: :class:`tencentcloud.ess.v20201111.models.RelieveInfo`
         :param _Agent: 关于渠道应用的相关信息，包括子客企业及应用编、号等详细内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
         :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
-        :param _ReleasedApprovers: 解除协议的签署人列表(如不指定该参数，默认使用原流程的签署人列表)。 <br/>
-如需更换原合同中的签署人，可通过指定该签署人的RecipientId编号更换此签署人。(可通过接口<a href="https://qian.tencent.com/developers/companyApis/queryFlows/DescribeFlowInfo/">DescribeFlowInfo</a>查询签署人的RecipientId编号)<br/>
-解除协议的签署人数量不能多于原流程的签署人数量。<br/>
+        :param _ReleasedApprovers: 替换解除协议的签署人， 如不指定替换签署人,  则使用原流程的签署人。 <br/>
+如需更换原合同中的企业端签署人，可通过指定该签署人的RecipientId编号更换此企业端签署人。(可通过接口<a href="https://qian.tencent.com/developers/companyApis/queryFlows/DescribeFlowInfo/">DescribeFlowInfo</a>查询签署人的RecipientId编号)<br/>
 
-`注意：只能更换同企业的签署人。`<br/>
-`注意：不支持更换个人类型的签署人。`<br/>
+注意：
+`只能更换自己企业的签署人,  不支持更换个人类型或者其他企业的签署人。`
+`可以不指定替换签署人, 使用原流程的签署人 `
         :type ReleasedApprovers: list of ReleasedApprover
         :param _Deadline: 合同流程的签署截止时间，格式为Unix标准时间戳（秒），如果未设置签署截止时间，则默认为合同流程创建后的7天时截止。
 如果在签署截止时间前未完成签署，则合同状态会变为已过期，导致合同作废。
@@ -8160,11 +8251,16 @@ class DescribeFlowBriefsRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Operator: 调用方用户信息，userId 必填
+        :param _Operator: 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
-        :param _FlowIds: 需要查询的流程ID列表，限制最大100个
+        :param _FlowIds: 查询的合同流程ID列表最多支持100个流程ID。 
+如果某个合同流程ID不存在，系统会跳过此ID的查询，继续查询剩余存在的合同流程。
+
+可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
         :type FlowIds: list of str
-        :param _Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        :param _Agent: 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
         """
         self._Operator = None
@@ -8221,7 +8317,8 @@ class DescribeFlowBriefsResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _FlowBriefs: 流程列表
+        :param _FlowBriefs: 合同流程基础信息列表，包含流程的名称、状态、创建日期等基本信息。 
+注：`与入参 FlowIds 的顺序可能存在不一致的情况。`
         :type FlowBriefs: list of FlowBrief
         :param _RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -8991,7 +9088,9 @@ class DescribeIntegrationEmployeesRequest(AbstractModel):
         :type Limit: int
         :param _Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
         :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
-        :param _Filters: 查询过滤实名用户，Key为Status，Values为["IsVerified"]
+        :param _Filters: 查询过滤实名用户，Key为Status，Values为["IsVerified"]，查询过滤未实名用户，Key为Status，Values为["NotVerified"]
+查询某个部门的用户，Key为DepartmentId，Values为["DepartmentId"]
+根据用户Id查询员工时，Key为UserId，Values为["UserId"]
 根据第三方系统openId过滤查询员工时,Key为StaffOpenId,Values为["OpenId","OpenId",...]
         :type Filters: list of Filter
         :param _Offset: 查询结果分页返回，此处指定第几页，如果不传默认从第一页返回。页码从 0 开始，即首页为 0，最大20000
@@ -9813,11 +9912,13 @@ class DescribeThirdPartyAuthCodeRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _AuthCode: 电子签小程序跳转客户小程序时携带的授权查看码
+        :param _AuthCode: 腾讯电子签小程序跳转客户企业小程序时携带的授权查看码，AuthCode由腾讯电子签小程序生成。
         :type AuthCode: str
-        :param _Operator: 操作人信息
+        :param _Operator: 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
-        :param _Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        :param _Agent: 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
         """
         self._AuthCode = None
@@ -9874,7 +9975,10 @@ class DescribeThirdPartyAuthCodeResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _VerifyStatus: 用户是否实名，VERIFIED 为实名，UNVERIFIED 未实名
+        :param _VerifyStatus: AuthCode 中对应个人用户是否实名
+<ul>
+<li> **VERIFIED** : 此个人已实名</li>
+<li> **UNVERIFIED**: 此个人未实名</li></ul>
         :type VerifyStatus: str
         :param _RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -14532,7 +14636,10 @@ class ReleasedApprover(AbstractModel):
 <ul><li> **SIGN_SEAL**：默认为印章控件类型（默认值）</li>
 <li> **SIGN_SIGNATURE**：手写签名控件类型</li></ul>
         :type ApproverSignComponentType: str
-        :param _ApproverSignRole: 参与方在合同中的角色是按照创建合同的时候来排序的; 解除协议默认会将第一个参与人叫甲方, 第二个叫乙方,第三个叫丙方，以此类推。如果您需要改动参与人的角色名字, 可以设置此签署方自定义控件别名字段，最大20个字。
+        :param _ApproverSignRole: 参与方在合同中的角色是按照创建合同的时候来排序的，解除协议默认会将第一个参与人叫`甲方`,第二个叫`乙方`,  第三个叫`丙方`，以此类推。
+
+如果需改动此参与人的角色名字，可用此字段指定，由汉字,英文字符,数字组成，最大20个字。
+
         :type ApproverSignRole: str
         """
         self._Name = None
@@ -14615,19 +14722,16 @@ class RelieveInfo(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Reason: 解除理由，最大支持200个字
+        :param _Reason: 解除理由，长度不能超过200，只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。
         :type Reason: str
-        :param _RemainInForceItem: 解除后仍然有效的条款，保留条款，最大支持200个字
+        :param _RemainInForceItem: 解除后仍然有效的条款，保留条款，长度不能超过200，只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。
 
         :type RemainInForceItem: str
-        :param _OriginalExpenseSettlement: 原合同事项处理-费用结算，最大支持200个字
-
+        :param _OriginalExpenseSettlement: 原合同事项处理-费用结算，长度不能超过200，只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。
         :type OriginalExpenseSettlement: str
-        :param _OriginalOtherSettlement: 原合同事项处理-其他事项，最大支持200个字
-
+        :param _OriginalOtherSettlement: 原合同事项处理-其他事项，长度不能超过200，只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。
         :type OriginalOtherSettlement: str
-        :param _OtherDeals: 其他约定，最大支持200个字
-
+        :param _OtherDeals: 其他约定，长度不能超过200，只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。
         :type OtherDeals: str
         """
         self._Reason = None

tencentcloud/essbasic/v20210526/models.py

@@ -5690,6 +5690,10 @@ class CommonFlowApprover(AbstractModel):
         :type ApproverOption: :class:`tencentcloud.essbasic.v20210526.models.CommonApproverOption`
         :param _SignComponents: 签署控件：文件发起使用
         :type SignComponents: list of Component
+        :param _ApproverVerifyTypes: 签署人查看合同时认证方式, 1-实名查看 2-短信验证码查看(企业签署方不支持该方式) 如果不传默认为1 查看合同的认证方式 Flow层级的优先于approver层级的 （当手写签名方式为OCR_ESIGN时，合同认证方式2无效，因为这种签名方式依赖实名认证）
+        :type ApproverVerifyTypes: list of int
+        :param _ApproverSignTypes: 签署人签署合同时的认证方式 1-人脸认证 2-签署密码 3-运营商三要素(默认为1,2)	
+        :type ApproverSignTypes: list of int
         """
         self._NotChannelOrganization = None
         self._ApproverType = None
@@ -5706,6 +5710,8 @@ class CommonFlowApprover(AbstractModel):
         self._NotifyType = None
         self._ApproverOption = None
         self._SignComponents = None
+        self._ApproverVerifyTypes = None
+        self._ApproverSignTypes = None
 
     @property
     def NotChannelOrganization(self):
@@ -5805,14 +5811,10 @@ class CommonFlowApprover(AbstractModel):
 
     @property
     def NotifyType(self):
-        warnings.warn("parameter `NotifyType` is deprecated", DeprecationWarning) 
-
         return self._NotifyType
 
     @NotifyType.setter
     def NotifyType(self, NotifyType):
-        warnings.warn("parameter `NotifyType` is deprecated", DeprecationWarning) 
-
         self._NotifyType = NotifyType
 
     @property
@@ -5831,6 +5833,22 @@ class CommonFlowApprover(AbstractModel):
     def SignComponents(self, SignComponents):
         self._SignComponents = SignComponents
 
+    @property
+    def ApproverVerifyTypes(self):
+        return self._ApproverVerifyTypes
+
+    @ApproverVerifyTypes.setter
+    def ApproverVerifyTypes(self, ApproverVerifyTypes):
+        self._ApproverVerifyTypes = ApproverVerifyTypes
+
+    @property
+    def ApproverSignTypes(self):
+        return self._ApproverSignTypes
+
+    @ApproverSignTypes.setter
+    def ApproverSignTypes(self, ApproverSignTypes):
+        self._ApproverSignTypes = ApproverSignTypes
+
 
     def _deserialize(self, params):
         self._NotChannelOrganization = params.get("NotChannelOrganization")
@@ -5855,6 +5873,8 @@ class CommonFlowApprover(AbstractModel):
                 obj = Component()
                 obj._deserialize(item)
                 self._SignComponents.append(obj)
+        self._ApproverVerifyTypes = params.get("ApproverVerifyTypes")
+        self._ApproverSignTypes = params.get("ApproverSignTypes")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -6091,6 +6111,12 @@ UpperRight-右下角。
         :param _Placeholder: 填写提示的内容
 注意：此字段可能返回 null，表示取不到有效值。
         :type Placeholder: str
+        :param _LockComponentValue: 是否锁定控件值不允许编辑（嵌入式发起使用） <br/>默认false：不锁定控件值，允许在页面编辑控件值	
+注意：此字段可能返回 null，表示取不到有效值。
+        :type LockComponentValue: bool
+        :param _ForbidMoveAndDelete: 是否禁止移动和删除控件 <br/>默认false，不禁止移动和删除控件	
+注意：此字段可能返回 null，表示取不到有效值。
+        :type ForbidMoveAndDelete: bool
         """
         self._ComponentId = None
         self._ComponentType = None
@@ -6117,6 +6143,8 @@ UpperRight-右下角。
         self._RelativeLocation = None
         self._KeywordIndexes = None
         self._Placeholder = None
+        self._LockComponentValue = None
+        self._ForbidMoveAndDelete = None
 
     @property
     def ComponentId(self):
@@ -6318,6 +6346,22 @@ UpperRight-右下角。
     def Placeholder(self, Placeholder):
         self._Placeholder = Placeholder
 
+    @property
+    def LockComponentValue(self):
+        return self._LockComponentValue
+
+    @LockComponentValue.setter
+    def LockComponentValue(self, LockComponentValue):
+        self._LockComponentValue = LockComponentValue
+
+    @property
+    def ForbidMoveAndDelete(self):
+        return self._ForbidMoveAndDelete
+
+    @ForbidMoveAndDelete.setter
+    def ForbidMoveAndDelete(self, ForbidMoveAndDelete):
+        self._ForbidMoveAndDelete = ForbidMoveAndDelete
+
 
     def _deserialize(self, params):
         self._ComponentId = params.get("ComponentId")
@@ -6345,6 +6389,68 @@ UpperRight-右下角。
         self._RelativeLocation = params.get("RelativeLocation")
         self._KeywordIndexes = params.get("KeywordIndexes")
         self._Placeholder = params.get("Placeholder")
+        self._LockComponentValue = params.get("LockComponentValue")
+        self._ForbidMoveAndDelete = params.get("ForbidMoveAndDelete")
+        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 ComponentLimit(AbstractModel):
+    """签署控件的类型和范围限制条件，用于控制文件发起后签署人拖拽签署区时可使用的控件类型和具体的印章或签名方式。
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _ComponentType: 控件类型，支持以下类型
+<ul><li>SIGN_SEAL : 印章控件</li>
+<li>SIGN_PAGING_SEAL : 骑缝章控件</li>
+<li>SIGN_LEGAL_PERSON_SEAL : 企业法定代表人控件</li>
+<li>SIGN_SIGNATURE : 用户签名控件</li></ul>
+        :type ComponentType: str
+        :param _ComponentValue: 签署控件类型的值(可选)，用与限制签署时印章或者签名的选择范围
+
+1.当ComponentType 是 SIGN_SEAL 或者 SIGN_PAGING_SEAL 时可传入企业印章Id（支持多个）
+
+2.当ComponentType 是 SIGN_SIGNATURE 时可传入以下类型（支持多个）
+
+<ul><li>HANDWRITE : 手写签名</li>
+<li>OCR_ESIGN : OCR印章（智慧手写签名）</li>
+<li>ESIGN : 个人印章</li>
+<li>SYSTEM_ESIGN : 系统印章</li></ul>
+
+3.当ComponentType 是 SIGN_LEGAL_PERSON_SEAL 时无需传递此参数。
+        :type ComponentValue: list of str
+        """
+        self._ComponentType = None
+        self._ComponentValue = None
+
+    @property
+    def ComponentType(self):
+        return self._ComponentType
+
+    @ComponentType.setter
+    def ComponentType(self, ComponentType):
+        self._ComponentType = ComponentType
+
+    @property
+    def ComponentValue(self):
+        return self._ComponentValue
+
+    @ComponentValue.setter
+    def ComponentValue(self, ComponentValue):
+        self._ComponentValue = ComponentValue
+
+
+    def _deserialize(self, params):
+        self._ComponentType = params.get("ComponentType")
+        self._ComponentValue = params.get("ComponentValue")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -8950,6 +9056,10 @@ ENTERPRISESERVER-企业静默签（文件发起时的企业静默签字）。
         :param _NotifyType: SMS: 短信(需确保“电子签短信通知签署方”功能是开启状态才能生效); NONE: 不发信息
 默认为SMS(签署方为子客时该字段不生效)
         :type NotifyType: str
+        :param _AddSignComponentsLimits: [通过文件创建签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles)时,如果设置了外层参数SignBeanTag=1(允许签署过程中添加签署控件),则可通过此参数明确规定合同所使用的签署控件类型（骑缝章、普通章法人章等）和具体的印章（印章ID）或签名方式。
+
+注：`限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章（通过传递ComponentValue,支持多个），他方企业或个人只支持限制控件类型。`
+        :type AddSignComponentsLimits: list of ComponentLimit
         """
         self._Name = None
         self._IdCardType = None
@@ -8973,6 +9083,7 @@ ENTERPRISESERVER-企业静默签（文件发起时的企业静默签字）。
         self._ApproverSignTypes = None
         self._SignId = None
         self._NotifyType = None
+        self._AddSignComponentsLimits = None
 
     @property
     def Name(self):
@@ -9154,6 +9265,14 @@ ENTERPRISESERVER-企业静默签（文件发起时的企业静默签字）。
     def NotifyType(self, NotifyType):
         self._NotifyType = NotifyType
 
+    @property
+    def AddSignComponentsLimits(self):
+        return self._AddSignComponentsLimits
+
+    @AddSignComponentsLimits.setter
+    def AddSignComponentsLimits(self, AddSignComponentsLimits):
+        self._AddSignComponentsLimits = AddSignComponentsLimits
+
 
     def _deserialize(self, params):
         self._Name = params.get("Name")
@@ -9185,6 +9304,12 @@ ENTERPRISESERVER-企业静默签（文件发起时的企业静默签字）。
         self._ApproverSignTypes = params.get("ApproverSignTypes")
         self._SignId = params.get("SignId")
         self._NotifyType = params.get("NotifyType")
+        if params.get("AddSignComponentsLimits") is not None:
+            self._AddSignComponentsLimits = []
+            for item in params.get("AddSignComponentsLimits"):
+                obj = ComponentLimit()
+                obj._deserialize(item)
+                self._AddSignComponentsLimits.append(obj)
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]

tencentcloud/lcic/v20220817/models.py

@@ -1265,6 +1265,8 @@ class CreateDocumentRequest(AbstractModel):
         :type DocumentType: str
         :param _DocumentSize: 文档大小，单位 字节
         :type DocumentSize: int
+        :param _AutoHandleUnsupportedElement: 是否对不支持元素开启自动处理的功能。默认关闭。
+        :type AutoHandleUnsupportedElement: bool
         """
         self._SdkAppId = None
         self._DocumentUrl = None
@@ -1274,6 +1276,7 @@ class CreateDocumentRequest(AbstractModel):
         self._Permission = None
         self._DocumentType = None
         self._DocumentSize = None
+        self._AutoHandleUnsupportedElement = None
 
     @property
     def SdkAppId(self):
@@ -1339,6 +1342,14 @@ class CreateDocumentRequest(AbstractModel):
     def DocumentSize(self, DocumentSize):
         self._DocumentSize = DocumentSize
 
+    @property
+    def AutoHandleUnsupportedElement(self):
+        return self._AutoHandleUnsupportedElement
+
+    @AutoHandleUnsupportedElement.setter
+    def AutoHandleUnsupportedElement(self, AutoHandleUnsupportedElement):
+        self._AutoHandleUnsupportedElement = AutoHandleUnsupportedElement
+
 
     def _deserialize(self, params):
         self._SdkAppId = params.get("SdkAppId")
@@ -1349,6 +1360,7 @@ class CreateDocumentRequest(AbstractModel):
         self._Permission = params.get("Permission")
         self._DocumentType = params.get("DocumentType")
         self._DocumentSize = params.get("DocumentSize")
+        self._AutoHandleUnsupportedElement = params.get("AutoHandleUnsupportedElement")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]