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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1642,7 +1642,7 @@ class ChannelCancelMultiFlowSignQRCodeRequest(AbstractModel):
1642
1642
  </ul>
1643
1643
  第三方平台子客企业和员工必须已经经过实名认证
1644
1644
  :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
1645
- :param _QrCodeId: 需要取消签署的二维码ID,为32位字符串。由[创建一码多扫流程签署二维码](https://qian.tencent.com/developers/partnerApis/templates/ChannelCreateMultiFlowSignQRCode)返回
1645
+ :param _QrCodeId: 需要取消的签署码ID,为32位字符串。由[创建一码多签签署码](https://qian.tencent.com/developers/partnerApis/templates/ChannelCreateMultiFlowSignQRCode)返回
1646
1646
  :type QrCodeId: str
1647
1647
  :param _Operator: 暂未开放
1648
1648
  :type Operator: :class:`tencentcloud.essbasic.v20210526.models.UserInfo`
@@ -1837,9 +1837,9 @@ class ChannelCreateBatchCancelFlowUrlRequest(AbstractModel):
1837
1837
  <ul>
1838
1838
  <li>渠道应用标识: Agent.AppId</li>
1839
1839
  <li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
1840
- <li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
1840
+ <li>第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId</li>
1841
1841
  </ul>
1842
- 第三方平台子客企业和员工必须已经经过实名认证
1842
+ 第三方平台子客企业和员工必须已经过实名认证
1843
1843
  :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
1844
1844
  :param _FlowIds: 要撤销的合同流程ID列表,最多100个,超过100不处理
1845
1845
  :type FlowIds: list of str
@@ -1905,6 +1905,8 @@ class ChannelCreateBatchCancelFlowUrlResponse(AbstractModel):
1905
1905
  def __init__(self):
1906
1906
  r"""
1907
1907
  :param _BatchCancelFlowUrl: 批量撤销合同的URL链接, 需要在手机端打开, 有效期24小时
1908
+
1909
+ 注:<font color="red">生成的链路后面不能再增加参数</font>(会出现覆盖链接中已有参数导致错误)
1908
1910
  :type BatchCancelFlowUrl: str
1909
1911
  :param _FailMessages: 与入参的FlowIds数组一致, 成功生成到撤销链接中,则为"", 不能撤销合同则为失败原因
1910
1912
  :type FailMessages: list of str
@@ -1991,7 +1993,8 @@ class ChannelCreateBatchQuickSignUrlRequest(AbstractModel):
1991
1993
  <li>**4**:系统签名</li></ul>
1992
1994
  注:
1993
1995
  <ul><li>默认情况下,签名类型为手写签名</li>
1994
- <li>您可以传递多种值,表示可用多种签名类型。</li></ul>
1996
+ <li>您可以传递多种值,表示可用多种签名类型。</li>
1997
+ <li>该参数会覆盖您合同中的签名类型,若您在发起合同时限定了签名类型(赋值签名类型给ComponentTypeLimit),请将这些签名类型赋予此参数</li></ul>
1995
1998
  :type SignatureTypes: list of int
1996
1999
  :param _ApproverSignTypes: 指定批量签署合同的认证校验方式,可传递以下值:
1997
2000
  <ul><li>**1**:人脸认证(默认),需进行人脸识别成功后才能签署合同</li>
@@ -2151,7 +2154,15 @@ class ChannelCreateBatchSignUrlRequest(AbstractModel):
2151
2154
 
2152
2155
  def __init__(self):
2153
2156
  r"""
2154
- :param _Agent: 关于渠道应用的相关信息,包括子客企业及应用编、号等详细内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
2157
+ :param _Agent: 关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
2158
+
2159
+ 此接口下面信息必填。
2160
+ <ul>
2161
+ <li>渠道应用标识: Agent.AppId</li>
2162
+ <li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
2163
+ <li>第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId</li>
2164
+ </ul>
2165
+ 第三方平台子客企业和员工必须已经过实名认证
2155
2166
  :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
2156
2167
  :param _Name: 签署方经办人的姓名。
2157
2168
  经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
@@ -2197,7 +2208,7 @@ class ChannelCreateBatchSignUrlRequest(AbstractModel):
2197
2208
  <li>请确认该名称与企业营业执照中注册的名称一致。</li>
2198
2209
  <li>如果名称中包含英文括号(),请使用中文括号()代替。</li>
2199
2210
  <li>请确保此企业已完成腾讯电子签企业认证。</li>
2200
- <li>若为子客企业,请确保员工已经加入企业。</li>
2211
+ <li>暂时仅支持给`自建应用集成企业` 生成员工批签链接,不支持子客企业。</li>
2201
2212
  </ul>
2202
2213
  :type OrganizationName: str
2203
2214
  :param _JumpToDetail: 是否直接跳转至合同内容页面进行签署
@@ -2333,13 +2344,17 @@ class ChannelCreateBatchSignUrlResponse(AbstractModel):
2333
2344
  r"""
2334
2345
  :param _SignUrl: 批量签署链接,以短链形式返回,短链的有效期参考回参中的 ExpiredTime。
2335
2346
 
2336
- 注: `非小程序和APP集成使用`
2347
+ 注:
2348
+ 1. 非小程序和APP集成使用
2349
+ 2. <font color="red">生成的链路后面不能再增加参数</font>(会出现覆盖链接中已有参数导致错误)
2337
2350
  :type SignUrl: str
2338
2351
  :param _ExpiredTime: 链接过期时间以 Unix 时间戳格式表示,从生成链接时间起,往后7天有效期。过期后短链将失效,无法打开。
2339
2352
  :type ExpiredTime: int
2340
2353
  :param _MiniAppPath: 从客户小程序或者客户APP跳转至腾讯电子签小程序进行批量签署的跳转路径
2341
2354
 
2342
- 注: `小程序和APP集成使用`
2355
+ 注:
2356
+ 1. 小程序和APP集成使用
2357
+ 2. <font color="red">生成的链路后面不能再增加参数</font>(会出现覆盖链接中已有参数导致错误)
2343
2358
  :type MiniAppPath: str
2344
2359
  :param _RequestId: 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2345
2360
  :type RequestId: str
@@ -2987,9 +3002,9 @@ class ChannelCreateFlowByFilesRequest(AbstractModel):
2987
3002
 
2988
3003
  此接口下面信息必填。
2989
3004
  <ul>
2990
- <li>渠道应用标识: Agent.ProxyOrganizationOpenId</li>
2991
- <li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
2992
- <li>第三方平台子客企业中的员工标识: Agent.AppId</li>
3005
+ <li>渠道应用标识: Agent.AppId</li>
3006
+ <li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
3007
+ <li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
2993
3008
  </ul>
2994
3009
  :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
2995
3010
  :param _FlowName: 合同流程的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。
@@ -3788,23 +3803,29 @@ class ChannelCreateFlowSignReviewRequest(AbstractModel):
3788
3803
  r"""
3789
3804
  :param _Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 必填。
3790
3805
  :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
3791
- :param _FlowId: 签署流程编号
3806
+ :param _FlowId: 合同流程ID,为32位字符串。
3807
+ <ul><li>建议开发者妥善保存此流程ID,以便于顺利进行后续操作。</li>
3808
+ <li>可登录腾讯电子签控制台,在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。</li></ul>
3792
3809
  :type FlowId: str
3793
3810
  :param _ReviewType: 企业内部审核结果
3794
- PASS: 通过
3795
- REJECT: 拒绝
3796
- SIGN_REJECT:拒签(流程结束)
3811
+ <ul><li>PASS: 审核通过</li>
3812
+ <li>REJECT: 审核拒绝</li>
3813
+ <li>SIGN_REJECT:拒签(流程结束)</li></ul>
3797
3814
  :type ReviewType: str
3798
- :param _ReviewMessage: 审核原因
3799
- 当ReviewType 是REJECT 时此字段必填,字符串长度不超过200
3815
+ :param _ReviewMessage: 审核结果原因
3816
+ <ul><li>字符串长度不超过200</li>
3817
+ <li>当ReviewType 是拒绝(REJECT) 时此字段必填。</li>
3818
+ <li>当ReviewType 是拒绝(SIGN_REJECT) 时此字段必填。</li></ul>
3800
3819
  :type ReviewMessage: str
3801
- :param _RecipientId: 签署节点审核时需要指定,给个人审核时必填。
3820
+ :param _RecipientId: 审核节点的签署人标志,用于指定当前审核的签署方
3821
+ <ul><li>**如果签署审核节点是个人, 此参数必填**。</li></ul>
3802
3822
  :type RecipientId: str
3803
- :param _OperateType: 操作类型,默认:SignReview;SignReview:签署审核,CreateReview:发起审核
3804
- 注:接口通过该字段区分操作类型
3805
- 该字段不传或者为空,则默认为SignReview签署审核,走签署审核流程
3806
- 若想使用发起审核,请指定该字段为:CreateReview
3807
- 若发起个人审核,则指定该字段为:SignReview
3823
+ :param _OperateType: 流程审核操作类型,取值如下:
3824
+ <ul><li>**SignReview**:(默认)签署审核</li>
3825
+ <li>**CreateReview**:发起审核</li>
3826
+ <li>注意:`该字段不传或者为空,则默认为SignReview签署审核,走签署审核流程`</li></ul>
3827
+
3828
+
3808
3829
  :type OperateType: str
3809
3830
  """
3810
3831
  self._Agent = None
@@ -4272,9 +4293,9 @@ class ChannelCreateMultiFlowSignQRCodeResponse(AbstractModel):
4272
4293
 
4273
4294
  def __init__(self):
4274
4295
  r"""
4275
- :param _QrCode: 签署二维码的基本信息,用于创建二维码,用户可扫描该二维码进行签署操作。
4296
+ :param _QrCode: 一码多签签署码的基本信息,用户可扫描该二维码进行签署操作。
4276
4297
  :type QrCode: :class:`tencentcloud.essbasic.v20210526.models.SignQrCode`
4277
- :param _SignUrls: 流程签署二维码的签署信息,适用于客户系统整合二维码功能。通过链接,用户可直接访问电子签名小程序并签署合同。
4298
+ :param _SignUrls: 一码多签签署码链接信息,适用于客户系统整合二维码功能。通过链接,用户可直接访问电子签名小程序并签署合同。
4278
4299
  :type SignUrls: :class:`tencentcloud.essbasic.v20210526.models.SignUrl`
4279
4300
  :param _RequestId: 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
4280
4301
  :type RequestId: str
@@ -4570,8 +4591,9 @@ class ChannelCreatePrepareFlowRequest(AbstractModel):
4570
4591
  :param _ResourceId: 资源id,与ResourceType相对应,取值范围:
4571
4592
  <ul>
4572
4593
  <li>文件Id(通过UploadFiles获取文件资源Id)</li>
4573
- <li>模板Id</li>
4594
+ <li>模板Id(通过控制台创建模板后获取模板Id)</li>
4574
4595
  </ul>
4596
+ 注意:需要同时设置 ResourceType 参数指定资源类型
4575
4597
  :type ResourceId: str
4576
4598
  :param _FlowOption: 合同流程配置信息,用于配置发起合同时定制化如是否允许修改,某些按钮的隐藏等逻辑
4577
4599
  :type FlowOption: :class:`tencentcloud.essbasic.v20210526.models.CreateFlowOption`
@@ -8455,7 +8477,7 @@ class CommonFlowApprover(AbstractModel):
8455
8477
 
8456
8478
  注: `签署方为第三方子客企业时会被置为NONE, 不会发短信通知`
8457
8479
  :type NotifyType: str
8458
- :param _ApproverOption: 签署人配置
8480
+ :param _ApproverOption: 签署人配置,用于控制签署人相关属性
8459
8481
  :type ApproverOption: :class:`tencentcloud.essbasic.v20210526.models.CommonApproverOption`
8460
8482
  :param _SignComponents: 使用PDF文件直接发起合同时,签署人指定的签署控件;<br/>使用模板发起合同时,指定本企业印章签署控件的印章ID: <br/>通过ComponentId或ComponenetName指定签署控件,ComponentValue为印章ID。
8461
8483
  :type SignComponents: list of Component
@@ -8703,223 +8725,188 @@ class Component(AbstractModel):
8703
8725
 
8704
8726
  def __init__(self):
8705
8727
  r"""
8706
- :param _ComponentId: 控件编号
8728
+ :param _ComponentId: 控件唯一ID。
8707
8729
 
8708
- CreateFlowByTemplates发起合同时优先以ComponentId(不为空)填充;否则以ComponentName填充
8730
+ **在绝对定位方式方式下**,ComponentId为控件的ID,长度不能超过30,只能由中文、字母、数字和下划线组成,可以在后续的操作中使用该名称来引用控件。
8709
8731
 
8710
- 注:
8711
- 当GenerateMode=KEYWORD时,通过"^"来决定是否使用关键字整词匹配能力。
8712
- 例:当GenerateMode=KEYWORD时,如果传入关键字"^甲方签署^",则会在PDF文件中有且仅有"甲方签署"关键字的地方进行对应操作。
8713
- 如传入的关键字为"甲方签署",则PDF文件中每个出现关键字的位置都会执行相应操作。
8732
+ **在关键字定位方式下**,ComponentId不仅为控件的ID,也是关键字整词。此方式下可以通过"^"来决定是否使用关键字整词匹配能力。
8733
+
8734
+ 例:
8735
+
8736
+ - 如传入的关键字<font color="red">"^甲方签署^"</font >,则会在PDF文件中有且仅有"甲方签署"关键字的地方(<font color="red">前后不能有其他字符</font >)进行对应操作。
8737
+ - 如传入的关键字为<font color="red">"甲方签署</font >",则PDF文件中每个出现关键字的位置(<font color="red">前后可以有其他字符</font >)都会执行相应操作。
8738
+ - 如传入的关键字为<font color="red">"^甲方签署</font >",则PDF文件中每个出现关键字的位置(<font color="red">前面不能有其他字符</font >)都会执行相应操作。
8739
+ - 如传入的关键字为<font color="red">"甲方签署^</font >",则PDF文件中每个出现关键字的位置(<font color="red">后面不能有其他字符</font >)都会执行相应操作。
8740
+
8741
+
8742
+ 注:`控件ID可以在一个PDF中不可重复`
8714
8743
 
8715
- 创建控件时,此值为空
8716
- 查询时返回完整结构
8717
8744
  :type ComponentId: str
8718
- :param _ComponentType: 如果是Component控件类型,则可选的字段为:
8719
- TEXT - 普通文本控件,输入文本字符串;
8720
- MULTI_LINE_TEXT - 多行文本控件,输入文本字符串;
8721
- CHECK_BOX - 勾选框控件,若选中填写ComponentValue 填写 true或者 false 字符串;
8722
- FILL_IMAGE - 图片控件,ComponentValue 填写图片的资源 ID;
8723
- DYNAMIC_TABLE - 动态表格控件;
8724
- ATTACHMENT - 附件控件,ComponentValue 填写附件图片的资源 ID列表,以逗号分割;
8725
- SELECTOR - 选择器控件,ComponentValue填写选择的字符串内容;
8726
- DATE - 日期控件;默认是格式化为xxxx年xx月xx日字符串;
8727
- DISTRICT - 省市区行政区控件,ComponentValue填写省市区行政区字符串内容;
8728
-
8729
- 如果是SignComponent控件类型,则可选的字段为
8730
- SIGN_SEAL - 签署印章控件;
8731
- SIGN_DATE - 签署日期控件;
8732
- SIGN_SIGNATURE - 用户签名控件;
8733
- SIGN_PERSONAL_SEAL - 个人签署印章控件(使用文件发起暂不支持此类型);
8734
- SIGN_PAGING_SEAL - 骑缝章;若文件发起,需要对应填充ComponentPosY、ComponentWidth、ComponentHeight
8735
- SIGN_OPINION - 签署意见控件,用户需要根据配置的签署意见内容,完成对意见内容的确认;
8736
- SIGN_LEGAL_PERSON_SEAL - 企业法定代表人控件。
8737
-
8738
- 表单域的控件不能作为印章和签名控件
8745
+ :param _ComponentType: **如果是Component填写控件类型,则可选的字段为**:
8746
+
8747
+ <ul><li> <b>TEXT</b> : 普通文本控件,输入文本字符串;</li>
8748
+ <li> <b>MULTI_LINE_TEXT</b> : 多行文本控件,输入文本字符串;</li>
8749
+ <li> <b>CHECK_BOX</b> : 勾选框控件,若选中填写ComponentValue 填写 true或者 false 字符串;</li>
8750
+ <li> <b>FILL_IMAGE</b> : 图片控件,ComponentValue 填写图片的资源 ID;</li>
8751
+ <li> <b>DYNAMIC_TABLE</b> : 动态表格控件;</li>
8752
+ <li> <b>ATTACHMENT</b> : 附件控件,ComponentValue 填写附件图片的资源 ID列表,以逗号分隔;</li>
8753
+ <li> <b>SELECTOR</b> : 选择器控件,ComponentValue填写选择的字符串内容;</li>
8754
+ <li> <b>DATE</b> : 日期控件;默认是格式化为xxxx年xx月xx日字符串;</li>
8755
+ <li> <b>DISTRICT</b> : 省市区行政区控件,ComponentValue填写省市区行政区字符串内容;</li></ul>
8756
+
8757
+ **如果是SignComponent签署控件类型,则可选的字段为**
8758
+
8759
+ <ul><li> <b>SIGN_SEAL</b> : 签署印章控件;</li>
8760
+ <li> <b>SIGN_DATE</b> : 签署日期控件;</li>
8761
+ <li> <b>SIGN_SIGNATURE</b> : 用户签名控件;</li>
8762
+ <li> <b>SIGN_PERSONAL_SEAL</b> : 个人签署印章控件(使用文件发起暂不支持此类型);</li>
8763
+ <li> <b>SIGN_PAGING_SEAL</b> : 骑缝章;若文件发起,需要对应填充ComponentPosY、ComponentWidth、ComponentHeight</li>
8764
+ <li> <b>SIGN_OPINION</b> : 签署意见控件,用户需要根据配置的签署意见内容,完成对意见内容的确认;</li>
8765
+ <li> <b>SIGN_LEGAL_PERSON_SEAL</b> : 企业法定代表人控件。</li></ul>
8766
+ 注:` 表单域的控件不能作为印章和签名控件`
8739
8767
  :type ComponentType: str
8740
- :param _ComponentName: 控件简称,不超过30个字符
8768
+ :param _ComponentName: **在绝对定位方式方式下**,ComponentName为控件名,长度不能超过20,只能由中文、字母、数字和下划线组成,可以在后续的操作中使用该名称来引用控件。
8769
+
8770
+ **在表单域定位方式下**,ComponentName不仅为控件名,也是表单域名称。
8771
+
8772
+ 注:`控件名可以在一个PDF中可以重复`
8773
+
8741
8774
  :type ComponentName: str
8742
- :param _ComponentRequired: 控件是否为必填项,
8743
- 默认为false-非必填
8775
+ :param _ComponentRequired: 如果是<b>填写控件</b>,ComponentRequired表示在填写页面此控件是否必填
8776
+ <ul><li>false(默认):可以不填写</li>
8777
+ <li>true :必须填写此填写控件</li></ul>
8778
+ 如果是<b>签署控件</b>,签批控件中签署意见等可以不填写, 其他签署控件不受此字段影响
8744
8779
  :type ComponentRequired: bool
8745
- :param _ComponentRecipientId: 控件关联的参与方ID,对应Recipient结构体中的RecipientId
8780
+ :param _ComponentRecipientId: **在通过接口拉取控件信息场景下**,为出参参数,此控件归属的参与方的角色ID角色(即RecipientId),**发起合同时候不要填写此字段留空即可**
8746
8781
  :type ComponentRecipientId: str
8747
- :param _FileIndex: 控件所属文件的序号 (文档中文件的排列序号,从0开始)
8782
+ :param _FileIndex: <font color="red">【暂未使用】</font>控件所属文件的序号(取值为:0-N)。 目前单文件的情况下,值一直为0
8748
8783
  :type FileIndex: int
8749
8784
  :param _GenerateMode: 控件生成的方式:
8750
- NORMAL - 普通控件
8751
- FIELD - 表单域
8752
- KEYWORD - 关键字(设置关键字时,请确保PDF原始文件内是关键字以文字形式保存在PDF文件中,不支持对图片内文字进行关键字查找)
8785
+ <ul><li> <b>NORMAL</b> : 绝对定位控件</li>
8786
+ <li> <b>FIELD</b> : 表单域</li>
8787
+ <li> <b>KEYWORD</b> : 关键字(设置关键字时,请确保PDF原始文件内是关键字以文字形式保存在PDF文件中,不支持对图片内文字进行关键字查找)</li></ul>
8753
8788
  :type GenerateMode: str
8754
- :param _ComponentWidth: 参数控件宽度,默认100,单位px
8755
- 表单域和关键字转换控件不用填
8789
+ :param _ComponentWidth: **在绝对定位方式和关键字定位方式下**,指定控件宽度,控件宽度是指控件在PDF文件中的宽度,单位为pt(点)。
8790
+
8756
8791
  :type ComponentWidth: float
8757
- :param _ComponentHeight: 参数控件高度,默认100,单位px
8758
- 表单域和关键字转换控件不用填
8792
+ :param _ComponentHeight: **在绝对定位方式和关键字定位方式下**,指定控件的高度, 控件高度是指控件在PDF文件中的高度,单位为pt(点)。
8793
+
8759
8794
  :type ComponentHeight: float
8760
- :param _ComponentPage: 参数控件所在页码,从1开始
8795
+ :param _ComponentPage: **在绝对定位方式方式下**,指定控件所在PDF文件上的页码
8796
+
8797
+ 注:
8798
+ 1. 页码编号是从<font color="red">1</font>开始编号的。
8799
+ 2. <font color="red">页面编号不能超过PDF文件的页码总数</font>。如果指定的页码超过了PDF文件的页码总数,在填写和签署时会出现错误,导致无法正常进行操作。
8761
8800
  :type ComponentPage: int
8762
- :param _ComponentPosX: 参数控件X位置,单位px
8801
+ :param _ComponentPosX: **在绝对定位方式和关键字定位方式下**,可以指定控件横向位置的位置,单位为pt(点)。
8763
8802
  :type ComponentPosX: float
8764
- :param _ComponentPosY: 参数控件Y位置,单位px
8803
+ :param _ComponentPosY: **在绝对定位方式和关键字定位方式下**,可以指定控件纵向位置的位置,单位为pt(点)。
8765
8804
  :type ComponentPosY: float
8766
- :param _ComponentExtra: 扩展参数:
8767
- 为JSON格式。
8768
- 不同类型的控件会有部分非通用参数
8769
-
8770
- ComponentType为TEXT、MULTI_LINE_TEXT时,支持以下参数:
8771
- 1 Font:目前只支持黑体、宋体
8772
- 2 FontSize: 范围12-72
8773
- 3 FontAlign: Left/Right/Center,左对齐/居中/右对齐
8774
- 4 FontColor:字符串类型,格式为RGB颜色数字
8775
- 参数样例:{\"FontColor\":\"255,0,0\",\"FontSize\":12}
8776
-
8777
- ComponentType为FILL_IMAGE时,支持以下参数:
8778
- NotMakeImageCenter:bool。是否设置图片居中。false:居中(默认)。 true: 不居中
8779
- FillMethod: int. 填充方式。0-铺满(默认);1-等比例缩放
8780
-
8781
- ComponentType为SIGN_SIGNATURE类型可以控制签署方式
8782
- {“ComponentTypeLimit”: [“xxx”]}
8783
- xxx可以为:
8784
- HANDWRITE – 手写签名
8785
- OCR_ESIGN -- AI智能识别手写签名
8786
- ESIGN -- 个人印章类型
8787
- SYSTEM_ESIGN -- 系统签名(该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署)
8788
- 如:{“ComponentTypeLimit”: [“SYSTEM_ESIGN”]}
8789
-
8790
- ComponentType为SIGN_DATE时,支持以下参数:
8791
- 1 Font:字符串类型目前只支持"黑体"、"宋体",如果不填默认为"黑体"
8792
- 2 FontSize: 数字类型,范围6-72,默认值为12
8793
- 3 FontAlign: 字符串类型,可取Left/Right/Center,对应左对齐/居中/右对齐
8794
- 4 Format: 字符串类型,日期格式,必须是以下五种之一 “yyyy m d”,”yyyy年m月d日”,”yyyy/m/d”,”yyyy-m-d”,”yyyy.m.d”。
8795
- 5 Gaps:: 字符串类型,仅在Format为“yyyy m d”时起作用,格式为用逗号分开的两个整数,例如”2,2”,两个数字分别是日期格式的前后两个空隙中的空格个数
8805
+ :param _ComponentExtra: **在所有的定位方式下**,控件的扩展参数,为<font color="red">JSON格式</font>,不同类型的控件会有部分非通用参数。
8806
+
8807
+ <font color="red">ComponentType为TEXT、MULTI_LINE_TEXT时</font>,支持以下参数:
8808
+ <ul><li> <b>Font</b>:目前只支持黑体、宋体</li>
8809
+ <li> <b>FontSize</b>: 范围12 :72</li>
8810
+ <li> <b>FontAlign</b>: Left/Right/Center,左对齐/居中/右对齐</li>
8811
+ <li> <b>FontColor</b>:字符串类型,格式为RGB颜色数字</li></ul>
8812
+ <b>参数样例</b>:`{"FontColor":"255,0,0","FontSize":12}`
8813
+
8814
+ <font color="red">ComponentType为FILL_IMAGE时</font>,支持以下参数:
8815
+ <ul><li> <b>NotMakeImageCenter</b>:bool。是否设置图片居中。false:居中(默认)。 true : 不居中</li>
8816
+ <li> <b>FillMethod</b> : int. 填充方式。0-铺满(默认);1-等比例缩放</li></ul>
8817
+
8818
+ <font color="red">ComponentType为SIGN_SIGNATURE类型时</font>,可以**ComponentTypeLimit**参数控制签署方式
8819
+ <ul><li> <b>HANDWRITE</b> : 手写签名</li>
8820
+ <li> <b>OCR_ESIGN</b> : AI智能识别手写签名</li>
8821
+ <li> <b>ESIGN</b> : 个人印章类型</li>
8822
+ <li> <b>SYSTEM_ESIGN</b> : 系统签名(该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署)</li>
8823
+ <li> <b>IMG_ESIGN</b> : 图片印章(该类型支持用户在签署将上传的PNG格式的图片作为签名)</li></ul>
8824
+ <b>参考样例</b>:`{"ComponentTypeLimit": ["SYSTEM_ESIGN"]}`
8825
+ 印章的对应关系参考下图
8826
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/ee0498856c060c065628a0c5ba780d6b.jpg)
8827
+
8828
+ <font color="red">ComponentType为SIGN_DATE时</font>,支持以下参数:
8829
+ <ul><li> <b>Font</b> :字符串类型目前只支持"黑体"、"宋体",如果不填默认为"黑体"</li>
8830
+ <li> <b>FontSize</b> : 数字类型,范围6-72,默认值为12</li>
8831
+ <li> <b>FontAlign</b> : 字符串类型,可取Left/Right/Center,对应左对齐/居中/右对齐</li>
8832
+ <li> <b>Format</b> : 字符串类型,日期格式,必须是以下五种之一 “yyyy m d”,”yyyy年m月d日”,”yyyy/m/d”,”yyyy-m-d”,”yyyy.m.d”。</li>
8833
+ <li> <b>Gaps</b> : 字符串类型,仅在Format为“yyyy m d”时起作用,格式为用逗号分开的两个整数,例如”2,2”,两个数字分别是日期格式的前后两个空隙中的空格个数</li></ul>
8796
8834
  如果extra参数为空,默认为”yyyy年m月d日”格式的居中日期
8797
8835
  特别地,如果extra中Format字段为空或无法被识别,则extra参数会被当作默认值处理(Font,FontSize,Gaps和FontAlign都不会起效)
8798
- 参数样例: "ComponentExtra": "{"Format":“yyyy m d”,"FontSize":12,"Gaps":"2,2", "FontAlign":"Right"}"
8799
-
8800
- ComponentType为SIGN_SEAL类型时,支持以下参数:
8801
- 1.PageRanges:PageRange的数组,通过PageRanges属性设置该印章在PDF所有页面上盖章(适用于标书在所有页面盖章的情况)
8802
- 参数样例: "ComponentExtra":"{"PageRanges":[{"BeginPage":1,"EndPage":-1}]}"
8803
- :type ComponentExtra: str
8804
- :param _ComponentValue: 控件填充vaule,ComponentType和传入值类型对应关系:
8805
- TEXT - 文本内容
8806
- MULTI_LINE_TEXT - 文本内容
8807
- CHECK_BOX - true/false
8808
- FILL_IMAGE、ATTACHMENT - 附件的FileId,需要通过UploadFiles接口上传获取
8809
- SELECTOR - 选项值
8810
- DATE - 默认是格式化为xxxx年xx月xx日
8811
- DYNAMIC_TABLE - 传入json格式的表格内容,具体见数据结构FlowInfo:https://cloud.tencent.com/document/api/1420/61525#FlowInfo
8812
- SIGN_SEAL - 印章ID
8813
- SIGN_PAGING_SEAL - 可以指定印章ID
8814
-
8815
- 控件值约束说明:
8816
- 企业全称控件:
8817
- 约束:企业名称中文字符中文括号
8818
- 检查正则表达式:/^[\u3400-\u4dbf\u4e00-\u9fa5()]+$/
8836
+ <b>参数样例</b>: ` "{"Format":"yyyy m d","FontSize":12,"Gaps":"2,2", "FontAlign":"Right"}"`
8819
8837
 
8820
- 统一社会信用代码控件:
8821
- 检查正则表达式:/^[A-Z0-9]{1,18}$/
8838
+ <font color="red">ComponentType为SIGN_SEAL类型时</font>,支持以下参数:
8839
+ <ul><li> <b>PageRanges</b> :PageRange的数组,通过PageRanges属性设置该印章在PDF所有页面上盖章(适用于标书在所有页面盖章的情况)</li></ul>
8840
+ <b>参数样例</b>:` "{"PageRange":[{"BeginPage":1,"EndPage":-1}]}"`
8822
8841
 
8823
- 法人名称控件:
8824
- 约束:最大50个字符,2到25个汉字或者1到50个字母
8825
- 检查正则表达式:/^([\u3400-\u4dbf\u4e00-\u9fa5.·]{2,25}|[a-zA-Z·,\s-]{1,50})$/
8826
8842
 
8827
- 签署意见控件:
8828
- 约束:签署意见最大长度为50字符
8829
-
8830
- 签署人手机号控件:
8831
- 约束:国内手机号 13,14,15,16,17,18,19号段长度11位
8832
-
8833
- 签署人身份证控件:
8834
- 约束:合法的身份证号码检查
8835
-
8836
- 控件名称:
8837
- 约束:控件名称最大长度为20字符
8838
-
8839
- 单行文本控件:
8840
- 约束:只允许输入中文,英文,数字,中英文标点符号
8841
-
8842
- 多行文本控件:
8843
- 约束:只允许输入中文,英文,数字,中英文标点符号
8844
-
8845
- 勾选框控件:
8846
- 约束:选择填字符串true,不选填字符串false
8847
-
8848
- 选择器控件:
8849
- 约束:同单行文本控件约束,填写选择值中的字符串
8850
-
8851
- 数字控件:
8852
- 约束:请输入有效的数字(可带小数点)
8853
- 检查正则表达式:/^(-|\+)?\d+(\.\d+)?$/
8854
-
8855
- 日期控件:
8856
- 约束:格式:yyyy年mm月dd日
8857
-
8858
- 附件控件:
8859
- 约束:JPG或PNG图片,上传数量限制,1到6个,最大6个附件
8860
-
8861
- 图片控件:
8862
- 约束:JPG或PNG图片,填写上传的图片资源ID
8863
-
8864
- 邮箱控件:
8865
- 约束:请输入有效的邮箱地址, w3c标准
8866
- 检查正则表达式:/^([A-Za-z0-9_\-.!#$%&])+@([A-Za-z0-9_\-.])+\.([A-Za-z]{2,4})$/
8867
- 参考:https://emailregex.com/
8868
-
8869
- 地址控件:
8870
- 同单行文本控件约束
8871
-
8872
- 省市区控件:
8873
- 同单行文本控件约束
8874
-
8875
- 性别控件:
8876
- 同单行文本控件约束,填写选择值中的字符串
8877
-
8878
- 学历控件:
8879
- 同单行文本控件约束,填写选择值中的字符串
8843
+ <font color="red">关键字模式下支持关键字找不到的情况下不进行报错的设置</font>
8844
+ <ul><li> <b>IgnoreKeywordError</b> :1-关键字查找不到时不进行报错</li></ul>
8845
+ 场景说明:如果使用关键字进行定位,但是指定的PDF文件中又没有设置的关键字时,发起合同会进行关键字是否存在的校验,如果关键字不存在,会进行报错返回。如果不希望进行报错,可以设置"IgnoreKeywordError"来忽略错误。请注意,如果关键字签署控件对应的签署方在整个PDF文件中一个签署控件都没有,还是会触发报错逻辑。
8846
+ <b>参数样例</b>:` "{"IgnoreKeywordError":1}"`
8847
+ :type ComponentExtra: str
8848
+ :param _ComponentValue: 控件填充vaule,ComponentType和传入值类型对应关系:
8849
+ <ul><li> <b>TEXT</b> : 文本内容</li>
8850
+ <li> <b>MULTI_LINE_TEXT</b> : 文本内容</li>
8851
+ <li> <b>CHECK_BOX</b> : true/false</li>
8852
+ <li> <b>FILL_IMAGE、ATTACHMENT</b> : 附件的FileId,需要通过UploadFiles接口上传获取</li>
8853
+ <li> <b>SELECTOR</b> : 选项值</li>
8854
+ <li> <b>DYNAMIC_TABLE</b> - 传入json格式的表格内容,详见说明:[数据表格](https://qian.tencent.com/developers/company/dynamic_table)</li>
8855
+ <li> <b>DATE</b> : 默认是格式化为xxxx年xx月xx日</li>
8856
+ <li> <b>SIGN_SEAL</b> : 印章ID,于控制台查询获取</li>
8857
+ <li> <b>SIGN_PAGING_SEAL</b> : 可以指定印章ID,于控制台查询获取</li></ul>
8858
+
8859
+
8860
+ <b>控件值约束说明</b>:
8861
+ <table> <thead> <tr> <th>特殊控件</th> <th>填写约束</th> </tr> </thead> <tbody> <tr> <td>企业全称控件</td> <td>企业名称中文字符中文括号</td> </tr> <tr> <td>统一社会信用代码控件</td> <td>企业注册的统一社会信用代码</td> </tr> <tr> <td>法人名称控件</td> <td>最大50个字符,2到25个汉字或者1到50个字母</td> </tr> <tr> <td>签署意见控件</td> <td>签署意见最大长度为50字符</td> </tr> <tr> <td>签署人手机号控件</td> <td>国内手机号 13,14,15,16,17,18,19号段长度11位</td> </tr> <tr> <td>签署人身份证控件</td> <td>合法的身份证号码检查</td> </tr> <tr> <td>控件名称</td> <td>控件名称最大长度为20字符,不支持表情</td> </tr> <tr> <td>单行文本控件</td> <td>只允许输入中文,英文,数字,中英文标点符号,不支持表情</td> </tr> <tr> <td>多行文本控件</td> <td>只允许输入中文,英文,数字,中英文标点符号,不支持表情</td> </tr> <tr> <td>勾选框控件</td> <td>选择填字符串true,不选填字符串false</td> </tr> <tr> <td>选择器控件</td> <td>同单行文本控件约束,填写选择值中的字符串</td> </tr> <tr> <td>数字控件</td> <td>请输入有效的数字(可带小数点)</td> </tr> <tr> <td>日期控件</td> <td>格式:yyyy年mm月dd日</td> </tr> <tr> <td>附件控件</td> <td>JPG或PNG图片,上传数量限制,1到6个,最大6个附件,填写上传的资源ID</td> </tr> <tr> <td>图片控件</td> <td>JPG或PNG图片,填写上传的图片资源ID</td> </tr> <tr> <td>邮箱控件</td> <td>有效的邮箱地址, w3c标准</td> </tr> <tr> <td>地址控件</td> <td>只允许输入中文,英文,数字,中英文标点符号,不支持表情</td> </tr> <tr> <td>省市区控件</td> <td>只允许输入中文,英文,数字,中英文标点符号,不支持表情</td> </tr> <tr> <td>性别控件</td> <td>选择值中的字符串</td> </tr> <tr> <td>学历控件</td> <td>选择值中的字符串</td> </tr> </tbody> </table>
8862
+ 注: `部分特殊控件需要在控制台配置模板形式创建`
8880
8863
  :type ComponentValue: str
8881
- :param _ComponentDateFontSize: 日期签署控件的字号,默认为 12
8882
-
8883
- 签署区日期控件会转换成图片格式并带存证,需要通过字体决定图片大小
8864
+ :param _ComponentDateFontSize: <font color="red">【暂未使用】</font>日期签署控件的字号,默认为 12
8884
8865
  :type ComponentDateFontSize: int
8885
- :param _DocumentId: 控件所属文档的Id, 模板相关接口为空值
8866
+ :param _DocumentId: <font color="red">【暂未使用】</font>控件归属的文档的ID, **发起合同时候不要填写此字段留空即可**
8886
8867
  :type DocumentId: str
8887
- :param _ComponentDescription: 控件描述,不超过30个字符
8868
+ :param _ComponentDescription: <font color="red">【暂未使用】</font>控件描述,用户自定义,不影响合同发起流程
8888
8869
  :type ComponentDescription: str
8889
- :param _OffsetX: 指定关键字时横坐标偏移量,单位pt
8870
+ :param _OffsetX: **如果控件是关键字定位方式**,可以对关键字定位出来的区域进行横坐标方向的调整,单位为pt(点)。例如,如果关键字定位出来的区域偏左或偏右,可以通过调整横坐标方向的参数来使控件位置更加准确。
8871
+ 注意: `向左调整设置为负数, 向右调整设置成正数`
8890
8872
  :type OffsetX: float
8891
- :param _OffsetY: 指定关键字时纵坐标偏移量,单位pt
8873
+ :param _OffsetY: **如果控件是关键字定位方式**,可以对关键字定位出来的区域进行纵坐标方向的调整,单位为pt(点)。例如,如果关键字定位出来的区域偏上或偏下,可以通过调整纵坐标方向的参数来使控件位置更加准确。
8874
+ 注意: `向上调整设置为负数, 向下调整设置成正数`
8892
8875
  :type OffsetY: float
8893
- :param _ChannelComponentId: 平台企业控件ID。
8894
- 如果不为空,属于平台企业预设控件;
8876
+ :param _ChannelComponentId: <font color="red">【暂未使用】</font>第三方应用集成平台模板控件 ID 标识
8895
8877
  :type ChannelComponentId: str
8896
- :param _KeywordOrder: 指定关键字排序规则,
8897
- Positive-正序,
8898
- Reverse-倒序。
8899
- 传入Positive时会根据关键字在PDF文件内的顺序进行排列。在指定KeywordIndexes时,0代表在PDF内查找内容时,查找到的第一个关键字。
8900
- 传入Reverse时会根据关键字在PDF文件内的反序进行排列。在指定KeywordIndexes时,0代表在PDF内查找内容时,查找到的最后一个关键字。
8878
+ :param _KeywordOrder: **如果控件是关键字定位方式**,指定关键字排序规则时,可以选择Positive或Reverse两种排序方式。
8879
+ <ul><li> <b>Positive</b> :表示正序,即根据关键字在PDF文件内的顺序进行排列</li>
8880
+ <li> <b>Reverse</b> :表示倒序,即根据关键字在PDF文件内的反序进行排列</li></ul>
8881
+
8882
+ 在指定KeywordIndexes时,如果使用Positive排序方式,0代表在PDF内查找内容时,查找到的第一个关键字;如果使用Reverse排序方式,0代表在PDF内查找内容时,查找到的最后一个关键字。
8901
8883
  :type KeywordOrder: str
8902
- :param _KeywordPage: 指定关键字页码。
8903
- 指定页码后,将只在指定的页码内查找关键字,非该页码的关键字将不会查询出来
8884
+ :param _KeywordPage: **如果控件是关键字定位方式**,在KeywordPage中指定关键字页码时,将只会在该页码中查找关键字,非该页码的关键字将不会查询出来。如果不设置查找所有页面中的关键字。
8904
8885
  :type KeywordPage: int
8905
- :param _RelativeLocation: 关键字位置模式,
8906
- Middle-居中,
8907
- Below-正下方,
8908
- Right-正右方,
8909
- LowerRight-右上角,
8910
- UpperRight-右下角。
8886
+ :param _RelativeLocation: **如果控件是关键字定位方式**,关键字生成的区域的对齐方式, 可以设置下面的值
8887
+ <ul><li> <b>Middle</b> :居中</li>
8888
+ <li> <b>Below</b> :正下方</li>
8889
+ <li> <b>Right</b> :正右方</li>
8890
+ <li> <b>LowerRight</b> :右上角</li>
8891
+ <li> <b>UpperRight</b> :右下角。</li></ul>
8911
8892
  示例:如果设置Middle的关键字盖章,则印章的中心会和关键字的中心重合,如果设置Below,则印章在关键字的正下方
8912
8893
  :type RelativeLocation: str
8913
- :param _KeywordIndexes: 关键字索引,如果一个关键字在PDF文件中存在多个,可以通过关键字索引指定使用第几个关键字作为最后的结果,可指定多个索引。
8914
- 示例[0,2],说明使用PDF文件内第1个和第3个关键字位置。
8894
+ :param _KeywordIndexes: **如果控件是关键字定位方式**,关键字索引是指在PDF文件中存在多个相同的关键字时,通过索引指定使用哪一个关键字作为最后的结果。可以通过指定多个索引来同时使用多个关键字。例如,[0,2]表示使用PDF文件内第1个和第3个关键字位置作为最后的结果。
8895
+
8896
+ 注意:关键字索引是从0开始计数的
8915
8897
  :type KeywordIndexes: list of int
8916
- :param _Placeholder: 填写提示的内容
8898
+ :param _Placeholder: 填写控件在腾讯电子签小程序填写界面展示的提示信息,例如,在身份证号码填写控件中,提示信息可以设置成“请输入18位身份证号码”。
8899
+ 注:`签署控件设置此字段无效`
8917
8900
  注意:此字段可能返回 null,表示取不到有效值。
8918
8901
  :type Placeholder: str
8919
- :param _LockComponentValue: 是否锁定控件值不允许编辑(嵌入式发起使用) <br/>默认false:不锁定控件值,允许在页面编辑控件值
8902
+ :param _LockComponentValue: **web嵌入发起合同场景下**, 是否锁定填写和签署控件值不允许嵌入页面进行编辑
8903
+ <ul><li>false(默认):不锁定控件值,允许在页面编辑控件值</li>
8904
+ <li>true:锁定控件值,在页面编辑控件值</li></ul>
8920
8905
  注意:此字段可能返回 null,表示取不到有效值。
8921
8906
  :type LockComponentValue: bool
8922
- :param _ForbidMoveAndDelete: 是否禁止移动和删除控件 <br/>默认false,不禁止移动和删除控件
8907
+ :param _ForbidMoveAndDelete: **web嵌入发起合同场景下**,是否禁止移动和删除填写和签署控件
8908
+ <ul><li> <b>false(默认)</b> :不禁止移动和删除控件</li>
8909
+ <li> <b>true</b> : 可以移动和删除控件</li></ul>
8923
8910
  注意:此字段可能返回 null,表示取不到有效值。
8924
8911
  :type ForbidMoveAndDelete: bool
8925
8912
  """
@@ -9552,17 +9539,25 @@ class CreateChannelOrganizationInfoChangeUrlRequest(AbstractModel):
9552
9539
  此接口下面信息必填。
9553
9540
  <ul>
9554
9541
  <li>渠道应用标识: Agent.AppId</li>
9555
- <li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
9556
- <li>第三方平台子客企业中的员工标识: Agent.ProxyOrganizationOpenId</li>
9542
+ <li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
9543
+ <li>第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId</li>
9557
9544
  </ul>
9545
+ 第三方平台子客企业和员工必须已经过实名认证
9558
9546
  :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
9559
9547
  :param _ChangeType: 企业信息变更类型,可选类型如下:
9560
9548
  <ul><li>**1**:企业超管变更, 可以将超管换成同企业的其他员工</li>
9561
9549
  <li>**2**:企业基础信息变更, 可以改企业名称 , 所在地址 , 法人名字等信息</li></ul>
9562
9550
  :type ChangeType: int
9551
+ :param _Endpoint: 变更链接类型:
9552
+ <ul>
9553
+ <li>**WEIXINAPP** : 创建变更短链。需要在移动端打开,会跳转到微信腾讯电子签小程序进行更换。(默认)</li>
9554
+ <li>**APP** : 创建变更小程序链接,可从第三方App或者小程序跳转到微信腾讯电子签小程序进行更换。</li>
9555
+ </ul>
9556
+ :type Endpoint: str
9563
9557
  """
9564
9558
  self._Agent = None
9565
9559
  self._ChangeType = None
9560
+ self._Endpoint = None
9566
9561
 
9567
9562
  @property
9568
9563
  def Agent(self):
@@ -9580,12 +9575,21 @@ class CreateChannelOrganizationInfoChangeUrlRequest(AbstractModel):
9580
9575
  def ChangeType(self, ChangeType):
9581
9576
  self._ChangeType = ChangeType
9582
9577
 
9578
+ @property
9579
+ def Endpoint(self):
9580
+ return self._Endpoint
9581
+
9582
+ @Endpoint.setter
9583
+ def Endpoint(self, Endpoint):
9584
+ self._Endpoint = Endpoint
9585
+
9583
9586
 
9584
9587
  def _deserialize(self, params):
9585
9588
  if params.get("Agent") is not None:
9586
9589
  self._Agent = Agent()
9587
9590
  self._Agent._deserialize(params.get("Agent"))
9588
9591
  self._ChangeType = params.get("ChangeType")
9592
+ self._Endpoint = params.get("Endpoint")
9589
9593
  memeber_set = set(params.keys())
9590
9594
  for name, value in vars(self).items():
9591
9595
  property_name = name[1:]
@@ -9700,10 +9704,10 @@ class CreateConsoleLoginUrlRequest(AbstractModel):
9700
9704
  注:该参数**仅在企业和员工激活完成,登录控制台场景才生效**。
9701
9705
  :type MenuStatus: str
9702
9706
  :param _Endpoint: 生成链接的类型:
9703
- <ul><li>**PC**:(默认)web控制台链接, 需要在PC浏览器中打开</li>
9707
+ <ul><li>**PC**:(默认)<font color="red">web控制台</font>链接, 需要在PC浏览器中打开</li>
9704
9708
  <li>**CHANNEL**:H5跳转到电子签小程序链接, 一般用于发送短信中带的链接, 打开后进入腾讯电子签小程序</li>
9705
- <li>**SHORT_URL**:H5跳转到电子签小程序链接的短链形式, 一般用于发送短信中带的链接, 打开后进入腾讯电子签小程序</li>
9706
- <li>**APP**:第三方APP或小程序跳转电子签小程序链接, 一般用于贵方小程序或者APP跳转过来, 打开后进入腾讯电子签小程序</li></ul>
9709
+ <li>**SHORT_URL**:<font color="red">H5</font>跳转到电子签小程序链接的短链形式, 一般用于发送短信中带的链接, 打开后进入腾讯电子签小程序</li>
9710
+ <li>**APP**:<font color="red">APP或小程序</font>跳转电子签小程序链接, 一般用于贵方小程序或者APP跳转过来, 打开后进入腾讯电子签小程序</li></ul>
9707
9711
  :type Endpoint: str
9708
9712
  :param _AutoJumpBackEvent: 触发自动跳转事件,仅对EndPoint为App类型有效,可选值包括:
9709
9713
  <ul><li> **VERIFIED** :企业认证完成/员工认证完成后跳回原App/小程序</li></ul>
@@ -9861,9 +9865,11 @@ class CreateConsoleLoginUrlResponse(AbstractModel):
9861
9865
  r"""
9862
9866
  :param _ConsoleUrl: 跳转链接, 链接的有效期根据企业,员工状态和终端等有区别, 可以参考下表
9863
9867
  <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>
9868
+
9864
9869
  注:
9865
- `1.链接仅单次有效,每次登录需要需要重新创建新的链接`
9866
- `2.创建的链接应避免被转义,如:&被转义为\u0026;如使用Postman请求后,请选择响应类型为 JSON,否则链接将被转义`
9870
+ 1. <font color="red">链接仅单次有效</font>,每次登录需要需要重新创建新的链接
9871
+ 2. 创建的链接应避免被转义,如:&被转义为\u0026;如使用Postman请求后,请选择响应类型为 JSON,否则链接将被转义
9872
+ 3. <font color="red">生成的链路后面不能再增加参数</font>(会出现覆盖链接中已有参数导致错误)
9867
9873
 
9868
9874
  :type ConsoleUrl: str
9869
9875
  :param _IsActivated: 子客企业是否已开通腾讯电子签,
@@ -9925,6 +9931,138 @@ class CreateConsoleLoginUrlResponse(AbstractModel):
9925
9931
  self._RequestId = params.get("RequestId")
9926
9932
 
9927
9933
 
9934
+ class CreateFlowGroupSignReviewRequest(AbstractModel):
9935
+ """CreateFlowGroupSignReview请求参数结构体
9936
+
9937
+ """
9938
+
9939
+ def __init__(self):
9940
+ r"""
9941
+ :param _Agent: 关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
9942
+
9943
+ 此接口下面信息必填。
9944
+ <ul>
9945
+ <li>渠道应用标识: Agent.AppId</li>
9946
+ <li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
9947
+ <li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
9948
+ </ul>
9949
+ 第三方平台子客企业和员工必须已经经过实名认证
9950
+ :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
9951
+ :param _FlowGroupId: 合同(流程)组的合同组Id,为32位字符串,通过接口[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByFiles) 或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates)创建合同组签署流程时返回。
9952
+ :type FlowGroupId: str
9953
+ :param _ReviewType: 提交的审核结果,审核结果有下面三种情况
9954
+ <ul><li><b>PASS</b>: 审核通过,合同流程可以继续执行签署等操作</li>
9955
+ <li><b>REJECT</b>: 审核拒绝,合同流程不会变动</li>
9956
+ <li><b>SIGN_REJECT</b>:拒签,合同流程直接结束,合同状态变为**合同拒签**</li></ul>
9957
+ :type ReviewType: str
9958
+ :param _ApproverInfo: 需要进行签署审核的签署人的个人信息或企业信息,签署方的匹配方式按照以下规则:
9959
+
9960
+ 个人:二选一(选择其中任意信息组合即可)
9961
+ <ul><li>姓名+证件类型+证件号</li>
9962
+ <li>姓名+手机号</li></ul>
9963
+
9964
+ 企业:二选一 (选择其中任意信息组合即可)
9965
+ <ul><li>企业名+姓名+证件类型+证件号</li>
9966
+ <li>企业名+姓名+手机号</li></ul>
9967
+ :type ApproverInfo: :class:`tencentcloud.essbasic.v20210526.models.NeedReviewApproverInfo`
9968
+ :param _ReviewMessage: 审核不通过的原因,该字段的字符串长度不超过200个字符。
9969
+
9970
+ 注:`当审核类型(ReviewType)为审核拒绝(REJECT)或拒签(SIGN_REJECT)时,审核结果原因字段必须填写`
9971
+
9972
+ :type ReviewMessage: str
9973
+ """
9974
+ self._Agent = None
9975
+ self._FlowGroupId = None
9976
+ self._ReviewType = None
9977
+ self._ApproverInfo = None
9978
+ self._ReviewMessage = None
9979
+
9980
+ @property
9981
+ def Agent(self):
9982
+ return self._Agent
9983
+
9984
+ @Agent.setter
9985
+ def Agent(self, Agent):
9986
+ self._Agent = Agent
9987
+
9988
+ @property
9989
+ def FlowGroupId(self):
9990
+ return self._FlowGroupId
9991
+
9992
+ @FlowGroupId.setter
9993
+ def FlowGroupId(self, FlowGroupId):
9994
+ self._FlowGroupId = FlowGroupId
9995
+
9996
+ @property
9997
+ def ReviewType(self):
9998
+ return self._ReviewType
9999
+
10000
+ @ReviewType.setter
10001
+ def ReviewType(self, ReviewType):
10002
+ self._ReviewType = ReviewType
10003
+
10004
+ @property
10005
+ def ApproverInfo(self):
10006
+ return self._ApproverInfo
10007
+
10008
+ @ApproverInfo.setter
10009
+ def ApproverInfo(self, ApproverInfo):
10010
+ self._ApproverInfo = ApproverInfo
10011
+
10012
+ @property
10013
+ def ReviewMessage(self):
10014
+ return self._ReviewMessage
10015
+
10016
+ @ReviewMessage.setter
10017
+ def ReviewMessage(self, ReviewMessage):
10018
+ self._ReviewMessage = ReviewMessage
10019
+
10020
+
10021
+ def _deserialize(self, params):
10022
+ if params.get("Agent") is not None:
10023
+ self._Agent = Agent()
10024
+ self._Agent._deserialize(params.get("Agent"))
10025
+ self._FlowGroupId = params.get("FlowGroupId")
10026
+ self._ReviewType = params.get("ReviewType")
10027
+ if params.get("ApproverInfo") is not None:
10028
+ self._ApproverInfo = NeedReviewApproverInfo()
10029
+ self._ApproverInfo._deserialize(params.get("ApproverInfo"))
10030
+ self._ReviewMessage = params.get("ReviewMessage")
10031
+ memeber_set = set(params.keys())
10032
+ for name, value in vars(self).items():
10033
+ property_name = name[1:]
10034
+ if property_name in memeber_set:
10035
+ memeber_set.remove(property_name)
10036
+ if len(memeber_set) > 0:
10037
+ warnings.warn("%s fileds are useless." % ",".join(memeber_set))
10038
+
10039
+
10040
+
10041
+ class CreateFlowGroupSignReviewResponse(AbstractModel):
10042
+ """CreateFlowGroupSignReview返回参数结构体
10043
+
10044
+ """
10045
+
10046
+ def __init__(self):
10047
+ r"""
10048
+ :param _RequestId: 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
10049
+ :type RequestId: str
10050
+ """
10051
+ self._RequestId = None
10052
+
10053
+ @property
10054
+ def RequestId(self):
10055
+ return self._RequestId
10056
+
10057
+ @RequestId.setter
10058
+ def RequestId(self, RequestId):
10059
+ self._RequestId = RequestId
10060
+
10061
+
10062
+ def _deserialize(self, params):
10063
+ self._RequestId = params.get("RequestId")
10064
+
10065
+
9928
10066
  class CreateFlowOption(AbstractModel):
9929
10067
  """创建合同个性化参数
9930
10068
 
@@ -10665,7 +10803,7 @@ class CreateSignUrlsRequest(AbstractModel):
10665
10803
  <ul>
10666
10804
  <li>渠道应用标识: Agent.AppId</li>
10667
10805
  <li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
10668
- <li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
10806
+ <li>第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId</li>
10669
10807
  </ul>
10670
10808
  第三方平台子客企业和员工必须已经过实名认证
10671
10809
  :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
@@ -10717,6 +10855,9 @@ class CreateSignUrlsRequest(AbstractModel):
10717
10855
  注: `GenerateType为"CHANNEL"时必填`
10718
10856
  :type OrganizationOpenId: str
10719
10857
  :param _OpenId: 第三方平台子客企业员工的标识OpenId,GenerateType为"CHANNEL"时可用,指定到具体参与人, 仅展示已经实名的经办人信息
10858
+
10859
+ 注:
10860
+ 如果传进来的<font color="red">OpenId已经实名并且加入企业, 则忽略Name,IdCardType,IdCardNumber,Mobile这四个入参</font>(会用此OpenId实名的身份证和登录的手机号覆盖)
10720
10861
  :type OpenId: str
10721
10862
  :param _AutoJumpBack: Endpoint为"APP" 类型的签署链接,可以设置此值;支持调用方小程序打开签署链接,在电子签小程序完成签署后自动回跳至调用方小程序
10722
10863
  :type AutoJumpBack: bool
@@ -11837,10 +11978,11 @@ class DescribeExtendedServiceAuthInfoRequest(AbstractModel):
11837
11978
 
11838
11979
  此接口下面信息必填。
11839
11980
  <ul>
11840
- <li>渠道应用标识: Agent.ProxyOrganizationOpenId</li>
11841
- <li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
11842
- <li>第三方平台子客企业中的员工标识: Agent.AppId</li>
11981
+ <li>渠道应用标识: Agent.AppId</li>
11982
+ <li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
11983
+ <li>第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId</li>
11843
11984
  </ul>
11985
+ 第三方平台子客企业和员工必须已经过实名认证
11844
11986
  :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
11845
11987
  """
11846
11988
  self._Agent = None
@@ -12280,7 +12422,6 @@ class DescribeTemplatesRequest(AbstractModel):
12280
12422
 
12281
12423
  设置为true之后, 返回参数PreviewUrl,为模板的H5预览链接, 有效期5分钟。可以通过浏览器打开此链接预览模板,或者嵌入到iframe中预览模板。
12282
12424
 
12283
- 注: `此功能为白名单功能,使用前请联系对接的客户经理沟通。`
12284
12425
  :type WithPreviewUrl: bool
12285
12426
  :param _WithPdfUrl: 是否获取模板的PDF文件链接。
12286
12427
 
@@ -12752,11 +12893,12 @@ class ExtentServiceAuthInfo(AbstractModel):
12752
12893
  :param _Type: 扩展服务类型
12753
12894
  <ul>
12754
12895
  <li>AUTO_SIGN 企业自动签(自动签署)</li>
12755
- <li> OVERSEA_SIGN 企业与港澳台居民*签署合同</li>
12896
+ <li> OVERSEA_SIGN 企业与港澳台居民签署合同</li>
12756
12897
  <li> MOBILE_CHECK_APPROVER 使用手机号验证签署方身份</li>
12757
12898
  <li> PAGING_SEAL 骑缝章</li>
12758
12899
  <li> DOWNLOAD_FLOW 授权渠道下载合同 </li>
12759
12900
  <li>AGE_LIMIT_EXPANSION 拓宽签署方年龄限制</li>
12901
+ <li>HIDE_OPERATOR_DISPLAY 隐藏合同经办人姓名</li>
12760
12902
  </ul>
12761
12903
  :type Type: str
12762
12904
  :param _Name: 扩展服务名称
@@ -13449,6 +13591,9 @@ class FlowApproverInfo(AbstractModel):
13449
13591
  :param _OpenId: 第三方平台子客企业员工的唯一标识,长度不能超过64,只能由字母和数字组成
13450
13592
 
13451
13593
  当签署方为同一第三方平台下的员工时,该字段若不指定,则发起【待领取】的流程
13594
+
13595
+ 注:
13596
+ 如果传进来的<font color="red">OpenId已经实名并且加入企业, 则忽略Name,IdCardType,IdCardNumber,Mobile这四个入参</font>(会用此OpenId实名的身份证和登录的手机号覆盖)
13452
13597
  :type OpenId: str
13453
13598
  :param _OrganizationOpenId: 同应用下第三方平台子客企业的唯一标识,定义Agent中的ProxyOrganizationOpenId一样,签署方为非发起方企业场景下必传,最大长度64个字符
13454
13599
  :type OrganizationOpenId: str
@@ -13494,7 +13639,14 @@ class FlowApproverInfo(AbstractModel):
13494
13639
  :param _ApproverOption: 可以控制签署方在签署合同时能否进行某些操作,例如拒签、转交他人、是否为动态补充签署人等。
13495
13640
  详细操作可以参考开发者中心的ApproverOption结构体。
13496
13641
  :type ApproverOption: :class:`tencentcloud.essbasic.v20210526.models.ApproverOption`
13497
- :param _ApproverNeedSignReview: 当前签署方进行签署操作是否需要企业内部审批,true 则为需要
13642
+ :param _ApproverNeedSignReview: 发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
13643
+ <ul><li>**false**:(默认)不需要审批,直接签署。</li>
13644
+ <li>**true**:需要走审批流程。当到对应参与人签署时,会阻塞其签署操作,等待企业内部审批完成。</li></ul>
13645
+ 企业可以通过ChannelCreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
13646
+ <ul><li>如果企业通知腾讯电子签平台审核通过,签署方可继续签署动作。</li>
13647
+ <li>如果企业通知腾讯电子签平台审核未通过,平台将继续阻塞签署方的签署动作,直到企业通知平台审核通过。</li></ul>
13648
+
13649
+ 注:`此功能可用于与企业内部的审批流程进行关联,支持手动、静默签署合同`
13498
13650
  :type ApproverNeedSignReview: bool
13499
13651
  :param _ApproverVerifyTypes: 指定个人签署方查看合同的校验方式,可以传值如下:
13500
13652
  <ul><li> **1** : (默认)人脸识别,人脸识别后才能合同内容</li>
@@ -13878,10 +14030,12 @@ class FlowApproverUrlInfo(AbstractModel):
13878
14030
 
13879
14031
  def __init__(self):
13880
14032
  r"""
13881
- :param _SignUrl: 签署短链接。</br>
14033
+ :param _SignUrl: 签署短链接。
14034
+
13882
14035
  注意:
13883
- - 该链接有效期为**30分钟**,同时需要注意保密,不要外泄给无关用户。
13884
- - 该链接不支持小程序嵌入,仅支持**移动端浏览器**打开。
14036
+ 1. 该链接有效期为**30分钟**,同时需要注意保密,不要外泄给无关用户。
14037
+ 2. 该链接不支持小程序嵌入,仅支持**移动端浏览器**打开。
14038
+ 3. <font color="red">生成的链路后面不能再增加参数</font>(会出现覆盖链接中已有参数导致错误)
13885
14039
  :type SignUrl: str
13886
14040
  :param _ApproverType: 签署人类型。
13887
14041
  - **PERSON**: 个人
@@ -13890,10 +14044,12 @@ class FlowApproverUrlInfo(AbstractModel):
13890
14044
  :type Name: str
13891
14045
  :param _Mobile: 签署人手机号。
13892
14046
  :type Mobile: str
13893
- :param _LongUrl: 签署长链接。</br>
14047
+ :param _LongUrl: 签署长链接。
14048
+
13894
14049
  注意:
13895
- - 该链接有效期为**30分钟**,同时需要注意保密,不要外泄给无关用户。
13896
- - 该链接不支持小程序嵌入,仅支持**移动端浏览器**打开。
14050
+ 1. 该链接有效期为**30分钟**,同时需要注意保密,不要外泄给无关用户。
14051
+ 2. 该链接不支持小程序嵌入,仅支持**移动端浏览器**打开。
14052
+ 3. <font color="red">生成的链路后面不能再增加参数</font>(会出现覆盖链接中已有参数导致错误)
13897
14053
  注意:此字段可能返回 null,表示取不到有效值。
13898
14054
  :type LongUrl: str
13899
14055
  """
@@ -15219,24 +15375,28 @@ class ModifyExtendedServiceRequest(AbstractModel):
15219
15375
 
15220
15376
  此接口下面信息必填。
15221
15377
  <ul>
15222
- <li>渠道应用标识: Agent.ProxyOrganizationOpenId</li>
15223
- <li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
15224
- <li>第三方平台子客企业中的员工标识: Agent.AppId</li>
15378
+ <li>渠道应用标识: Agent.AppId</li>
15379
+ <li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
15380
+ <li>第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId</li>
15225
15381
  </ul>
15382
+ 第三方平台子客企业和员工必须已经过实名认证
15226
15383
  :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
15227
15384
  :param _ServiceType: 扩展服务类型
15228
15385
  <ul>
15229
15386
  <li>AUTO_SIGN 企业自动签(自动签署)</li>
15230
- <li> OVERSEA_SIGN 企业与港澳台居民*签署合同</li>
15387
+ <li> OVERSEA_SIGN 企业与港澳台居民签署合同</li>
15231
15388
  <li> MOBILE_CHECK_APPROVER 使用手机号验证签署方身份</li>
15232
15389
  <li> PAGING_SEAL 骑缝章</li>
15233
15390
  <li> DOWNLOAD_FLOW 授权渠道下载合同 </li>
15234
15391
  <li>AGE_LIMIT_EXPANSION 拓宽签署方年龄限制</li>
15392
+ <li>HIDE_OPERATOR_DISPLAY 隐藏合同经办人姓名</li>
15235
15393
  </ul>
15236
15394
  :type ServiceType: str
15237
- :param _Operate: 操作类型
15238
- OPEN:开通
15239
- CLOSE:关闭
15395
+ :param _Operate: 操作类型
15396
+ <ul>
15397
+ <li>OPEN : 开通</li>
15398
+ <li>CLOSE : 关闭</li>
15399
+ </ul>
15240
15400
  :type Operate: str
15241
15401
  :param _Endpoint: 链接跳转类型,支持以下类型
15242
15402
  <ul>
@@ -15310,8 +15470,8 @@ class ModifyExtendedServiceResponse(AbstractModel):
15310
15470
  :param _OperateUrl: 操作跳转链接,有效期24小时
15311
15471
  若操作时没有返回跳转链接,表示无需跳转操作,此时会直接开通/关闭服务。
15312
15472
 
15313
- 当操作类型是 OPEN 且 扩展服务类型是 AUTO_SIGN 或 DOWNLOAD_FLOW 或者 OVERSEA_SIGN 时返回操作链接,
15314
- 返回的链接需要平台方自行触达超管或法人,超管或法人点击链接完成服务开通操作。
15473
+ 当操作类型是 OPEN 且 扩展服务类型是 AUTO_SIGN 或 DOWNLOAD_FLOW 或者 OVERSEA_SIGN 时返回操作链接,
15474
+ 返回的链接需要平台方自行触达超管或法人,超管或法人点击链接完成服务开通操作
15315
15475
  :type OperateUrl: str
15316
15476
  :param _RequestId: 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
15317
15477
  :type RequestId: str
@@ -15341,6 +15501,114 @@ class ModifyExtendedServiceResponse(AbstractModel):
15341
15501
  self._RequestId = params.get("RequestId")
15342
15502
 
15343
15503
 
15504
+ class NeedReviewApproverInfo(AbstractModel):
15505
+ """需要进行签署审核的签署人信息
15506
+
15507
+ """
15508
+
15509
+ def __init__(self):
15510
+ r"""
15511
+ :param _ApproverType: 签署方经办人的类型,支持以下类型
15512
+ <ul><li> ORGANIZATION 企业(含企业自动签)</li>
15513
+ <li>PERSON 个人(含个人自动签)</li></ul>
15514
+ :type ApproverType: str
15515
+ :param _ApproverName: 签署方经办人的姓名。 经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
15516
+ :type ApproverName: str
15517
+ :param _ApproverMobile: 签署方经办人手机号码, 支持国内手机号11位数字(无需加+86前缀或其他字符)。 请确认手机号所有方为此合同签署方。
15518
+ :type ApproverMobile: str
15519
+ :param _ApproverIdCardType: 签署方经办人的证件类型,支持以下类型
15520
+ <ul><li>ID_CARD 居民身份证 (默认值)</li>
15521
+ <li>HONGKONG_AND_MACAO 港澳居民来往内地通行证</li>
15522
+ <li>HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)</li>
15523
+ <li>OTHER_CARD_TYPE 其他证件</li></ul>
15524
+
15525
+ 注: `其他证件类型为白名单功能,使用前请联系对接的客户经理沟通。`
15526
+ :type ApproverIdCardType: str
15527
+ :param _ApproverIdCardNumber: 签署方经办人的证件号码,应符合以下规则
15528
+ <ul><li>居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。</li>
15529
+ <li>港澳居民来往内地通行证号码应为9位字符串,第1位为“C”,第2位为英文字母(但“I”、“O”除外),后7位为阿拉伯数字。</li>
15530
+ <li>港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。</li></ul>
15531
+ :type ApproverIdCardNumber: str
15532
+ :param _OrganizationName: 组织机构名称。
15533
+ 请确认该名称与企业营业执照中注册的名称一致。
15534
+ 如果名称中包含英文括号(),请使用中文括号()代替。
15535
+ 如果签署方是企业签署方(approverType = 0 或者 approverType = 3), 则企业名称必填。
15536
+
15537
+ :type OrganizationName: str
15538
+ """
15539
+ self._ApproverType = None
15540
+ self._ApproverName = None
15541
+ self._ApproverMobile = None
15542
+ self._ApproverIdCardType = None
15543
+ self._ApproverIdCardNumber = None
15544
+ self._OrganizationName = None
15545
+
15546
+ @property
15547
+ def ApproverType(self):
15548
+ return self._ApproverType
15549
+
15550
+ @ApproverType.setter
15551
+ def ApproverType(self, ApproverType):
15552
+ self._ApproverType = ApproverType
15553
+
15554
+ @property
15555
+ def ApproverName(self):
15556
+ return self._ApproverName
15557
+
15558
+ @ApproverName.setter
15559
+ def ApproverName(self, ApproverName):
15560
+ self._ApproverName = ApproverName
15561
+
15562
+ @property
15563
+ def ApproverMobile(self):
15564
+ return self._ApproverMobile
15565
+
15566
+ @ApproverMobile.setter
15567
+ def ApproverMobile(self, ApproverMobile):
15568
+ self._ApproverMobile = ApproverMobile
15569
+
15570
+ @property
15571
+ def ApproverIdCardType(self):
15572
+ return self._ApproverIdCardType
15573
+
15574
+ @ApproverIdCardType.setter
15575
+ def ApproverIdCardType(self, ApproverIdCardType):
15576
+ self._ApproverIdCardType = ApproverIdCardType
15577
+
15578
+ @property
15579
+ def ApproverIdCardNumber(self):
15580
+ return self._ApproverIdCardNumber
15581
+
15582
+ @ApproverIdCardNumber.setter
15583
+ def ApproverIdCardNumber(self, ApproverIdCardNumber):
15584
+ self._ApproverIdCardNumber = ApproverIdCardNumber
15585
+
15586
+ @property
15587
+ def OrganizationName(self):
15588
+ return self._OrganizationName
15589
+
15590
+ @OrganizationName.setter
15591
+ def OrganizationName(self, OrganizationName):
15592
+ self._OrganizationName = OrganizationName
15593
+
15594
+
15595
+ def _deserialize(self, params):
15596
+ self._ApproverType = params.get("ApproverType")
15597
+ self._ApproverName = params.get("ApproverName")
15598
+ self._ApproverMobile = params.get("ApproverMobile")
15599
+ self._ApproverIdCardType = params.get("ApproverIdCardType")
15600
+ self._ApproverIdCardNumber = params.get("ApproverIdCardNumber")
15601
+ self._OrganizationName = params.get("OrganizationName")
15602
+ memeber_set = set(params.keys())
15603
+ for name, value in vars(self).items():
15604
+ property_name = name[1:]
15605
+ if property_name in memeber_set:
15606
+ memeber_set.remove(property_name)
15607
+ if len(memeber_set) > 0:
15608
+ warnings.warn("%s fileds are useless." % ",".join(memeber_set))
15609
+
15610
+
15611
+
15344
15612
  class OccupiedSeal(AbstractModel):
15345
15613
  """持有的电子印章信息
15346
15614
 
@@ -15511,7 +15779,7 @@ class OperateChannelTemplateRequest(AbstractModel):
15511
15779
 
15512
15780
  此接口下面信息必填。
15513
15781
  <ul>
15514
- <li>第三方平台子客企业中的员工标识: Agent.AppId</li>
15782
+ <li>渠道应用标识: Agent.AppId</li>
15515
15783
  </ul>
15516
15784
  :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
15517
15785
  :param _OperateType: 操作类型,可取值如下:
@@ -17463,6 +17731,8 @@ class SignUrlInfo(AbstractModel):
17463
17731
  def __init__(self):
17464
17732
  r"""
17465
17733
  :param _SignUrl: 签署链接,过期时间为90天
17734
+
17735
+ 注:<font color="red">生成的链路后面不能再增加参数</font>(会出现覆盖链接中已有参数导致错误)
17466
17736
  注意:此字段可能返回 null,表示取不到有效值。
17467
17737
  :type SignUrl: str
17468
17738
  :param _Deadline: 合同过期时间戳,单位秒
@@ -18317,21 +18587,20 @@ class TemplateInfo(AbstractModel):
18317
18587
  :type Description: str
18318
18588
  :param _Components: 模板的填充控件列表
18319
18589
  :type Components: list of Component
18320
- :param _Recipients: 模板中的签署参与方列表
18590
+ :param _Recipients: 此模块需要签署的各个参与方的角色列表。RecipientId标识每个参与方角色对应的唯一标识符,用于确定此角色的信息。
18321
18591
  :type Recipients: list of Recipient
18322
- :param _SignComponents: 模板中的签署控件列表
18592
+ :param _SignComponents: 此模板中的签署控件列表
18323
18593
  :type SignComponents: list of Component
18324
18594
  :param _TemplateType: 模板类型:1-静默签;3-普通模板
18325
18595
  :type TemplateType: int
18326
18596
  :param _IsPromoter: 是否是发起人 ,已弃用
18327
18597
  :type IsPromoter: bool
18328
- :param _Creator: 模板的创建者信息,电子签系统用户ID
18598
+ :param _Creator: 模板的创建者名字
18329
18599
  :type Creator: str
18330
18600
  :param _CreatedOn: 模板创建的时间戳,格式为Unix标准时间戳(秒)
18331
18601
  :type CreatedOn: int
18332
18602
  :param _PreviewUrl: 模板的H5预览链接,有效期5分钟。
18333
18603
  可以通过浏览器打开此链接预览模板,或者嵌入到iframe中预览模板。
18334
- (此功能开放需要联系客户经理)
18335
18604
  注意:此字段可能返回 null,表示取不到有效值。
18336
18605
  :type PreviewUrl: str
18337
18606
  :param _PdfUrl: 第三方应用集成-模板PDF文件链接,有效期5分钟。
@@ -18348,13 +18617,14 @@ class TemplateInfo(AbstractModel):
18348
18617
  1-平台自动设置子客模板
18349
18618
  注意:此字段可能返回 null,表示取不到有效值。
18350
18619
  :type ChannelAutoSave: int
18351
- :param _TemplateVersion: 模板版本,全数字字符。
18352
- 默认为空,初始版本为yyyyMMdd001。
18620
+ :param _TemplateVersion: 模板版本,由全数字字符组成。
18621
+ 默认为空,模板版本号由日期和序号组成,初始版本为yyyyMMdd001,yyyyMMdd002表示第二个版本,以此类推。
18353
18622
  注意:此字段可能返回 null,表示取不到有效值。
18354
18623
  :type TemplateVersion: str
18355
- :param _Available: 模板可用状态:
18356
- 1启用(默认)
18357
- 2停用
18624
+ :param _Available: 模板可用状态的取值通常为以下两种:
18625
+
18626
+ <ul><li>1:启用(默认),表示模板处于启用状态,可以被用户正常使用。</li>
18627
+ <li>2:停用,表示模板处于停用状态,禁止用户使用该模板。</li></ul>
18358
18628
  注意:此字段可能返回 null,表示取不到有效值。
18359
18629
  :type Available: int
18360
18630
  """