tencentcloud-sdk-python 3.0.1210__py2.py3-none-any.whl → 3.0.1225__py2.py3-none-any.whl

tencentcloud/ess/v20201111/models.py

@@ -2721,6 +2721,352 @@ class CreateBatchCancelFlowUrlResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class CreateBatchInitOrganizationUrlRequest(AbstractModel):
+    """CreateBatchInitOrganizationUrl请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Operator: 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+        :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
+        :param _OperateTypes: 初始化操作类型
+<ul><li>CREATE_SEAL : 创建印章</li>
+<li>AUTH_JOIN_ORGANIZATION_GROUP : 加入集团企业</li>
+<li>OPEN_AUTO_SIGN :开通企业自动签署</li></ul>
+        :type OperateTypes: list of str
+        :param _OrganizationIds: 批量操作的企业Id列表，最大支持50个
+        :type OrganizationIds: list of str
+        :param _Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
+        """
+        self._Operator = None
+        self._OperateTypes = None
+        self._OrganizationIds = None
+        self._Agent = None
+
+    @property
+    def Operator(self):
+        return self._Operator
+
+    @Operator.setter
+    def Operator(self, Operator):
+        self._Operator = Operator
+
+    @property
+    def OperateTypes(self):
+        return self._OperateTypes
+
+    @OperateTypes.setter
+    def OperateTypes(self, OperateTypes):
+        self._OperateTypes = OperateTypes
+
+    @property
+    def OrganizationIds(self):
+        return self._OrganizationIds
+
+    @OrganizationIds.setter
+    def OrganizationIds(self, OrganizationIds):
+        self._OrganizationIds = OrganizationIds
+
+    @property
+    def Agent(self):
+        return self._Agent
+
+    @Agent.setter
+    def Agent(self, Agent):
+        self._Agent = Agent
+
+
+    def _deserialize(self, params):
+        if params.get("Operator") is not None:
+            self._Operator = UserInfo()
+            self._Operator._deserialize(params.get("Operator"))
+        self._OperateTypes = params.get("OperateTypes")
+        self._OrganizationIds = params.get("OrganizationIds")
+        if params.get("Agent") is not None:
+            self._Agent = Agent()
+            self._Agent._deserialize(params.get("Agent"))
+        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 CreateBatchInitOrganizationUrlResponse(AbstractModel):
+    """CreateBatchInitOrganizationUrl返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _MiniAppPath: 小程序路径
+        :type MiniAppPath: str
+        :param _OperateLongUrl: 操作长链
+        :type OperateLongUrl: str
+        :param _OperateShortUrl: 操作短链
+        :type OperateShortUrl: str
+        :param _QRCodeUrl: 操作二维码
+        :type QRCodeUrl: str
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._MiniAppPath = None
+        self._OperateLongUrl = None
+        self._OperateShortUrl = None
+        self._QRCodeUrl = None
+        self._RequestId = None
+
+    @property
+    def MiniAppPath(self):
+        return self._MiniAppPath
+
+    @MiniAppPath.setter
+    def MiniAppPath(self, MiniAppPath):
+        self._MiniAppPath = MiniAppPath
+
+    @property
+    def OperateLongUrl(self):
+        return self._OperateLongUrl
+
+    @OperateLongUrl.setter
+    def OperateLongUrl(self, OperateLongUrl):
+        self._OperateLongUrl = OperateLongUrl
+
+    @property
+    def OperateShortUrl(self):
+        return self._OperateShortUrl
+
+    @OperateShortUrl.setter
+    def OperateShortUrl(self, OperateShortUrl):
+        self._OperateShortUrl = OperateShortUrl
+
+    @property
+    def QRCodeUrl(self):
+        return self._QRCodeUrl
+
+    @QRCodeUrl.setter
+    def QRCodeUrl(self, QRCodeUrl):
+        self._QRCodeUrl = QRCodeUrl
+
+    @property
+    def RequestId(self):
+        return self._RequestId
+
+    @RequestId.setter
+    def RequestId(self, RequestId):
+        self._RequestId = RequestId
+
+
+    def _deserialize(self, params):
+        self._MiniAppPath = params.get("MiniAppPath")
+        self._OperateLongUrl = params.get("OperateLongUrl")
+        self._OperateShortUrl = params.get("OperateShortUrl")
+        self._QRCodeUrl = params.get("QRCodeUrl")
+        self._RequestId = params.get("RequestId")
+
+
+class CreateBatchOrganizationAuthorizationUrlRequest(AbstractModel):
+    """CreateBatchOrganizationAuthorizationUrl请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Operator: 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+        :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
+        :param _AdminName: 组织机构超管姓名。 在注册流程中，必须是超管本人进行操作。
+此参数需要跟[创建企业批量认证链接](https://qian.tencent.com/developers/companyApis/organizations/CreateBatchOrganizationRegistrationTasks)中 AdminName 保持一致。
+        :type AdminName: str
+        :param _AdminMobile: 组织机构超管手机号。 在注册流程中，必须是超管本人进行操作。此参数需要跟[创建企业批量认证链接](https://qian.tencent.com/developers/companyApis/organizations/CreateBatchOrganizationRegistrationTasks)中 Admin Mobile保持一致。
+        :type AdminMobile: str
+        :param _Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
+        :param _SubTaskIds: 企业批量认证链接的子任务 SubTaskId，该 SubTaskId 是通过接口 查询企业批量认证链接 DescribeBatchOrganizationRegistrationUrls 获得。此参数需与超管个人三要素（AdminName，AdminMobile，AdminIdCardNumber）配合使用。若 SubTaskId 不属于传入的超级管理员，将进行筛选。
+        :type SubTaskIds: list of str
+        :param _AdminIdCardType: 组织机构超管证件类型支持以下类型
+- ID_CARD : 居民身份证 (默认值)
+-  HONGKONG_AND_MACAO : 港澳居民来往内地通行证
+- HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)
+此参数需要跟[创建企业批量认证链接](https://qian.tencent.com/developers/companyApis/organizations/CreateBatchOrganizationRegistrationTasks)中 AdminIdCardType保持一致。
+        :type AdminIdCardType: str
+        :param _AdminIdCardNumber: 组织机构超管证件号。 在注册流程中，必须是超管本人进行操作。此参数需要跟[创建企业批量认证链接](https://qian.tencent.com/developers/companyApis/organizations/CreateBatchOrganizationRegistrationTasks)中 AdminIdCardNumber保持一致。
+        :type AdminIdCardNumber: str
+        :param _Endpoint: 要跳转的链接类型<ul><li> **HTTP**：跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型  ，此时返回长链 (默认类型)</li><li>**HTTP_SHORT_URL**：跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型，此时返回短链</li><li>**APP**： 第三方APP或小程序跳转电子签小程序的path,  APP或者小程序跳转适合此类型</li><li>**QR_CODE**： 跳转电子签小程序的http_url的二维码形式,  可以在页面展示适合此类型</li></ul>
+        :type Endpoint: str
+        """
+        self._Operator = None
+        self._AdminName = None
+        self._AdminMobile = None
+        self._Agent = None
+        self._SubTaskIds = None
+        self._AdminIdCardType = None
+        self._AdminIdCardNumber = None
+        self._Endpoint = None
+
+    @property
+    def Operator(self):
+        return self._Operator
+
+    @Operator.setter
+    def Operator(self, Operator):
+        self._Operator = Operator
+
+    @property
+    def AdminName(self):
+        return self._AdminName
+
+    @AdminName.setter
+    def AdminName(self, AdminName):
+        self._AdminName = AdminName
+
+    @property
+    def AdminMobile(self):
+        return self._AdminMobile
+
+    @AdminMobile.setter
+    def AdminMobile(self, AdminMobile):
+        self._AdminMobile = AdminMobile
+
+    @property
+    def Agent(self):
+        return self._Agent
+
+    @Agent.setter
+    def Agent(self, Agent):
+        self._Agent = Agent
+
+    @property
+    def SubTaskIds(self):
+        return self._SubTaskIds
+
+    @SubTaskIds.setter
+    def SubTaskIds(self, SubTaskIds):
+        self._SubTaskIds = SubTaskIds
+
+    @property
+    def AdminIdCardType(self):
+        return self._AdminIdCardType
+
+    @AdminIdCardType.setter
+    def AdminIdCardType(self, AdminIdCardType):
+        self._AdminIdCardType = AdminIdCardType
+
+    @property
+    def AdminIdCardNumber(self):
+        return self._AdminIdCardNumber
+
+    @AdminIdCardNumber.setter
+    def AdminIdCardNumber(self, AdminIdCardNumber):
+        self._AdminIdCardNumber = AdminIdCardNumber
+
+    @property
+    def Endpoint(self):
+        return self._Endpoint
+
+    @Endpoint.setter
+    def Endpoint(self, Endpoint):
+        self._Endpoint = Endpoint
+
+
+    def _deserialize(self, params):
+        if params.get("Operator") is not None:
+            self._Operator = UserInfo()
+            self._Operator._deserialize(params.get("Operator"))
+        self._AdminName = params.get("AdminName")
+        self._AdminMobile = params.get("AdminMobile")
+        if params.get("Agent") is not None:
+            self._Agent = Agent()
+            self._Agent._deserialize(params.get("Agent"))
+        self._SubTaskIds = params.get("SubTaskIds")
+        self._AdminIdCardType = params.get("AdminIdCardType")
+        self._AdminIdCardNumber = params.get("AdminIdCardNumber")
+        self._Endpoint = params.get("Endpoint")
+        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 CreateBatchOrganizationAuthorizationUrlResponse(AbstractModel):
+    """CreateBatchOrganizationAuthorizationUrl返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _AuthUrl: 批量企业注册链接-单链接包含多条认证流，根据Endpoint的不同设置，返回不同的链接地址。失效时间：7天
+跳转链接, 链接的有效期根据企业,员工状态和终端等有区别, 可以参考下表
+<table> <thead> <tr> <th>Endpoint</th> <th>示例</th> <th>链接有效期限</th> </tr> </thead>  <tbody>
+ <tr> <td>HTTP</td> <td>https://res.ess.tencent.cn/cdn/h5-activity-dev/jump-mp.html?to=AUTHORIZATION_ENTERPRISE_FOR_BATCH_SUBMIT&shortKey=yDCHHURDfBxSB2rj2Bfa</td> <td>7天</td> </tr> 
+<tr> <td>HTTP_SHORT_URL</td> <td>https://test.essurl.cn/8gDKUBAWK8</td> <td>7天</td> </tr> 
+<tr> <td>APP</td> <td>pages/guide/index?to=AUTHORIZATION_ENTERPRISE_FOR_BATCH_SUBMIT&shortKey=yDCHpURDfR6iEkdpsDde</td> <td>7天</td> </tr><tr> <td>QR_CODE</td> <td>https://dyn.test.ess.tencent.cn/imgs/qrcode_urls/authorization_enterprise_for_batch_submit/yDCHHUUckpbdauq9UEjnoFDCCumAMmv1.png</td> <td>7天</td> </tr> </tbody> </table>
+注： 
+`1.创建的链接应避免被转义，如：&被转义为\u0026；如使用Postman请求后，请选择响应类型为 JSON，否则链接将被转义`
+
+        :type AuthUrl: str
+        :param _ErrorMessages: 认证流认证失败信息
+        :type ErrorMessages: list of str
+        :param _ExpireTime: 链接过期时间，为 7 天后，创建时间，格式为Unix标准时间戳（秒）。
+        :type ExpireTime: int
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._AuthUrl = None
+        self._ErrorMessages = None
+        self._ExpireTime = None
+        self._RequestId = None
+
+    @property
+    def AuthUrl(self):
+        return self._AuthUrl
+
+    @AuthUrl.setter
+    def AuthUrl(self, AuthUrl):
+        self._AuthUrl = AuthUrl
+
+    @property
+    def ErrorMessages(self):
+        return self._ErrorMessages
+
+    @ErrorMessages.setter
+    def ErrorMessages(self, ErrorMessages):
+        self._ErrorMessages = ErrorMessages
+
+    @property
+    def ExpireTime(self):
+        return self._ExpireTime
+
+    @ExpireTime.setter
+    def ExpireTime(self, ExpireTime):
+        self._ExpireTime = ExpireTime
+
+    @property
+    def RequestId(self):
+        return self._RequestId
+
+    @RequestId.setter
+    def RequestId(self, RequestId):
+        self._RequestId = RequestId
+
+
+    def _deserialize(self, params):
+        self._AuthUrl = params.get("AuthUrl")
+        self._ErrorMessages = params.get("ErrorMessages")
+        self._ExpireTime = params.get("ExpireTime")
+        self._RequestId = params.get("RequestId")
+
+
 class CreateBatchOrganizationRegistrationTasksRequest(AbstractModel):
     """CreateBatchOrganizationRegistrationTasks请求参数结构体
 
@@ -15101,10 +15447,10 @@ class DescribeUserAutoSignStatusResponse(AbstractModel):
 
 值为unix时间戳,单位为秒。
         :type LicenseTo: int
-        :param _LicenseType: 设置用户开通自动签时是否绑定个人自动签账号许可。
-
-<ul><li>**0**: 使用个人自动签账号许可进行开通，个人自动签账号许可有效期1年，注: `不可解绑释放更换他人`</li></ul>
+        :param _LicenseType: 设置用户开通自动签时是否绑定个人自动签账号许可。<ul><li>**0**: 使用个人自动签账号许可进行开通，个人自动签账号许可有效期1年，注: `不可解绑释放更换他人`</li><li>**1**: 不绑定自动签账号许可开通，后续使用合同份额进行合同发起</li></ul>
         :type LicenseType: int
+        :param _SealId: 用户开通自动签指定使用的印章，为空则未设置印章，需重新进入开通链接设置印章。
+        :type SealId: str
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
         """
@@ -15112,6 +15458,7 @@ class DescribeUserAutoSignStatusResponse(AbstractModel):
         self._LicenseFrom = None
         self._LicenseTo = None
         self._LicenseType = None
+        self._SealId = None
         self._RequestId = None
 
     @property
@@ -15146,6 +15493,14 @@ class DescribeUserAutoSignStatusResponse(AbstractModel):
     def LicenseType(self, LicenseType):
         self._LicenseType = LicenseType
 
+    @property
+    def SealId(self):
+        return self._SealId
+
+    @SealId.setter
+    def SealId(self, SealId):
+        self._SealId = SealId
+
     @property
     def RequestId(self):
         return self._RequestId
@@ -15160,6 +15515,7 @@ class DescribeUserAutoSignStatusResponse(AbstractModel):
         self._LicenseFrom = params.get("LicenseFrom")
         self._LicenseTo = params.get("LicenseTo")
         self._LicenseType = params.get("LicenseType")
+        self._SealId = params.get("SealId")
         self._RequestId = params.get("RequestId")
 
 
@@ -20280,9 +20636,12 @@ class OrganizationAuthUrl(AbstractModel):
         :type AuthUrl: str
         :param _ErrorMessage: 企业批量注册的错误信息，例如：企业三要素不通过	
         :type ErrorMessage: str
+        :param _SubTaskId: 企业批量注册的唯一 Id， 此 Id 可以用在[创建企业批量认证链接-单链接](https://qian.tencent.com/developers/companyApis/organizations/CreateBatchOrganizationAuthorizationUrl)。
+        :type SubTaskId: str
         """
         self._AuthUrl = None
         self._ErrorMessage = None
+        self._SubTaskId = None
 
     @property
     def AuthUrl(self):
@@ -20300,10 +20659,19 @@ class OrganizationAuthUrl(AbstractModel):
     def ErrorMessage(self, ErrorMessage):
         self._ErrorMessage = ErrorMessage
 
+    @property
+    def SubTaskId(self):
+        return self._SubTaskId
+
+    @SubTaskId.setter
+    def SubTaskId(self, SubTaskId):
+        self._SubTaskId = SubTaskId
+
 
     def _deserialize(self, params):
         self._AuthUrl = params.get("AuthUrl")
         self._ErrorMessage = params.get("ErrorMessage")
+        self._SubTaskId = params.get("SubTaskId")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -20904,6 +21272,11 @@ WECHAT-微信通知
 <li> 5 :设备指纹识别</li>
 <li> 6 :设备面容识别</li></ul>
         :type ApproverSignTypes: list of int
+        :param _NoTransfer: 签署方是否可以转他人处理
+
+<ul><li> **false** : ( 默认)可以转他人处理</li>
+<li> **true** :不可以转他人处理</li></ul>
+        :type NoTransfer: bool
         """
         self._RecipientId = None
         self._RecipientType = None
@@ -20920,6 +21293,7 @@ WECHAT-微信通知
         self._RecipientExtra = None
         self._ApproverVerifyTypes = None
         self._ApproverSignTypes = None
+        self._NoTransfer = None
 
     @property
     def RecipientId(self):
@@ -21041,6 +21415,14 @@ WECHAT-微信通知
     def ApproverSignTypes(self, ApproverSignTypes):
         self._ApproverSignTypes = ApproverSignTypes
 
+    @property
+    def NoTransfer(self):
+        return self._NoTransfer
+
+    @NoTransfer.setter
+    def NoTransfer(self, NoTransfer):
+        self._NoTransfer = NoTransfer
+
 
     def _deserialize(self, params):
         self._RecipientId = params.get("RecipientId")
@@ -21058,6 +21440,7 @@ WECHAT-微信通知
         self._RecipientExtra = params.get("RecipientExtra")
         self._ApproverVerifyTypes = params.get("ApproverVerifyTypes")
         self._ApproverSignTypes = params.get("ApproverSignTypes")
+        self._NoTransfer = params.get("NoTransfer")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]

tencentcloud/essbasic/v20210526/essbasic_client.py

@@ -213,8 +213,8 @@ class EssbasicClient(AbstractClient):
         请确保生成链接时候的身份信息和签署合同参与方的信息保持一致。
 
         注：
-        - 使用此接口生成链接，需要提前开通 `使用手机号验证签署方身份` 功能，在 `腾讯电子签网页端-企业设置-拓展服务` 中可以找到。
-        - 参与人点击链接后需短信验证码才能查看合同内容。
+        - 使用此接口生成链接，需要提前开通 `个人签署方仅校验手机号` 功能，在 `腾讯电子签网页端-企业设置-拓展服务` 中可以找到。
+        - 个人参与方点击链接后需短信验证码才能查看合同内容。
         - 个人用户批量签署，需要传Name，Mobile，IdCardNumber(IdCardType) 参数。
         - saas企业员工用户批量签署，在传递了姓名等基本信息参数的情况下，还需要传OrganizationName（参与方所在企业名称）参数生成签署链接，<font color="red">请确保此企业已完成腾讯电子签企业认证</font>。
         - 子客企业员工用户批量签署，需要传递员工OpenId和子客企业的OrganizationOpenId。<font color="red">请确保此OrganizationOpenId对应子客已经认证，且OpenId对应员工此子客下已经实名</font>。Name，Mobile, IdCard等信息此时可以不传，系统会查询此OpenId实名信息自动补充。
@@ -1499,6 +1499,35 @@ class EssbasicClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def CreateBatchInitOrganizationUrl(self, request):
+        """支持企业进行批量初始化操作：
+
+        此接口存在以下限制：
+        1. 批量操作的企业需要已经完成电子签的认证流程。
+        2. 通过此接口生成的链接在小程序端进行操作时，操作人需要是<font  color="red">所有企业的超管或法人</font>。
+        3. 批量操作的企业，需要是本方第三方应用下的企业。
+        4. <font  color="red">操作链接过期时间默认为生成链接后7天。</font>
+
+        :param request: Request instance for CreateBatchInitOrganizationUrl.
+        :type request: :class:`tencentcloud.essbasic.v20210526.models.CreateBatchInitOrganizationUrlRequest`
+        :rtype: :class:`tencentcloud.essbasic.v20210526.models.CreateBatchInitOrganizationUrlResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("CreateBatchInitOrganizationUrl", params, headers=headers)
+            response = json.loads(body)
+            model = models.CreateBatchInitOrganizationUrlResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def CreateBatchOrganizationRegistrationTasks(self, request):
         """该接口用于批量创建企业认证链接， 可以支持PC浏览器，H5和小程序三种途径。
         此接口为异步提交任务接口，需要与[查询子企业批量认证链接](https://qcloudimg.tencent-cloud.cn/raw/1d3737991b2a3be78002bd78a47d6917.png)配合使用，整体流程如下图。