tencentcloud-sdk-ess 3.0.636 → 3.0.638

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 55a3bb5e9f6dbf24486fe545bd56b3edab7a8efe
-  data.tar.gz: 706173f428ed9fab52e63b019721b504b032128c
+  metadata.gz: bdde2b3c56c3fffcf140370488d2979d29f4f96f
+  data.tar.gz: ef6f6ef6c90e0719b05548d826f66d746f2afbd3
 SHA512:
-  metadata.gz: 4e623f8ab962bfc24e1d3029671562b36c507510dc96abeeb096a071f99788eb6d8c35e107fc2574e481741bc19e168119d714a91fce131f8cdafa4fae49a565
-  data.tar.gz: d4ebde332b7ae4520e9766dc2f5e7a1034485ca30b24652213b240375a5d30df3cb83eb13207da1fd982b86acad7c70286dcfbd309a19bdd8e276b1abe6d91cc
+  metadata.gz: 07951ac097744f7563d16e8b061f457eb3de99b7b5f025f206248d66c616f33647af2b57d57ba2603980c65af5ba47276eeebc37ce561fe7e7264662b8711ed6
+  data.tar.gz: 13300779e58e694df608e784a7694cc7546d1b50dfb8d35d80f8a35d4e9bb30419890c93ff514d37096fe039832e11ecfd32f5c3b43b460f2623231299090d19

data/lib/VERSION

@@ -1 +1 @@
-3.0.636
+3.0.638

data/lib/v20201111/models.rb

@@ -76,63 +76,116 @@ module TencentCloud
 
       # 参与者信息
       class ApproverInfo < TencentCloud::Common::AbstractModel
-        # @param ApproverType: 参与者类型：
+        # @param ApproverType: 在指定签署方时，可选择企业B端或个人C端等不同的参与者类型，可选类型如下:
         # 0：企业
         # 1：个人
         # 3：企业静默签署
         # 注：类型为3（企业静默签署）时，此接口会默认完成该签署方的签署。静默签署仅进行盖章操作，不能自动签名。
         # 7: 个人自动签署，适用于个人自动签场景。
-        # 注: 个人自动签场景为白名单功能, 使用前请联系对接的客户经理沟通。
+        # 注: 个人自动签场景为白名单功能，使用前请联系对接的客户经理沟通。
         # @type ApproverType: Integer
-        # @param ApproverName: 签署人的姓名
+        # @param ApproverName: 签署方经办人的姓名。
+        # 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
         # @type ApproverName: String
-        # @param ApproverMobile: 签署人的手机号，11位数字
+        # @param ApproverMobile: 本企业的签署方经办人的员工UserId
+
+        # 可登录腾讯电子签控制台，在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
+
+        # 注: 若传该字段，则签署方经办人的其他信息（如签署方经办人的姓名、证件号码、手机号码等）将被忽略。
         # @type ApproverMobile: String
-        # @param OrganizationName: 如果签署方是企业签署方(approverType = 1 或者 approverType = 3)，
+        # @param OrganizationName: 组织机构名称。
+        # 如果签署方是企业签署方(approverType = 1 或者 approverType = 3)， 则企业名称必填。
 
-        # 则企业名称必填
+        # 注: 请确认该名称与企业营业执照中注册的名称一致 ; 如果名称中包含英文括号()，请使用中文括号（）代替。
         # @type OrganizationName: String
-        # @param SignComponents: 签署人的签署控件列表
+        # @param SignComponents: 合同中的签署控件列表，列表中可支持下列多种签署控件,控件的详细定义参考开发者中心的Component结构体
+        # - 个人签名/印章
+        # - 企业印章
+        # - 骑缝章等签署控件
         # @type SignComponents: Array
-        # @param ApproverIdCardType: 签署人的证件类型
-        # ID_CARD 身份证
-        # HONGKONG_AND_MACAO 港澳居民来往内地通行证
-        # HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)
-        # OTHER_CARD_TYPE 其他（需要使用该类型请先联系运营经理）
+        # @param ApproverIdCardType: 签署方经办人的证件类型，支持以下类型
+        # - ID_CARD 居民身份证  (默认值)
+        # - HONGKONG_AND_MACAO 港澳居民来往内地通行证
+        # - HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)
+        # - OTHER_CARD_TYPE 其他证件
+
+        # 注: 其他证件类型为白名单功能，使用前请联系对接的客户经理沟通。
         # @type ApproverIdCardType: String
-        # @param ApproverIdCardNumber: 签署人证件号（长度不超过18位）
+        # @param ApproverIdCardNumber: 签署方经办人的证件号码，应符合以下规则
+        # - 居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。
+        # - 港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。
+        # - 港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。
         # @type ApproverIdCardNumber: String
-        # @param NotifyType: 签署通知类型：sms--短信，none--不通知
+        # @param NotifyType: 通知签署方经办人的方式,  有以下途径:
+
+        # - sms:  (默认)短信
+        # - none: 不通知
         # @type NotifyType: String
-        # @param ApproverRole: 签署人角色类型：1--收款人、2--开具人、3--见证人
+        # @param ApproverRole: 收据场景设置签署人角色类型, 可以设置如下类型:
+        # - 1:收款人
+        # - 2:开具人
+        # - 3:见证人
+
+        # 注: 收据场景为白名单功能，使用前请联系对接的客户经理沟通。
         # @type ApproverRole: Integer
         # @param VerifyChannel: 签署意愿确认渠道，默认为WEIXINAPP:人脸识别
+
+        # 注: 将要废弃, 用ApproverSignTypes签署人签署合同时的认证方式代替, 新客户可请用ApproverSignTypes来设置
         # @type VerifyChannel: Array
-        # @param PreReadTime: 合同的强制预览时间：3~300s，未指定则按合同页数计算
+        # @param PreReadTime: 签署方在签署合同之前，需要强制阅读合同的时长，可指定为3秒至300秒之间的任意值。
+
+        # 若未指定阅读时间，则会按照合同页数大小计算阅读时间，计算规则如下：
+
+        # - 合同页数少于等于2页，阅读时间为3秒；
+        # - 合同页数为3到5页，阅读时间为5秒；
+        # - 合同页数大于等于6页，阅读时间为10秒。
         # @type PreReadTime: Integer
         # @param UserId: 签署人userId，仅支持本企业的员工userid， 可在控制台组织管理处获得
 
         # 若传此字段 则以userid的信息为主，会覆盖传递过来的签署人基本信息， 包括姓名，手机号，证件类型等信息
         # @type UserId: String
-        # @param ApproverSource: 签署人用户来源，此参数仅针对企微用户开放
-
-        # 企微侧用户请传入：WEWORKAPP
+        # @param ApproverSource: 在企微场景下使用，需设置参数为WEWORKAPP，以表明合同来源于企微。
         # @type ApproverSource: String
-        # @param CustomApproverTag: 企业签署方或签标识，客户自定义，64位长度。用于发起含有或签签署人的合同。或签参与人必须有此字段。合同内不同或签参与人CustomApproverTag需要保证唯一。如果或签签署人为本方企微参与人，ApproverSource参数需要指定WEWORKAPP
+        # @param CustomApproverTag: 在企业微信场景下，表明该合同流程为或签，其最大长度为64位字符串。
+        # 所有参与或签的人员均需具备该标识。
+        # 注意，在合同中，不同的或签参与人必须保证其CustomApproverTag唯一。
+        # 如果或签签署人为本方企业微信参与人，则需要指定ApproverSource参数为WEWORKAPP。
         # @type CustomApproverTag: String
-        # @param ApproverOption: 签署人个性化能力值
+        # @param ApproverOption: 可以控制签署方在签署合同时能否进行某些操作，例如拒签、转交他人等。
+        # 详细操作可以参考开发者中心的ApproverOption结构体。
         # @type ApproverOption: :class:`Tencentcloud::Ess.v20201111.models.ApproverOption`
-        # @param ApproverVerifyTypes: 签署人查看合同时认证方式,
-        # 1-实名查看 2-短信验证码查看(企业签署方不支持该方式)
-        # 如果不传默认为1
-        # 模板发起的时候,认证方式以模板配置为主
+        # @param ApproverVerifyTypes: 指定个人签署方查看合同的校验方式,可以传值如下:
+
+        # - 1 : （默认）人脸识别,人脸识别后才能合同内容
+        # - 2 : 手机号验证, 用户手机号和参与方手机号(ApproverMobile)相同即可查看合同内容
+
+        # 注:
+
+        # - 如果合同流程设置ApproverVerifyType查看合同的校验方式,    则忽略此签署人的查看合同的校验方式
+        # - 此字段不可传多个校验方式
         # @type ApproverVerifyTypes: Array
-        # @param ApproverSignTypes: 签署人签署合同时的认证方式
-        # 1-人脸认证 2-签署密码 3-运营商三要素(默认为1,2)
-        # 合同签署认证方式的优先级 verifyChannel>approverSignTypes
-        # 模板发起的时候,认证方式以模板配置为主
+        # @param ApproverSignTypes: 您可以指定签署方签署合同的认证校验方式，可传递以下值：
+
+        # - 1：人脸认证，需进行人脸识别成功后才能签署合同；
+        # - 2：签署密码，需输入与用户在腾讯电子签设置的密码一致才能校验成功进行合同签署；
+        # - 3：运营商三要素，需到运营商处比对手机号实名信息（名字、手机号、证件号）校验一致才能成功进行合同签署。
+
+        # 注：
+
+        # - 默认情况下，认证校验方式为人脸认证和签署密码两种形式；
+        # - 您可以传递多种值，表示可用多种认证校验方式。
         # @type ApproverSignTypes: Array
-        # @param ApproverNeedSignReview: 当前签署方进行签署操作是否需要企业内部审批，true 则为需要。为个人签署方时则由发起方企业审核。
+        # @param ApproverNeedSignReview: 发起方企业的签署人进行签署操作前，是否需要企业内部走审批流程，取值如下：
+
+        # - false：（默认）不需要审批，直接签署。
+        # - true：需要走审批流程。当到对应参与人签署时，会阻塞其签署操作，等待企业内部审批完成。
+
+        # 企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
+
+        # - 如果企业通知腾讯电子签平台审核通过，签署方可继续签署动作。
+        # - 如果企业通知腾讯电子签平台审核未通过，平台将继续阻塞签署方的签署动作，直到企业通知平台审核通过。
+
+        # 注：此功能可用于与企业内部的审批流程进行关联，支持手动、静默签署合同
         # @type ApproverNeedSignReview: Boolean
 
         attr_accessor :ApproverType, :ApproverName, :ApproverMobile, :OrganizationName, :SignComponents, :ApproverIdCardType, :ApproverIdCardNumber, :NotifyType, :ApproverRole, :VerifyChannel, :PreReadTime, :UserId, :ApproverSource, :CustomApproverTag, :ApproverOption, :ApproverVerifyTypes, :ApproverSignTypes, :ApproverNeedSignReview
@@ -192,9 +245,15 @@ module TencentCloud
 
       # 签署人个性化能力信息
       class ApproverOption < TencentCloud::Common::AbstractModel
-        # @param NoRefuse: 是否可以拒签 默认false-可以拒签 true-不可以拒签
+        # @param NoRefuse: 签署方是否可以拒签
+
+        # - false: ( 默认)可以拒签
+        # - true:不可以拒签
         # @type NoRefuse: Boolean
-        # @param NoTransfer: 是否可以转发 默认false-可以转发 true-不可以转发
+        # @param NoTransfer: 签署方是否可以转他人处理
+
+        # - false: ( 默认)可以转他人处理
+        # - true:不可以转他人处理
         # @type NoTransfer: Boolean
 
         attr_accessor :NoRefuse, :NoTransfer
@@ -574,19 +633,26 @@ module TencentCloud
 
       # 抄送信息
       class CcInfo < TencentCloud::Common::AbstractModel
-        # @param Mobile: 被抄送人手机号，11位数字
+        # @param Mobile: 被抄送方手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。
+        # 请确认手机号所有方为此业务通知方。
         # @type Mobile: String
-        # @param Name: 被抄送人姓名
+        # @param Name: 被抄送方姓名。
+        # 抄送方的姓名将用于身份认证，请确保填写的姓名为抄送方的真实姓名，而非昵称等代名。
         # @type Name: String
-        # @param CcType: 被抄送人类型,
-        # 0--个人
-        # 1--员工
+        # @param CcType: 被抄送方类型, 可设置以下类型:
+
+        # - 0:个人抄送方
+        # - 1:企业员工抄送方
         # @type CcType: Integer
-        # @param CcPermission: 被抄送人权限
-        # 0--可查看
-        # 1--可查看也可下载
+        # @param CcPermission: 被抄送方权限, 可设置如下权限:
+
+        # - 0:可查看合同内容
+        # - 1:可查看合同内容也可下载原文
         # @type CcPermission: Integer
-        # @param NotifyType: 关注方通知类型：sms--短信，none--不通知
+        # @param NotifyType: 通知签署方经办人的方式,  有以下途径:
+
+        # - sms:  (默认)短信
+        # - none: 不通知
         # @type NotifyType: String
 
         attr_accessor :Mobile, :Name, :CcType, :CcPermission, :NotifyType
@@ -1155,7 +1221,7 @@ module TencentCloud
         # @type EmbedType: String
         # @param BusinessId: WEB嵌入的业务资源ID
         # <br/>PREVIEW_SEAL_DETAIL，必填，取值为印章id
-        # <br/>MODIFY_TEMPLATE，PREVIEW_TEMPLATE，必填，取值为模版id
+        # <br/>MODIFY_TEMPLATE，PREVIEW_TEMPLATE，必填，取值为模板id
         # <br/>PREVIEW_FLOW，PREVIEW_FLOW_DETAIL，必填，取值为合同id
         # @type BusinessId: String
         # @param Agent: 代理相关应用信息，如集团主企业代子企业操作
@@ -1283,73 +1349,131 @@ module TencentCloud
 
       # CreateFlowByFiles请求参数结构体
       class CreateFlowByFilesRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 调用方用户信息，userId 必填。支持填入集团子公司经办人 userId 代发合同
+        # @param Operator: 执行本接口操作的员工信息。
+        # 使用此接口时，必须填写userId。
+        # 在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
+        # 支持填入集团子公司经办人 userId 代发合同。
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param FlowName: 签署流程名称,最大长度200个字符
+        # @param FlowName: 合同流程的名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。
+        # 该名称还将用于合同签署完成后的下载文件名。
         # @type FlowName: String
-        # @param Approvers: 签署参与者信息，最大限制50方
+        # @param Approvers: 合同流程的参与方列表，最多可支持50个参与方，可在列表中指定企业B端签署方和个人C端签署方的联系和认证方式等信息，具体定义可以参考开发者中心的ApproverInfo结构体。
+        # 如果合同流程是有序签署，Approvers列表中参与人的顺序就是默认的签署顺序，请确保列表中参与人的顺序符合实际签署顺序。
         # @type Approvers: Array
-        # @param FileIds: 签署pdf文件的资源编号列表，通过UploadFiles接口获取，暂时仅支持单文件发起
+        # @param FileIds: 本合同流程需包含的PDF文件资源编号列表，通过UploadFiles接口获取PDF文件资源编号。目前，此接口仅支持单个文件发起。
         # @type FileIds: Array
-        # @param FlowType: 签署流程的类型(如销售合同/入职合同等)，最大长度200个字符
+        # @param FlowDescription: 合同流程描述信息(可自定义此描述)，最大长度1000个字符。
+        # @type FlowDescription: String
+        # @param FlowType: 合同流程的类别分类（可自定义名称，如销售合同/入职合同等），最大长度为200个字符，仅限中文、字母、数字和下划线组成。
         # @type FlowType: String
-        # @param Components: 经办人内容控件配置
+        # @param Components: 模板或者合同中的填写控件列表，列表中可支持下列多种填写控件，控件的详细定义参考开发者中心的Component结构体
+        # - 单行文本控件
+        # - 多行文本控件
+        # - 勾选框控件
+        # - 数字控件
+        # - 图片控件
+        # - 动态表格等填写控件
         # @type Components: Array
-        # @param CcInfos: 被抄送人的信息列表。
-        # 注:此功能为白名单功能，若有需要，请联系电子签客服开白使用
+        # @param CcInfos: 合同流程的抄送人列表，最多可支持50个抄送人，抄送人可查看合同内容及签署进度，但无需参与合同签署。
+        # 注:此功能为白名单功能，使用前请联系对接的客户经理沟通。
         # @type CcInfos: Array
-        # @param NeedPreview: 是否需要预览，true：预览模式，false：非预览（默认）；
-        # 预览链接有效期300秒；
+        # @param CcNotifyType: 可以设置以下时间节点来给抄送人发送短信通知来查看合同内容：
+
+        # - 0：合同发起时通知（默认值）
+        # - 1：签署完成后通知
+        # @type CcNotifyType: Integer
+        # @param NeedPreview: 是否为预览模式，取值如下：
+
+        # false：非预览模式（默认），会产生合同流程并返回合同流程编号FlowId。
 
-        # 注：如果使用“预览模式”，出参会返回合同预览链接 PreviewUrl，不会正式发起合同，且出参不会返回签署流程编号 FlowId；如果使用“非预览”，则会正常返回签署流程编号 FlowId，不会生成合同预览链接 PreviewUrl。
+        # true：预览模式，不产生合同流程，不返回合同流程编号FlowId，而是返回预览链接PreviewUrl，有效期为300秒，用于查看真实发起后合同的样子。
         # @type NeedPreview: Boolean
-        # @param PreviewType: 预览链接类型 默认:0-文件流, 1- H5链接 注意:此参数在NeedPreview 为true 时有效,
+        # @param PreviewType: 预览模式下产生的预览链接类型
+
+        # - 0 :(默认) 文件流 ,点开后后下载预览的合同PDF文件
+
+        # - 1 :H5链接 ,点开后在浏览器中展示合同的样子
+
+        # 注意: 此参数在NeedPreview 为true时有效
         # @type PreviewType: Integer
-        # @param Deadline: 签署流程的签署截止时间。
-        # 值为unix时间戳,精确到秒,不传默认为当前时间一年后
+        # @param Deadline: 合同流程的签署截止时间，格式为Unix标准时间戳（秒），如果未设置签署截止时间，则默认为合同流程创建后的365天时截止。
+        # 如果在签署截止时间前未完成签署，则合同状态会变为已过期，导致合同作废。
         # @type Deadline: Integer
-        # @param RemindedOn: 合同到期提醒时间戳，单位秒。设定该值后，可以提前进行到期通知，方便客户处理合同到期事务，如合同续签等。该值支持的范围是从发起时间起到往后的10年内。仅合同发起方企业的发起人可以编辑修改。
+        # @param RemindedOn: 合同到期提醒时间，为Unix标准时间戳（秒）格式，支持的范围是从发起时间开始到后10年内。
+        # 到达提醒时间后，腾讯电子签会短信通知发起方企业合同提醒，可用于处理合同到期事务，如合同续签等事宜。
         # @type RemindedOn: Integer
-        # @param Unordered: 发送类型：
-        # true：无序签
-        # false：有序签
-        # 注：默认为false（有序签）
+        # @param Unordered: 合同流程的签署顺序类型：
+        # - false：(默认)有序签署, 本合同多个参与人需要依次签署
+        # - true：无序签署, 本合同多个参与人没有先后签署限制
         # @type Unordered: Boolean
-        # @param CustomShowMap: 合同显示的页卡模板，说明：只支持{合同名称}, {发起方企业}, {发起方姓名}, {签署方N企业}, {签署方N姓名}，且N不能超过签署人的数量，N从1开始
+        # @param CustomShowMap: 您可以自定义腾讯电子签小程序合同列表页展示的合同内容模板，模板中支持以下变量：
+
+        # - {合同名称}
+        # - {发起方企业}
+        # - {发起方姓名}
+        # - {签署方N企业}
+        # - {签署方N姓名}
+
+        # 其中，N表示签署方的编号，从1开始，不能超过签署人的数量。
+
+        # 例如，如果是腾讯公司张三发给李四名称为“租房合同”的合同，您可以将此字段设置为：
+        # 合同名称:`合同名称:{合同名称};发起方: {发起方企业}({发起方姓名});签署方:{签署方1姓名}`
+
+        # 则小程序中列表页展示此合同为以下样子
+        # ```
+        # 合同名称：租房合同
+        # 发起方：腾讯公司(张三)
+        # 签署方：李四
+        # ```
         # @type CustomShowMap: String
-        # @param NeedSignReview: 发起方企业的签署人进行签署操作是否需要企业内部审批。使用此功能需要发起方企业有参与签署。
-        # 若设置为true，审核结果需通过接口 CreateFlowSignReview 通知电子签，审核通过后，发起方企业签署人方可进行签署操作，否则会阻塞其签署操作。
+        # @param NeedSignReview: 发起方企业的签署人进行签署操作前，是否需要企业内部走审批流程，取值如下：
 
-        # 注：企业可以通过此功能与企业内部的审批流程进行关联，支持手动、静默签署合同。
+        # - false：（默认）不需要审批，直接签署。
+        # - true：需要走审批流程。当到对应参与人签署时，会阻塞其签署操作，等待企业内部审批完成。
+
+        # 企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
+
+        # - 如果企业通知腾讯电子签平台审核通过，签署方可继续签署动作。
+        # - 如果企业通知腾讯电子签平台审核未通过，平台将继续阻塞签署方的签署动作，直到企业通知平台审核通过。
+
+        # 注：此功能可用于与企业内部的审批流程进行关联，支持手动、静默签署合同
         # @type NeedSignReview: Boolean
-        # @param UserData: 用户自定义字段，回调的时候会进行透传，长度需要小于20480
+        # @param UserData: 调用方自定义的个性化字段(可自定义此名称)，并以base64方式编码，支持的最大数据大小为 20480长度。
+        # 在合同状态变更的回调信息等场景中，该字段的信息将原封不动地透传给贵方。
+        # 回调的相关说明可参考开发者中心的"回调通知"模块。
         # @type UserData: String
-        # @param ApproverVerifyType: 签署人校验方式
-        # VerifyCheck: 人脸识别（默认）
-        # MobileCheck：手机号验证
-        # 参数说明：可选人脸识别或手机号验证两种方式，若选择后者，未实名个人签署方在签署合同时，无需经过实名认证和意愿确认两次人脸识别，该能力仅适用于个人签署方。
+        # @param ApproverVerifyType: 指定个人签署方查看合同的校验方式
+
+        # - VerifyCheck :（默认）人脸识别,人脸识别后才能合同内容
+        # - MobileCheck:  手机号验证, 用户手机号和参与方手机号(ApproverMobile)相同即可查看合同内容
         # @type ApproverVerifyType: String
-        # @param FlowDescription: 签署流程描述,最大长度1000个字符
-        # @type FlowDescription: String
-        # @param SignBeanTag: 标识是否允许发起后添加控件。0为不允许1为允许。如果为1，创建的时候不能有签署控件，只能创建后添加。注意发起后添加控件功能不支持添加骑缝章和签批控件
+        # @param SignBeanTag: 签署方签署控件（印章/签名等）的生成方式：
+
+        # - 0：在合同流程发起时，由发起人指定签署方的签署控件的位置和数量。
+        # - 1：签署方在签署时自行添加签署控件，可以拖动位置和控制数量。
         # @type SignBeanTag: Integer
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
-        # @param CcNotifyType: 给关注人发送短信通知的类型，0-合同发起时通知 1-签署完成后通知
-        # @type CcNotifyType: Integer
-        # @param AutoSignScene: 个人自动签场景。发起自动签署时，需设置对应自动签署场景，目前仅支持场景：处方单-E_PRESCRIPTION_AUTO_SIGN
+        # @param AutoSignScene: 个人自动签名的使用场景包括以下, 个人自动签署(即ApproverType设置成个人自动签署时)业务此值必传：
+
+        # - E_PRESCRIPTION_AUTO_SIGN：处方单（医疗自动签）
+
+        # 注: 个人自动签名场景是白名单功能，使用前请与对接的客户经理联系沟通。
         # @type AutoSignScene: String
 
-        attr_accessor :Operator, :FlowName, :Approvers, :FileIds, :FlowType, :Components, :CcInfos, :NeedPreview, :PreviewType, :Deadline, :RemindedOn, :Unordered, :CustomShowMap, :NeedSignReview, :UserData, :ApproverVerifyType, :FlowDescription, :SignBeanTag, :Agent, :CcNotifyType, :AutoSignScene
+        attr_accessor :Operator, :FlowName, :Approvers, :FileIds, :FlowDescription, :FlowType, :Components, :CcInfos, :CcNotifyType, :NeedPreview, :PreviewType, :Deadline, :RemindedOn, :Unordered, :CustomShowMap, :NeedSignReview, :UserData, :ApproverVerifyType, :SignBeanTag, :Agent, :AutoSignScene
 
-        def initialize(operator=nil, flowname=nil, approvers=nil, fileids=nil, flowtype=nil, components=nil, ccinfos=nil, needpreview=nil, previewtype=nil, deadline=nil, remindedon=nil, unordered=nil, customshowmap=nil, needsignreview=nil, userdata=nil, approververifytype=nil, flowdescription=nil, signbeantag=nil, agent=nil, ccnotifytype=nil, autosignscene=nil)
+        def initialize(operator=nil, flowname=nil, approvers=nil, fileids=nil, flowdescription=nil, flowtype=nil, components=nil, ccinfos=nil, ccnotifytype=nil, needpreview=nil, previewtype=nil, deadline=nil, remindedon=nil, unordered=nil, customshowmap=nil, needsignreview=nil, userdata=nil, approververifytype=nil, signbeantag=nil, agent=nil, autosignscene=nil)
           @Operator = operator
           @FlowName = flowname
           @Approvers = approvers
           @FileIds = fileids
+          @FlowDescription = flowdescription
           @FlowType = flowtype
           @Components = components
           @CcInfos = ccinfos
+          @CcNotifyType = ccnotifytype
           @NeedPreview = needpreview
           @PreviewType = previewtype
           @Deadline = deadline
@@ -1359,10 +1483,8 @@ module TencentCloud
           @NeedSignReview = needsignreview
           @UserData = userdata
           @ApproverVerifyType = approververifytype
-          @FlowDescription = flowdescription
           @SignBeanTag = signbeantag
           @Agent = agent
-          @CcNotifyType = ccnotifytype
           @AutoSignScene = autosignscene
         end
 
@@ -1381,6 +1503,7 @@ module TencentCloud
             end
           end
           @FileIds = params['FileIds']
+          @FlowDescription = params['FlowDescription']
           @FlowType = params['FlowType']
           unless params['Components'].nil?
             @Components = []
@@ -1398,6 +1521,7 @@ module TencentCloud
               @CcInfos << ccinfo_tmp
             end
           end
+          @CcNotifyType = params['CcNotifyType']
           @NeedPreview = params['NeedPreview']
           @PreviewType = params['PreviewType']
           @Deadline = params['Deadline']
@@ -1407,26 +1531,26 @@ module TencentCloud
           @NeedSignReview = params['NeedSignReview']
           @UserData = params['UserData']
           @ApproverVerifyType = params['ApproverVerifyType']
-          @FlowDescription = params['FlowDescription']
           @SignBeanTag = params['SignBeanTag']
           unless params['Agent'].nil?
             @Agent = Agent.new
             @Agent.deserialize(params['Agent'])
           end
-          @CcNotifyType = params['CcNotifyType']
           @AutoSignScene = params['AutoSignScene']
         end
       end
 
       # CreateFlowByFiles返回参数结构体
       class CreateFlowByFilesResponse < TencentCloud::Common::AbstractModel
-        # @param FlowId: 签署流程编号。
+        # @param FlowId: 合同流程ID，为32位字符串。
+        # 建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
+        # 可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
 
-        # 注：如入参 是否需要预览 NeedPreview 设置为 true，不会正式发起合同，此处不会有值返回；如入参 是否需要预览 NeedPreview 设置为 false，此处会正常返回签署流程编号 FlowId。
+        # 注: 如果是预览模式(即NeedPreview设置为true)时, 此处不会有值返回。
         # @type FlowId: String
-        # @param PreviewUrl: 合同预览链接。
+        # @param PreviewUrl: 合同预览链接URL。
 
-        # 注：如入参 是否需要预览 NeedPreview 设置为 true，会开启“预览模式”，此处会返回预览链接；如入参 是否需要预览 NeedPreview 设置为 false，此处不会有值返回。
+        # 注：如果是预览模式(即NeedPreview设置为true)时, 才会有此预览链接URL
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type PreviewUrl: String
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
@@ -2896,7 +3020,7 @@ module TencentCloud
 
       # CreateSchemeUrl返回参数结构体
       class CreateSchemeUrlResponse < TencentCloud::Common::AbstractModel
-        # @param SchemeUrl: 小程序链接地址，有效期5分钟
+        # @param SchemeUrl: 小程序链接地址，有效期30天
         # @type SchemeUrl: String
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-ess
 version: !ruby/object:Gem::Version
-  version: 3.0.636
+  version: 3.0.638
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-08-15 00:00:00.000000000 Z
+date: 2023-08-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common