tencentcloud-sdk-nodejs-essbasic 4.0.1014 → 4.0.1019
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.
- package/package.json +1 -1
- package/products.md +40 -39
- package/src/services/essbasic/v20210526/essbasic_client.ts +1251 -1234
- package/src/services/essbasic/v20210526/essbasic_models.ts +60 -0
- package/tencentcloud/services/essbasic/v20210526/essbasic_client.d.ts +766 -757
- package/tencentcloud/services/essbasic/v20210526/essbasic_client.js +950 -939
- package/tencentcloud/services/essbasic/v20210526/essbasic_models.d.ts +58 -0
|
@@ -1,21 +1,11 @@
|
|
|
1
1
|
import * as TencentCloudCommon from "tencentcloud-sdk-nodejs-common";
|
|
2
|
-
import { SyncProxyOrganizationResponse, ChannelCreateConvertTaskApiResponse, ChannelCreateFlowRemindsResponse, ChannelDeleteSealPoliciesRequest, ChannelBatchCancelFlowsResponse, ChannelDescribeSignFaceVideoRequest, ChannelDisableUserAutoSignResponse, DescribeExtendedServiceAuthDetailResponse, CreateLegalSealQrCodeResponse, DescribeCancelFlowsTaskResponse, CreateEmployeeQualificationSealQrCodeResponse, ChannelCreateFlowGroupByTemplatesResponse, ChannelCreateFlowSignReviewRequest, DescribeFlowDetailInfoRequest, ChannelCancelFlowResponse, ModifyExtendedServiceRequest, DescribeResourceUrlsByFlowsRequest, CreateChannelOrganizationInfoChangeUrlResponse, ChannelCreateFlowSignUrlResponse, ChannelCreateBatchSignUrlResponse, ChannelCreatePrepareFlowResponse, CreateBatchInitOrganizationUrlResponse, OperateChannelTemplateResponse, ChannelCreateDynamicFlowApproverResponse, ChannelCreateRoleRequest, CreateOrganizationAuthFileResponse, CreateConsoleLoginUrlResponse, ChannelDeleteRoleUsersRequest, ChannelCreateUserRolesResponse, SyncProxyOrganizationRequest, ChannelCreatePrepareFlowRequest, ChannelCreateFlowSignUrlRequest, ChannelCreateSealPolicyResponse, ChannelDescribeSignFaceVideoResponse, ChannelCancelUserAutoSignEnableUrlResponse, ChannelCreateWebThemeConfigRequest, CreateFlowGroupSignReviewResponse, ChannelCreateConvertTaskApiRequest, ChannelCreateFlowByFilesRequest, UploadFilesResponse, ChannelCreatePreparedPersonalEsignResponse, DescribeResourceUrlsByFlowsResponse, ChannelCreateFlowGroupByFilesRequest, ChannelCreateOrganizationModifyQrCodeRequest, CreateChannelSubOrganizationActiveRequest, ChannelRenewAutoSignLicenseResponse, DescribeFlowDetailInfoResponse, ChannelDescribeRolesRequest, DescribeBatchOrganizationRegistrationUrlsRequest, PrepareFlowsResponse, ChannelCancelFlowRequest, ChannelCreateOrganizationBatchSignUrlRequest, GetDownloadFlowUrlResponse, DescribeTemplatesResponse, CreateBatchOrganizationRegistrationTasksResponse, ChannelVerifyPdfRequest, CreateChannelFlowEvidenceReportRequest, ChannelDescribeBillUsageDetailRequest, ChannelCancelUserAutoSignEnableUrlRequest, DeleteOrganizationAuthorizationsResponse, DescribeExtendedServiceAuthDetailRequest, CreateOrganizationAuthFileRequest, ChannelVerifyPdfResponse, ArchiveDynamicFlowResponse, CreateConsoleLoginUrlRequest, CreateLegalSealQrCodeRequest, CreateCloseOrganizationUrlRequest, CreatePersonAuthCertificateImageResponse, CreateEmployeeQualificationSealQrCodeRequest, ChannelCreateUserAutoSignSealUrlRequest, ChannelCreateUserAutoSignEnableUrlRequest, ChannelCancelMultiFlowSignQRCodeRequest, ChannelDescribeOrganizationSealsRequest, DescribeUsageRequest, DescribeExtendedServiceAuthInfoRequest, CreateCloseOrganizationUrlResponse, DescribeChannelSealPolicyWorkflowUrlRequest, CreatePartnerAutoSignAuthUrlResponse, ArchiveDynamicFlowRequest, ChannelCreateDynamicFlowApproverRequest, ModifyFlowDeadlineResponse, ChannelCreateBoundFlowsResponse, ChannelCreateUserAutoSignSealUrlResponse, ChannelCreateBatchQuickSignUrlRequest, ChannelCreateBoundFlowsRequest, ChannelDescribeEmployeesRequest, CreateFlowBlockchainEvidenceUrlResponse, ChannelDeleteRoleUsersResponse, SyncProxyOrganizationOperatorsRequest, ChannelCreateFlowApproversResponse, DescribeUsageResponse, CreateSignUrlsRequest, ChannelCreateMultiFlowSignQRCodeRequest, ChannelCreateUserAutoSignEnableUrlResponse, ChannelGetTaskResultApiRequest, DescribeChannelOrganizationsRequest, ChannelCreatePreparedPersonalEsignRequest, ChannelRenewAutoSignLicenseRequest, ChannelDescribeBillUsageDetailResponse, CreatePersonAuthCertificateImageRequest, CreateFlowsByTemplatesResponse, DescribeChannelFlowEvidenceReportRequest, ChannelCreateRoleResponse, ChannelDescribeUserAutoSignStatusRequest, ChannelModifyRoleResponse, CreateSignUrlsResponse, ChannelDeleteRoleRequest, CreateBatchOrganizationRegistrationTasksRequest, ChannelCreateBatchQuickSignUrlResponse, CreatePartnerAutoSignAuthUrlRequest, ChannelCreateBatchCancelFlowUrlRequest, ChannelDescribeAccountBillDetailResponse, ChannelCreateFlowByFilesResponse, ChannelCreateFlowSignReviewResponse, ChannelDisableUserAutoSignRequest, ChannelDescribeOrganizationSealsResponse, SyncProxyOrganizationOperatorsResponse, CreateSealByImageResponse, ChannelCancelMultiFlowSignQRCodeResponse, ChannelDescribeRolesResponse, CreateChannelSubOrganizationActiveResponse, ChannelCreateReleaseFlowRequest, ChannelDescribeFlowComponentsResponse, DeleteOrganizationAuthorizationsRequest, ChannelCreateFlowGroupByFilesResponse, ChannelCreateMultiFlowSignQRCodeResponse, DescribeCancelFlowsTaskRequest, ChannelDescribeUserAutoSignStatusResponse, ModifyExtendedServiceResponse, ChannelCreateUserRolesRequest, ChannelGetTaskResultApiResponse, ChannelCreateBatchSignUrlRequest, ChannelCreateOrganizationModifyQrCodeResponse, ChannelDeleteSealPoliciesResponse, ChannelCreateWebThemeConfigResponse, GetDownloadFlowUrlRequest, ChannelCreateEmbedWebUrlResponse, ChannelBatchCancelFlowsRequest, CreateChannelOrganizationInfoChangeUrlRequest, ChannelModifyRoleRequest, ModifyFlowDeadlineRequest, ChannelUpdateSealStatusRequest, ChannelCreateFlowGroupByTemplatesRequest, CreateBatchInitOrganizationUrlRequest, CreateFlowGroupSignReviewRequest, DescribeTemplatesRequest, ChannelCreateSealPolicyRequest, CreateFlowsByTemplatesRequest, DescribeBatchOrganizationRegistrationUrlsResponse, UploadFilesRequest, CreateSealByImageRequest, DescribeChannelOrganizationsResponse, ChannelCreateOrganizationBatchSignUrlResponse, ChannelCreateBatchCancelFlowUrlResponse, OperateChannelTemplateRequest, DescribeChannelSealPolicyWorkflowUrlResponse, CreateChannelFlowEvidenceReportResponse, ChannelDescribeAccountBillDetailRequest, ChannelDescribeEmployeesResponse, ChannelDeleteRoleResponse, ChannelCreateReleaseFlowResponse, DescribeChannelFlowEvidenceReportResponse, CreateFlowBlockchainEvidenceUrlRequest, ChannelCreateFlowApproversRequest, ChannelUpdateSealStatusResponse, ChannelCreateFlowRemindsRequest, DescribeExtendedServiceAuthInfoResponse, ChannelCreateEmbedWebUrlRequest, ChannelDescribeFlowComponentsRequest, PrepareFlowsRequest } from "./essbasic_models";
|
|
2
|
+
import { SyncProxyOrganizationResponse, ChannelCreateConvertTaskApiResponse, ChannelCreateFlowRemindsResponse, ChannelDeleteSealPoliciesRequest, ChannelBatchCancelFlowsResponse, ChannelDescribeSignFaceVideoRequest, ChannelDisableUserAutoSignResponse, DescribeExtendedServiceAuthDetailResponse, CreateLegalSealQrCodeResponse, DescribeCancelFlowsTaskResponse, CreateEmployeeQualificationSealQrCodeResponse, ChannelCreateFlowGroupByTemplatesResponse, ChannelCreateFlowSignReviewRequest, DescribeFlowDetailInfoRequest, ChannelCancelFlowResponse, ModifyExtendedServiceRequest, DescribeResourceUrlsByFlowsRequest, CreateChannelOrganizationInfoChangeUrlResponse, ChannelCreateFlowSignUrlResponse, ChannelCreateBatchSignUrlResponse, ChannelCreatePrepareFlowResponse, CreateBatchInitOrganizationUrlResponse, OperateChannelTemplateResponse, ChannelCreateDynamicFlowApproverResponse, ChannelCreateRoleRequest, CreateOrganizationAuthFileResponse, CreateConsoleLoginUrlResponse, ChannelDeleteRoleUsersRequest, ChannelCreateUserRolesResponse, SyncProxyOrganizationRequest, ChannelCreatePrepareFlowRequest, ChannelCreateFlowSignUrlRequest, ChannelCreateSealPolicyResponse, ChannelDescribeSignFaceVideoResponse, ChannelCancelUserAutoSignEnableUrlResponse, ChannelCreateWebThemeConfigRequest, CreateFlowGroupSignReviewResponse, ChannelCreateConvertTaskApiRequest, ChannelCreateFlowByFilesRequest, UploadFilesResponse, ChannelCreatePreparedPersonalEsignResponse, DescribeResourceUrlsByFlowsResponse, ChannelCreateFlowGroupByFilesRequest, ChannelCreateOrganizationModifyQrCodeRequest, CreateChannelSubOrganizationActiveRequest, ChannelRenewAutoSignLicenseResponse, DescribeFlowDetailInfoResponse, ChannelDescribeRolesRequest, DescribeBatchOrganizationRegistrationUrlsRequest, PrepareFlowsResponse, ChannelCancelFlowRequest, ChannelCreateOrganizationBatchSignUrlRequest, GetDownloadFlowUrlResponse, DescribeTemplatesResponse, CreateBatchOrganizationRegistrationTasksResponse, ChannelVerifyPdfRequest, CreateChannelFlowEvidenceReportRequest, ChannelDescribeBillUsageDetailRequest, ChannelCancelUserAutoSignEnableUrlRequest, DeleteOrganizationAuthorizationsResponse, DescribeExtendedServiceAuthDetailRequest, CreateOrganizationAuthFileRequest, ChannelVerifyPdfResponse, ArchiveDynamicFlowResponse, CreateConsoleLoginUrlRequest, CreateLegalSealQrCodeRequest, CreateCloseOrganizationUrlRequest, CreatePersonAuthCertificateImageResponse, CreateEmployeeQualificationSealQrCodeRequest, ChannelCreateUserAutoSignSealUrlRequest, ChannelCreateUserAutoSignEnableUrlRequest, ChannelCancelMultiFlowSignQRCodeRequest, ChannelDescribeOrganizationSealsRequest, DescribeUsageRequest, DescribeExtendedServiceAuthInfoRequest, CreateCloseOrganizationUrlResponse, DescribeChannelSealPolicyWorkflowUrlRequest, CreatePartnerAutoSignAuthUrlResponse, ArchiveDynamicFlowRequest, ChannelCreateDynamicFlowApproverRequest, ModifyFlowDeadlineResponse, ChannelCreateBoundFlowsResponse, ChannelCreateUserAutoSignSealUrlResponse, ChannelCreateBatchQuickSignUrlRequest, ChannelCreateBoundFlowsRequest, ChannelDescribeEmployeesRequest, CreateFlowBlockchainEvidenceUrlResponse, ChannelDeleteRoleUsersResponse, SyncProxyOrganizationOperatorsRequest, ChannelCreateFlowApproversResponse, DescribeUsageResponse, CreateSignUrlsRequest, ChannelCreateMultiFlowSignQRCodeRequest, ChannelCreateUserAutoSignEnableUrlResponse, ChannelGetTaskResultApiRequest, DescribeChannelOrganizationsRequest, ChannelCreatePreparedPersonalEsignRequest, ChannelRenewAutoSignLicenseRequest, ChannelDescribeBillUsageDetailResponse, CreatePersonAuthCertificateImageRequest, CreateFlowsByTemplatesResponse, DescribeChannelFlowEvidenceReportRequest, ChannelCreateRoleResponse, ChannelDescribeUserAutoSignStatusRequest, ChannelModifyRoleResponse, CreateSignUrlsResponse, ChannelDeleteRoleRequest, CreateBatchOrganizationRegistrationTasksRequest, ChannelCreateBatchQuickSignUrlResponse, CreateBatchOrganizationAuthorizationUrlResponse, CreatePartnerAutoSignAuthUrlRequest, ChannelCreateBatchCancelFlowUrlRequest, ChannelDescribeAccountBillDetailResponse, ChannelCreateFlowByFilesResponse, ChannelCreateFlowSignReviewResponse, ChannelDisableUserAutoSignRequest, ChannelDescribeOrganizationSealsResponse, SyncProxyOrganizationOperatorsResponse, CreateSealByImageResponse, ChannelCancelMultiFlowSignQRCodeResponse, ChannelDescribeRolesResponse, CreateChannelSubOrganizationActiveResponse, ChannelCreateReleaseFlowRequest, ChannelDescribeFlowComponentsResponse, DeleteOrganizationAuthorizationsRequest, ChannelCreateFlowGroupByFilesResponse, ChannelCreateMultiFlowSignQRCodeResponse, DescribeCancelFlowsTaskRequest, ChannelDescribeUserAutoSignStatusResponse, ModifyExtendedServiceResponse, ChannelCreateUserRolesRequest, ChannelGetTaskResultApiResponse, ChannelCreateBatchSignUrlRequest, ChannelCreateOrganizationModifyQrCodeResponse, ChannelDeleteSealPoliciesResponse, ChannelCreateWebThemeConfigResponse, GetDownloadFlowUrlRequest, ChannelCreateEmbedWebUrlResponse, ChannelBatchCancelFlowsRequest, CreateChannelOrganizationInfoChangeUrlRequest, ChannelModifyRoleRequest, ModifyFlowDeadlineRequest, ChannelUpdateSealStatusRequest, ChannelCreateFlowGroupByTemplatesRequest, CreateBatchInitOrganizationUrlRequest, CreateFlowGroupSignReviewRequest, DescribeTemplatesRequest, ChannelCreateSealPolicyRequest, CreateFlowsByTemplatesRequest, DescribeBatchOrganizationRegistrationUrlsResponse, UploadFilesRequest, CreateSealByImageRequest, DescribeChannelOrganizationsResponse, ChannelCreateOrganizationBatchSignUrlResponse, CreateBatchOrganizationAuthorizationUrlRequest, ChannelCreateBatchCancelFlowUrlResponse, OperateChannelTemplateRequest, DescribeChannelSealPolicyWorkflowUrlResponse, CreateChannelFlowEvidenceReportResponse, ChannelDescribeAccountBillDetailRequest, ChannelDescribeEmployeesResponse, ChannelDeleteRoleResponse, ChannelCreateReleaseFlowResponse, DescribeChannelFlowEvidenceReportResponse, CreateFlowBlockchainEvidenceUrlRequest, ChannelCreateFlowApproversRequest, ChannelUpdateSealStatusResponse, ChannelCreateFlowRemindsRequest, DescribeExtendedServiceAuthInfoResponse, ChannelCreateEmbedWebUrlRequest, ChannelDescribeFlowComponentsRequest, PrepareFlowsRequest } from "./essbasic_models";
|
|
3
3
|
/**
|
|
4
4
|
* essbasic client
|
|
5
5
|
* @class
|
|
6
6
|
*/
|
|
7
7
|
export declare class Client extends TencentCloudCommon.AbstractClient {
|
|
8
8
|
constructor(clientConfig: TencentCloudCommon.ClientConfig);
|
|
9
|
-
/**
|
|
10
|
-
* 此接口(ChannelDeleteSealPolicies)用于删除已指定员工印章授权信息,删除员工的印章授权后,该员工使用印章进行盖章时,将需要提交印章授权申请且通过审核后才能使用该印章进行签署。
|
|
11
|
-
*/
|
|
12
|
-
ChannelDeleteSealPolicies(req: ChannelDeleteSealPoliciesRequest, cb?: (error: string, rep: ChannelDeleteSealPoliciesResponse) => void): Promise<ChannelDeleteSealPoliciesResponse>;
|
|
13
|
-
/**
|
|
14
|
-
* 给医疗个人自动签许可续期。续期成功后,可对医疗自动签许可追加一年有效期,只可续期一次。
|
|
15
|
-
|
|
16
|
-
注意: `处方单等特殊场景专用,此接口为白名单功能,使用前请联系对接的客户经理沟通。`
|
|
17
|
-
*/
|
|
18
|
-
ChannelRenewAutoSignLicense(req: ChannelRenewAutoSignLicenseRequest, cb?: (error: string, rep: ChannelRenewAutoSignLicenseResponse) => void): Promise<ChannelRenewAutoSignLicenseResponse>;
|
|
19
9
|
/**
|
|
20
10
|
* 提交企业流程审批结果
|
|
21
11
|
**当前存在两种审核操作:**
|
|
@@ -35,41 +25,6 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
|
|
|
35
25
|
</ul>
|
|
36
26
|
*/
|
|
37
27
|
ChannelCreateFlowSignReview(req: ChannelCreateFlowSignReviewRequest, cb?: (error: string, rep: ChannelCreateFlowSignReviewResponse) => void): Promise<ChannelCreateFlowSignReviewResponse>;
|
|
38
|
-
/**
|
|
39
|
-
* 管理企业扩展服务
|
|
40
|
-
|
|
41
|
-
- **直接开通的情形:** 若在操作过程中接口没有返回跳转链接,这表明无需进行任何跳转操作。此时,相应的企业拓展服务将会直接被开通或关闭。
|
|
42
|
-
|
|
43
|
-
- **需要法人或者超管签署开通协议的情形:** 当需要开通以下企业拓展服务时, 系统将返回一个操作链接。贵方需要主动联系并通知企业的超级管理员(超管)或法人。由他们点击该链接,完成服务的开通操作。
|
|
44
|
-
- **AUTO_SIGN(企业自动签)**
|
|
45
|
-
- **DOWNLOAD_FLOW(授权渠道下载合同)**
|
|
46
|
-
|
|
47
|
-
注意: `在调用此接口以管理企业扩展服务时,操作者( Agent.ProxyOperator.OpenId)必须是企业的超级管理员(超管)或法人`
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
对应的扩展服务能力可以在控制台的【扩展服务】中找到
|
|
51
|
-

|
|
52
|
-
*/
|
|
53
|
-
ModifyExtendedService(req: ModifyExtendedServiceRequest, cb?: (error: string, rep: ModifyExtendedServiceResponse) => void): Promise<ModifyExtendedServiceResponse>;
|
|
54
|
-
/**
|
|
55
|
-
* 此接口(ChannelCreateMultiFlowSignQRCode)用于创建一码多签签署码。
|
|
56
|
-
|
|
57
|
-
**适用场景**:
|
|
58
|
-
签署人可通过扫描二维码补充签署信息进行实名签署。常用于提前不知道签署人的身份信息场景,例如:劳务工招工、大批量员工入职等场景。
|
|
59
|
-
|
|
60
|
-
**注意**:
|
|
61
|
-
1. 本接口适用于**发起方没有填写控件的 B2C或者单C模板**, 若是B2C模板,还要满足以下任意一个条件
|
|
62
|
-
- 模板中配置的签署顺序是无序
|
|
63
|
-
- B端企业的签署方式是静默签署
|
|
64
|
-
- B端企业是非首位签署
|
|
65
|
-
2. 通过扫描一码多签签署码发起的合同,合同涉及到的回调消息可参考文档[合同发起及签署相关回调
|
|
66
|
-
]( https://qian.tencent.com/developers/partner/callback_types_contracts_sign)
|
|
67
|
-
3. 用户通过扫描一码多签签署码发起合同时,因企业额度不足导致失败 会触发签署二维码相关回调,具体参考文档[签署二维码相关回调](https://qian.tencent.com/developers/partner/callback_types_commons#%E7%AD%BE%E7%BD%B2%E4%BA%8C%E7%BB%B4%E7%A0%81%E7%9B%B8%E5%85%B3%E5%9B%9E%E8%B0%83)
|
|
68
|
-
|
|
69
|
-
签署码的样式如下图:
|
|
70
|
-

|
|
71
|
-
*/
|
|
72
|
-
ChannelCreateMultiFlowSignQRCode(req: ChannelCreateMultiFlowSignQRCodeRequest, cb?: (error: string, rep: ChannelCreateMultiFlowSignQRCodeResponse) => void): Promise<ChannelCreateMultiFlowSignQRCodeResponse>;
|
|
73
28
|
/**
|
|
74
29
|
* 此接口(ChannelModifyRole)用来更新企业自定义角色。
|
|
75
30
|
|
|
@@ -79,67 +34,14 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
|
|
|
79
34
|
*/
|
|
80
35
|
ChannelModifyRole(req: ChannelModifyRoleRequest, cb?: (error: string, rep: ChannelModifyRoleResponse) => void): Promise<ChannelModifyRoleResponse>;
|
|
81
36
|
/**
|
|
82
|
-
*
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
**注**:
|
|
87
|
-
<ul>
|
|
88
|
-
<li>此接口静默签(企业自动签)能力为白名单功能,使用前请联系对接的客户经理沟通。</li>
|
|
89
|
-
<li>此接口需要依赖<a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>生成pdf资源编号(FileIds)进行使用。整体的逻辑如下图</li>
|
|
90
|
-
</ul>
|
|
91
|
-
|
|
92
|
-

|
|
93
|
-
|
|
94
|
-
**可以作为发起方和签署方的角色列表**
|
|
95
|
-
<table> <thead> <tr> <th>场景编号</th> <th>发起方</th> <th>签署方</th> <th>补充</th> </tr> </thead> <tbody> <tr> <td>场景一</td> <td>子企业A的员工</td> <td>子企业A的员工</td> <td>子企业是通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">CreateConsoleLoginUrl</a>生成子客登录链接注册的企业</td> </tr> <tr> <td>场景二</td> <td>子企业A的员工</td> <td>子企业B(不指定经办人走领取逻辑)</td> <td>领取的逻辑可以参考文档<a href="https://qian.tencent.com/developers/partner/dynamic_signer" target="_blank">动态签署方</a> </td> </tr> <tr> <td>场景三</td> <td>子企业A的员工</td> <td>子企业B的员工</td> <td>-</td> </tr> <tr> <td>场景四</td> <td>子企业A的员工</td> <td>个人</td> <td>就是自然人,不是企业员工</td> </tr> <tr> <td>场景五</td> <td>子企业A的员工</td> <td>SaaS平台企业员工</td> <td>SaaS平台企业是通过<a href="https://qian.tencent.cn/console/company-register" target="_blank">https://qian.tencent.cn/console/company-register</a>链接注册的企业</td> </tr> </tbody> </table>
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
**注**:
|
|
99
|
-
`1. 发起合同时候, 作为发起方的第三方子企业A员工的企业和员工必须经过实名, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名`
|
|
100
|
-
|
|
101
|
-
`2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
|
|
102
|
-
|
|
103
|
-
`3. 合同发起后就会扣减合同的额度, 只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。(过期,拒签,签署完成,解除完成等状态不会返还额度)`
|
|
104
|
-
|
|
105
|
-
`4. 静默(自动)签署不支持合同签署方存在填写功能`
|
|
106
|
-
|
|
107
|
-
<font color="red">相关视频指引</font> <br>
|
|
108
|
-
1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a><br>
|
|
109
|
-
1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-ChannelCreateFlowByFiles.mp4" target="_blank">【用PDF文件创建签署流程】编写示例</a><br>
|
|
110
|
-
*/
|
|
111
|
-
ChannelCreateFlowByFiles(req: ChannelCreateFlowByFilesRequest, cb?: (error: string, rep: ChannelCreateFlowByFilesResponse) => void): Promise<ChannelCreateFlowByFilesResponse>;
|
|
112
|
-
/**
|
|
113
|
-
* 获取区块链存证证书查看链接/二维码接口
|
|
114
|
-
|
|
115
|
-
适用场景:企业员工可以通过此接口生成合同区块链存证证书的查看链接/二维码,以供他人扫码打开腾讯电子签小程序查看。
|
|
116
|
-
|
|
117
|
-
[点击查看区块链存证证书样式](https://qcloudimg.tencent-cloud.cn/raw/47d5e9c2ffa90ad4e27b3cd14095aa08.jpg)
|
|
118
|
-
|
|
119
|
-
注:
|
|
120
|
-
<ul><li>1. 二维码下载链接过期时间为5分钟,请尽快下载保存。二维码/短链的过期时间为<font color="red">7天</font>,超过有效期则不可用。</li>
|
|
121
|
-
<li>2. 合同状态需为<font color="red">签署完成</font> 、<font color="red">已解除</font>才能生成证书查看二维码/短链。</li>
|
|
122
|
-
<li>3. 调用接口时,需确保接口调用身份拥有此合同的访问数据权限或为合同参与方。</li>
|
|
123
|
-
<li>4. 通过扫码或者点击链接,用户无需登录或者鉴权即可查看对应合同的区块链存证证书,请妥善保管好二维码或链接。</li></ul>
|
|
124
|
-
*/
|
|
125
|
-
CreateFlowBlockchainEvidenceUrl(req: CreateFlowBlockchainEvidenceUrlRequest, cb?: (error: string, rep: CreateFlowBlockchainEvidenceUrlResponse) => void): Promise<CreateFlowBlockchainEvidenceUrlResponse>;
|
|
126
|
-
/**
|
|
127
|
-
* 此接口用于获取企业批量认证异步任务的状态及结果。需要先调用接口<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks" target="_blank">提交子企业批量认证链接创建任务</a>获取到任务ID,然后再调用此接口获取到各个子企业的注册认证链接。整体流程如下图。
|
|
128
|
-

|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
注:
|
|
132
|
-
`异步任务的处理完成时间视当前已提交的任务量、任务的复杂程度等因素决定,正常情况下 3~5 秒即可完成,但也可能需要更长的时间`
|
|
133
|
-
*/
|
|
134
|
-
DescribeBatchOrganizationRegistrationUrls(req: DescribeBatchOrganizationRegistrationUrlsRequest, cb?: (error: string, rep: DescribeBatchOrganizationRegistrationUrlsResponse) => void): Promise<DescribeBatchOrganizationRegistrationUrlsResponse>;
|
|
135
|
-
/**
|
|
136
|
-
* 1. 可以**通过图片**为子客企业代创建印章,图片最大5MB
|
|
137
|
-
|
|
138
|
-
2. 可以**系统创建**子客企业代创建印章, 系统创建的印章样子下图(样式可以调整)
|
|
37
|
+
* 1. 在使用[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByFiles)或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates)创建合同组签署流程时,若指定了参数以下参数为true,则可以调用此接口提交企业内部签署审批结果,即使是自动签署也需要进行审核通过才会进行签署。
|
|
38
|
+
- [FlowInfo.NeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowinfo)
|
|
39
|
+
- [FlowFileInfo.NeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowfileinfo)
|
|
40
|
+
- [FlowApproverInfo.ApproverNeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowapproverinfo)
|
|
139
41
|
|
|
140
|
-
|
|
42
|
+
2. 同一合同组,同一签署人可以多次提交签署审批结果,签署时的最后一个“审批结果”有效。
|
|
141
43
|
*/
|
|
142
|
-
|
|
44
|
+
CreateFlowGroupSignReview(req: CreateFlowGroupSignReviewRequest, cb?: (error: string, rep: CreateFlowGroupSignReviewResponse) => void): Promise<CreateFlowGroupSignReviewResponse>;
|
|
143
45
|
/**
|
|
144
46
|
* 此接口(CancelMultiFlowSignQRCode)用于废除取消一码多签签署码。
|
|
145
47
|
该接口所需的二维码ID,源自[创建一码多签签署码](https://qian.tencent.com/developers/partnerApis/templates/ChannelCreateMultiFlowSignQRCode)生成的。
|
|
@@ -164,32 +66,14 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
|
|
|
164
66
|
*/
|
|
165
67
|
DescribeExtendedServiceAuthInfo(req: DescribeExtendedServiceAuthInfoRequest, cb?: (error: string, rep: DescribeExtendedServiceAuthInfoResponse) => void): Promise<DescribeExtendedServiceAuthInfoResponse>;
|
|
166
68
|
/**
|
|
167
|
-
*
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
<font color="red">系统默认角色</font>说明可参考下表
|
|
69
|
+
* 此接口用于获取企业批量认证异步任务的状态及结果。需要先调用接口<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks" target="_blank">提交子企业批量认证链接创建任务</a>获取到任务ID,然后再调用此接口获取到各个子企业的注册认证链接。整体流程如下图。
|
|
70
|
+

|
|
171
71
|
|
|
172
|
-
| 角色名称| 建议授予对象 | 角色描述 |
|
|
173
|
-
| --- | --- | --- |
|
|
174
|
-
| **超级管理员** |电子签业务最高权限,可以授权给法务/企业法人/业务负责人等 | 所有功能和数据管理权限,只能设置一位超管。 |
|
|
175
|
-
| **业务管理员**|IT 系统负责人,可以授权给CTO等 | 企业合同模块、印章模块、模板模块等全量功能及数据权限。 |
|
|
176
|
-
| **经办人**|企业法务负责人等 | 发起合同、签署合同(含填写、拒签)、撤销合同、持有印章等权限能力,可查看企业所有合同数据。 |
|
|
177
|
-
| **业务员**|销售员、采购员 等| 发起合同、签署合同(含填写、拒签)、撤销合同、持有印章等权限能力,可查看自己相关所有合同数据。 |
|
|
178
72
|
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
ChannelDescribeRoles(req: ChannelDescribeRolesRequest, cb?: (error: string, rep: ChannelDescribeRolesResponse) => void): Promise<ChannelDescribeRolesResponse>;
|
|
182
|
-
/**
|
|
183
|
-
* 此接口(ChannelCreateConvertTaskApi)用来将word、excel、html、图片、txt类型文件转换为PDF文件。<br />
|
|
184
|
-
前提条件:源文件已经通过 <a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>完成上传,并得到了源文件的资源Id。<br />
|
|
185
|
-
适用场景1:已经上传了一个word文件,希望将该word文件转换成pdf文件后发起合同
|
|
186
|
-
适用场景2:已经上传了一个jpg图片文件,希望将该图片文件转换成pdf文件后发起合同<br />
|
|
187
|
-
转换文件是一个耗时操作,若想查看转换任务是否完成,可以通过<a href="https://qian.tencent.com/developers/partnerApis/files/ChannelGetTaskResultApi" target="_blank">查询转换任务状态</a>接口获取任务状态。<br />
|
|
188
|
-
注:
|
|
189
|
-
1. `支持的文件类型有doc、docx、xls、xlsx、html、jpg、jpeg、png、bmp、txt`
|
|
190
|
-
2. `可通过发起合同时设置预览来检查转换文件是否达到预期效果`
|
|
73
|
+
注:
|
|
74
|
+
`异步任务的处理完成时间视当前已提交的任务量、任务的复杂程度等因素决定,正常情况下 3~5 秒即可完成,但也可能需要更长的时间`
|
|
191
75
|
*/
|
|
192
|
-
|
|
76
|
+
DescribeBatchOrganizationRegistrationUrls(req: DescribeBatchOrganizationRegistrationUrlsRequest, cb?: (error: string, rep: DescribeBatchOrganizationRegistrationUrlsResponse) => void): Promise<DescribeBatchOrganizationRegistrationUrlsResponse>;
|
|
193
77
|
/**
|
|
194
78
|
* 此接口(DescribeUsage)用于获取此应用下子客企业的合同消耗数量。
|
|
195
79
|
|
|
@@ -199,77 +83,239 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
|
|
|
199
83
|
*/
|
|
200
84
|
DescribeUsage(req: DescribeUsageRequest, cb?: (error: string, rep: DescribeUsageResponse) => void): Promise<DescribeUsageResponse>;
|
|
201
85
|
/**
|
|
202
|
-
*
|
|
86
|
+
* 该接口用于在使用视频认证方式签署合同后,获取用户的签署人脸认证视频。
|
|
203
87
|
|
|
204
|
-
1.
|
|
205
|
-
2.
|
|
88
|
+
1. 该接口**仅适用于在H5端签署**的合同,**在通过视频认证后**获取认证的视频内容。
|
|
89
|
+
2. 该接口**不支持小程序端**的签署认证的视频获取。
|
|
90
|
+
3. 请在**签署完成后的三天内**获取视频,**过期后将无法获取**。
|
|
206
91
|
|
|
92
|
+
**注意:该接口需要开通白名单,请联系客户经理开通后使用。**
|
|
93
|
+
*/
|
|
94
|
+
ChannelDescribeSignFaceVideo(req: ChannelDescribeSignFaceVideoRequest, cb?: (error: string, rep: ChannelDescribeSignFaceVideoResponse) => void): Promise<ChannelDescribeSignFaceVideoResponse>;
|
|
95
|
+
/**
|
|
96
|
+
* 通过此接口,删除员工绑定的角色,支持以电子签userId、客户系统userId两种方式调用。
|
|
207
97
|
|
|
208
|
-
|
|
98
|
+
对应控制台的操作如下图
|
|
99
|
+

|
|
209
100
|
*/
|
|
210
|
-
|
|
101
|
+
ChannelDeleteRoleUsers(req: ChannelDeleteRoleUsersRequest, cb?: (error: string, rep: ChannelDeleteRoleUsersResponse) => void): Promise<ChannelDeleteRoleUsersResponse>;
|
|
211
102
|
/**
|
|
212
|
-
*
|
|
213
|
-
1. <b> 合同(流程)层面</b>:仅需提供签署流程ID。此操作将对整个签署流程以及未单独设置签署截止时间的签署人进行延期。
|
|
214
|
-
2. <b> 签署人层面</b> :需提供流程ID和签署人ID。此操作针对特定签署人进行延期,特别是对于有序合同(流程),签署截止时间不得超过后续签署人的流程截止时间。
|
|
103
|
+
* 创建跳转小程序查看或签署的链接
|
|
215
104
|
|
|
216
|
-
|
|
217
|
-
1. 执行操作的员工须为<font color="red">发起方企业的超级管理员、法定代表人或签署流程发起人</font>。
|
|
218
|
-
2. 延长整个签署流程时,<font color="red">应至少有一方尚未签署</font>(即签署流程不能处于已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等状态)。
|
|
219
|
-
3. 延长整个签署流程时,新的签署截止日期应晚于已设定的签署截止日期和当前日期。
|
|
220
|
-
4. 延长签署方截止时间时,<font color="red">签署方不能处于流程完结或已终止状态</font>(即签署人不能处于已签署、已拒签、已过期、已撤回、拒绝填写、已解除等状态)。
|
|
221
|
-
5. 延长签署方截止时间时,新的签署截止日期应晚于当前日期和已设定的截止日期。若为有序合同,还需早于或等于下一签署人的截止日期,且早于签署流程整体的截止日期。
|
|
222
|
-
6. <font color="red">不支持操作合同组合同</font>。
|
|
105
|
+
**腾讯电子签小程序的AppID 和 原始Id如下:**
|
|
223
106
|
|
|
224
|
-
|
|
225
|
-
|
|
107
|
+
| 小程序 | AppID | 原始ID |
|
|
108
|
+
| ------------ | ------------ | ------------ |
|
|
109
|
+
| 腾讯电子签(正式版) | wxa023b292fd19d41d | gh_da88f6188665 |
|
|
110
|
+
| 腾讯电子签Demo | wx371151823f6f3edf | gh_39a5d3de69fa |
|
|
111
|
+
|
|
112
|
+
**主要使用场景EndPoint分类**
|
|
113
|
+
|
|
114
|
+
|EndPoint| 场景| 说明和示例|
|
|
115
|
+
| ---- | ---- | --- |
|
|
116
|
+
| WEIXINAPP | 短链跳转腾讯电子签小程序签署场景 | 点击链接打开电子签小程序(与腾讯电子签官方短信提醒用户签署形式一样)<br> 示例: https://essurl.cn/x9nvWU8fTg|
|
|
117
|
+
| LONGURL2WEIXINAPP | 长链跳转腾讯电子签小程序签署场景 | 点击链接打开电子签小程序, 是WEIXINAPP生成短链代表的那个长链|
|
|
118
|
+
| CHANNEL | 带有H5引导页的跳转腾讯电子签小程序签署场景 | 点击链接打开一个H5引导页面, 页面中有个"前往小程序"的按钮, 点击后会跳转到腾讯电子签小程序签署场景; 签署完成会回到H5引导页面, 然后跳转到指定创建链接指定的JumpUrl<br>示例: https://res.ess.tencent.cn/cdn/h5-activity-beta/jump-mp.html?use=channel-guide&type=warning&token=uIFKIU8fTd |
|
|
119
|
+
|APP| <font color="red">贵方APP</font>跳转腾讯电子签小程序签署场景| 贵方App直接跳转到小程序后, 在腾讯电子签小程序签署完成后返回贵方App的场景<br>跳转到腾讯电子签小程序的实现可以参考微信的官方文档:<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/launchApp.html" target="_blank">开放能力/打开 App</a> <br> 示例: pages/guide?from=default&where=mini& to=CONTRACT_DETAIL& id=yDwiBUUc*duRvquCSX8wd& shortKey=yDwivUA**W1yRsTre3 |
|
|
120
|
+
|APP| <font color="red">贵方小程序</font>跳转腾讯电子签小程序签署场景| 贵方小程序直接跳转到小程序后, 在腾讯电子签小程序签署完成后返回贵方小程序的场景<br>跳转到腾讯电子签小程序的实现可以参考微信官方文档<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html" target="_blank">全屏方式</a>和<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html " target="_blank">半屏方式</a><br>此时返回的SignUrl就是官方文档中的path<br> 示例:pages/guide?from=default&where=mini& to=CONTRACT_DETAIL& id=yDwiBUUc*duRvquCSX8wd& shortKey=yDwivUA**W1yRsTre3 |
|
|
226
121
|
*/
|
|
227
|
-
|
|
122
|
+
CreateSignUrls(req: CreateSignUrlsRequest, cb?: (error: string, rep: CreateSignUrlsResponse) => void): Promise<CreateSignUrlsResponse>;
|
|
228
123
|
/**
|
|
229
|
-
*
|
|
124
|
+
* 此接口(ChannelCreateBoundFlows)用于子客企业领取未归属给员工的合同,将合同领取给当前员工,合同不能重复领取。
|
|
230
125
|
|
|
231
|
-
|
|
126
|
+
|
|
127
|
+
**未归属合同发起方式**
|
|
128
|
+
指定对应企业的OrganizationOpenId和OrganizationName而不指定具体的参与人(OpenId/名字/手机号等), 则合同进入待领取状态, 示例代码如下
|
|
129
|
+
```
|
|
130
|
+
FlowApprovers: []*essbasic.FlowApproverInfo{
|
|
131
|
+
{
|
|
132
|
+
ApproverType: common.StringPtr("ORGANIZATION"),
|
|
133
|
+
OrganizationOpenId: common.StringPtr("org_dianziqian"),
|
|
134
|
+
OrganizationName: common.StringPtr("典子谦示例企业"),
|
|
135
|
+
}
|
|
136
|
+
},
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
可以<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>登录控制台查看带领取的合同
|
|
140
|
+

|
|
141
|
+
|
|
142
|
+
注:
|
|
143
|
+
1. 支持批量领取, 如果有一个合同流程无法领取会导致接口报错, 使得所有合同都领取失败
|
|
144
|
+
2. 只有企业的<font color="red">超管或者法人</font>才能进行合同的领取
|
|
145
|
+
*/
|
|
146
|
+
ChannelCreateBoundFlows(req: ChannelCreateBoundFlowsRequest, cb?: (error: string, rep: ChannelCreateBoundFlowsResponse) => void): Promise<ChannelCreateBoundFlowsResponse>;
|
|
147
|
+
/**
|
|
148
|
+
* 创建一个用于他方自动签授权的链接(可选择他方授权或我方授权)。通过这个链接,合作方企业可以直接进入小程序,进行自动签授权操作。
|
|
149
|
+
|
|
150
|
+
如果授权企业尚未开通企业自动签功能,该链接还将引导他们首先开通本企业的自动签服务
|
|
151
|
+
|
|
152
|
+
|
|
153
|
+
注:
|
|
154
|
+
1. <font color='red'>所在企业的超管、法人才有权限调用此接口</font>(Agent.ProxyOperator.OpenId 需要传递超管或者法人的OpenId)
|
|
155
|
+
2. 已经在授权中或者授权成功的企业,无法重复授权
|
|
156
|
+
3. 授权企业和被授权企业必须都是已认证企业
|
|
157
|
+
4. <font color='red'>需要授权企业或被授权企业的超管或者法人打开链接</font>走开通逻辑。
|
|
158
|
+
|
|
159
|
+
**该接口效果同控制台: 企业设置-> 扩展服务 -> 企业自动签署 -> 合作企业方授权**
|
|
160
|
+

|
|
161
|
+
*/
|
|
162
|
+
CreatePartnerAutoSignAuthUrl(req: CreatePartnerAutoSignAuthUrlRequest, cb?: (error: string, rep: CreatePartnerAutoSignAuthUrlResponse) => void): Promise<CreatePartnerAutoSignAuthUrlResponse>;
|
|
163
|
+
/**
|
|
164
|
+
* 用来创建嵌入式页面个性化主题配置(例如是否展示电子签logo、定义主题色等),该接口配合其他所有可嵌入页面接口使用
|
|
165
|
+
创建配置对当前第三方应用全局生效,如果多次调用,会以最后一次的配置为准
|
|
166
|
+
*/
|
|
167
|
+
ChannelCreateWebThemeConfig(req: ChannelCreateWebThemeConfigRequest, cb?: (error: string, rep: ChannelCreateWebThemeConfigResponse) => void): Promise<ChannelCreateWebThemeConfigResponse>;
|
|
168
|
+
/**
|
|
169
|
+
* 指定需要批量催办的签署流程ID,批量催办合同,最多100个。需要符合以下条件的合同才可被催办
|
|
170
|
+
1. 合同中当前状态为 **待签署** 的签署人是催办的对象
|
|
171
|
+
2. **每个合同只能催办一次**
|
|
172
|
+
|
|
173
|
+
**催办的效果**: 对方会收到如下的短信通知
|
|
174
|
+
|
|
175
|
+

|
|
176
|
+
|
|
177
|
+
|
|
178
|
+
**注**:`合同催办是白名单功能,请联系客户经理申请开白后使用`
|
|
179
|
+
*/
|
|
180
|
+
ChannelCreateFlowReminds(req: ChannelCreateFlowRemindsRequest, cb?: (error: string, rep: ChannelCreateFlowRemindsResponse) => void): Promise<ChannelCreateFlowRemindsResponse>;
|
|
181
|
+
/**
|
|
182
|
+
* 通过合同编号批量撤销合同,单次最多支持撤销100份合同。
|
|
183
|
+
|
|
184
|
+
适用场景:如果某个合同当前**至少还有一方没有签署**,则可通过该接口取消该合同流程。常用于合同发错、内容填错,需要及时撤销的场景。
|
|
232
185
|
|
|
233
186
|
- **可撤回合同状态**:未全部签署完成
|
|
234
187
|
- **不撤回合同状态**:已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
|
|
235
188
|
|
|
189
|
+
批量撤销结果可以通过接口返回的TaskId关联[批量撤销任务结果回调](https://qian.tencent.com/developers/partner/callback_types_contracts_sign#%E4%B9%9D-%E6%89%B9%E9%87%8F%E6%92%A4%E9%94%80%E7%BB%93%E6%9E%9C%E5%9B%9E%E8%B0%83)或通过接口[查询批量撤销合同结果](https://qian.tencent.com/developers/partnerApis/operateFlows/DescribeCancelFlowsTask)主动查询。
|
|
190
|
+
|
|
191
|
+
|
|
236
192
|
注:
|
|
237
193
|
- 有对应合同撤销权限的人: <font color='red'>**合同的发起人(并已经授予撤销权限)或者发起人所在企业的超管、法人**</font>
|
|
238
194
|
- 签署完毕的合同需要双方走解除流程将合同作废,可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>
|
|
239
195
|
- <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。</font>
|
|
240
196
|
- 撤销后可以看合同PDF内容的人员: 发起方的超管, 发起方自己,发起方撤销合同的操作人员,已经签署合同、已经填写合同、邀请填写已经补充信息的参与人员, 其他参与人员看不到合同的内容。
|
|
241
197
|
*/
|
|
242
|
-
|
|
198
|
+
ChannelBatchCancelFlows(req: ChannelBatchCancelFlowsRequest, cb?: (error: string, rep: ChannelBatchCancelFlowsResponse) => void): Promise<ChannelBatchCancelFlowsResponse>;
|
|
243
199
|
/**
|
|
244
|
-
*
|
|
200
|
+
* **适用场景**:
|
|
201
|
+
当通过模板或文件发起合同时,若未指定企业签署人信息,则可调用此接口动态补充签署人。同一签署人只允许补充一人,最终实际签署人取决于谁先领取合同完成签署。
|
|
245
202
|
|
|
246
|
-
|
|
247
|
-
- 员工必须在企业下完成实名认证,且需作为批量签署合同的签署方或者领取方。
|
|
248
|
-
- 仅支持传入待签署或者待领取的合同,待填写暂不支持。
|
|
249
|
-
- 员工批量签署,支持多种签名方式,包括手写签名、临摹签名、系统签名、个人印章、签批控件等。
|
|
203
|
+
**接口使用说明**:
|
|
250
204
|
|
|
251
|
-
|
|
252
|
-
|
|
205
|
+
1.本接口现已支持批量补充签署人
|
|
206
|
+
|
|
207
|
+
2.当<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中指定需要补充的FlowId时,可以对指定合同补充签署人;可以指定多个相同发起方的不同合同在完成批量补充
|
|
208
|
+
|
|
209
|
+
3.当<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中指定需要补充的FlowId时,是对指定的合同补充多个指定的签署人
|
|
210
|
+
|
|
211
|
+
4.如果同时指定了<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId和<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId,仅使用<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId作为补充的合同
|
|
212
|
+
|
|
213
|
+
5.如果部分指定了<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId,又指定了<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId;那么<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>存在指定的FlowId,则使用<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId,不存在则使用<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId作为补充的合同
|
|
214
|
+
|
|
215
|
+
|
|
216
|
+
6.如果同时未指定了<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId和<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId,则传参错误
|
|
217
|
+
|
|
218
|
+
**限制条件**:
|
|
219
|
+
1. 本企业(发起方企业)企业签署人仅支持通过企业名称+姓名+手机号进行补充。
|
|
220
|
+
2. 个人签署人支持通过姓名+手机号进行补充,补充动态签署人时:若个人用户已完成实名,则可通过姓名+证件号码进行补充。
|
|
253
221
|
*/
|
|
254
|
-
|
|
222
|
+
ChannelCreateFlowApprovers(req: ChannelCreateFlowApproversRequest, cb?: (error: string, rep: ChannelCreateFlowApproversResponse) => void): Promise<ChannelCreateFlowApproversResponse>;
|
|
255
223
|
/**
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
224
|
+
* 获取个人用户认证证书图片下载URL
|
|
225
|
+
|
|
226
|
+
个人用户认证证书图片样式如下图
|
|
227
|
+
|
|
228
|
+

|
|
229
|
+
|
|
230
|
+
注:
|
|
231
|
+
<ul>
|
|
232
|
+
<li>只能获取个人用户证明图片, 企业员工的暂不支持</li>
|
|
233
|
+
<li>专为电子处方单(医疗自动签)特定场景使用。在使用前,请务必与您的客户经理联系以确认已经开通电子处方单功能 </li>
|
|
234
|
+
</ul>
|
|
235
|
+
*/
|
|
236
|
+
CreatePersonAuthCertificateImage(req: CreatePersonAuthCertificateImageRequest, cb?: (error: string, rep: CreatePersonAuthCertificateImageResponse) => void): Promise<CreatePersonAuthCertificateImageResponse>;
|
|
259
237
|
/**
|
|
260
|
-
|
|
238
|
+
* 提交申请出证报告任务并返回报告ID。
|
|
239
|
+
|
|
240
|
+
注意:
|
|
241
|
+
- 使用此功能**需搭配出证套餐** ,使用前请联系对接的客户经理沟通。
|
|
242
|
+
- 操作人必须是**发起方或者签署方企业的(非走授权书认证)法人或者超管**。
|
|
243
|
+
- 合同流程必须**所有参与方已经签署完成**。
|
|
244
|
+
- 出证过程需一定时间,建议在**提交出证任务后的24小时之后**,通过<a href="https://qian.tencent.com/developers/partnerApis/certificate/DescribeChannelFlowEvidenceReport" target="_blank">获取出证报告任务执行结果</a>接口进行查询执行结果和出证报告的下载URL。
|
|
245
|
+
|
|
246
|
+
|
|
247
|
+

|
|
248
|
+
*/
|
|
249
|
+
CreateChannelFlowEvidenceReport(req: CreateChannelFlowEvidenceReportRequest, cb?: (error: string, rep: CreateChannelFlowEvidenceReportResponse) => void): Promise<CreateChannelFlowEvidenceReportResponse>;
|
|
250
|
+
/**
|
|
251
|
+
* 本接口(ChannelCreatePreparedPersonalEsign)用于创建导入个人印章(处方单场景专用,使用此接口请与客户经理确认)。
|
|
261
252
|
*/
|
|
262
|
-
|
|
253
|
+
ChannelCreatePreparedPersonalEsign(req: ChannelCreatePreparedPersonalEsignRequest, cb?: (error: string, rep: ChannelCreatePreparedPersonalEsignResponse) => void): Promise<ChannelCreatePreparedPersonalEsignResponse>;
|
|
263
254
|
/**
|
|
264
|
-
*
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
255
|
+
* 接口(ChannelCreateFlowByFiles)用PDF文件创建签署流程。
|
|
256
|
+
|
|
257
|
+
适用场景:适用非制式的合同文件签署,开发者有每个签署流程的PDF,可以通过该接口传入完整的PDF文件及流程信息生成待签署的合同流程。
|
|
258
|
+
|
|
259
|
+
**注**:
|
|
260
|
+
<ul>
|
|
261
|
+
<li>此接口静默签(企业自动签)能力为白名单功能,使用前请联系对接的客户经理沟通。</li>
|
|
262
|
+
<li>此接口需要依赖<a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>生成pdf资源编号(FileIds)进行使用。整体的逻辑如下图</li>
|
|
263
|
+
</ul>
|
|
264
|
+
|
|
265
|
+

|
|
266
|
+
|
|
267
|
+
**可以作为发起方和签署方的角色列表**
|
|
268
|
+
<table> <thead> <tr> <th>场景编号</th> <th>发起方</th> <th>签署方</th> <th>补充</th> </tr> </thead> <tbody> <tr> <td>场景一</td> <td>子企业A的员工</td> <td>子企业A的员工</td> <td>子企业是通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">CreateConsoleLoginUrl</a>生成子客登录链接注册的企业</td> </tr> <tr> <td>场景二</td> <td>子企业A的员工</td> <td>子企业B(不指定经办人走领取逻辑)</td> <td>领取的逻辑可以参考文档<a href="https://qian.tencent.com/developers/partner/dynamic_signer" target="_blank">动态签署方</a> </td> </tr> <tr> <td>场景三</td> <td>子企业A的员工</td> <td>子企业B的员工</td> <td>-</td> </tr> <tr> <td>场景四</td> <td>子企业A的员工</td> <td>个人</td> <td>就是自然人,不是企业员工</td> </tr> <tr> <td>场景五</td> <td>子企业A的员工</td> <td>SaaS平台企业员工</td> <td>SaaS平台企业是通过<a href="https://qian.tencent.cn/console/company-register" target="_blank">https://qian.tencent.cn/console/company-register</a>链接注册的企业</td> </tr> </tbody> </table>
|
|
269
|
+
|
|
270
|
+
|
|
271
|
+
**注**:
|
|
272
|
+
`1. 发起合同时候, 作为发起方的第三方子企业A员工的企业和员工必须经过实名, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名`
|
|
273
|
+
|
|
274
|
+
`2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
|
|
275
|
+
|
|
276
|
+
`3. 合同发起后就会扣减合同的额度, 只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。(过期,拒签,签署完成,解除完成等状态不会返还额度)`
|
|
277
|
+
|
|
278
|
+
`4. 静默(自动)签署不支持合同签署方存在填写功能`
|
|
279
|
+
|
|
280
|
+
<font color="red">相关视频指引</font> <br>
|
|
281
|
+
1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a><br>
|
|
282
|
+
1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-ChannelCreateFlowByFiles.mp4" target="_blank">【用PDF文件创建签署流程】编写示例</a><br>
|
|
271
283
|
*/
|
|
272
|
-
|
|
284
|
+
ChannelCreateFlowByFiles(req: ChannelCreateFlowByFilesRequest, cb?: (error: string, rep: ChannelCreateFlowByFilesResponse) => void): Promise<ChannelCreateFlowByFilesResponse>;
|
|
285
|
+
/**
|
|
286
|
+
* 1. 可以**通过图片**为子客企业代创建印章,图片最大5MB
|
|
287
|
+
|
|
288
|
+
2. 可以**系统创建**子客企业代创建印章, 系统创建的印章样子下图(样式可以调整)
|
|
289
|
+
|
|
290
|
+

|
|
291
|
+
*/
|
|
292
|
+
CreateSealByImage(req: CreateSealByImageRequest, cb?: (error: string, rep: CreateSealByImageResponse) => void): Promise<CreateSealByImageResponse>;
|
|
293
|
+
/**
|
|
294
|
+
* 此接口(ChannelCreateConvertTaskApi)用来将word、excel、html、图片、txt类型文件转换为PDF文件。<br />
|
|
295
|
+
前提条件:源文件已经通过 <a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>完成上传,并得到了源文件的资源Id。<br />
|
|
296
|
+
适用场景1:已经上传了一个word文件,希望将该word文件转换成pdf文件后发起合同
|
|
297
|
+
适用场景2:已经上传了一个jpg图片文件,希望将该图片文件转换成pdf文件后发起合同<br />
|
|
298
|
+
转换文件是一个耗时操作,若想查看转换任务是否完成,可以通过<a href="https://qian.tencent.com/developers/partnerApis/files/ChannelGetTaskResultApi" target="_blank">查询转换任务状态</a>接口获取任务状态。<br />
|
|
299
|
+
注:
|
|
300
|
+
1. `支持的文件类型有doc、docx、xls、xlsx、html、jpg、jpeg、png、bmp、txt`
|
|
301
|
+
2. `可通过发起合同时设置预览来检查转换文件是否达到预期效果`
|
|
302
|
+
*/
|
|
303
|
+
ChannelCreateConvertTaskApi(req: ChannelCreateConvertTaskApiRequest, cb?: (error: string, rep: ChannelCreateConvertTaskApiResponse) => void): Promise<ChannelCreateConvertTaskApiResponse>;
|
|
304
|
+
/**
|
|
305
|
+
* 撤销签署流程接口
|
|
306
|
+
|
|
307
|
+
适用场景:如果某个合同流程当前至少还有一方没有签署,则可通过该接口取消该合同流程。常用于合同发错、内容填错,需要及时撤销的场景。
|
|
308
|
+
|
|
309
|
+
- **可撤回合同状态**:未全部签署完成
|
|
310
|
+
- **不撤回合同状态**:已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
|
|
311
|
+
|
|
312
|
+
注:
|
|
313
|
+
- 有对应合同撤销权限的人: <font color='red'>**合同的发起人(并已经授予撤销权限)或者发起人所在企业的超管、法人**</font>
|
|
314
|
+
- 签署完毕的合同需要双方走解除流程将合同作废,可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>
|
|
315
|
+
- <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。</font>
|
|
316
|
+
- 撤销后可以看合同PDF内容的人员: 发起方的超管, 发起方自己,发起方撤销合同的操作人员,已经签署合同、已经填写合同、邀请填写已经补充信息的参与人员, 其他参与人员看不到合同的内容。
|
|
317
|
+
*/
|
|
318
|
+
ChannelCancelFlow(req: ChannelCancelFlowRequest, cb?: (error: string, rep: ChannelCancelFlowResponse) => void): Promise<ChannelCancelFlowResponse>;
|
|
273
319
|
/**
|
|
274
320
|
* 接口(CreateFlowsByTemplates)用于使用模板批量创建签署流程。当前可批量发起合同(签署流程)数量为1-20个。
|
|
275
321
|
如若在模板中配置了动态表格, 上传的附件必须为A4大小
|
|
@@ -338,25 +384,64 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
|
|
|
338
384
|
*/
|
|
339
385
|
CreateFlowsByTemplates(req: CreateFlowsByTemplatesRequest, cb?: (error: string, rep: CreateFlowsByTemplatesResponse) => void): Promise<CreateFlowsByTemplatesResponse>;
|
|
340
386
|
/**
|
|
341
|
-
*
|
|
342
|
-
无需对应的用户刷脸等方式同意即可关闭。
|
|
387
|
+
* 此接口(ChannelCreateRole)用来创建企业自定义角色。
|
|
343
388
|
|
|
344
|
-
|
|
389
|
+
适用场景1:创建当前企业的自定义角色,并且创建时不进行权限的设置(PermissionGroups 参数不传),角色中的权限内容可通过接口 ChannelModifyRole 完成更新。
|
|
345
390
|
|
|
346
|
-
|
|
347
|
-
<li>如果此用户在开通时候绑定过个人自动签账号许可, 关闭此用户的自动签不会归还个人自动签账号许可的额度。</li></ul>
|
|
391
|
+
适用场景2:创建当前企业的自定义角色,并且创建时进行权限的设置(PermissionGroups 参数要传),权限树内容 PermissionGroups 可参考[查询角色列表接口](https://qian.tencent.com/developers/partnerApis/accounts/ChannelDescribeRoles) 的输出。此处注意权限树内容可能会更新,需尽量拉取最新的权限树内容,并且权限树内容 PermissionGroups 必须是一颗完整的权限树。
|
|
348
392
|
*/
|
|
349
|
-
|
|
393
|
+
ChannelCreateRole(req: ChannelCreateRoleRequest, cb?: (error: string, rep: ChannelCreateRoleResponse) => void): Promise<ChannelCreateRoleResponse>;
|
|
350
394
|
/**
|
|
351
|
-
*
|
|
395
|
+
* 生成用印申请审批链接,审批人可以通过此链接进入小程序进行审批。
|
|
396
|
+
p.s.
|
|
397
|
+
Agent参数中的OpenId 必须为审批者的openId,且链接必须由审批人打开。
|
|
398
|
+
*/
|
|
399
|
+
DescribeChannelSealPolicyWorkflowUrl(req: DescribeChannelSealPolicyWorkflowUrlRequest, cb?: (error: string, rep: DescribeChannelSealPolicyWorkflowUrlResponse) => void): Promise<DescribeChannelSealPolicyWorkflowUrlResponse>;
|
|
400
|
+
/**
|
|
401
|
+
* 生成渠道子客编辑企业信息二维码
|
|
402
|
+
*/
|
|
403
|
+
ChannelCreateOrganizationModifyQrCode(req: ChannelCreateOrganizationModifyQrCodeRequest, cb?: (error: string, rep: ChannelCreateOrganizationModifyQrCodeResponse) => void): Promise<ChannelCreateOrganizationModifyQrCodeResponse>;
|
|
404
|
+
/**
|
|
405
|
+
* 接口(ChannelCreateDynamicFlowApprover)用来补充<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles" target="_blank">用PDF文件创建签署流程</a>发起的动态合同的签署人信息
|
|
406
|
+
**注**:
|
|
407
|
+
<ul>
|
|
408
|
+
<li>此接口需要保证:渠道企业已开启:模块化计费能力,</li>
|
|
409
|
+
<li>此接口需要保证:渠道应用已开启:动态签署人2.0能力</li>
|
|
410
|
+
<li>此接口需要保证:合同发起时指定开启了动态合同</li>
|
|
411
|
+
<li>此接口补充的动态签署人传参规则,请参考接口:<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles" target="_blank">用PDF文件创建签署流程</a>的签署人传参规则</li>
|
|
412
|
+
</ul>
|
|
413
|
+
*/
|
|
414
|
+
ChannelCreateDynamicFlowApprover(req: ChannelCreateDynamicFlowApproverRequest, cb?: (error: string, rep: ChannelCreateDynamicFlowApproverResponse) => void): Promise<ChannelCreateDynamicFlowApproverResponse>;
|
|
415
|
+
/**
|
|
416
|
+
* 该接口用于获取创建法人章的二维码,需要通过微信扫描。扫描后将跳转到腾讯电子签署,进入到创建法人章的流程。
|
|
352
417
|
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
418
|
+
**注意**
|
|
419
|
+
1. 该二维码**有效期为7天**,过期后将失效,可重新创建 。
|
|
420
|
+
2. 每个公司**只能有1个法人章**,无法重复创建或者创建多个
|
|
356
421
|
|
|
357
|
-
|
|
422
|
+
法人章的样式可以参考下图索引(也可以自己上传法人印章图片):
|
|
423
|
+
|
|
424
|
+

|
|
358
425
|
*/
|
|
359
|
-
|
|
426
|
+
CreateLegalSealQrCode(req: CreateLegalSealQrCodeRequest, cb?: (error: string, rep: CreateLegalSealQrCodeResponse) => void): Promise<CreateLegalSealQrCodeResponse>;
|
|
427
|
+
/**
|
|
428
|
+
* 对合同流程文件进行数字签名验证,判断数字签名是否有效,合同文件内容是否被篡改。
|
|
429
|
+
|
|
430
|
+
**补充**: 可以到控制台[合同验签](https://qian.tencent.com/verifySign)体验验签功能,界面如下
|
|
431
|
+

|
|
432
|
+
*/
|
|
433
|
+
ChannelVerifyPdf(req: ChannelVerifyPdfRequest, cb?: (error: string, rep: ChannelVerifyPdfResponse) => void): Promise<ChannelVerifyPdfResponse>;
|
|
434
|
+
/**
|
|
435
|
+
* 此接口(GetDownloadFlowUrl)用户获取合同控制台下载页面链接, 点击链接后会跳转至本企业合同管理控制台(会筛选出传入的合同列表), 点击**下载**按钮后就会下载传入的合同列表, 下载页面如下图
|
|
436
|
+

|
|
437
|
+
|
|
438
|
+
注:
|
|
439
|
+
<ul>
|
|
440
|
+
<li>仅支持下载 <b>本企业</b> 下合同,链接会 <b>登录企业控制台</b> </li>
|
|
441
|
+
<li> <b>链接仅可使用一次</b>,不可重复使用</li>
|
|
442
|
+
</ul>
|
|
443
|
+
*/
|
|
444
|
+
GetDownloadFlowUrl(req: GetDownloadFlowUrlRequest, cb?: (error: string, rep: GetDownloadFlowUrlResponse) => void): Promise<GetDownloadFlowUrlResponse>;
|
|
360
445
|
/**
|
|
361
446
|
* 此接口查询子企业电子印章。<br />
|
|
362
447
|
|
|
@@ -365,64 +450,219 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
|
|
|
365
450
|
*/
|
|
366
451
|
ChannelDescribeOrganizationSeals(req: ChannelDescribeOrganizationSealsRequest, cb?: (error: string, rep: ChannelDescribeOrganizationSealsResponse) => void): Promise<ChannelDescribeOrganizationSealsResponse>;
|
|
367
452
|
/**
|
|
368
|
-
*
|
|
453
|
+
* 查询企业扩展服务的授权详情(列表),当前支持查询以下内容:
|
|
369
454
|
|
|
370
|
-
|
|
455
|
+
1. **企业自动签**
|
|
456
|
+
2. **批量签署**
|
|
371
457
|
|
|
372
|
-
- **需要在<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>前同步的企业信息**, 否则会出现信息同步没有用的情形
|
|
373
|
-
- **企业信息需要和营业执照信息对应**, 否则会出现激活过程验证不通过的问题
|
|
374
458
|
|
|
375
|
-
|
|
459
|
+
注: <font color='red'>所在企业的超管、法人才有权限调用此接口</font>(Agent.ProxyOperator.OpenId 需要传递超管或者法人的OpenId)
|
|
460
|
+
*/
|
|
461
|
+
DescribeExtendedServiceAuthDetail(req: DescribeExtendedServiceAuthDetailRequest, cb?: (error: string, rep: DescribeExtendedServiceAuthDetailResponse) => void): Promise<DescribeExtendedServiceAuthDetailResponse>;
|
|
462
|
+
/**
|
|
463
|
+
* 创建企业注销链接
|
|
376
464
|
|
|
465
|
+
系统将返回操作链接。贵方需要主动联系并通知企业的超级管理员(超管)或法人。由他们点击该链接,完成企业的注销操作。
|
|
377
466
|
|
|
378
|
-
|
|
379
|
-
- **第三方平台子客企业名称**: 对应上图中的**2**
|
|
380
|
-
- **企业法定代表人的名字**:对应上图中的**3**
|
|
381
|
-
- **企业详细住所**:对应上图中的**4**
|
|
467
|
+
注意: `在调用此接口以管理企业扩展服务时,操作者( Agent.ProxyOperator.OpenId)必须是企业的超级管理员(超管)或法人。`
|
|
382
468
|
*/
|
|
383
|
-
|
|
469
|
+
CreateCloseOrganizationUrl(req: CreateCloseOrganizationUrlRequest, cb?: (error: string, rep: CreateCloseOrganizationUrlResponse) => void): Promise<CreateCloseOrganizationUrlResponse>;
|
|
384
470
|
/**
|
|
385
|
-
*
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-

|
|
471
|
+
* 该接口 (PrepareFlows) 用于创建待发起文件
|
|
472
|
+
用户通过该接口进入签署流程发起的确认页面,进行发起信息二次确认, 如果确认则进行正常发起。
|
|
473
|
+
目前该接口只支持B2C,<font color='red'> **不建议使用,将会废弃**</font>。
|
|
389
474
|
*/
|
|
390
|
-
|
|
475
|
+
PrepareFlows(req: PrepareFlowsRequest, cb?: (error: string, rep: PrepareFlowsResponse) => void): Promise<PrepareFlowsResponse>;
|
|
391
476
|
/**
|
|
392
|
-
*
|
|
477
|
+
* 分页查询企业角色列表,法人的角色是系统保留角色,不会返回,按照角色创建时间升序排列。
|
|
393
478
|
|
|
394
|
-
**适用场景**
|
|
395
|
-
该接口常用来配合<a href="https://qian.tencent.com/developers/partnerApis/startFlows/CreateFlowsByTemplates" target="_blank">用模板创建签署流程</a>和<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates" target="_blank">通过多模板创建合同组签署流程</a>接口,作为创建合同的前置接口使用。
|
|
396
|
-
通过此接口查询到模板信息后,再通过调用创建合同的接口,指定模板ID,指定模板中需要的填写控件内容等,完成合同文档的创建。
|
|
397
479
|
|
|
398
|
-
|
|
399
|
-
子客企业的模板有两种途径获取
|
|
400
|
-
- 渠道方(平台方)配置完成后, 分发给同应用的各个子企业
|
|
401
|
-
- 子客企业通过CreateConsoleLoginUrl创建的链接登录子客控制台自己创建
|
|
480
|
+
<font color="red">系统默认角色</font>说明可参考下表
|
|
402
481
|
|
|
403
|
-
|
|
482
|
+
| 角色名称| 建议授予对象 | 角色描述 |
|
|
483
|
+
| --- | --- | --- |
|
|
484
|
+
| **超级管理员** |电子签业务最高权限,可以授权给法务/企业法人/业务负责人等 | 所有功能和数据管理权限,只能设置一位超管。 |
|
|
485
|
+
| **业务管理员**|IT 系统负责人,可以授权给CTO等 | 企业合同模块、印章模块、模板模块等全量功能及数据权限。 |
|
|
486
|
+
| **经办人**|企业法务负责人等 | 发起合同、签署合同(含填写、拒签)、撤销合同、持有印章等权限能力,可查看企业所有合同数据。 |
|
|
487
|
+
| **业务员**|销售员、采购员 等| 发起合同、签署合同(含填写、拒签)、撤销合同、持有印章等权限能力,可查看自己相关所有合同数据。 |
|
|
404
488
|
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
|
|
489
|
+
附件:<a href="https://dyn.ess.tencent.cn/guide/apivideo/roles.xlsx" target="_blank">点击下载角色对应的权限点的excel文档</a>
|
|
490
|
+
*/
|
|
491
|
+
ChannelDescribeRoles(req: ChannelDescribeRolesRequest, cb?: (error: string, rep: ChannelDescribeRolesResponse) => void): Promise<ChannelDescribeRolesResponse>;
|
|
492
|
+
/**
|
|
493
|
+
* 获取合同流程PDF的下载链接,可以下载签署中、签署完的此子企业创建的合同。
|
|
409
494
|
|
|
410
|
-

|
|
411
495
|
|
|
412
|
-
模板中各元素的层级关系, 所有的填写控件和签署控件都归属某一个角色(通过控件的ComponentRecipientId来关联)
|
|
413
496
|
|
|
414
|
-

|
|
415
497
|
|
|
498
|
+
### 2. 确保合同的PDF已经合成后,再调用本接口。
|
|
499
|
+
用户创建合同或者提交签署动作后,后台需要1~3秒的时间就进行合同PDF合成或者签名,为了确保您下载的是签署完成的完整合同文件,我们建议采取下面两种方式的一种来<font color="red"><b>确保PDF已经合成完成,然后在调用本接口</b></font>。
|
|
416
500
|
|
|
417
|
-
|
|
501
|
+
**第一种**:请确保您的系统配置了[接收合同完成通知的回调](https://qian.tencent.com/developers/partner/callback_types_contracts_sign)功能。一旦所有参与方签署完毕,我们的系统将自动向您提供的回调地址发送完成通知。
|
|
418
502
|
|
|
419
|
-
|
|
420
|
-
>2. TemplateId 和TemplateIds互为独立,若两个参数都传入,则以TemplateId为准
|
|
503
|
+
**第二种**:通过调用我们的[获取合同信息](https://qian.tencent.com/developers/partnerApis/flows/DescribeFlowDetailInfo)接口来主动检查合同的签署状态。请仅在确认合同状态为“全部签署完成”后,进行文件的下载操作。
|
|
421
504
|
|
|
422
|
-
|
|
423
|
-
|
|
505
|
+
### 3. 链接具有有效期限
|
|
506
|
+
<font color="red"><b>生成的链接是有时间限制的,过期后将无法访问</b></font>。您可以在接口返回的信息中查看具体的过期时间。为避免错误,请确保在链接过期之前进行下载操作。
|
|
507
|
+
|
|
508
|
+
### 4. 有两种开通下载权限的途径。
|
|
509
|
+
|
|
510
|
+
**第一种**: 需第三方应用的子企业登录控制台进行授权, 授权在**企业中心**的**授权管理**区域, 界面如下图。
|
|
511
|
+
授权过程需要**子企业超管**扫描跳转到电子签小程序签署<<渠道端下载渠道子客合同功能授权委托书>>
|
|
512
|
+
|
|
513
|
+

|
|
514
|
+
|
|
515
|
+
**第二种**: 渠道方企业在**企业应用管理**的配置界面打开需要配置的应用,点击**应用扩展服务**开通此功能,需要**渠道方企业的超管**扫描二维码跳转到电子签小程序签署 <<渠道端下载渠道子客合同功能开通知情同意书>>
|
|
516
|
+
注:
|
|
517
|
+
1. `请注意如果第三方应用的子客主动关闭了渠道端下载渠道子客合同功能开关,那么渠道方开通了此功能也无法下载子客的合同文件`
|
|
518
|
+
|
|
519
|
+

|
|
424
520
|
*/
|
|
425
|
-
|
|
521
|
+
DescribeResourceUrlsByFlows(req: DescribeResourceUrlsByFlowsRequest, cb?: (error: string, rep: DescribeResourceUrlsByFlowsResponse) => void): Promise<DescribeResourceUrlsByFlowsResponse>;
|
|
522
|
+
/**
|
|
523
|
+
* 查询渠道子客企业信息时,可以支持单个子客和整个应用下所有子客的查询。返回的信息包括超管、法人的信息以及当前企业的认证状态等信息。
|
|
524
|
+
|
|
525
|
+
- 对于单个企业的查询,通过**指定子客的唯一标识**来查询该子客的企业信息
|
|
526
|
+
- 对于整个应用下所有企业的查询,**不需要指定子客的唯一标识**,直接查询整个应用下所有子客企业的企业信息
|
|
527
|
+
*/
|
|
528
|
+
DescribeChannelOrganizations(req: DescribeChannelOrganizationsRequest, cb?: (error: string, rep: DescribeChannelOrganizationsResponse) => void): Promise<DescribeChannelOrganizationsResponse>;
|
|
529
|
+
/**
|
|
530
|
+
* 支持企业进行批量初始化操作:
|
|
531
|
+
|
|
532
|
+
此接口存在以下限制:
|
|
533
|
+
1. 批量操作的企业需要已经完成电子签的认证流程。
|
|
534
|
+
2. 通过此接口生成的链接在小程序端进行操作时,操作人需要是<font color="red">所有企业的超管或法人</font>。
|
|
535
|
+
3. 批量操作的企业,需要是本方第三方应用下的企业。
|
|
536
|
+
4. <font color="red">操作链接过期时间默认为生成链接后7天。</font>
|
|
537
|
+
*/
|
|
538
|
+
CreateBatchInitOrganizationUrl(req: CreateBatchInitOrganizationUrlRequest, cb?: (error: string, rep: CreateBatchInitOrganizationUrlResponse) => void): Promise<CreateBatchInitOrganizationUrlResponse>;
|
|
539
|
+
/**
|
|
540
|
+
* 通过此接口(ChannelDescribeAccountBillDetail)查询该第三方平台子客账号计费详情。
|
|
541
|
+
<ul>
|
|
542
|
+
<li>对于渠道客户企业的查询,通过指定渠道企业的唯一标识(Agent.ProxyOrganizationId)来查询子客账号消耗详情</li>
|
|
543
|
+
</ul>
|
|
544
|
+
*/
|
|
545
|
+
ChannelDescribeAccountBillDetail(req: ChannelDescribeAccountBillDetailRequest, cb?: (error: string, rep: ChannelDescribeAccountBillDetailResponse) => void): Promise<ChannelDescribeAccountBillDetailResponse>;
|
|
546
|
+
/**
|
|
547
|
+
* 您可以通过合同流程ID查询相关的<font color="red"><b>填写控件</b></font>信息及其内容。这包括控件的归属方、控件的填写状态(是否已填写)以及具体的填写内容。
|
|
548
|
+
|
|
549
|
+
无论是<font color="red"><b>发起方还是签署方</b></font>填写的控件,均包含在查询结果中。
|
|
550
|
+
|
|
551
|
+

|
|
552
|
+
### 2. 哪些控件会出现在结果里边?
|
|
553
|
+
**A.不返回的控件类型:**
|
|
554
|
+
- 动态表格
|
|
555
|
+
- 附件控件
|
|
556
|
+
- 水印控件
|
|
557
|
+
|
|
558
|
+
**B.返回的控件类型:**
|
|
559
|
+
- 单行文本
|
|
560
|
+
- 多行文本
|
|
561
|
+
- 勾选框控件
|
|
562
|
+
- 数字控件
|
|
563
|
+
- 日期控件
|
|
564
|
+
- 图片控件(图片下载地址)
|
|
565
|
+
- 邮箱控件
|
|
566
|
+
- 地址控件
|
|
567
|
+
- 学历控件
|
|
568
|
+
- 性别控件
|
|
569
|
+
- 省市区控件
|
|
570
|
+
|
|
571
|
+
### 3.怎么授权?
|
|
572
|
+
|
|
573
|
+
此接口需要授权, 有两种开通权限的途径
|
|
574
|
+
|
|
575
|
+
**第一种**: 需第三方应用的子企业登录控制台进行授权, 授权在**企业中心**的**授权管理**区域, 界面如下图
|
|
576
|
+
授权过程需要**子企业超管**扫描跳转到电子签小程序签署<<渠道端下载渠道子客合同功能授权委托书>>
|
|
577
|
+
|
|
578
|
+

|
|
579
|
+
|
|
580
|
+
**第二种**: 第三方应用的配置接口打开全第三个应用下的所有自己起开通, 需要**渠道方企业的超管**扫描二维码跳转到电子签小程序签署 <<渠道端下载渠道子客合同功能开通知情同意书>>
|
|
581
|
+

|
|
582
|
+
*/
|
|
583
|
+
ChannelDescribeFlowComponents(req: ChannelDescribeFlowComponentsRequest, cb?: (error: string, rep: ChannelDescribeFlowComponentsResponse) => void): Promise<ChannelDescribeFlowComponentsResponse>;
|
|
584
|
+
/**
|
|
585
|
+
* 此接口(ChannelDeleteSealPolicies)用于删除已指定员工印章授权信息,删除员工的印章授权后,该员工使用印章进行盖章时,将需要提交印章授权申请且通过审核后才能使用该印章进行签署。
|
|
586
|
+
*/
|
|
587
|
+
ChannelDeleteSealPolicies(req: ChannelDeleteSealPoliciesRequest, cb?: (error: string, rep: ChannelDeleteSealPoliciesResponse) => void): Promise<ChannelDeleteSealPoliciesResponse>;
|
|
588
|
+
/**
|
|
589
|
+
* 此接口(ChannelCreateMultiFlowSignQRCode)用于创建一码多签签署码。
|
|
590
|
+
|
|
591
|
+
**适用场景**:
|
|
592
|
+
签署人可通过扫描二维码补充签署信息进行实名签署。常用于提前不知道签署人的身份信息场景,例如:劳务工招工、大批量员工入职等场景。
|
|
593
|
+
|
|
594
|
+
**注意**:
|
|
595
|
+
1. 本接口适用于**发起方没有填写控件的 B2C或者单C模板**, 若是B2C模板,还要满足以下任意一个条件
|
|
596
|
+
- 模板中配置的签署顺序是无序
|
|
597
|
+
- B端企业的签署方式是静默签署
|
|
598
|
+
- B端企业是非首位签署
|
|
599
|
+
2. 通过扫描一码多签签署码发起的合同,合同涉及到的回调消息可参考文档[合同发起及签署相关回调
|
|
600
|
+
]( https://qian.tencent.com/developers/partner/callback_types_contracts_sign)
|
|
601
|
+
3. 用户通过扫描一码多签签署码发起合同时,因企业额度不足导致失败 会触发签署二维码相关回调,具体参考文档[签署二维码相关回调](https://qian.tencent.com/developers/partner/callback_types_commons#%E7%AD%BE%E7%BD%B2%E4%BA%8C%E7%BB%B4%E7%A0%81%E7%9B%B8%E5%85%B3%E5%9B%9E%E8%B0%83)
|
|
602
|
+
|
|
603
|
+
签署码的样式如下图:
|
|
604
|
+

|
|
605
|
+
*/
|
|
606
|
+
ChannelCreateMultiFlowSignQRCode(req: ChannelCreateMultiFlowSignQRCodeRequest, cb?: (error: string, rep: ChannelCreateMultiFlowSignQRCodeResponse) => void): Promise<ChannelCreateMultiFlowSignQRCodeResponse>;
|
|
607
|
+
/**
|
|
608
|
+
* 管理企业扩展服务
|
|
609
|
+
|
|
610
|
+
- **直接开通的情形:** 若在操作过程中接口没有返回跳转链接,这表明无需进行任何跳转操作。此时,相应的企业拓展服务将会直接被开通或关闭。
|
|
611
|
+
|
|
612
|
+
- **需要法人或者超管签署开通协议的情形:** 当需要开通以下企业拓展服务时, 系统将返回一个操作链接。贵方需要主动联系并通知企业的超级管理员(超管)或法人。由他们点击该链接,完成服务的开通操作。
|
|
613
|
+
- **AUTO_SIGN(企业自动签)**
|
|
614
|
+
- **DOWNLOAD_FLOW(授权渠道下载合同)**
|
|
615
|
+
|
|
616
|
+
注意: `在调用此接口以管理企业扩展服务时,操作者( Agent.ProxyOperator.OpenId)必须是企业的超级管理员(超管)或法人`
|
|
617
|
+
|
|
618
|
+
|
|
619
|
+
对应的扩展服务能力可以在控制台的【扩展服务】中找到
|
|
620
|
+

|
|
621
|
+
*/
|
|
622
|
+
ModifyExtendedService(req: ModifyExtendedServiceRequest, cb?: (error: string, rep: ModifyExtendedServiceResponse) => void): Promise<ModifyExtendedServiceResponse>;
|
|
623
|
+
/**
|
|
624
|
+
* 获取区块链存证证书查看链接/二维码接口
|
|
625
|
+
|
|
626
|
+
适用场景:企业员工可以通过此接口生成合同区块链存证证书的查看链接/二维码,以供他人扫码打开腾讯电子签小程序查看。
|
|
627
|
+
|
|
628
|
+
[点击查看区块链存证证书样式](https://qcloudimg.tencent-cloud.cn/raw/47d5e9c2ffa90ad4e27b3cd14095aa08.jpg)
|
|
629
|
+
|
|
630
|
+
注:
|
|
631
|
+
<ul><li>1. 二维码下载链接过期时间为5分钟,请尽快下载保存。二维码/短链的过期时间为<font color="red">7天</font>,超过有效期则不可用。</li>
|
|
632
|
+
<li>2. 合同状态需为<font color="red">签署完成</font> 、<font color="red">已解除</font>才能生成证书查看二维码/短链。</li>
|
|
633
|
+
<li>3. 调用接口时,需确保接口调用身份拥有此合同的访问数据权限或为合同参与方。</li>
|
|
634
|
+
<li>4. 通过扫码或者点击链接,用户无需登录或者鉴权即可查看对应合同的区块链存证证书,请妥善保管好二维码或链接。</li></ul>
|
|
635
|
+
*/
|
|
636
|
+
CreateFlowBlockchainEvidenceUrl(req: CreateFlowBlockchainEvidenceUrlRequest, cb?: (error: string, rep: CreateFlowBlockchainEvidenceUrlResponse) => void): Promise<CreateFlowBlockchainEvidenceUrlResponse>;
|
|
637
|
+
/**
|
|
638
|
+
* 此接口用于获取企业批量认证链接-单链接包含多条认证流。
|
|
639
|
+
|
|
640
|
+
前提条件:已调用 [CreateBatchOrganizationRegistrationTasks创建子企业批量认证链接任务接口](https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks) 和[查询子企业批量认证链接DescribeBatchOrganizationRegistrationUrls](https://qian.tencent.com/developers/partnerApis/accounts/DescribeBatchOrganizationRegistrationUrls) 确保认证任务已经完成。
|
|
641
|
+
|
|
642
|
+
异步任务的处理完成时间视当前已提交的任务量、任务的复杂程度等因素决定,正常情况下 3~5 秒即可完成,但也可能需要更长的时间。
|
|
643
|
+
此链接包含多条认证流程,使用该链接可以批量的对企业进行认证。
|
|
644
|
+
*/
|
|
645
|
+
CreateBatchOrganizationAuthorizationUrl(req: CreateBatchOrganizationAuthorizationUrlRequest, cb?: (error: string, rep: CreateBatchOrganizationAuthorizationUrlResponse) => void): Promise<CreateBatchOrganizationAuthorizationUrlResponse>;
|
|
646
|
+
/**
|
|
647
|
+
* 该接口用于发起合同后,生成个人/企业用户的批量待办链接。
|
|
648
|
+
**注意:**
|
|
649
|
+
1. 该接口可生成签署人的批量、合同组签署/查看链接 。
|
|
650
|
+
2. 该签署链接**有效期为30分钟**,过期后将失效,如需签署可重新创建批量签署链接 。
|
|
651
|
+
4. 该接口返回的签署链接适用于APP集成的场景,支持APP打开或浏览器直接打开,**不支持微信小程序嵌入**。
|
|
652
|
+
跳转到小程序的实现,参考微信官方文档(分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式),如何配置也可以请参考: <a href="https://qian.tencent.com/developers/company/openwxminiprogram">跳转电子签小程序配置</a>。
|
|
653
|
+
6. 因h5涉及人脸身份认证能力基于慧眼人脸核身,对Android和iOS系统均有一定要求, 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
|
|
654
|
+
*/
|
|
655
|
+
ChannelCreateBatchQuickSignUrl(req: ChannelCreateBatchQuickSignUrlRequest, cb?: (error: string, rep: ChannelCreateBatchQuickSignUrlResponse) => void): Promise<ChannelCreateBatchQuickSignUrlResponse>;
|
|
656
|
+
/**
|
|
657
|
+
* 通过此接口可以关闭个人用户自动签功能。
|
|
658
|
+
无需对应的用户刷脸等方式同意即可关闭。
|
|
659
|
+
|
|
660
|
+
注意:
|
|
661
|
+
|
|
662
|
+
<ul><li>处方单等特殊场景专用,此接口为白名单功能,使用前请联系对接的客户经理沟通。</li>
|
|
663
|
+
<li>如果此用户在开通时候绑定过个人自动签账号许可, 关闭此用户的自动签不会归还个人自动签账号许可的额度。</li></ul>
|
|
664
|
+
*/
|
|
665
|
+
ChannelDisableUserAutoSign(req: ChannelDisableUserAutoSignRequest, cb?: (error: string, rep: ChannelDisableUserAutoSignResponse) => void): Promise<ChannelDisableUserAutoSignResponse>;
|
|
426
666
|
/**
|
|
427
667
|
* 该接口用于批量创建企业认证链接, 可以支持PC浏览器,H5和小程序三种途径。
|
|
428
668
|
此接口为异步提交任务接口,需要与[查询子企业批量认证链接](https://qcloudimg.tencent-cloud.cn/raw/1d3737991b2a3be78002bd78a47d6917.png)配合使用,整体流程如下图。
|
|
@@ -447,6 +687,43 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
|
|
|
447
687
|
| 腾讯电子签Demo | wx371151823f6f3edf | gh_39a5d3de69fa |
|
|
448
688
|
*/
|
|
449
689
|
CreateBatchOrganizationRegistrationTasks(req: CreateBatchOrganizationRegistrationTasksRequest, cb?: (error: string, rep: CreateBatchOrganizationRegistrationTasksResponse) => void): Promise<CreateBatchOrganizationRegistrationTasksResponse>;
|
|
690
|
+
/**
|
|
691
|
+
* 该接口用于获取个人授权执业章给企业的二维码,需要个人用户通过微信扫码。
|
|
692
|
+
|
|
693
|
+
扫描后将跳转到腾讯电子签小程序,进入到授权执业章的流程。
|
|
694
|
+
|
|
695
|
+
个人用户授权成功后,企业印章管理员需对印章进行审核,审核通过后,即可使用个人授权的执业章进行盖章操作。
|
|
696
|
+
|
|
697
|
+
**注意**
|
|
698
|
+
1. 该二维码**有效期为7天**,过期后将失效,可重新创建。
|
|
699
|
+
|
|
700
|
+
|
|
701
|
+
整体流程入下图
|
|
702
|
+
|
|
703
|
+

|
|
704
|
+
*/
|
|
705
|
+
CreateEmployeeQualificationSealQrCode(req: CreateEmployeeQualificationSealQrCodeRequest, cb?: (error: string, rep: CreateEmployeeQualificationSealQrCodeResponse) => void): Promise<CreateEmployeeQualificationSealQrCodeResponse>;
|
|
706
|
+
/**
|
|
707
|
+
* 此接口(ChannelGetTaskResultApi)用来查询转换任务的状态。如需发起转换任务,请使用<a href="https://qian.tencent.com/developers/partnerApis/files/ChannelCreateConvertTaskApi" target="_blank">创建文件转换任务接口</a>进行资源文件的转换操作<br />
|
|
708
|
+
前提条件:已调用 <a href="https://qian.tencent.com/developers/partnerApis/files/ChannelCreateConvertTaskApi" target="_blank">创建文件转换任务接口</a>进行文件转换,并得到了返回的转换任务Id。<br />
|
|
709
|
+
|
|
710
|
+
适用场景:已创建一个文件转换任务,想查询该文件转换任务的状态,或获取转换后的文件资源ID。<br />
|
|
711
|
+
注:
|
|
712
|
+
1. `大文件转换所需的时间可能会比较长。`
|
|
713
|
+
2. `本接口返回的文件资源ID就是PDF资源ID,可以直接用于【用PDF文件创建签署流程】接口发起合同。`
|
|
714
|
+
*/
|
|
715
|
+
ChannelGetTaskResultApi(req: ChannelGetTaskResultApiRequest, cb?: (error: string, rep: ChannelGetTaskResultApiResponse) => void): Promise<ChannelGetTaskResultApiResponse>;
|
|
716
|
+
/**
|
|
717
|
+
* 获取设置自动签印章小程序链接。
|
|
718
|
+
|
|
719
|
+
注意:
|
|
720
|
+
<ul><li>需要<code>企业开通自动签</code>后使用。</li>
|
|
721
|
+
<li>仅支持<code>已经开通了自动签的个人</code>更换自动签印章。</li>
|
|
722
|
+
<li>链接有效期默认7天,<code>最多30天</code>。</li>
|
|
723
|
+
<li>该接口的链接适用于<code>小程序</code>端。</li>
|
|
724
|
+
<li>该接口不会扣除您的合同套餐,暂不参与计费。</li></ul>
|
|
725
|
+
*/
|
|
726
|
+
ChannelCreateUserAutoSignSealUrl(req: ChannelCreateUserAutoSignSealUrlRequest, cb?: (error: string, rep: ChannelCreateUserAutoSignSealUrlResponse) => void): Promise<ChannelCreateUserAutoSignSealUrlResponse>;
|
|
450
727
|
/**
|
|
451
728
|
* 激活或续期子客企业, 在激活状态下,企业可以正常发起合同;在非激活状态下,企业仅能查看和签署合同。
|
|
452
729
|
|
|
@@ -465,6 +742,45 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
|
|
|
465
742
|

|
|
466
743
|
*/
|
|
467
744
|
CreateChannelSubOrganizationActive(req: CreateChannelSubOrganizationActiveRequest, cb?: (error: string, rep: CreateChannelSubOrganizationActiveResponse) => void): Promise<CreateChannelSubOrganizationActiveResponse>;
|
|
745
|
+
/**
|
|
746
|
+
* 通过此接口(DescribeTemplates)查询该第三方平台子客企业在电子签拥有的有效模板,不包括第三方平台模板。
|
|
747
|
+
|
|
748
|
+
**适用场景**
|
|
749
|
+
该接口常用来配合<a href="https://qian.tencent.com/developers/partnerApis/startFlows/CreateFlowsByTemplates" target="_blank">用模板创建签署流程</a>和<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates" target="_blank">通过多模板创建合同组签署流程</a>接口,作为创建合同的前置接口使用。
|
|
750
|
+
通过此接口查询到模板信息后,再通过调用创建合同的接口,指定模板ID,指定模板中需要的填写控件内容等,完成合同文档的创建。
|
|
751
|
+
|
|
752
|
+
**模板的来源**
|
|
753
|
+
子客企业的模板有两种途径获取
|
|
754
|
+
- 渠道方(平台方)配置完成后, 分发给同应用的各个子企业
|
|
755
|
+
- 子客企业通过CreateConsoleLoginUrl创建的链接登录子客控制台自己创建
|
|
756
|
+
|
|
757
|
+
**一个模板通常会包含以下结构信息**
|
|
758
|
+
|
|
759
|
+
- 模板ID, 模板名字等基本信息
|
|
760
|
+
- 发起方参与信息Promoter、签署参与方 Recipients,后者会在模板发起合同时用于指定参与方
|
|
761
|
+
- 发起方和签署方的填写控件 Components
|
|
762
|
+
- 签署方的签署控件 SignComponents
|
|
763
|
+
|
|
764
|
+

|
|
765
|
+
|
|
766
|
+
模板中各元素的层级关系, 所有的填写控件和签署控件都归属某一个角色(通过控件的ComponentRecipientId来关联)
|
|
767
|
+
|
|
768
|
+

|
|
769
|
+
|
|
770
|
+
|
|
771
|
+
**注意**
|
|
772
|
+
|
|
773
|
+
>1. 查询条件TemplateId、TemplateName与ChannelTemplateId可同时存在,即可查询同时满足这些条件的模板。
|
|
774
|
+
>2. TemplateId 和TemplateIds互为独立,若两个参数都传入,则以TemplateId为准
|
|
775
|
+
|
|
776
|
+
<font color="red">相关视频指引</font> <br>
|
|
777
|
+
1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateTemplates.mp4" target="_blank">创建模板&设置成本企业自动签署</a><br>
|
|
778
|
+
*/
|
|
779
|
+
DescribeTemplates(req: DescribeTemplatesRequest, cb?: (error: string, rep: DescribeTemplatesResponse) => void): Promise<DescribeTemplatesResponse>;
|
|
780
|
+
/**
|
|
781
|
+
* 此接口(ChannelCancelUserAutoSignEnableUrl)用来撤销发送给个人用户的自动签开通链接,撤销后对应的个人用户开通链接失效。若个人用户已经完成开通,将无法撤销。(处方单场景专用,使用此接口请与客户经理确认)
|
|
782
|
+
*/
|
|
783
|
+
ChannelCancelUserAutoSignEnableUrl(req: ChannelCancelUserAutoSignEnableUrlRequest, cb?: (error: string, rep: ChannelCancelUserAutoSignEnableUrlResponse) => void): Promise<ChannelCancelUserAutoSignEnableUrlResponse>;
|
|
468
784
|
/**
|
|
469
785
|
* 此接口(UploadFiles)文件上传。<br/>
|
|
470
786
|
|
|
@@ -485,25 +801,204 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
|
|
|
485
801
|
*/
|
|
486
802
|
UploadFiles(req: UploadFilesRequest, cb?: (error: string, rep: UploadFilesResponse) => void): Promise<UploadFilesResponse>;
|
|
487
803
|
/**
|
|
488
|
-
*
|
|
489
|
-
|
|
490
|
-
扫描后将跳转到腾讯电子签小程序,进入到授权执业章的流程。
|
|
491
|
-
|
|
492
|
-
个人用户授权成功后,企业印章管理员需对印章进行审核,审核通过后,即可使用个人授权的执业章进行盖章操作。
|
|
804
|
+
* 该接口用于发起合同后,生成用户的签署链接 <br/>
|
|
493
805
|
|
|
494
806
|
**注意**
|
|
495
|
-
1.
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-

|
|
807
|
+
1. 该签署**链接有效期为30分钟**,过期后将失效,如需签署可重新创建签署链接 。
|
|
808
|
+
2. 该接口返回的签署链接适用于APP集成的场景,支持APP打开或浏览器直接打开,**不支持微信小程序嵌入**。配置方式请参考:<a href="https://qian.tencent.com/developers/company/openqianh5/">跳转电子签H5</a>。
|
|
809
|
+
如需跳转到小程序的实现,参考微信官方文档(分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式),如何配置也可以请参考: <a href="https://qian.tencent.com/developers/company/openwxminiprogram">跳转电子签小程序配置</a>。
|
|
810
|
+
3. 因h5涉及人脸身份认证能力基于慧眼人脸核身,对Android和iOS系统均有一定要求, 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
|
|
501
811
|
*/
|
|
502
|
-
|
|
812
|
+
ChannelCreateFlowSignUrl(req: ChannelCreateFlowSignUrlRequest, cb?: (error: string, rep: ChannelCreateFlowSignUrlResponse) => void): Promise<ChannelCreateFlowSignUrlResponse>;
|
|
503
813
|
/**
|
|
504
|
-
* 此接口(
|
|
814
|
+
* 此接口(CreateChannelOrganizationInfoChangeUrl)用于创建子客企业信息变更链接。
|
|
505
815
|
|
|
506
|
-
|
|
816
|
+
<h3 id="1">支持变更链接类型,通过入参 Endpoint 指定,默认为WEIXINAPP。</h3>
|
|
817
|
+
|
|
818
|
+
<h4 id="WEIXINAPP">WEIXINAPP</h4>
|
|
819
|
+
<p>创建变更短链。需要在移动端打开,会跳转到微信腾讯电子签小程序进行更换。</p>
|
|
820
|
+
|
|
821
|
+
<h4 id="APP">APP</h4>
|
|
822
|
+
<p>创建变更小程序链接,可从第三方App跳转到微信腾讯电子签小程序进行更换。</p>
|
|
823
|
+
|
|
824
|
+
|
|
825
|
+
<h3 id="2">支持创建企业超管变更链接或企业基础信息变更链接,通过入参 ChangeType 指定。</h3>
|
|
826
|
+
|
|
827
|
+
<h4 id="1-企业超管变更">1. 企业超管变更</h4>
|
|
828
|
+
|
|
829
|
+
<p>换成企业的其他员工来当超管</p>
|
|
830
|
+
|
|
831
|
+
<h4 id="2-企业基础信息变更">2. 企业基础信息变更</h4>
|
|
832
|
+
|
|
833
|
+
<h5 id="可以变动">可以变动</h5>
|
|
834
|
+
|
|
835
|
+
<ul>
|
|
836
|
+
<li>企业名称<br>
|
|
837
|
+
</li>
|
|
838
|
+
<li>法定代表人姓名(新法人有邀请链接)<br>
|
|
839
|
+
</li>
|
|
840
|
+
<li>企业地址和所在地</li>
|
|
841
|
+
</ul>
|
|
842
|
+
|
|
843
|
+
<h5 id="不可变动">不可变动</h5>
|
|
844
|
+
|
|
845
|
+
<ul>
|
|
846
|
+
<li>统一社会信用代码<br>
|
|
847
|
+
</li>
|
|
848
|
+
<li>企业主体类型</li>
|
|
849
|
+
</ul>
|
|
850
|
+
|
|
851
|
+
<p>如果企业名称变动会引起下面的变动</p>
|
|
852
|
+
|
|
853
|
+
<ul>
|
|
854
|
+
<li>合同: 老合同不做任何处理, 新发起的合同需要用新的企业名字作为签署方, 否则无法签署</li>
|
|
855
|
+
<li>印章: 会删除所有的印章所有的机构公章,合同专用章,财务专用章和人事专用章, 然后用新企业名称生成新的机构公章,合同专用章,财务专用章和人事专用章, 而法人章不会处理</li>
|
|
856
|
+
<li>证书: 企业证书会重新请求CA机构用新企业名称生成新的证书</li>
|
|
857
|
+
</ul>
|
|
858
|
+
|
|
859
|
+
|
|
860
|
+
注意:
|
|
861
|
+
1. 生成的电子签小程序链接<font color='red'>只能由企业的法人或者超管</font>点击后进行操作, 其他员工打开后会提示“无权查看该内容”
|
|
862
|
+
2. 法人可以无需生成链接,直接在电子签小程序中更换本企业的超管
|
|
863
|
+
*/
|
|
864
|
+
CreateChannelOrganizationInfoChangeUrl(req: CreateChannelOrganizationInfoChangeUrlRequest, cb?: (error: string, rep: CreateChannelOrganizationInfoChangeUrlResponse) => void): Promise<CreateChannelOrganizationInfoChangeUrlResponse>;
|
|
865
|
+
/**
|
|
866
|
+
* 接口(ChannelCreateFlowGroupByFiles)用于使用 PDF 文件创建合同组签署流程。
|
|
867
|
+
|
|
868
|
+
- 该接口允许通过选择多个模板一次性创建多个合同,这些合同被组织在一个合同组中。
|
|
869
|
+
- 每个签署方将收到一个签署链接,通过这个链接可以访问并签署合同组中的所有合同。
|
|
870
|
+
- 合同组中的合同必须作为一个整体进行签署,不能将合同组拆分成单独的合同进行逐一签署。
|
|
871
|
+
|
|
872
|
+
<img src="https://qcloudimg.tencent-cloud.cn/raw/a63074a0293c9ff5bf6c0bb74c0d3b20.png" width="400" />
|
|
873
|
+
|
|
874
|
+
|
|
875
|
+
### 2. 适用场景
|
|
876
|
+
|
|
877
|
+
该接口适用于需要一次性完成多份合同签署的情况,多份合同一般具有关联性,用户以目录的形式查看合同。
|
|
878
|
+
|
|
879
|
+
### 3. 发起方要求和签署方实名要求
|
|
880
|
+
- **发起方要求**:作为合同发起方的第三方子企业A的员工必须进行实名认证。
|
|
881
|
+
- **签署方要求**:签署方可以是多种身份(如第三方子企业的员工、个人、SaaS平台企业员工),其中企业和员工可以不进行实名认证。
|
|
882
|
+
|
|
883
|
+
**可以作为发起方和签署方的角色列表**
|
|
884
|
+
|
|
885
|
+
<table>
|
|
886
|
+
<thead>
|
|
887
|
+
<tr>
|
|
888
|
+
<th>场景编号</th>
|
|
889
|
+
<th>可作为发起方类型</th>
|
|
890
|
+
<th>可作为签署方的类型</th>
|
|
891
|
+
</tr>
|
|
892
|
+
</thead>
|
|
893
|
+
|
|
894
|
+
<tbody>
|
|
895
|
+
<tr>
|
|
896
|
+
<td>场景一</td>
|
|
897
|
+
<td>第三方子企业A员工</td>
|
|
898
|
+
<td>第三方子企业A员工</td>
|
|
899
|
+
</tr>
|
|
900
|
+
|
|
901
|
+
<tr>
|
|
902
|
+
<td>场景二</td>
|
|
903
|
+
<td>第三方子企业A员工</td>
|
|
904
|
+
<td>第三方子企业B员工</td>
|
|
905
|
+
</tr>
|
|
906
|
+
|
|
907
|
+
<tr>
|
|
908
|
+
<td>场景三</td>
|
|
909
|
+
<td>第三方子企业A员工</td>
|
|
910
|
+
<td>个人/自然人</td>
|
|
911
|
+
</tr>
|
|
912
|
+
|
|
913
|
+
<tr>
|
|
914
|
+
<td>场景四</td>
|
|
915
|
+
<td>第三方子企业A员工</td>
|
|
916
|
+
<td>SaaS平台企业员工</td>
|
|
917
|
+
</tr>
|
|
918
|
+
</tbody>
|
|
919
|
+
</table>
|
|
920
|
+
|
|
921
|
+
### 4. 签署方参数差异
|
|
922
|
+
- 根据签署方的不同类型(第三方子企业的员工、个人、SaaS平台企业员工),传递的参数也不同。具体参数的结构和要求可以参考开发者中心提供的 `FlowApproverInfo` 结构体说明。
|
|
923
|
+
|
|
924
|
+
### 5. 合同额度的扣减与返还
|
|
925
|
+
- **扣减时机**:合同一旦发起,相关的合同额度就会被扣减,合同组下面的每个合同都要扣减一个合同额度。
|
|
926
|
+
- **返还条件**:只有在合同被撤销且没有任何签署方签署过,或者只有自动签署的情况下,合同额度才会被返还。
|
|
927
|
+
- **不返还的情况**:如果合同已过期、被拒签、签署完成或已解除,合同额度将不会被返还。
|
|
928
|
+
|
|
929
|
+
### 6. 静默(自动)签署的限制
|
|
930
|
+
- 在使用静默(自动)签署功能时,合同签署方不能有填写控件。<font color="red">此接口静默签(企业自动签)能力为白名单功能</font>,使用前请联系对接的客户经理沟通。
|
|
931
|
+
|
|
932
|
+
### 7.合同组暂不支持抄送功能
|
|
933
|
+
*/
|
|
934
|
+
ChannelCreateFlowGroupByFiles(req: ChannelCreateFlowGroupByFilesRequest, cb?: (error: string, rep: ChannelCreateFlowGroupByFilesResponse) => void): Promise<ChannelCreateFlowGroupByFilesResponse>;
|
|
935
|
+
/**
|
|
936
|
+
* 此接口用于查询合同或者合同组的详情信息,支持查询多个(数量不能超过100)。
|
|
937
|
+
|
|
938
|
+
适用场景:可用于主动查询某个合同或者合同组的详情信息。
|
|
939
|
+
|
|
940
|
+
注: `只能查询本企业创建的合同(创建合同用的Agent和此接口用的Agent数据最好一致) `
|
|
941
|
+
*/
|
|
942
|
+
DescribeFlowDetailInfo(req: DescribeFlowDetailInfoRequest, cb?: (error: string, rep: DescribeFlowDetailInfoResponse) => void): Promise<DescribeFlowDetailInfoResponse>;
|
|
943
|
+
/**
|
|
944
|
+
* 通过此接口(ChannelDescribeBillUsageDetail)查询该第三方平台子客企业的套餐消耗详情。可以支持单个子客和整个应用下所有子客的查询。
|
|
945
|
+
<ul>
|
|
946
|
+
<li>对于单个子客企业的查询,通过指定子客的唯一标识(Agent.ProxyOrganizationOpenId)来查询该子客消耗详情</li>
|
|
947
|
+
<li>对于整个应用下所有企业的查询,不需要指定子客的唯一标识,只需要传入渠道应用标识(Agent.AppId)直接查询整个应用下所有子客企业消耗详情</li>
|
|
948
|
+
</ul>
|
|
949
|
+
*/
|
|
950
|
+
ChannelDescribeBillUsageDetail(req: ChannelDescribeBillUsageDetailRequest, cb?: (error: string, rep: ChannelDescribeBillUsageDetailResponse) => void): Promise<ChannelDescribeBillUsageDetailResponse>;
|
|
951
|
+
/**
|
|
952
|
+
* 批量清理未认证的企业认证流程。
|
|
953
|
+
|
|
954
|
+
此接口用来清除企业方认证信息填写错误,批量清理认证中的认证流信息。
|
|
955
|
+
为接口[提交子企业批量认证链接创建任务](https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks) 和[查询子企业批量认证链接](https://qian.tencent.com/developers/partnerApis/accounts/DescribeBatchOrganizationRegistrationUrls) 接口的扩展接口。即在批量认证过程中,当发起认证企业发现超管信息错误的时候,可以将当前超管下的所有认证流企业清除。
|
|
956
|
+
|
|
957
|
+
注意:
|
|
958
|
+
**这个接口的操作人必须跟生成批量认证链接接口的应用号一致,才可以调用,否则会返回当前操作人没有认证中的企业认证流**
|
|
959
|
+
*/
|
|
960
|
+
DeleteOrganizationAuthorizations(req: DeleteOrganizationAuthorizationsRequest, cb?: (error: string, rep: DeleteOrganizationAuthorizationsResponse) => void): Promise<DeleteOrganizationAuthorizationsResponse>;
|
|
961
|
+
/**
|
|
962
|
+
* 在已启动的签署流程中,可对签署截止日期进行延期操作,主要分为以下两个层面:
|
|
963
|
+
1. <b> 合同(流程)层面</b>:仅需提供签署流程ID。此操作将对整个签署流程以及未单独设置签署截止时间的签署人进行延期。
|
|
964
|
+
2. <b> 签署人层面</b> :需提供流程ID和签署人ID。此操作针对特定签署人进行延期,特别是对于有序合同(流程),签署截止时间不得超过后续签署人的流程截止时间。
|
|
965
|
+
|
|
966
|
+
此接口存在以下限制:
|
|
967
|
+
1. 执行操作的员工须为<font color="red">发起方企业的超级管理员、法定代表人或签署流程发起人</font>。
|
|
968
|
+
2. 延长整个签署流程时,<font color="red">应至少有一方尚未签署</font>(即签署流程不能处于已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等状态)。
|
|
969
|
+
3. 延长整个签署流程时,新的签署截止日期应晚于已设定的签署截止日期和当前日期。
|
|
970
|
+
4. 延长签署方截止时间时,<font color="red">签署方不能处于流程完结或已终止状态</font>(即签署人不能处于已签署、已拒签、已过期、已撤回、拒绝填写、已解除等状态)。
|
|
971
|
+
5. 延长签署方截止时间时,新的签署截止日期应晚于当前日期和已设定的截止日期。若为有序合同,还需早于或等于下一签署人的截止日期,且早于签署流程整体的截止日期。
|
|
972
|
+
6. <font color="red">不支持操作合同组合同</font>。
|
|
973
|
+
|
|
974
|
+
合同(流程)层面截止时间子企业控制台展示的位置:
|
|
975
|
+

|
|
976
|
+
*/
|
|
977
|
+
ModifyFlowDeadline(req: ModifyFlowDeadlineRequest, cb?: (error: string, rep: ModifyFlowDeadlineResponse) => void): Promise<ModifyFlowDeadlineResponse>;
|
|
978
|
+
/**
|
|
979
|
+
* 通过此接口,可以创建企业批量签署链接,员工只需点击链接即可跳转至控制台进行批量签署。
|
|
980
|
+
|
|
981
|
+
注:
|
|
982
|
+
- 员工必须在企业下完成实名认证,且需作为批量签署合同的签署方或者领取方。
|
|
983
|
+
- 仅支持传入待签署或者待领取的合同,待填写暂不支持。
|
|
984
|
+
- 员工批量签署,支持多种签名方式,包括手写签名、临摹签名、系统签名、个人印章、签批控件等。
|
|
985
|
+
|
|
986
|
+
签署的嵌入页面长相如下:
|
|
987
|
+

|
|
988
|
+
*/
|
|
989
|
+
ChannelCreateOrganizationBatchSignUrl(req: ChannelCreateOrganizationBatchSignUrlRequest, cb?: (error: string, rep: ChannelCreateOrganizationBatchSignUrlResponse) => void): Promise<ChannelCreateOrganizationBatchSignUrlResponse>;
|
|
990
|
+
/**
|
|
991
|
+
* 将指定印章授权给第三方平台子客企业下的某些员工
|
|
992
|
+
*/
|
|
993
|
+
ChannelCreateSealPolicy(req: ChannelCreateSealPolicyRequest, cb?: (error: string, rep: ChannelCreateSealPolicyResponse) => void): Promise<ChannelCreateSealPolicyResponse>;
|
|
994
|
+
/**
|
|
995
|
+
* 通过接口[批量撤销合同流程](https://qian.tencent.com/developers/partnerApis/operateFlows/ChannelBatchCancelFlows)或者[获取批量撤销签署流程腾讯电子签小程序链接](https://qian.tencent.com/developers/partnerApis/operateFlows/ChannelCreateBatchCancelFlowUrl)发起批量撤销任务后,可通过此接口查询批量撤销任务的结果。
|
|
996
|
+
*/
|
|
997
|
+
DescribeCancelFlowsTask(req: DescribeCancelFlowsTaskRequest, cb?: (error: string, rep: DescribeCancelFlowsTaskResponse) => void): Promise<DescribeCancelFlowsTaskResponse>;
|
|
998
|
+
/**
|
|
999
|
+
* 此接口(CreateConsoleLoginUrl)用于创建第三方平台子客企业控制台Web/移动登录链接。支持web控制台、电子签小程序和H5链接。登录链接是进入子客web企业控制台的唯一入口。
|
|
1000
|
+
|
|
1001
|
+
Web链接访问后,会根据子客企业(**Agent中ProxyOrganizationOpenId表示**)和员工(**Agent中OpenId表示**)的状态,进入不同的流程,主要情况分类如下:
|
|
507
1002
|
<table>
|
|
508
1003
|
<thead>
|
|
509
1004
|
<tr>
|
|
@@ -543,10 +1038,6 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
|
|
|
543
1038
|
1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-createconsoleloginin.mp4" target="_blank">【生成子客登录链接】代码编写 & 子企业认证示例</a><br>
|
|
544
1039
|
*/
|
|
545
1040
|
CreateConsoleLoginUrl(req: CreateConsoleLoginUrlRequest, cb?: (error: string, rep: CreateConsoleLoginUrlResponse) => void): Promise<CreateConsoleLoginUrlResponse>;
|
|
546
|
-
/**
|
|
547
|
-
* 生成渠道子客编辑企业信息二维码
|
|
548
|
-
*/
|
|
549
|
-
ChannelCreateOrganizationModifyQrCode(req: ChannelCreateOrganizationModifyQrCodeRequest, cb?: (error: string, rep: ChannelCreateOrganizationModifyQrCodeResponse) => void): Promise<ChannelCreateOrganizationModifyQrCodeResponse>;
|
|
550
1041
|
/**
|
|
551
1042
|
* 通过此接口指定合同、签署人、填写控件等信息,生成嵌入式链接,此链接可以嵌入到其他网页或者直接打开,打开后进入发起页面。在此页面上,合同信息和签署人信息均不可更改。
|
|
552
1043
|
|
|
@@ -611,26 +1102,22 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
|
|
|
611
1102
|
*/
|
|
612
1103
|
ChannelDeleteRole(req: ChannelDeleteRoleRequest, cb?: (error: string, rep: ChannelDeleteRoleResponse) => void): Promise<ChannelDeleteRoleResponse>;
|
|
613
1104
|
/**
|
|
614
|
-
* 此接口(
|
|
615
|
-
前提条件:已调用 <a href="https://qian.tencent.com/developers/partnerApis/files/ChannelCreateConvertTaskApi" target="_blank">创建文件转换任务接口</a>进行文件转换,并得到了返回的转换任务Id。<br />
|
|
1105
|
+
* 此接口(SyncProxyOrganization)用于同步第三方平台子客企业信息,包括企业名称、企业营业执照、企业统一社会信用代码和法人姓名等,便于子客企业在企业激活过程中无需手动上传营业执照或补充企业信息。
|
|
616
1106
|
|
|
617
|
-
|
|
618
|
-
|
|
619
|
-
|
|
620
|
-
|
|
621
|
-
|
|
622
|
-
|
|
623
|
-
|
|
624
|
-
|
|
625
|
-
|
|
626
|
-
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
<li>此接口需要保证:合同发起时指定开启了动态合同</li>
|
|
630
|
-
<li>此接口补充的动态签署人传参规则,请参考接口:<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles" target="_blank">用PDF文件创建签署流程</a>的签署人传参规则</li>
|
|
631
|
-
</ul>
|
|
1107
|
+
注意:
|
|
1108
|
+
|
|
1109
|
+
- **需要在<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>前同步的企业信息**, 否则会出现信息同步没有用的情形
|
|
1110
|
+
- **企业信息需要和营业执照信息对应**, 否则会出现激活过程验证不通过的问题
|
|
1111
|
+
|
|
1112
|
+

|
|
1113
|
+
|
|
1114
|
+
|
|
1115
|
+
- **企业统一社会信用代码**: 对应上图中的**1**
|
|
1116
|
+
- **第三方平台子客企业名称**: 对应上图中的**2**
|
|
1117
|
+
- **企业法定代表人的名字**:对应上图中的**3**
|
|
1118
|
+
- **企业详细住所**:对应上图中的**4**
|
|
632
1119
|
*/
|
|
633
|
-
|
|
1120
|
+
SyncProxyOrganization(req: SyncProxyOrganizationRequest, cb?: (error: string, rep: SyncProxyOrganizationResponse) => void): Promise<SyncProxyOrganizationResponse>;
|
|
634
1121
|
/**
|
|
635
1122
|
* 此接口(ChannelUpdateSealStatus)用于第三方应用平台为子客企业更新印章状态。
|
|
636
1123
|
*/
|
|
@@ -651,80 +1138,17 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
|
|
|
651
1138
|
*/
|
|
652
1139
|
ChannelCreateBatchSignUrl(req: ChannelCreateBatchSignUrlRequest, cb?: (error: string, rep: ChannelCreateBatchSignUrlResponse) => void): Promise<ChannelCreateBatchSignUrlResponse>;
|
|
653
1140
|
/**
|
|
654
|
-
*
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
**未归属合同发起方式**
|
|
658
|
-
指定对应企业的OrganizationOpenId和OrganizationName而不指定具体的参与人(OpenId/名字/手机号等), 则合同进入待领取状态, 示例代码如下
|
|
659
|
-
```
|
|
660
|
-
FlowApprovers: []*essbasic.FlowApproverInfo{
|
|
661
|
-
{
|
|
662
|
-
ApproverType: common.StringPtr("ORGANIZATION"),
|
|
663
|
-
OrganizationOpenId: common.StringPtr("org_dianziqian"),
|
|
664
|
-
OrganizationName: common.StringPtr("典子谦示例企业"),
|
|
665
|
-
}
|
|
666
|
-
},
|
|
667
|
-
```
|
|
668
|
-
|
|
669
|
-
可以<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>登录控制台查看带领取的合同
|
|
670
|
-

|
|
671
|
-
|
|
672
|
-
注:
|
|
673
|
-
1. 支持批量领取, 如果有一个合同流程无法领取会导致接口报错, 使得所有合同都领取失败
|
|
674
|
-
2. 只有企业的<font color="red">超管或者法人</font>才能进行合同的领取
|
|
675
|
-
*/
|
|
676
|
-
ChannelCreateBoundFlows(req: ChannelCreateBoundFlowsRequest, cb?: (error: string, rep: ChannelCreateBoundFlowsResponse) => void): Promise<ChannelCreateBoundFlowsResponse>;
|
|
677
|
-
/**
|
|
678
|
-
* 获取设置自动签印章小程序链接。
|
|
1141
|
+
* 给医疗个人自动签许可续期。续期成功后,可对医疗自动签许可追加一年有效期,只可续期一次。
|
|
679
1142
|
|
|
680
|
-
|
|
681
|
-
<ul><li>需要<code>企业开通自动签</code>后使用。</li>
|
|
682
|
-
<li>仅支持<code>已经开通了自动签的个人</code>更换自动签印章。</li>
|
|
683
|
-
<li>链接有效期默认7天,<code>最多30天</code>。</li>
|
|
684
|
-
<li>该接口的链接适用于<code>小程序</code>端。</li>
|
|
685
|
-
<li>该接口不会扣除您的合同套餐,暂不参与计费。</li></ul>
|
|
1143
|
+
注意: `处方单等特殊场景专用,此接口为白名单功能,使用前请联系对接的客户经理沟通。`
|
|
686
1144
|
*/
|
|
687
|
-
|
|
1145
|
+
ChannelRenewAutoSignLicense(req: ChannelRenewAutoSignLicenseRequest, cb?: (error: string, rep: ChannelRenewAutoSignLicenseResponse) => void): Promise<ChannelRenewAutoSignLicenseResponse>;
|
|
688
1146
|
/**
|
|
689
1147
|
* 通过此接口获取个人用户自动签的开通状态。
|
|
690
1148
|
|
|
691
1149
|
注意: `处方单等特殊场景专用,此接口为白名单功能,使用前请联系对接的客户经理沟通。`
|
|
692
1150
|
*/
|
|
693
1151
|
ChannelDescribeUserAutoSignStatus(req: ChannelDescribeUserAutoSignStatusRequest, cb?: (error: string, rep: ChannelDescribeUserAutoSignStatusResponse) => void): Promise<ChannelDescribeUserAutoSignStatusResponse>;
|
|
694
|
-
/**
|
|
695
|
-
* 该接口用于获取创建法人章的二维码,需要通过微信扫描。扫描后将跳转到腾讯电子签署,进入到创建法人章的流程。
|
|
696
|
-
|
|
697
|
-
**注意**
|
|
698
|
-
1. 该二维码**有效期为7天**,过期后将失效,可重新创建 。
|
|
699
|
-
2. 每个公司**只能有1个法人章**,无法重复创建或者创建多个
|
|
700
|
-
|
|
701
|
-
法人章的样式可以参考下图索引(也可以自己上传法人印章图片):
|
|
702
|
-
|
|
703
|
-

|
|
704
|
-
*/
|
|
705
|
-
CreateLegalSealQrCode(req: CreateLegalSealQrCodeRequest, cb?: (error: string, rep: CreateLegalSealQrCodeResponse) => void): Promise<CreateLegalSealQrCodeResponse>;
|
|
706
|
-
/**
|
|
707
|
-
* 对合同流程文件进行数字签名验证,判断数字签名是否有效,合同文件内容是否被篡改。
|
|
708
|
-
|
|
709
|
-
**补充**: 可以到控制台[合同验签](https://qian.tencent.com/verifySign)体验验签功能,界面如下
|
|
710
|
-

|
|
711
|
-
*/
|
|
712
|
-
ChannelVerifyPdf(req: ChannelVerifyPdfRequest, cb?: (error: string, rep: ChannelVerifyPdfResponse) => void): Promise<ChannelVerifyPdfResponse>;
|
|
713
|
-
/**
|
|
714
|
-
* 用来创建嵌入式页面个性化主题配置(例如是否展示电子签logo、定义主题色等),该接口配合其他所有可嵌入页面接口使用
|
|
715
|
-
创建配置对当前第三方应用全局生效,如果多次调用,会以最后一次的配置为准
|
|
716
|
-
*/
|
|
717
|
-
ChannelCreateWebThemeConfig(req: ChannelCreateWebThemeConfigRequest, cb?: (error: string, rep: ChannelCreateWebThemeConfigResponse) => void): Promise<ChannelCreateWebThemeConfigResponse>;
|
|
718
|
-
/**
|
|
719
|
-
* 该接口用于发起合同后,生成用户的签署链接 <br/>
|
|
720
|
-
|
|
721
|
-
**注意**
|
|
722
|
-
1. 该签署**链接有效期为30分钟**,过期后将失效,如需签署可重新创建签署链接 。
|
|
723
|
-
2. 该接口返回的签署链接适用于APP集成的场景,支持APP打开或浏览器直接打开,**不支持微信小程序嵌入**。配置方式请参考:<a href="https://qian.tencent.com/developers/company/openqianh5/">跳转电子签H5</a>。
|
|
724
|
-
如需跳转到小程序的实现,参考微信官方文档(分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式),如何配置也可以请参考: <a href="https://qian.tencent.com/developers/company/openwxminiprogram">跳转电子签小程序配置</a>。
|
|
725
|
-
3. 因h5涉及人脸身份认证能力基于慧眼人脸核身,对Android和iOS系统均有一定要求, 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
|
|
726
|
-
*/
|
|
727
|
-
ChannelCreateFlowSignUrl(req: ChannelCreateFlowSignUrlRequest, cb?: (error: string, rep: ChannelCreateFlowSignUrlResponse) => void): Promise<ChannelCreateFlowSignUrlResponse>;
|
|
728
1152
|
/**
|
|
729
1153
|
* 发起解除协议的主要应用场景为:基于一份已经签署的合同(签署流程),进行解除操作。
|
|
730
1154
|
解除协议的模板是官方提供,经过提供法务审核,暂不支持自定义。具体用法可以参考文档[合同解除](https://qian.tencent.com/developers/partner/flow_release)。
|
|
@@ -746,32 +1170,6 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
|
|
|
746
1170
|
**注**:通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/SyncProxyOrganizationOperators" target="_blank">企业员工新增或离职</a>接口增加的新员工或者离职的员工也会在列表中。
|
|
747
1171
|
*/
|
|
748
1172
|
ChannelDescribeEmployees(req: ChannelDescribeEmployeesRequest, cb?: (error: string, rep: ChannelDescribeEmployeesResponse) => void): Promise<ChannelDescribeEmployeesResponse>;
|
|
749
|
-
/**
|
|
750
|
-
* 创建企业注销链接
|
|
751
|
-
|
|
752
|
-
系统将返回操作链接。贵方需要主动联系并通知企业的超级管理员(超管)或法人。由他们点击该链接,完成企业的注销操作。
|
|
753
|
-
|
|
754
|
-
注意: `在调用此接口以管理企业扩展服务时,操作者( Agent.ProxyOperator.OpenId)必须是企业的超级管理员(超管)或法人。`
|
|
755
|
-
*/
|
|
756
|
-
CreateCloseOrganizationUrl(req: CreateCloseOrganizationUrlRequest, cb?: (error: string, rep: CreateCloseOrganizationUrlResponse) => void): Promise<CreateCloseOrganizationUrlResponse>;
|
|
757
|
-
/**
|
|
758
|
-
* 通过合同编号批量撤销合同,单次最多支持撤销100份合同。
|
|
759
|
-
|
|
760
|
-
适用场景:如果某个合同当前**至少还有一方没有签署**,则可通过该接口取消该合同流程。常用于合同发错、内容填错,需要及时撤销的场景。
|
|
761
|
-
|
|
762
|
-
- **可撤回合同状态**:未全部签署完成
|
|
763
|
-
- **不撤回合同状态**:已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
|
|
764
|
-
|
|
765
|
-
批量撤销结果可以通过接口返回的TaskId关联[批量撤销任务结果回调](https://qian.tencent.com/developers/partner/callback_types_contracts_sign#%E4%B9%9D-%E6%89%B9%E9%87%8F%E6%92%A4%E9%94%80%E7%BB%93%E6%9E%9C%E5%9B%9E%E8%B0%83)或通过接口[查询批量撤销合同结果](https://qian.tencent.com/developers/partnerApis/operateFlows/DescribeCancelFlowsTask)主动查询。
|
|
766
|
-
|
|
767
|
-
|
|
768
|
-
注:
|
|
769
|
-
- 有对应合同撤销权限的人: <font color='red'>**合同的发起人(并已经授予撤销权限)或者发起人所在企业的超管、法人**</font>
|
|
770
|
-
- 签署完毕的合同需要双方走解除流程将合同作废,可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>
|
|
771
|
-
- <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。</font>
|
|
772
|
-
- 撤销后可以看合同PDF内容的人员: 发起方的超管, 发起方自己,发起方撤销合同的操作人员,已经签署合同、已经填写合同、邀请填写已经补充信息的参与人员, 其他参与人员看不到合同的内容。
|
|
773
|
-
*/
|
|
774
|
-
ChannelBatchCancelFlows(req: ChannelBatchCancelFlowsRequest, cb?: (error: string, rep: ChannelBatchCancelFlowsResponse) => void): Promise<ChannelBatchCancelFlowsResponse>;
|
|
775
1173
|
/**
|
|
776
1174
|
* 该接口用于结束动态签署方2.0的合同流程。
|
|
777
1175
|
|
|
@@ -784,195 +1182,22 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
|
|
|
784
1182
|
*/
|
|
785
1183
|
ArchiveDynamicFlow(req: ArchiveDynamicFlowRequest, cb?: (error: string, rep: ArchiveDynamicFlowResponse) => void): Promise<ArchiveDynamicFlowResponse>;
|
|
786
1184
|
/**
|
|
787
|
-
*
|
|
788
|
-
|
|
789
|
-
|
|
790
|
-
|
|
791
|
-
PrepareFlows(req: PrepareFlowsRequest, cb?: (error: string, rep: PrepareFlowsResponse) => void): Promise<PrepareFlowsResponse>;
|
|
792
|
-
/**
|
|
793
|
-
* 创建跳转小程序查看或签署的链接
|
|
794
|
-
|
|
795
|
-
**腾讯电子签小程序的AppID 和 原始Id如下:**
|
|
796
|
-
|
|
797
|
-
| 小程序 | AppID | 原始ID |
|
|
798
|
-
| ------------ | ------------ | ------------ |
|
|
799
|
-
| 腾讯电子签(正式版) | wxa023b292fd19d41d | gh_da88f6188665 |
|
|
800
|
-
| 腾讯电子签Demo | wx371151823f6f3edf | gh_39a5d3de69fa |
|
|
801
|
-
|
|
802
|
-
**主要使用场景EndPoint分类**
|
|
803
|
-
|
|
804
|
-
|EndPoint| 场景| 说明和示例|
|
|
805
|
-
| ---- | ---- | --- |
|
|
806
|
-
| WEIXINAPP | 短链跳转腾讯电子签小程序签署场景 | 点击链接打开电子签小程序(与腾讯电子签官方短信提醒用户签署形式一样)<br> 示例: https://essurl.cn/x9nvWU8fTg|
|
|
807
|
-
| LONGURL2WEIXINAPP | 长链跳转腾讯电子签小程序签署场景 | 点击链接打开电子签小程序, 是WEIXINAPP生成短链代表的那个长链|
|
|
808
|
-
| CHANNEL | 带有H5引导页的跳转腾讯电子签小程序签署场景 | 点击链接打开一个H5引导页面, 页面中有个"前往小程序"的按钮, 点击后会跳转到腾讯电子签小程序签署场景; 签署完成会回到H5引导页面, 然后跳转到指定创建链接指定的JumpUrl<br>示例: https://res.ess.tencent.cn/cdn/h5-activity-beta/jump-mp.html?use=channel-guide&type=warning&token=uIFKIU8fTd |
|
|
809
|
-
|APP| <font color="red">贵方APP</font>跳转腾讯电子签小程序签署场景| 贵方App直接跳转到小程序后, 在腾讯电子签小程序签署完成后返回贵方App的场景<br>跳转到腾讯电子签小程序的实现可以参考微信的官方文档:<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/launchApp.html" target="_blank">开放能力/打开 App</a> <br> 示例: pages/guide?from=default&where=mini& to=CONTRACT_DETAIL& id=yDwiBUUc*duRvquCSX8wd& shortKey=yDwivUA**W1yRsTre3 |
|
|
810
|
-
|APP| <font color="red">贵方小程序</font>跳转腾讯电子签小程序签署场景| 贵方小程序直接跳转到小程序后, 在腾讯电子签小程序签署完成后返回贵方小程序的场景<br>跳转到腾讯电子签小程序的实现可以参考微信官方文档<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html" target="_blank">全屏方式</a>和<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html " target="_blank">半屏方式</a><br>此时返回的SignUrl就是官方文档中的path<br> 示例:pages/guide?from=default&where=mini& to=CONTRACT_DETAIL& id=yDwiBUUc*duRvquCSX8wd& shortKey=yDwivUA**W1yRsTre3 |
|
|
811
|
-
*/
|
|
812
|
-
CreateSignUrls(req: CreateSignUrlsRequest, cb?: (error: string, rep: CreateSignUrlsResponse) => void): Promise<CreateSignUrlsResponse>;
|
|
813
|
-
/**
|
|
814
|
-
* 此接口(GetDownloadFlowUrl)用户获取合同控制台下载页面链接, 点击链接后会跳转至本企业合同管理控制台(会筛选出传入的合同列表), 点击**下载**按钮后就会下载传入的合同列表, 下载页面如下图
|
|
815
|
-

|
|
816
|
-
|
|
817
|
-
注:
|
|
818
|
-
<ul>
|
|
819
|
-
<li>仅支持下载 <b>本企业</b> 下合同,链接会 <b>登录企业控制台</b> </li>
|
|
820
|
-
<li> <b>链接仅可使用一次</b>,不可重复使用</li>
|
|
821
|
-
</ul>
|
|
822
|
-
*/
|
|
823
|
-
GetDownloadFlowUrl(req: GetDownloadFlowUrlRequest, cb?: (error: string, rep: GetDownloadFlowUrlResponse) => void): Promise<GetDownloadFlowUrlResponse>;
|
|
824
|
-
/**
|
|
825
|
-
* **适用场景**:
|
|
826
|
-
当通过模板或文件发起合同时,若未指定企业签署人信息,则可调用此接口动态补充签署人。同一签署人只允许补充一人,最终实际签署人取决于谁先领取合同完成签署。
|
|
827
|
-
|
|
828
|
-
**接口使用说明**:
|
|
829
|
-
|
|
830
|
-
1.本接口现已支持批量补充签署人
|
|
831
|
-
|
|
832
|
-
2.当<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中指定需要补充的FlowId时,可以对指定合同补充签署人;可以指定多个相同发起方的不同合同在完成批量补充
|
|
833
|
-
|
|
834
|
-
3.当<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中指定需要补充的FlowId时,是对指定的合同补充多个指定的签署人
|
|
835
|
-
|
|
836
|
-
4.如果同时指定了<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId和<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId,仅使用<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId作为补充的合同
|
|
837
|
-
|
|
838
|
-
5.如果部分指定了<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId,又指定了<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId;那么<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>存在指定的FlowId,则使用<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId,不存在则使用<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId作为补充的合同
|
|
839
|
-
|
|
840
|
-
|
|
841
|
-
6.如果同时未指定了<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId和<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId,则传参错误
|
|
842
|
-
|
|
843
|
-
**限制条件**:
|
|
844
|
-
1. 本企业(发起方企业)企业签署人仅支持通过企业名称+姓名+手机号进行补充。
|
|
845
|
-
2. 个人签署人支持通过姓名+手机号进行补充,补充动态签署人时:若个人用户已完成实名,则可通过姓名+证件号码进行补充。
|
|
846
|
-
*/
|
|
847
|
-
ChannelCreateFlowApprovers(req: ChannelCreateFlowApproversRequest, cb?: (error: string, rep: ChannelCreateFlowApproversResponse) => void): Promise<ChannelCreateFlowApproversResponse>;
|
|
848
|
-
/**
|
|
849
|
-
* 获取个人用户认证证书图片下载URL
|
|
850
|
-
|
|
851
|
-
个人用户认证证书图片样式如下图
|
|
852
|
-
|
|
853
|
-

|
|
854
|
-
|
|
855
|
-
注:
|
|
856
|
-
<ul>
|
|
857
|
-
<li>只能获取个人用户证明图片, 企业员工的暂不支持</li>
|
|
858
|
-
<li>专为电子处方单(医疗自动签)特定场景使用。在使用前,请务必与您的客户经理联系以确认已经开通电子处方单功能 </li>
|
|
859
|
-
</ul>
|
|
860
|
-
*/
|
|
861
|
-
CreatePersonAuthCertificateImage(req: CreatePersonAuthCertificateImageRequest, cb?: (error: string, rep: CreatePersonAuthCertificateImageResponse) => void): Promise<CreatePersonAuthCertificateImageResponse>;
|
|
862
|
-
/**
|
|
863
|
-
* 创建一个用于他方自动签授权的链接(可选择他方授权或我方授权)。通过这个链接,合作方企业可以直接进入小程序,进行自动签授权操作。
|
|
864
|
-
|
|
865
|
-
如果授权企业尚未开通企业自动签功能,该链接还将引导他们首先开通本企业的自动签服务
|
|
866
|
-
|
|
867
|
-
|
|
868
|
-
注:
|
|
869
|
-
1. <font color='red'>所在企业的超管、法人才有权限调用此接口</font>(Agent.ProxyOperator.OpenId 需要传递超管或者法人的OpenId)
|
|
870
|
-
2. 已经在授权中或者授权成功的企业,无法重复授权
|
|
871
|
-
3. 授权企业和被授权企业必须都是已认证企业
|
|
872
|
-
4. <font color='red'>需要授权企业或被授权企业的超管或者法人打开链接</font>走开通逻辑。
|
|
873
|
-
|
|
874
|
-
**该接口效果同控制台: 企业设置-> 扩展服务 -> 企业自动签署 -> 合作企业方授权**
|
|
875
|
-

|
|
876
|
-
*/
|
|
877
|
-
CreatePartnerAutoSignAuthUrl(req: CreatePartnerAutoSignAuthUrlRequest, cb?: (error: string, rep: CreatePartnerAutoSignAuthUrlResponse) => void): Promise<CreatePartnerAutoSignAuthUrlResponse>;
|
|
878
|
-
/**
|
|
879
|
-
* 此接口(ChannelCreateRole)用来创建企业自定义角色。
|
|
880
|
-
|
|
881
|
-
适用场景1:创建当前企业的自定义角色,并且创建时不进行权限的设置(PermissionGroups 参数不传),角色中的权限内容可通过接口 ChannelModifyRole 完成更新。
|
|
882
|
-
|
|
883
|
-
适用场景2:创建当前企业的自定义角色,并且创建时进行权限的设置(PermissionGroups 参数要传),权限树内容 PermissionGroups 可参考[查询角色列表接口](https://qian.tencent.com/developers/partnerApis/accounts/ChannelDescribeRoles) 的输出。此处注意权限树内容可能会更新,需尽量拉取最新的权限树内容,并且权限树内容 PermissionGroups 必须是一颗完整的权限树。
|
|
884
|
-
*/
|
|
885
|
-
ChannelCreateRole(req: ChannelCreateRoleRequest, cb?: (error: string, rep: ChannelCreateRoleResponse) => void): Promise<ChannelCreateRoleResponse>;
|
|
886
|
-
/**
|
|
887
|
-
* 获取合同流程PDF的下载链接,可以下载签署中、签署完的此子企业创建的合同。
|
|
888
|
-
|
|
889
|
-
|
|
890
|
-
|
|
891
|
-
|
|
892
|
-
### 2. 确保合同的PDF已经合成后,再调用本接口。
|
|
893
|
-
用户创建合同或者提交签署动作后,后台需要1~3秒的时间就进行合同PDF合成或者签名,为了确保您下载的是签署完成的完整合同文件,我们建议采取下面两种方式的一种来<font color="red"><b>确保PDF已经合成完成,然后在调用本接口</b></font>。
|
|
894
|
-
|
|
895
|
-
**第一种**:请确保您的系统配置了[接收合同完成通知的回调](https://qian.tencent.com/developers/partner/callback_types_contracts_sign)功能。一旦所有参与方签署完毕,我们的系统将自动向您提供的回调地址发送完成通知。
|
|
896
|
-
|
|
897
|
-
**第二种**:通过调用我们的[获取合同信息](https://qian.tencent.com/developers/partnerApis/flows/DescribeFlowDetailInfo)接口来主动检查合同的签署状态。请仅在确认合同状态为“全部签署完成”后,进行文件的下载操作。
|
|
898
|
-
|
|
899
|
-
### 3. 链接具有有效期限
|
|
900
|
-
<font color="red"><b>生成的链接是有时间限制的,过期后将无法访问</b></font>。您可以在接口返回的信息中查看具体的过期时间。为避免错误,请确保在链接过期之前进行下载操作。
|
|
901
|
-
|
|
902
|
-
### 4. 有两种开通下载权限的途径。
|
|
903
|
-
|
|
904
|
-
**第一种**: 需第三方应用的子企业登录控制台进行授权, 授权在**企业中心**的**授权管理**区域, 界面如下图。
|
|
905
|
-
授权过程需要**子企业超管**扫描跳转到电子签小程序签署<<渠道端下载渠道子客合同功能授权委托书>>
|
|
906
|
-
|
|
907
|
-

|
|
908
|
-
|
|
909
|
-
**第二种**: 渠道方企业在**企业应用管理**的配置界面打开需要配置的应用,点击**应用扩展服务**开通此功能,需要**渠道方企业的超管**扫描二维码跳转到电子签小程序签署 <<渠道端下载渠道子客合同功能开通知情同意书>>
|
|
910
|
-
注:
|
|
911
|
-
1. `请注意如果第三方应用的子客主动关闭了渠道端下载渠道子客合同功能开关,那么渠道方开通了此功能也无法下载子客的合同文件`
|
|
912
|
-
|
|
913
|
-

|
|
914
|
-
*/
|
|
915
|
-
DescribeResourceUrlsByFlows(req: DescribeResourceUrlsByFlowsRequest, cb?: (error: string, rep: DescribeResourceUrlsByFlowsResponse) => void): Promise<DescribeResourceUrlsByFlowsResponse>;
|
|
916
|
-
/**
|
|
917
|
-
* 1. 在使用[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByFiles)或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates)创建合同组签署流程时,若指定了参数以下参数为true,则可以调用此接口提交企业内部签署审批结果,即使是自动签署也需要进行审核通过才会进行签署。
|
|
918
|
-
- [FlowInfo.NeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowinfo)
|
|
919
|
-
- [FlowFileInfo.NeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowfileinfo)
|
|
920
|
-
- [FlowApproverInfo.ApproverNeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowapproverinfo)
|
|
921
|
-
|
|
922
|
-
2. 同一合同组,同一签署人可以多次提交签署审批结果,签署时的最后一个“审批结果”有效。
|
|
923
|
-
*/
|
|
924
|
-
CreateFlowGroupSignReview(req: CreateFlowGroupSignReviewRequest, cb?: (error: string, rep: CreateFlowGroupSignReviewResponse) => void): Promise<CreateFlowGroupSignReviewResponse>;
|
|
925
|
-
/**
|
|
926
|
-
* 使用此接口,用来绑定企业实名员工的角色,
|
|
927
|
-
支持以电子签userId、客户系统openId两种方式进行绑定。
|
|
928
|
-
|
|
929
|
-
对应控制台的操作如下图
|
|
930
|
-

|
|
931
|
-
*/
|
|
932
|
-
ChannelCreateUserRoles(req: ChannelCreateUserRolesRequest, cb?: (error: string, rep: ChannelCreateUserRolesResponse) => void): Promise<ChannelCreateUserRolesResponse>;
|
|
933
|
-
/**
|
|
934
|
-
* 此接口(ChannelCancelUserAutoSignEnableUrl)用来撤销发送给个人用户的自动签开通链接,撤销后对应的个人用户开通链接失效。若个人用户已经完成开通,将无法撤销。(处方单场景专用,使用此接口请与客户经理确认)
|
|
935
|
-
*/
|
|
936
|
-
ChannelCancelUserAutoSignEnableUrl(req: ChannelCancelUserAutoSignEnableUrlRequest, cb?: (error: string, rep: ChannelCancelUserAutoSignEnableUrlResponse) => void): Promise<ChannelCancelUserAutoSignEnableUrlResponse>;
|
|
937
|
-
/**
|
|
938
|
-
* 生成用印申请审批链接,审批人可以通过此链接进入小程序进行审批。
|
|
939
|
-
p.s.
|
|
940
|
-
Agent参数中的OpenId 必须为审批者的openId,且链接必须由审批人打开。
|
|
941
|
-
*/
|
|
942
|
-
DescribeChannelSealPolicyWorkflowUrl(req: DescribeChannelSealPolicyWorkflowUrlRequest, cb?: (error: string, rep: DescribeChannelSealPolicyWorkflowUrlResponse) => void): Promise<DescribeChannelSealPolicyWorkflowUrlResponse>;
|
|
943
|
-
/**
|
|
944
|
-
* 查询渠道子客企业信息时,可以支持单个子客和整个应用下所有子客的查询。返回的信息包括超管、法人的信息以及当前企业的认证状态等信息。
|
|
945
|
-
|
|
946
|
-
- 对于单个企业的查询,通过**指定子客的唯一标识**来查询该子客的企业信息
|
|
947
|
-
- 对于整个应用下所有企业的查询,**不需要指定子客的唯一标识**,直接查询整个应用下所有子客企业的企业信息
|
|
948
|
-
*/
|
|
949
|
-
DescribeChannelOrganizations(req: DescribeChannelOrganizationsRequest, cb?: (error: string, rep: DescribeChannelOrganizationsResponse) => void): Promise<DescribeChannelOrganizationsResponse>;
|
|
950
|
-
/**
|
|
951
|
-
* 指定需要批量催办的签署流程ID,批量催办合同,最多100个。需要符合以下条件的合同才可被催办
|
|
952
|
-
1. 合同中当前状态为 **待签署** 的签署人是催办的对象
|
|
953
|
-
2. **每个合同只能催办一次**
|
|
954
|
-
|
|
955
|
-
**催办的效果**: 对方会收到如下的短信通知
|
|
956
|
-
|
|
957
|
-

|
|
958
|
-
|
|
1185
|
+
* 生成合成后的各类企业授权书,包括:
|
|
1186
|
+
- 企业认证超管授权书
|
|
1187
|
+
- 超管变更授权书
|
|
1188
|
+
- 企业注销授权书
|
|
959
1189
|
|
|
960
|
-
|
|
1190
|
+
注: 需自行保证传入真实的企业/法人/超管信息,否则后续的审核将会拒绝。
|
|
961
1191
|
*/
|
|
962
|
-
|
|
1192
|
+
CreateOrganizationAuthFile(req: CreateOrganizationAuthFileRequest, cb?: (error: string, rep: CreateOrganizationAuthFileResponse) => void): Promise<CreateOrganizationAuthFileResponse>;
|
|
963
1193
|
/**
|
|
964
|
-
*
|
|
965
|
-
|
|
966
|
-
注意:
|
|
967
|
-
- 使用此功能**需搭配出证套餐** ,使用前请联系对接的客户经理沟通。
|
|
968
|
-
- 操作人必须是**发起方或者签署方企业的(非走授权书认证)法人或者超管**。
|
|
969
|
-
- 合同流程必须**所有参与方已经签署完成**。
|
|
970
|
-
- 出证过程需一定时间,建议在**提交出证任务后的24小时之后**,通过<a href="https://qian.tencent.com/developers/partnerApis/certificate/DescribeChannelFlowEvidenceReport" target="_blank">获取出证报告任务执行结果</a>接口进行查询执行结果和出证报告的下载URL。
|
|
971
|
-
|
|
1194
|
+
* 使用此接口,用来绑定企业实名员工的角色,
|
|
1195
|
+
支持以电子签userId、客户系统openId两种方式进行绑定。
|
|
972
1196
|
|
|
973
|
-
|
|
1197
|
+
对应控制台的操作如下图
|
|
1198
|
+

|
|
974
1199
|
*/
|
|
975
|
-
|
|
1200
|
+
ChannelCreateUserRoles(req: ChannelCreateUserRolesRequest, cb?: (error: string, rep: ChannelCreateUserRolesResponse) => void): Promise<ChannelCreateUserRolesResponse>;
|
|
976
1201
|
/**
|
|
977
1202
|
* 接口(ChannelCreateFlowGroupByTemplates)用于通过多模板创建合同组签署流程。
|
|
978
1203
|
|
|
@@ -1041,91 +1266,6 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
|
|
|
1041
1266
|
### 7.合同组暂不支持抄送功能
|
|
1042
1267
|
*/
|
|
1043
1268
|
ChannelCreateFlowGroupByTemplates(req: ChannelCreateFlowGroupByTemplatesRequest, cb?: (error: string, rep: ChannelCreateFlowGroupByTemplatesResponse) => void): Promise<ChannelCreateFlowGroupByTemplatesResponse>;
|
|
1044
|
-
/**
|
|
1045
|
-
* 支持企业进行批量初始化操作:
|
|
1046
|
-
|
|
1047
|
-
此接口存在以下限制:
|
|
1048
|
-
1. 批量操作的企业需要已经完成电子签的认证流程。
|
|
1049
|
-
2. 通过此接口生成的链接在小程序端进行操作时,操作人需要是<font color="red">所有企业的超管或法人</font>。
|
|
1050
|
-
3. 批量操作的企业,需要是本方第三方应用下的企业。
|
|
1051
|
-
4. <font color="red">操作链接过期时间默认为生成链接后7天。</font>
|
|
1052
|
-
*/
|
|
1053
|
-
CreateBatchInitOrganizationUrl(req: CreateBatchInitOrganizationUrlRequest, cb?: (error: string, rep: CreateBatchInitOrganizationUrlResponse) => void): Promise<CreateBatchInitOrganizationUrlResponse>;
|
|
1054
|
-
/**
|
|
1055
|
-
* 此接口(CreateChannelOrganizationInfoChangeUrl)用于创建子客企业信息变更链接。
|
|
1056
|
-
|
|
1057
|
-
<h3 id="1">支持变更链接类型,通过入参 Endpoint 指定,默认为WEIXINAPP。</h3>
|
|
1058
|
-
|
|
1059
|
-
<h4 id="WEIXINAPP">WEIXINAPP</h4>
|
|
1060
|
-
<p>创建变更短链。需要在移动端打开,会跳转到微信腾讯电子签小程序进行更换。</p>
|
|
1061
|
-
|
|
1062
|
-
<h4 id="APP">APP</h4>
|
|
1063
|
-
<p>创建变更小程序链接,可从第三方App跳转到微信腾讯电子签小程序进行更换。</p>
|
|
1064
|
-
|
|
1065
|
-
|
|
1066
|
-
<h3 id="2">支持创建企业超管变更链接或企业基础信息变更链接,通过入参 ChangeType 指定。</h3>
|
|
1067
|
-
|
|
1068
|
-
<h4 id="1-企业超管变更">1. 企业超管变更</h4>
|
|
1069
|
-
|
|
1070
|
-
<p>换成企业的其他员工来当超管</p>
|
|
1071
|
-
|
|
1072
|
-
<h4 id="2-企业基础信息变更">2. 企业基础信息变更</h4>
|
|
1073
|
-
|
|
1074
|
-
<h5 id="可以变动">可以变动</h5>
|
|
1075
|
-
|
|
1076
|
-
<ul>
|
|
1077
|
-
<li>企业名称<br>
|
|
1078
|
-
</li>
|
|
1079
|
-
<li>法定代表人姓名(新法人有邀请链接)<br>
|
|
1080
|
-
</li>
|
|
1081
|
-
<li>企业地址和所在地</li>
|
|
1082
|
-
</ul>
|
|
1083
|
-
|
|
1084
|
-
<h5 id="不可变动">不可变动</h5>
|
|
1085
|
-
|
|
1086
|
-
<ul>
|
|
1087
|
-
<li>统一社会信用代码<br>
|
|
1088
|
-
</li>
|
|
1089
|
-
<li>企业主体类型</li>
|
|
1090
|
-
</ul>
|
|
1091
|
-
|
|
1092
|
-
<p>如果企业名称变动会引起下面的变动</p>
|
|
1093
|
-
|
|
1094
|
-
<ul>
|
|
1095
|
-
<li>合同: 老合同不做任何处理, 新发起的合同需要用新的企业名字作为签署方, 否则无法签署</li>
|
|
1096
|
-
<li>印章: 会删除所有的印章所有的机构公章,合同专用章,财务专用章和人事专用章, 然后用新企业名称生成新的机构公章,合同专用章,财务专用章和人事专用章, 而法人章不会处理</li>
|
|
1097
|
-
<li>证书: 企业证书会重新请求CA机构用新企业名称生成新的证书</li>
|
|
1098
|
-
</ul>
|
|
1099
|
-
|
|
1100
|
-
|
|
1101
|
-
注意:
|
|
1102
|
-
1. 生成的电子签小程序链接<font color='red'>只能由企业的法人或者超管</font>点击后进行操作, 其他员工打开后会提示“无权查看该内容”
|
|
1103
|
-
2. 法人可以无需生成链接,直接在电子签小程序中更换本企业的超管
|
|
1104
|
-
*/
|
|
1105
|
-
CreateChannelOrganizationInfoChangeUrl(req: CreateChannelOrganizationInfoChangeUrlRequest, cb?: (error: string, rep: CreateChannelOrganizationInfoChangeUrlResponse) => void): Promise<CreateChannelOrganizationInfoChangeUrlResponse>;
|
|
1106
|
-
/**
|
|
1107
|
-
* 此接口(SyncProxyOrganizationOperators)用于同步 第三方平台子客企业经办人列表,主要是同步经办人的离职状态。
|
|
1108
|
-
子客Web控制台的组织架构管理,依赖于第三方应用平台的,无法在页面针对员工做新增/更新/离职等操作, 必须通过 API 来操作。
|
|
1109
|
-
|
|
1110
|
-
- **新增员工的场景**: 通过本接口提前导入员工列表, 然后调用<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>分享给对应的员工进行实名, 新增员工后员工的状态为**未实名**, 通过链接实名后状态变为**已实名**, 已实名员工就可以参与合同的发起。
|
|
1111
|
-
|
|
1112
|
-
- **员工离职的场景**: 通过本接口将员工置为离职, 员工无法登录控制台和腾讯电子签小程序进行操作了, 同时给此员工分配的openid会被回收可以给其他新员工使用 (离职后员工数据会被置空, 再次加入公司会从零开始) , 若员工信息有误可通过离职后在新增来解决, 离职员工状态为**离职**。
|
|
1113
|
-
|
|
1114
|
-

|
|
1115
|
-
|
|
1116
|
-
**注**:
|
|
1117
|
-
- 新增员工可以配置白名单限制注册使用对应openid的员工必须满足SyncProxyOrganizationOperators导入的(默认生成子客登录链接生成的链接可以任意员工点击注册绑定对应的openid), 此白名单需要咨询接入经理
|
|
1118
|
-
- <font color='red'>超管和法人无法通过此接口离职</font>, 需要超管和法人将权限转移给其他人后才可通过此接口离职
|
|
1119
|
-
- 新增员工的场景同ID不同员工会覆盖掉上一个同ID的员工, 如果上一个员工已经实名则不会被覆盖
|
|
1120
|
-
*/
|
|
1121
|
-
SyncProxyOrganizationOperators(req: SyncProxyOrganizationOperatorsRequest, cb?: (error: string, rep: SyncProxyOrganizationOperatorsResponse) => void): Promise<SyncProxyOrganizationOperatorsResponse>;
|
|
1122
|
-
/**
|
|
1123
|
-
* 通过此接口(ChannelDescribeAccountBillDetail)查询该第三方平台子客账号计费详情。
|
|
1124
|
-
<ul>
|
|
1125
|
-
<li>对于渠道客户企业的查询,通过指定渠道企业的唯一标识(Agent.ProxyOrganizationId)来查询子客账号消耗详情</li>
|
|
1126
|
-
</ul>
|
|
1127
|
-
*/
|
|
1128
|
-
ChannelDescribeAccountBillDetail(req: ChannelDescribeAccountBillDetailRequest, cb?: (error: string, rep: ChannelDescribeAccountBillDetailResponse) => void): Promise<ChannelDescribeAccountBillDetailResponse>;
|
|
1129
1269
|
/**
|
|
1130
1270
|
* 获取出证报告任务执行结果,返回报告 URL。
|
|
1131
1271
|
|
|
@@ -1159,88 +1299,21 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
|
|
|
1159
1299
|
*/
|
|
1160
1300
|
OperateChannelTemplate(req: OperateChannelTemplateRequest, cb?: (error: string, rep: OperateChannelTemplateResponse) => void): Promise<OperateChannelTemplateResponse>;
|
|
1161
1301
|
/**
|
|
1162
|
-
|
|
1163
|
-
|
|
1164
|
-
ChannelCreatePreparedPersonalEsign(req: ChannelCreatePreparedPersonalEsignRequest, cb?: (error: string, rep: ChannelCreatePreparedPersonalEsignResponse) => void): Promise<ChannelCreatePreparedPersonalEsignResponse>;
|
|
1165
|
-
/**
|
|
1166
|
-
* 生成合成后的各类企业授权书,包括:
|
|
1167
|
-
- 企业认证超管授权书
|
|
1168
|
-
- 超管变更授权书
|
|
1169
|
-
- 企业注销授权书
|
|
1170
|
-
|
|
1171
|
-
注: 需自行保证传入真实的企业/法人/超管信息,否则后续的审核将会拒绝。
|
|
1172
|
-
*/
|
|
1173
|
-
CreateOrganizationAuthFile(req: CreateOrganizationAuthFileRequest, cb?: (error: string, rep: CreateOrganizationAuthFileResponse) => void): Promise<CreateOrganizationAuthFileResponse>;
|
|
1174
|
-
/**
|
|
1175
|
-
* 接口(ChannelCreateFlowGroupByFiles)用于使用 PDF 文件创建合同组签署流程。
|
|
1176
|
-
|
|
1177
|
-
- 该接口允许通过选择多个模板一次性创建多个合同,这些合同被组织在一个合同组中。
|
|
1178
|
-
- 每个签署方将收到一个签署链接,通过这个链接可以访问并签署合同组中的所有合同。
|
|
1179
|
-
- 合同组中的合同必须作为一个整体进行签署,不能将合同组拆分成单独的合同进行逐一签署。
|
|
1180
|
-
|
|
1181
|
-
<img src="https://qcloudimg.tencent-cloud.cn/raw/a63074a0293c9ff5bf6c0bb74c0d3b20.png" width="400" />
|
|
1182
|
-
|
|
1183
|
-
|
|
1184
|
-
### 2. 适用场景
|
|
1185
|
-
|
|
1186
|
-
该接口适用于需要一次性完成多份合同签署的情况,多份合同一般具有关联性,用户以目录的形式查看合同。
|
|
1187
|
-
|
|
1188
|
-
### 3. 发起方要求和签署方实名要求
|
|
1189
|
-
- **发起方要求**:作为合同发起方的第三方子企业A的员工必须进行实名认证。
|
|
1190
|
-
- **签署方要求**:签署方可以是多种身份(如第三方子企业的员工、个人、SaaS平台企业员工),其中企业和员工可以不进行实名认证。
|
|
1191
|
-
|
|
1192
|
-
**可以作为发起方和签署方的角色列表**
|
|
1193
|
-
|
|
1194
|
-
<table>
|
|
1195
|
-
<thead>
|
|
1196
|
-
<tr>
|
|
1197
|
-
<th>场景编号</th>
|
|
1198
|
-
<th>可作为发起方类型</th>
|
|
1199
|
-
<th>可作为签署方的类型</th>
|
|
1200
|
-
</tr>
|
|
1201
|
-
</thead>
|
|
1202
|
-
|
|
1203
|
-
<tbody>
|
|
1204
|
-
<tr>
|
|
1205
|
-
<td>场景一</td>
|
|
1206
|
-
<td>第三方子企业A员工</td>
|
|
1207
|
-
<td>第三方子企业A员工</td>
|
|
1208
|
-
</tr>
|
|
1209
|
-
|
|
1210
|
-
<tr>
|
|
1211
|
-
<td>场景二</td>
|
|
1212
|
-
<td>第三方子企业A员工</td>
|
|
1213
|
-
<td>第三方子企业B员工</td>
|
|
1214
|
-
</tr>
|
|
1215
|
-
|
|
1216
|
-
<tr>
|
|
1217
|
-
<td>场景三</td>
|
|
1218
|
-
<td>第三方子企业A员工</td>
|
|
1219
|
-
<td>个人/自然人</td>
|
|
1220
|
-
</tr>
|
|
1221
|
-
|
|
1222
|
-
<tr>
|
|
1223
|
-
<td>场景四</td>
|
|
1224
|
-
<td>第三方子企业A员工</td>
|
|
1225
|
-
<td>SaaS平台企业员工</td>
|
|
1226
|
-
</tr>
|
|
1227
|
-
</tbody>
|
|
1228
|
-
</table>
|
|
1302
|
+
* 此接口(SyncProxyOrganizationOperators)用于同步 第三方平台子客企业经办人列表,主要是同步经办人的离职状态。
|
|
1303
|
+
子客Web控制台的组织架构管理,依赖于第三方应用平台的,无法在页面针对员工做新增/更新/离职等操作, 必须通过 API 来操作。
|
|
1229
1304
|
|
|
1230
|
-
|
|
1231
|
-
- 根据签署方的不同类型(第三方子企业的员工、个人、SaaS平台企业员工),传递的参数也不同。具体参数的结构和要求可以参考开发者中心提供的 `FlowApproverInfo` 结构体说明。
|
|
1305
|
+
- **新增员工的场景**: 通过本接口提前导入员工列表, 然后调用<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>分享给对应的员工进行实名, 新增员工后员工的状态为**未实名**, 通过链接实名后状态变为**已实名**, 已实名员工就可以参与合同的发起。
|
|
1232
1306
|
|
|
1233
|
-
|
|
1234
|
-
- **扣减时机**:合同一旦发起,相关的合同额度就会被扣减,合同组下面的每个合同都要扣减一个合同额度。
|
|
1235
|
-
- **返还条件**:只有在合同被撤销且没有任何签署方签署过,或者只有自动签署的情况下,合同额度才会被返还。
|
|
1236
|
-
- **不返还的情况**:如果合同已过期、被拒签、签署完成或已解除,合同额度将不会被返还。
|
|
1307
|
+
- **员工离职的场景**: 通过本接口将员工置为离职, 员工无法登录控制台和腾讯电子签小程序进行操作了, 同时给此员工分配的openid会被回收可以给其他新员工使用 (离职后员工数据会被置空, 再次加入公司会从零开始) , 若员工信息有误可通过离职后在新增来解决, 离职员工状态为**离职**。
|
|
1237
1308
|
|
|
1238
|
-
|
|
1239
|
-
- 在使用静默(自动)签署功能时,合同签署方不能有填写控件。<font color="red">此接口静默签(企业自动签)能力为白名单功能</font>,使用前请联系对接的客户经理沟通。
|
|
1309
|
+

|
|
1240
1310
|
|
|
1241
|
-
|
|
1311
|
+
**注**:
|
|
1312
|
+
- 新增员工可以配置白名单限制注册使用对应openid的员工必须满足SyncProxyOrganizationOperators导入的(默认生成子客登录链接生成的链接可以任意员工点击注册绑定对应的openid), 此白名单需要咨询接入经理
|
|
1313
|
+
- <font color='red'>超管和法人无法通过此接口离职</font>, 需要超管和法人将权限转移给其他人后才可通过此接口离职
|
|
1314
|
+
- 新增员工的场景同ID不同员工会覆盖掉上一个同ID的员工, 如果上一个员工已经实名则不会被覆盖
|
|
1242
1315
|
*/
|
|
1243
|
-
|
|
1316
|
+
SyncProxyOrganizationOperators(req: SyncProxyOrganizationOperatorsRequest, cb?: (error: string, rep: SyncProxyOrganizationOperatorsResponse) => void): Promise<SyncProxyOrganizationOperatorsResponse>;
|
|
1244
1317
|
/**
|
|
1245
1318
|
* 本接口(ChannelCreateEmbedWebUrl)用于创建可嵌入web页面的URL(此web页面可以通过iframe方式嵌入到贵方系统的网页中),支持以下类型的Web链接创建:
|
|
1246
1319
|
1. 创建印章
|
|
@@ -1256,74 +1329,10 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
|
|
|
1256
1329
|

|
|
1257
1330
|
*/
|
|
1258
1331
|
ChannelCreateEmbedWebUrl(req: ChannelCreateEmbedWebUrlRequest, cb?: (error: string, rep: ChannelCreateEmbedWebUrlResponse) => void): Promise<ChannelCreateEmbedWebUrlResponse>;
|
|
1259
|
-
/**
|
|
1260
|
-
* 此接口用于查询合同或者合同组的详情信息,支持查询多个(数量不能超过100)。
|
|
1261
|
-
|
|
1262
|
-
适用场景:可用于主动查询某个合同或者合同组的详情信息。
|
|
1263
|
-
|
|
1264
|
-
注: `只能查询本企业创建的合同(创建合同用的Agent和此接口用的Agent数据最好一致) `
|
|
1265
|
-
*/
|
|
1266
|
-
DescribeFlowDetailInfo(req: DescribeFlowDetailInfoRequest, cb?: (error: string, rep: DescribeFlowDetailInfoResponse) => void): Promise<DescribeFlowDetailInfoResponse>;
|
|
1267
|
-
/**
|
|
1268
|
-
* 通过此接口(ChannelDescribeBillUsageDetail)查询该第三方平台子客企业的套餐消耗详情。可以支持单个子客和整个应用下所有子客的查询。
|
|
1269
|
-
<ul>
|
|
1270
|
-
<li>对于单个子客企业的查询,通过指定子客的唯一标识(Agent.ProxyOrganizationOpenId)来查询该子客消耗详情</li>
|
|
1271
|
-
<li>对于整个应用下所有企业的查询,不需要指定子客的唯一标识,只需要传入渠道应用标识(Agent.AppId)直接查询整个应用下所有子客企业消耗详情</li>
|
|
1272
|
-
</ul>
|
|
1273
|
-
*/
|
|
1274
|
-
ChannelDescribeBillUsageDetail(req: ChannelDescribeBillUsageDetailRequest, cb?: (error: string, rep: ChannelDescribeBillUsageDetailResponse) => void): Promise<ChannelDescribeBillUsageDetailResponse>;
|
|
1275
1332
|
/**
|
|
1276
1333
|
* 获取个人用户自动签的开通链接。
|
|
1277
1334
|
|
|
1278
1335
|
注意: `处方单等特殊场景专用,此接口为白名单功能,使用前请联系对接的客户经理沟通。`
|
|
1279
1336
|
*/
|
|
1280
1337
|
ChannelCreateUserAutoSignEnableUrl(req: ChannelCreateUserAutoSignEnableUrlRequest, cb?: (error: string, rep: ChannelCreateUserAutoSignEnableUrlResponse) => void): Promise<ChannelCreateUserAutoSignEnableUrlResponse>;
|
|
1281
|
-
/**
|
|
1282
|
-
* 批量清理未认证的企业认证流程。
|
|
1283
|
-
|
|
1284
|
-
此接口用来清除企业方认证信息填写错误,批量清理认证中的认证流信息。
|
|
1285
|
-
为接口[提交子企业批量认证链接创建任务](https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks) 和[查询子企业批量认证链接](https://qian.tencent.com/developers/partnerApis/accounts/DescribeBatchOrganizationRegistrationUrls) 接口的扩展接口。即在批量认证过程中,当发起认证企业发现超管信息错误的时候,可以将当前超管下的所有认证流企业清除。
|
|
1286
|
-
|
|
1287
|
-
注意:
|
|
1288
|
-
**这个接口的操作人必须跟生成批量认证链接接口的应用号一致,才可以调用,否则会返回当前操作人没有认证中的企业认证流**
|
|
1289
|
-
*/
|
|
1290
|
-
DeleteOrganizationAuthorizations(req: DeleteOrganizationAuthorizationsRequest, cb?: (error: string, rep: DeleteOrganizationAuthorizationsResponse) => void): Promise<DeleteOrganizationAuthorizationsResponse>;
|
|
1291
|
-
/**
|
|
1292
|
-
* 您可以通过合同流程ID查询相关的<font color="red"><b>填写控件</b></font>信息及其内容。这包括控件的归属方、控件的填写状态(是否已填写)以及具体的填写内容。
|
|
1293
|
-
|
|
1294
|
-
无论是<font color="red"><b>发起方还是签署方</b></font>填写的控件,均包含在查询结果中。
|
|
1295
|
-
|
|
1296
|
-

|
|
1297
|
-
### 2. 哪些控件会出现在结果里边?
|
|
1298
|
-
**A.不返回的控件类型:**
|
|
1299
|
-
- 动态表格
|
|
1300
|
-
- 附件控件
|
|
1301
|
-
- 水印控件
|
|
1302
|
-
|
|
1303
|
-
**B.返回的控件类型:**
|
|
1304
|
-
- 单行文本
|
|
1305
|
-
- 多行文本
|
|
1306
|
-
- 勾选框控件
|
|
1307
|
-
- 数字控件
|
|
1308
|
-
- 日期控件
|
|
1309
|
-
- 图片控件(图片下载地址)
|
|
1310
|
-
- 邮箱控件
|
|
1311
|
-
- 地址控件
|
|
1312
|
-
- 学历控件
|
|
1313
|
-
- 性别控件
|
|
1314
|
-
- 省市区控件
|
|
1315
|
-
|
|
1316
|
-
### 3.怎么授权?
|
|
1317
|
-
|
|
1318
|
-
此接口需要授权, 有两种开通权限的途径
|
|
1319
|
-
|
|
1320
|
-
**第一种**: 需第三方应用的子企业登录控制台进行授权, 授权在**企业中心**的**授权管理**区域, 界面如下图
|
|
1321
|
-
授权过程需要**子企业超管**扫描跳转到电子签小程序签署<<渠道端下载渠道子客合同功能授权委托书>>
|
|
1322
|
-
|
|
1323
|
-

|
|
1324
|
-
|
|
1325
|
-
**第二种**: 第三方应用的配置接口打开全第三个应用下的所有自己起开通, 需要**渠道方企业的超管**扫描二维码跳转到电子签小程序签署 <<渠道端下载渠道子客合同功能开通知情同意书>>
|
|
1326
|
-

|
|
1327
|
-
*/
|
|
1328
|
-
ChannelDescribeFlowComponents(req: ChannelDescribeFlowComponentsRequest, cb?: (error: string, rep: ChannelDescribeFlowComponentsResponse) => void): Promise<ChannelDescribeFlowComponentsResponse>;
|
|
1329
1338
|
}
|