tencentcloud-sdk-ess 3.0.1163 → 3.0.1169

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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 23fbf50c77872051d40c3f6eac4ae46cf61b0843
4
- data.tar.gz: 3838d636ce1526412d3bc3921c83aed0107a36c6
3
+ metadata.gz: 46ccaf24bd9d02c59ca0d0a74770105e7a82abb2
4
+ data.tar.gz: e42438826d79487acba8254bcebcd195c8264d38
5
5
  SHA512:
6
- metadata.gz: fc78f78f027c0e574122ff4ff7bb60fa37ddd3a8e9de37b0015a2fe98fa141eaa1fc9d0a3203c86bf2cb8bc4a8e57f034da8465781916f94974e1cac70c02b44
7
- data.tar.gz: db1dfde63cca09803de9ba587cc97037efdc146de0347d15554b771c1ca6e424bc7739b7332f0daba3be8e86115e0a81608ad89d9defae7cbd92df0a918568fa
6
+ metadata.gz: 946344fe575f6a65b9dd3a89cb5696dff6d2e84207ed28b97d6ff37da5b91e2966a7ebcd845068fd8d2add296e250cd78b22dbce7431830124979e6763efeea4
7
+ data.tar.gz: 408afe76efed19d56cf52ddcefb23e363c4eaeb16cac004d1ab033d5f38b0145d1f3eb97b30e10ca5df5915ac1ce67bdf796e83b110ad30ff9fd4ff309393fc9
data/lib/VERSION CHANGED
@@ -1 +1 @@
1
- 3.0.1163
1
+ 3.0.1169
@@ -180,6 +180,68 @@ module TencentCloud
180
180
  raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
181
181
  end
182
182
 
183
+ # 本接口(CreateBatchAdminChangeInvitations)用于批量创建企业超管信息变更。
184
+ # 该接口为提交任务接口,如果需要获得链接, 需要使用接口创建超管变更链接(CreateBatchAdminChangeInvitationsUrl)。
185
+
186
+ # 批量创建链接有以下限制:
187
+
188
+ # 1. 单次最多创建10个企业的超管变更。
189
+ # 2. 同一批创建的企业不能重复,唯一值为企业 Id。
190
+
191
+ # 注意:
192
+ # 此接口创建的超管变更企业,必须是以下两种企业。
193
+ # 1. 集团子企业,调用方必须是主企业。
194
+ # 2. 代认证企业,此企业是由[创建企业认证链接](https://qian.tencent.com/developers/companyApis/organizations/CreateOrganizationAuthUrl)创建的
195
+
196
+ # @param request: Request instance for CreateBatchAdminChangeInvitations.
197
+ # @type request: :class:`Tencentcloud::ess::V20201111::CreateBatchAdminChangeInvitationsRequest`
198
+ # @rtype: :class:`Tencentcloud::ess::V20201111::CreateBatchAdminChangeInvitationsResponse`
199
+ def CreateBatchAdminChangeInvitations(request)
200
+ body = send_request('CreateBatchAdminChangeInvitations', request.serialize)
201
+ response = JSON.parse(body)
202
+ if response['Response'].key?('Error') == false
203
+ model = CreateBatchAdminChangeInvitationsResponse.new
204
+ model.deserialize(response['Response'])
205
+ model
206
+ else
207
+ code = response['Response']['Error']['Code']
208
+ message = response['Response']['Error']['Message']
209
+ reqid = response['Response']['RequestId']
210
+ raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
211
+ end
212
+ rescue TencentCloud::Common::TencentCloudSDKException => e
213
+ raise e
214
+ rescue StandardError => e
215
+ raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
216
+ end
217
+
218
+ # 此接口用于获取企业批量变更超管链接,包含多条超管变更任务。
219
+
220
+ # 前提条件:已调用 [CreateBatchAdminChangeInvitations生成批量变更超管任务接口](https://qian.tencent.com/developers/companyApis/organizations/CreateBatchAdminChangeInvitations) 确保任务提交。
221
+ # 此链接包含多条超管变更流程,使用该链接可以批量的对企业进行超管变更。
222
+
223
+ # @param request: Request instance for CreateBatchAdminChangeInvitationsUrl.
224
+ # @type request: :class:`Tencentcloud::ess::V20201111::CreateBatchAdminChangeInvitationsUrlRequest`
225
+ # @rtype: :class:`Tencentcloud::ess::V20201111::CreateBatchAdminChangeInvitationsUrlResponse`
226
+ def CreateBatchAdminChangeInvitationsUrl(request)
227
+ body = send_request('CreateBatchAdminChangeInvitationsUrl', request.serialize)
228
+ response = JSON.parse(body)
229
+ if response['Response'].key?('Error') == false
230
+ model = CreateBatchAdminChangeInvitationsUrlResponse.new
231
+ model.deserialize(response['Response'])
232
+ model
233
+ else
234
+ code = response['Response']['Error']['Code']
235
+ message = response['Response']['Error']['Message']
236
+ reqid = response['Response']['RequestId']
237
+ raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
238
+ end
239
+ rescue TencentCloud::Common::TencentCloudSDKException => e
240
+ raise e
241
+ rescue StandardError => e
242
+ raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
243
+ end
244
+
183
245
  # 指定需要批量撤回的签署流程Id,以获取批量撤销链接。
184
246
  # 客户需指定要撤回的签署流程Id,最多可指定100个,超过100则不处理。
185
247
  # 接口调用成功后,将返回批量撤回合同的链接。通过点击链接,可跳转至电子签小程序完成批量撤回操作。
@@ -38,6 +38,60 @@ module TencentCloud
38
38
  end
39
39
  end
40
40
 
41
+ # 企业变更超管信息。
42
+ class AdminChangeInvitationInfo < TencentCloud::Common::AbstractModel
43
+ # @param ChangeAdminOrganizationId: 要变更的企业Id。
44
+ # 使用接口进行变更,所支持的企业有两种。
45
+ # 1. 集团主企业替子企业进行超管变更。
46
+ # 子企业的企业 Id 可在更多-组织管理-集团组织管理处获取。如图位置![image](https://qcloudimg.tencent-cloud.cn/raw/3d4469c13ca9e66a847560fc4309c58b.png)
47
+ # 2. 使用接口[创建企业认证链接](https://qian.tencent.com/developers/companyApis/organizations/CreateOrganizationAuthUrl) 创建的企业,企业 Id 可以从回调[企业引导企业实名认证后回调](https://qian.tencent.com/developers/company/callback_types_staffs#%E5%8D%81%E4%B8%80-%E4%BC%81%E4%B8%9A%E5%BC%95%E5%AF%BC%E4%BC%81%E4%B8%9A%E5%AE%9E%E5%90%8D%E8%AE%A4%E8%AF%81%E5%90%8E%E5%9B%9E%E8%B0%83)得到。
48
+ # @type ChangeAdminOrganizationId: String
49
+ # @param NewAdminName: 组织机构要变更的超管姓名。
50
+ # 跟超管变更的操作人保持一致。
51
+ # @type NewAdminName: String
52
+ # @param AuthFiles: 授权书(PNG或JPG或PDF) base64格式, 大小不超过8M 。
53
+ # p.s. 如果上传授权书 ,需遵循以下条件
54
+ # 1. 超管的信息(超管姓名,超管手机号)必须为必填参数。
55
+ # @type AuthFiles: Array
56
+ # @param NewAdminMobile: 组织机构要变更的超管手机号。
57
+ # 跟超管变更的操作人保持一致。
58
+ # 超管变更的手机号和超管变更的证件号,必须要传递一个。
59
+ # @type NewAdminMobile: String
60
+ # @param NewAdminIdCardType: 组织机构要变更的超管证件类型支持以下类型
61
+ # - ID_CARD : 中国大陆居民身份证 (默认值)
62
+ # - HONGKONG_AND_MACAO : 中国港澳居民来往内地通行证
63
+ # - HONGKONG_MACAO_AND_TAIWAN : 中国港澳台居民居住证(格式同中国大陆居民身份证)
64
+
65
+ # 跟超管变更的操作人保持一致。
66
+ # @type NewAdminIdCardType: String
67
+ # @param NewAdminIdCardNumber: 组织机构新超管证件号。
68
+
69
+ # 跟超管变更的操作人保持一致。
70
+
71
+ # 超管变更的手机号和超管变更的证件号,必须要传递一个。
72
+ # @type NewAdminIdCardNumber: String
73
+
74
+ attr_accessor :ChangeAdminOrganizationId, :NewAdminName, :AuthFiles, :NewAdminMobile, :NewAdminIdCardType, :NewAdminIdCardNumber
75
+
76
+ def initialize(changeadminorganizationid=nil, newadminname=nil, authfiles=nil, newadminmobile=nil, newadminidcardtype=nil, newadminidcardnumber=nil)
77
+ @ChangeAdminOrganizationId = changeadminorganizationid
78
+ @NewAdminName = newadminname
79
+ @AuthFiles = authfiles
80
+ @NewAdminMobile = newadminmobile
81
+ @NewAdminIdCardType = newadminidcardtype
82
+ @NewAdminIdCardNumber = newadminidcardnumber
83
+ end
84
+
85
+ def deserialize(params)
86
+ @ChangeAdminOrganizationId = params['ChangeAdminOrganizationId']
87
+ @NewAdminName = params['NewAdminName']
88
+ @AuthFiles = params['AuthFiles']
89
+ @NewAdminMobile = params['NewAdminMobile']
90
+ @NewAdminIdCardType = params['NewAdminIdCardType']
91
+ @NewAdminIdCardNumber = params['NewAdminIdCardNumber']
92
+ end
93
+ end
94
+
41
95
  # 代理相关应用信息,如集团主企业代子企业操作
42
96
  class Agent < TencentCloud::Common::AbstractModel
43
97
  # @param AppId: 代理机构的应用编号,32位字符串,一般不用传
@@ -1650,6 +1704,162 @@ module TencentCloud
1650
1704
  end
1651
1705
  end
1652
1706
 
1707
+ # CreateBatchAdminChangeInvitations请求参数结构体
1708
+ class CreateBatchAdminChangeInvitationsRequest < TencentCloud::Common::AbstractModel
1709
+ # @param Operator: 执行本接口操作的员工信息。
1710
+ # 注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
1711
+ # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
1712
+ # @param AdminChangeInvitationInfos: 组织机构超管变更信息。
1713
+ # 一次最多支持10条超管变更信息。
1714
+ # @type AdminChangeInvitationInfos: Array
1715
+ # @param Agent: 代理企业和员工的信息。
1716
+ # 在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
1717
+ # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
1718
+
1719
+ attr_accessor :Operator, :AdminChangeInvitationInfos, :Agent
1720
+
1721
+ def initialize(operator=nil, adminchangeinvitationinfos=nil, agent=nil)
1722
+ @Operator = operator
1723
+ @AdminChangeInvitationInfos = adminchangeinvitationinfos
1724
+ @Agent = agent
1725
+ end
1726
+
1727
+ def deserialize(params)
1728
+ unless params['Operator'].nil?
1729
+ @Operator = UserInfo.new
1730
+ @Operator.deserialize(params['Operator'])
1731
+ end
1732
+ unless params['AdminChangeInvitationInfos'].nil?
1733
+ @AdminChangeInvitationInfos = []
1734
+ params['AdminChangeInvitationInfos'].each do |i|
1735
+ adminchangeinvitationinfo_tmp = AdminChangeInvitationInfo.new
1736
+ adminchangeinvitationinfo_tmp.deserialize(i)
1737
+ @AdminChangeInvitationInfos << adminchangeinvitationinfo_tmp
1738
+ end
1739
+ end
1740
+ unless params['Agent'].nil?
1741
+ @Agent = Agent.new
1742
+ @Agent.deserialize(params['Agent'])
1743
+ end
1744
+ end
1745
+ end
1746
+
1747
+ # CreateBatchAdminChangeInvitations返回参数结构体
1748
+ class CreateBatchAdminChangeInvitationsResponse < TencentCloud::Common::AbstractModel
1749
+ # @param ErrorMessages: 批量生成企业认证链接的详细错误信息,
1750
+ # 顺序与输入参数保持一致。
1751
+ # 若企业认证均成功生成,则不返回错误信息;
1752
+ # 若存在任何错误,则返回具体的错误描述。
1753
+ # @type ErrorMessages: Array
1754
+ # @param RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1755
+ # @type RequestId: String
1756
+
1757
+ attr_accessor :ErrorMessages, :RequestId
1758
+
1759
+ def initialize(errormessages=nil, requestid=nil)
1760
+ @ErrorMessages = errormessages
1761
+ @RequestId = requestid
1762
+ end
1763
+
1764
+ def deserialize(params)
1765
+ @ErrorMessages = params['ErrorMessages']
1766
+ @RequestId = params['RequestId']
1767
+ end
1768
+ end
1769
+
1770
+ # CreateBatchAdminChangeInvitationsUrl请求参数结构体
1771
+ class CreateBatchAdminChangeInvitationsUrlRequest < TencentCloud::Common::AbstractModel
1772
+ # @param Operator: 执行本接口操作的员工信息。
1773
+ # 注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
1774
+ # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
1775
+ # @param NewAdminName: 组织机构要变更的超管姓名。 在超管变更流程中,必须是超管本人进行操作,需要更当前操作人的姓名保持一致。
1776
+ # @type NewAdminName: String
1777
+ # @param NewAdminMobile: 组织机构要变更的超管手机号。
1778
+ # 在超管变更流程中,必须是超管本人进行操作,需要更当前操作人的手机号保持一致。
1779
+
1780
+ # 超管手机号 和超管证件号 二选一 必填。
1781
+
1782
+ # 注意:
1783
+ # 1. 如果新超管的个人身份在电子签进行了手机号的变更,之前提交的超管变更任务将无法获取。
1784
+ # @type NewAdminMobile: String
1785
+ # @param NewAdminIdCardType: 组织机构要变更的超管证件类型支持以下类型
1786
+ # - ID_CARD : 中国大陆居民身份证 (默认值)
1787
+ # - HONGKONG_AND_MACAO : 中国港澳居民来往内地通行证
1788
+ # - HONGKONG_MACAO_AND_TAIWAN : 中国港澳台居民居住证(格式同中国大陆居民身份证)
1789
+ # 需要更当前操作人的证件类型保持一致。
1790
+ # @type NewAdminIdCardType: String
1791
+ # @param NewAdminIdCardNumber: 组织机构要变更的超管证件号。
1792
+ # 在超管变更流程中,必须是超管本人进行操作,需要更当前操作人的证件号保持一致。
1793
+
1794
+ # 超管手机号和超管证件号 二选一必填。
1795
+ # @type NewAdminIdCardNumber: String
1796
+ # @param NotifyType: 通知方式。
1797
+ # NONE(默认)
1798
+ # SMS - 如果使用这个方式,则会给即将变更的超管发信息。
1799
+ # 注意:
1800
+ # 发送信息的手机号,是用户传递的手机号。
1801
+ # 如果用户同时传递了证件号,手机号会用用户在电子签注册的手机号进行覆盖。
1802
+ # @type NotifyType: String
1803
+ # @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>
1804
+ # @type Endpoint: String
1805
+
1806
+ attr_accessor :Operator, :NewAdminName, :NewAdminMobile, :NewAdminIdCardType, :NewAdminIdCardNumber, :NotifyType, :Endpoint
1807
+
1808
+ def initialize(operator=nil, newadminname=nil, newadminmobile=nil, newadminidcardtype=nil, newadminidcardnumber=nil, notifytype=nil, endpoint=nil)
1809
+ @Operator = operator
1810
+ @NewAdminName = newadminname
1811
+ @NewAdminMobile = newadminmobile
1812
+ @NewAdminIdCardType = newadminidcardtype
1813
+ @NewAdminIdCardNumber = newadminidcardnumber
1814
+ @NotifyType = notifytype
1815
+ @Endpoint = endpoint
1816
+ end
1817
+
1818
+ def deserialize(params)
1819
+ unless params['Operator'].nil?
1820
+ @Operator = UserInfo.new
1821
+ @Operator.deserialize(params['Operator'])
1822
+ end
1823
+ @NewAdminName = params['NewAdminName']
1824
+ @NewAdminMobile = params['NewAdminMobile']
1825
+ @NewAdminIdCardType = params['NewAdminIdCardType']
1826
+ @NewAdminIdCardNumber = params['NewAdminIdCardNumber']
1827
+ @NotifyType = params['NotifyType']
1828
+ @Endpoint = params['Endpoint']
1829
+ end
1830
+ end
1831
+
1832
+ # CreateBatchAdminChangeInvitationsUrl返回参数结构体
1833
+ class CreateBatchAdminChangeInvitationsUrlResponse < TencentCloud::Common::AbstractModel
1834
+ # @param Url: 批量企业注册链接-单链接包含多条认证流,根据Endpoint的不同设置,返回不同的链接地址。失效时间:7天
1835
+ # 跳转链接, 链接的有效期根据企业,员工状态和终端等有区别, 可以参考下表
1836
+ # <table> <thead> <tr> <th>Endpoint</th> <th>示例</th> <th>链接有效期限</th> </tr> </thead> <tbody>
1837
+ # <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>
1838
+ # <tr> <td>HTTP_SHORT_URL</td> <td>https://test.essurl.cn/8gDKUBAWK8</td> <td>7天</td> </tr>
1839
+ # <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>
1840
+ # 注:
1841
+ # `1.创建的链接应避免被转义,如:&被转义为\u0026;如使用Postman请求后,请选择响应类型为 JSON,否则链接将被转义`
1842
+ # @type Url: String
1843
+ # @param ExpireTime: 链接过期时间,为 7 天后,创建时间,格式为Unix标准时间戳(秒)。
1844
+ # @type ExpireTime: Integer
1845
+ # @param RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1846
+ # @type RequestId: String
1847
+
1848
+ attr_accessor :Url, :ExpireTime, :RequestId
1849
+
1850
+ def initialize(url=nil, expiretime=nil, requestid=nil)
1851
+ @Url = url
1852
+ @ExpireTime = expiretime
1853
+ @RequestId = requestid
1854
+ end
1855
+
1856
+ def deserialize(params)
1857
+ @Url = params['Url']
1858
+ @ExpireTime = params['ExpireTime']
1859
+ @RequestId = params['RequestId']
1860
+ end
1861
+ end
1862
+
1653
1863
  # CreateBatchCancelFlowUrl请求参数结构体
1654
1864
  class CreateBatchCancelFlowUrlRequest < TencentCloud::Common::AbstractModel
1655
1865
  # @param Operator: 执行本接口操作的员工信息。
@@ -4287,13 +4497,15 @@ module TencentCloud
4287
4497
  # @type PreviewAfterStart: Boolean
4288
4498
  # @param SignAfterStart: 发起成功之后是否签署合同,仅当前经办人作为签署人时生效 <ul><li>(默认) false -否</li> <li> true - 展示签署按钮</li></ul>
4289
4499
  # @type SignAfterStart: Boolean
4500
+ # @param NeedFlowDraft: 发起过程中是否保存草稿
4501
+ # @type NeedFlowDraft: Boolean
4290
4502
 
4291
- attr_accessor :CanEditFlow, :CanEditFormField, :HideShowFlowName, :HideShowFlowType, :HideShowDeadline, :CanSkipAddApprover, :SkipUploadFile, :ForbidEditFillComponent, :CustomCreateFlowDescription, :ForbidAddApprover, :ForbidEditApprover, :ForbidEditFlowProperties, :HideComponentTypes, :ShowComponentTypes, :ResultPageConfig, :SignComponentConfig, :ForbidEditWatermark, :HideOperationInstructions, :HideOperationSteps, :SelfName, :HideSignCodeAfterStart, :PreviewAfterStart, :SignAfterStart
4503
+ attr_accessor :CanEditFlow, :CanEditFormField, :HideShowFlowName, :HideShowFlowType, :HideShowDeadline, :CanSkipAddApprover, :SkipUploadFile, :ForbidEditFillComponent, :CustomCreateFlowDescription, :ForbidAddApprover, :ForbidEditApprover, :ForbidEditFlowProperties, :HideComponentTypes, :ShowComponentTypes, :ResultPageConfig, :SignComponentConfig, :ForbidEditWatermark, :HideOperationInstructions, :HideOperationSteps, :SelfName, :HideSignCodeAfterStart, :PreviewAfterStart, :SignAfterStart, :NeedFlowDraft
4292
4504
  extend Gem::Deprecate
4293
4505
  deprecate :HideOperationInstructions, :none, 2025, 11
4294
4506
  deprecate :HideOperationInstructions=, :none, 2025, 11
4295
4507
 
4296
- def initialize(caneditflow=nil, caneditformfield=nil, hideshowflowname=nil, hideshowflowtype=nil, hideshowdeadline=nil, canskipaddapprover=nil, skipuploadfile=nil, forbideditfillcomponent=nil, customcreateflowdescription=nil, forbidaddapprover=nil, forbideditapprover=nil, forbideditflowproperties=nil, hidecomponenttypes=nil, showcomponenttypes=nil, resultpageconfig=nil, signcomponentconfig=nil, forbideditwatermark=nil, hideoperationinstructions=nil, hideoperationsteps=nil, selfname=nil, hidesigncodeafterstart=nil, previewafterstart=nil, signafterstart=nil)
4508
+ def initialize(caneditflow=nil, caneditformfield=nil, hideshowflowname=nil, hideshowflowtype=nil, hideshowdeadline=nil, canskipaddapprover=nil, skipuploadfile=nil, forbideditfillcomponent=nil, customcreateflowdescription=nil, forbidaddapprover=nil, forbideditapprover=nil, forbideditflowproperties=nil, hidecomponenttypes=nil, showcomponenttypes=nil, resultpageconfig=nil, signcomponentconfig=nil, forbideditwatermark=nil, hideoperationinstructions=nil, hideoperationsteps=nil, selfname=nil, hidesigncodeafterstart=nil, previewafterstart=nil, signafterstart=nil, needflowdraft=nil)
4297
4509
  @CanEditFlow = caneditflow
4298
4510
  @CanEditFormField = caneditformfield
4299
4511
  @HideShowFlowName = hideshowflowname
@@ -4317,6 +4529,7 @@ module TencentCloud
4317
4529
  @HideSignCodeAfterStart = hidesigncodeafterstart
4318
4530
  @PreviewAfterStart = previewafterstart
4319
4531
  @SignAfterStart = signafterstart
4532
+ @NeedFlowDraft = needflowdraft
4320
4533
  end
4321
4534
 
4322
4535
  def deserialize(params)
@@ -4353,6 +4566,7 @@ module TencentCloud
4353
4566
  @HideSignCodeAfterStart = params['HideSignCodeAfterStart']
4354
4567
  @PreviewAfterStart = params['PreviewAfterStart']
4355
4568
  @SignAfterStart = params['SignAfterStart']
4569
+ @NeedFlowDraft = params['NeedFlowDraft']
4356
4570
  end
4357
4571
  end
4358
4572
 
@@ -5305,10 +5519,21 @@ module TencentCloud
5305
5519
 
5306
5520
  # 在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的<a href="https://qian.tencent.com/developers/company/callback_types_v2" target="_blank">回调通知</a>模块。
5307
5521
  # @type UserData: String
5522
+ # @param Hides: 生成的签署链接在签署页面隐藏的按钮列表,可设置如下:
5523
+
5524
+ # <ul><li> **0** :合同签署页面更多操作按钮</li>
5525
+ # <li> **1** :合同签署页面更多操作的拒绝签署按钮</li>
5526
+ # <li> **2** :合同签署页面更多操作的转他人处理按钮</li>
5527
+ # <li> **3** :签署成功页的查看详情按钮</li>
5528
+ # <li> **4** :合同签署页面更多操作的查看合同基本信息按钮</li>
5529
+ # <li> **5** :合同签署页面更多操作的撤销按钮</li></ul>
5530
+
5531
+ # 注: `字段为数组, 可以传值隐藏多个按钮`
5532
+ # @type Hides: Array
5308
5533
 
5309
- attr_accessor :Operator, :ResourceType, :ResourceId, :FlowName, :Agent, :Approvers, :CcInfos, :Unordered, :DeadlineAfterStartDays, :UserFlowTypeId, :FlowOption, :PageOption, :UserData
5534
+ attr_accessor :Operator, :ResourceType, :ResourceId, :FlowName, :Agent, :Approvers, :CcInfos, :Unordered, :DeadlineAfterStartDays, :UserFlowTypeId, :FlowOption, :PageOption, :UserData, :Hides
5310
5535
 
5311
- def initialize(operator=nil, resourcetype=nil, resourceid=nil, flowname=nil, agent=nil, approvers=nil, ccinfos=nil, unordered=nil, deadlineafterstartdays=nil, userflowtypeid=nil, flowoption=nil, pageoption=nil, userdata=nil)
5536
+ def initialize(operator=nil, resourcetype=nil, resourceid=nil, flowname=nil, agent=nil, approvers=nil, ccinfos=nil, unordered=nil, deadlineafterstartdays=nil, userflowtypeid=nil, flowoption=nil, pageoption=nil, userdata=nil, hides=nil)
5312
5537
  @Operator = operator
5313
5538
  @ResourceType = resourcetype
5314
5539
  @ResourceId = resourceid
@@ -5322,6 +5547,7 @@ module TencentCloud
5322
5547
  @FlowOption = flowoption
5323
5548
  @PageOption = pageoption
5324
5549
  @UserData = userdata
5550
+ @Hides = hides
5325
5551
  end
5326
5552
 
5327
5553
  def deserialize(params)
@@ -5364,6 +5590,7 @@ module TencentCloud
5364
5590
  @PageOption.deserialize(params['PageOption'])
5365
5591
  end
5366
5592
  @UserData = params['UserData']
5593
+ @Hides = params['Hides']
5367
5594
  end
5368
5595
  end
5369
5596
 
@@ -5790,10 +6017,12 @@ module TencentCloud
5790
6017
 
5791
6018
  # p.s. 如果Endpoint是 APP,传递的跳转地址无效,不会进行跳转,仅会进行回跳。
5792
6019
  # @type JumpEvents: Array
6020
+ # @param OrganizationIdCardType: 企业证照类型:<ul><li> **USCC** :(默认)工商组织营业执照</li><li> **PRACTICELICENSEOFMEDICALINSTITUTION** :医疗机构执业许可证</li></ul>
6021
+ # @type OrganizationIdCardType: String
5793
6022
 
5794
- attr_accessor :Operator, :AuthorizationTypes, :OrganizationName, :UniformSocialCreditCode, :LegalName, :AutoJumpUrl, :OrganizationAddress, :AdminName, :AdminMobile, :AdminIdCardNumber, :AdminIdCardType, :UniformSocialCreditCodeSame, :LegalNameSame, :AdminNameSame, :AdminIdCardNumberSame, :AdminMobileSame, :OrganizationNameSame, :BusinessLicense, :Endpoint, :Initialization, :PowerOfAttorneys, :UserData, :BankAccountNumber, :BankAccountNumberSame, :JumpEvents
6023
+ attr_accessor :Operator, :AuthorizationTypes, :OrganizationName, :UniformSocialCreditCode, :LegalName, :AutoJumpUrl, :OrganizationAddress, :AdminName, :AdminMobile, :AdminIdCardNumber, :AdminIdCardType, :UniformSocialCreditCodeSame, :LegalNameSame, :AdminNameSame, :AdminIdCardNumberSame, :AdminMobileSame, :OrganizationNameSame, :BusinessLicense, :Endpoint, :Initialization, :PowerOfAttorneys, :UserData, :BankAccountNumber, :BankAccountNumberSame, :JumpEvents, :OrganizationIdCardType
5795
6024
 
5796
- def initialize(operator=nil, authorizationtypes=nil, organizationname=nil, uniformsocialcreditcode=nil, legalname=nil, autojumpurl=nil, organizationaddress=nil, adminname=nil, adminmobile=nil, adminidcardnumber=nil, adminidcardtype=nil, uniformsocialcreditcodesame=nil, legalnamesame=nil, adminnamesame=nil, adminidcardnumbersame=nil, adminmobilesame=nil, organizationnamesame=nil, businesslicense=nil, endpoint=nil, initialization=nil, powerofattorneys=nil, userdata=nil, bankaccountnumber=nil, bankaccountnumbersame=nil, jumpevents=nil)
6025
+ def initialize(operator=nil, authorizationtypes=nil, organizationname=nil, uniformsocialcreditcode=nil, legalname=nil, autojumpurl=nil, organizationaddress=nil, adminname=nil, adminmobile=nil, adminidcardnumber=nil, adminidcardtype=nil, uniformsocialcreditcodesame=nil, legalnamesame=nil, adminnamesame=nil, adminidcardnumbersame=nil, adminmobilesame=nil, organizationnamesame=nil, businesslicense=nil, endpoint=nil, initialization=nil, powerofattorneys=nil, userdata=nil, bankaccountnumber=nil, bankaccountnumbersame=nil, jumpevents=nil, organizationidcardtype=nil)
5797
6026
  @Operator = operator
5798
6027
  @AuthorizationTypes = authorizationtypes
5799
6028
  @OrganizationName = organizationname
@@ -5819,6 +6048,7 @@ module TencentCloud
5819
6048
  @BankAccountNumber = bankaccountnumber
5820
6049
  @BankAccountNumberSame = bankaccountnumbersame
5821
6050
  @JumpEvents = jumpevents
6051
+ @OrganizationIdCardType = organizationidcardtype
5822
6052
  end
5823
6053
 
5824
6054
  def deserialize(params)
@@ -5857,6 +6087,7 @@ module TencentCloud
5857
6087
  @JumpEvents << jumpevent_tmp
5858
6088
  end
5859
6089
  end
6090
+ @OrganizationIdCardType = params['OrganizationIdCardType']
5860
6091
  end
5861
6092
  end
5862
6093
 
@@ -6362,6 +6593,7 @@ module TencentCloud
6362
6593
  # <ul>
6363
6594
  # <li>文件Id(通过UploadFiles获取文件资源Id)</li>
6364
6595
  # <li>模板Id(通过控制台创建模板后获取模板Id)</li>
6596
+ # <li>草稿Id(通过嵌入页面保存草稿后获取草稿Id)</li>
6365
6597
  # </ul>
6366
6598
  # 注意:需要同时设置 ResourceType 参数指定资源类型
6367
6599
  # @type ResourceId: String
@@ -6371,7 +6603,9 @@ module TencentCloud
6371
6603
  # @type FlowName: String
6372
6604
  # @param ResourceType: 资源类型,取值有:
6373
6605
  # <ul><li> **1**:模板</li>
6374
- # <li> **2**:文件(默认值)</li></ul>
6606
+ # <li> **2**:文件(默认值)</li>
6607
+ # <li> **3**:草稿</li>
6608
+ # </ul>
6375
6609
  # @type ResourceType: Integer
6376
6610
  # @param Unordered: 合同流程的签署顺序类型:
6377
6611
  # <ul><li> **false**:(默认)有序签署, 本合同多个参与人需要依次签署 </li>
@@ -6532,20 +6766,24 @@ module TencentCloud
6532
6766
  # @type Url: String
6533
6767
  # @param FlowId: 创建的合同id(还未实际发起),每次调用会生成新的id,用户可以记录此字段对应后续页面发起的合同,若在页面上未成功发起,则此字段无效。
6534
6768
  # @type FlowId: String
6769
+ # @param DraftId: 临时的草稿id(还未实际保存草稿),用户可以记录此字段对应后续页面保存的草稿,若在页面上未保存草稿,则此字段无效。
6770
+ # @type DraftId: String
6535
6771
  # @param RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
6536
6772
  # @type RequestId: String
6537
6773
 
6538
- attr_accessor :Url, :FlowId, :RequestId
6774
+ attr_accessor :Url, :FlowId, :DraftId, :RequestId
6539
6775
 
6540
- def initialize(url=nil, flowid=nil, requestid=nil)
6776
+ def initialize(url=nil, flowid=nil, draftid=nil, requestid=nil)
6541
6777
  @Url = url
6542
6778
  @FlowId = flowid
6779
+ @DraftId = draftid
6543
6780
  @RequestId = requestid
6544
6781
  end
6545
6782
 
6546
6783
  def deserialize(params)
6547
6784
  @Url = params['Url']
6548
6785
  @FlowId = params['FlowId']
6786
+ @DraftId = params['DraftId']
6549
6787
  @RequestId = params['RequestId']
6550
6788
  end
6551
6789
  end
@@ -6847,7 +7085,10 @@ module TencentCloud
6847
7085
  # <ul><li> **0** :合同签署页面更多操作按钮</li>
6848
7086
  # <li> **1** :合同签署页面更多操作的拒绝签署按钮</li>
6849
7087
  # <li> **2** :合同签署页面更多操作的转他人处理按钮</li>
6850
- # <li> **3** :签署成功页的查看详情按钮</li></ul>
7088
+ # <li> **3** :签署成功页的查看详情按钮</li>
7089
+ # <li> **4** :合同签署页面更多操作的查看合同基本信息按钮</li>
7090
+ # <li> **5** :合同签署页面更多操作的撤销按钮</li></ul>
7091
+
6851
7092
 
6852
7093
  # 注: `字段为数组, 可以传值隐藏多个按钮`
6853
7094
  # @type Hides: Array
@@ -8963,12 +9204,15 @@ module TencentCloud
8963
9204
  # @type HighRiskCount: Integer
8964
9205
  # @param TotalRiskCount: 合同审查出的风险总数
8965
9206
  # @type TotalRiskCount: Integer
9207
+ # @param ApprovedLists: 通过项信息(详细引文信息)
9208
+ # 注意:此字段可能返回 null,表示取不到有效值。
9209
+ # @type ApprovedLists: Array
8966
9210
  # @param RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
8967
9211
  # @type RequestId: String
8968
9212
 
8969
- attr_accessor :ChecklistId, :CreatedOn, :FinishedOn, :PolicyType, :ResourceId, :Risks, :Role, :Status, :TaskId, :Comment, :UserData, :HighRiskCount, :TotalRiskCount, :RequestId
9213
+ attr_accessor :ChecklistId, :CreatedOn, :FinishedOn, :PolicyType, :ResourceId, :Risks, :Role, :Status, :TaskId, :Comment, :UserData, :HighRiskCount, :TotalRiskCount, :ApprovedLists, :RequestId
8970
9214
 
8971
- def initialize(checklistid=nil, createdon=nil, finishedon=nil, policytype=nil, resourceid=nil, risks=nil, role=nil, status=nil, taskid=nil, comment=nil, userdata=nil, highriskcount=nil, totalriskcount=nil, requestid=nil)
9215
+ def initialize(checklistid=nil, createdon=nil, finishedon=nil, policytype=nil, resourceid=nil, risks=nil, role=nil, status=nil, taskid=nil, comment=nil, userdata=nil, highriskcount=nil, totalriskcount=nil, approvedlists=nil, requestid=nil)
8972
9216
  @ChecklistId = checklistid
8973
9217
  @CreatedOn = createdon
8974
9218
  @FinishedOn = finishedon
@@ -8982,6 +9226,7 @@ module TencentCloud
8982
9226
  @UserData = userdata
8983
9227
  @HighRiskCount = highriskcount
8984
9228
  @TotalRiskCount = totalriskcount
9229
+ @ApprovedLists = approvedlists
8985
9230
  @RequestId = requestid
8986
9231
  end
8987
9232
 
@@ -9009,6 +9254,14 @@ module TencentCloud
9009
9254
  @UserData = params['UserData']
9010
9255
  @HighRiskCount = params['HighRiskCount']
9011
9256
  @TotalRiskCount = params['TotalRiskCount']
9257
+ unless params['ApprovedLists'].nil?
9258
+ @ApprovedLists = []
9259
+ params['ApprovedLists'].each do |i|
9260
+ outputreference_tmp = OutputReference.new
9261
+ outputreference_tmp.deserialize(i)
9262
+ @ApprovedLists << outputreference_tmp
9263
+ end
9264
+ end
9012
9265
  @RequestId = params['RequestId']
9013
9266
  end
9014
9267
  end
@@ -11108,13 +11361,22 @@ module TencentCloud
11108
11361
  # <ul><li> <b>true</b> :允许在模板预览页展示控件</li>
11109
11362
  # <li> <b>false</b> :(默认)不允许在模板预览页展示控件</li></ul>
11110
11363
  # @type ShowTemplateComponent: Boolean
11111
- # @param SkipUploadFile: 跳过上传文件,默认为false(展示上传文件页)![image](https://qcloudimg.tencent-cloud.cn/raw/8ca33745cf772e79831dbe5a70e82400.png)
11364
+ # @param SkipUploadFile: 跳过上传文件,默认为false(展示上传文件页)![image](https://qcloudimg.tencent-cloud.cn/raw/8ca33745cf772e79831dbe5a70e82400.png)
11112
11365
  # - false: 展示上传文件页
11113
11366
  # - true: 不展示上传文件页
11114
11367
 
11115
11368
 
11116
11369
  # 注意: 此参数仅针对**EmbedType=CREATE_TEMPLATE(创建模板)和EmbedType=CREATE_CONTRACT_DRAFT_COOPEDIT(创建起草合同)有效**,
11117
11370
  # @type SkipUploadFile: Boolean
11371
+ # @param SkipDownloadFile: 隐藏下载文件按钮,默认为false(展示下载文件按钮)
11372
+
11373
+ # - false: 展示下载文件按钮
11374
+ # - true: 不展示下载文件按钮
11375
+
11376
+
11377
+
11378
+ # 注意: 此参数仅针对**EmbedType=PREVIEW_FLOW_DETAIL(查看合同详情)**有效
11379
+ # @type SkipDownloadFile: Boolean
11118
11380
  # @param ForbidEditWatermark: 是否禁止编辑(展示)水印控件属性
11119
11381
  # <ul><li>(默认) false -否</li> <li> true - 禁止编辑</li></ul>
11120
11382
  # @type ForbidEditWatermark: Boolean
@@ -11124,12 +11386,13 @@ module TencentCloud
11124
11386
  # <ul><li>(默认) false -否</li> <li> true - 禁止编辑</li></ul>
11125
11387
  # @type ForbidEditSealDescription: Boolean
11126
11388
 
11127
- attr_accessor :ShowFlowDetailComponent, :ShowTemplateComponent, :SkipUploadFile, :ForbidEditWatermark, :SealDescription, :ForbidEditSealDescription
11389
+ attr_accessor :ShowFlowDetailComponent, :ShowTemplateComponent, :SkipUploadFile, :SkipDownloadFile, :ForbidEditWatermark, :SealDescription, :ForbidEditSealDescription
11128
11390
 
11129
- def initialize(showflowdetailcomponent=nil, showtemplatecomponent=nil, skipuploadfile=nil, forbideditwatermark=nil, sealdescription=nil, forbideditsealdescription=nil)
11391
+ def initialize(showflowdetailcomponent=nil, showtemplatecomponent=nil, skipuploadfile=nil, skipdownloadfile=nil, forbideditwatermark=nil, sealdescription=nil, forbideditsealdescription=nil)
11130
11392
  @ShowFlowDetailComponent = showflowdetailcomponent
11131
11393
  @ShowTemplateComponent = showtemplatecomponent
11132
11394
  @SkipUploadFile = skipuploadfile
11395
+ @SkipDownloadFile = skipdownloadfile
11133
11396
  @ForbidEditWatermark = forbideditwatermark
11134
11397
  @SealDescription = sealdescription
11135
11398
  @ForbidEditSealDescription = forbideditsealdescription
@@ -11139,6 +11402,7 @@ module TencentCloud
11139
11402
  @ShowFlowDetailComponent = params['ShowFlowDetailComponent']
11140
11403
  @ShowTemplateComponent = params['ShowTemplateComponent']
11141
11404
  @SkipUploadFile = params['SkipUploadFile']
11405
+ @SkipDownloadFile = params['SkipDownloadFile']
11142
11406
  @ForbidEditWatermark = params['ForbidEditWatermark']
11143
11407
  @SealDescription = params['SealDescription']
11144
11408
  @ForbidEditSealDescription = params['ForbidEditSealDescription']
@@ -14718,6 +14982,50 @@ module TencentCloud
14718
14982
  end
14719
14983
  end
14720
14984
 
14985
+ # 审查通过项对应的引文信息
14986
+ class OutputReference < TencentCloud::Common::AbstractModel
14987
+ # @param RiskId: 合同审查风险结果ID
14988
+ # @type RiskId: String
14989
+ # @param RiskName: 风险名称
14990
+ # @type RiskName: String
14991
+ # @param RiskDescription: 风险描述
14992
+ # @type RiskDescription: String
14993
+ # @param CategoryName: 风险要点分类名称
14994
+ # @type CategoryName: String
14995
+ # @param RiskBasis: 审查依据
14996
+ # @type RiskBasis: String
14997
+ # @param Excerpts: 引文内容
14998
+ # 注意:此字段可能返回 null,表示取不到有效值。
14999
+ # @type Excerpts: Array
15000
+
15001
+ attr_accessor :RiskId, :RiskName, :RiskDescription, :CategoryName, :RiskBasis, :Excerpts
15002
+
15003
+ def initialize(riskid=nil, riskname=nil, riskdescription=nil, categoryname=nil, riskbasis=nil, excerpts=nil)
15004
+ @RiskId = riskid
15005
+ @RiskName = riskname
15006
+ @RiskDescription = riskdescription
15007
+ @CategoryName = categoryname
15008
+ @RiskBasis = riskbasis
15009
+ @Excerpts = excerpts
15010
+ end
15011
+
15012
+ def deserialize(params)
15013
+ @RiskId = params['RiskId']
15014
+ @RiskName = params['RiskName']
15015
+ @RiskDescription = params['RiskDescription']
15016
+ @CategoryName = params['CategoryName']
15017
+ @RiskBasis = params['RiskBasis']
15018
+ unless params['Excerpts'].nil?
15019
+ @Excerpts = []
15020
+ params['Excerpts'].each do |i|
15021
+ referenceexcerpt_tmp = ReferenceExcerpt.new
15022
+ referenceexcerpt_tmp.deserialize(i)
15023
+ @Excerpts << referenceexcerpt_tmp
15024
+ end
15025
+ end
15026
+ end
15027
+ end
15028
+
14721
15029
  # 合同审查任务识别出的风险结果信息
14722
15030
  class OutputRisk < TencentCloud::Common::AbstractModel
14723
15031
  # @param RiskId: 合同审查风险结果ID
@@ -14744,10 +15052,12 @@ module TencentCloud
14744
15052
  # @type Positions: Array
14745
15053
  # @param RiskBasis: 审查依据
14746
15054
  # @type RiskBasis: String
15055
+ # @param RiskLevelId: 风险等级id
15056
+ # @type RiskLevelId: Integer
14747
15057
 
14748
- attr_accessor :RiskId, :RiskName, :RiskDescription, :RiskLevel, :RiskAdvice, :RiskPresentation, :Content, :Positions, :RiskBasis
15058
+ attr_accessor :RiskId, :RiskName, :RiskDescription, :RiskLevel, :RiskAdvice, :RiskPresentation, :Content, :Positions, :RiskBasis, :RiskLevelId
14749
15059
 
14750
- def initialize(riskid=nil, riskname=nil, riskdescription=nil, risklevel=nil, riskadvice=nil, riskpresentation=nil, content=nil, positions=nil, riskbasis=nil)
15060
+ def initialize(riskid=nil, riskname=nil, riskdescription=nil, risklevel=nil, riskadvice=nil, riskpresentation=nil, content=nil, positions=nil, riskbasis=nil, risklevelid=nil)
14751
15061
  @RiskId = riskid
14752
15062
  @RiskName = riskname
14753
15063
  @RiskDescription = riskdescription
@@ -14757,6 +15067,7 @@ module TencentCloud
14757
15067
  @Content = content
14758
15068
  @Positions = positions
14759
15069
  @RiskBasis = riskbasis
15070
+ @RiskLevelId = risklevelid
14760
15071
  end
14761
15072
 
14762
15073
  def deserialize(params)
@@ -14776,6 +15087,7 @@ module TencentCloud
14776
15087
  end
14777
15088
  end
14778
15089
  @RiskBasis = params['RiskBasis']
15090
+ @RiskLevelId = params['RiskLevelId']
14779
15091
  end
14780
15092
  end
14781
15093
 
@@ -15157,6 +15469,30 @@ module TencentCloud
15157
15469
  end
15158
15470
  end
15159
15471
 
15472
+ # 引用的资料
15473
+ class ReferenceExcerpt < TencentCloud::Common::AbstractModel
15474
+ # @param Content: 原文内容
15475
+ # @type Content: String
15476
+ # @param Position: 坐标信息
15477
+ # 注意:此字段可能返回 null,表示取不到有效值。
15478
+ # @type Position: :class:`Tencentcloud::Ess.v20201111.models.PositionInfo`
15479
+
15480
+ attr_accessor :Content, :Position
15481
+
15482
+ def initialize(content=nil, position=nil)
15483
+ @Content = content
15484
+ @Position = position
15485
+ end
15486
+
15487
+ def deserialize(params)
15488
+ @Content = params['Content']
15489
+ unless params['Position'].nil?
15490
+ @Position = PositionInfo.new
15491
+ @Position.deserialize(params['Position'])
15492
+ end
15493
+ end
15494
+ end
15495
+
15160
15496
  # 发起流程快速注册相关信息
15161
15497
  class RegisterInfo < TencentCloud::Common::AbstractModel
15162
15498
  # @param LegalName: 法人姓名
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: tencentcloud-sdk-ess
3
3
  version: !ruby/object:Gem::Version
4
- version: 3.0.1163
4
+ version: 3.0.1169
5
5
  platform: ruby
6
6
  authors:
7
7
  - Tencent Cloud
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2025-11-06 00:00:00.000000000 Z
11
+ date: 2025-11-19 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: tencentcloud-sdk-common