-
Notifications
You must be signed in to change notification settings - Fork 127
/
EssClient.cs
3231 lines (3051 loc) · 219 KB
/
EssClient.cs
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
/*
* Copyright (c) 2018 THL A29 Limited, a Tencent company. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
namespace TencentCloud.Ess.V20201111
{
using Newtonsoft.Json;
using System.Threading.Tasks;
using TencentCloud.Common;
using TencentCloud.Common.Profile;
using TencentCloud.Ess.V20201111.Models;
public class EssClient : AbstractClient{
private const string endpoint = "ess.tencentcloudapi.com";
private const string version = "2020-11-11";
private const string sdkVersion = "SDK_NET_3.0.1033";
/// <summary>
/// Client constructor.
/// </summary>
/// <param name="credential">Credentials.</param>
/// <param name="region">Region name, such as "ap-guangzhou".</param>
public EssClient(Credential credential, string region)
: this(credential, region, new ClientProfile { Language = Language.ZH_CN })
{
}
/// <summary>
/// Client Constructor.
/// </summary>
/// <param name="credential">Credentials.</param>
/// <param name="region">Region name, such as "ap-guangzhou".</param>
/// <param name="profile">Client profiles.</param>
public EssClient(Credential credential, string region, ClientProfile profile)
: base(endpoint, version, credential, region, profile)
{
SdkVersion = sdkVersion;
}
/// <summary>
/// 此接口(BindEmployeeUserIdWithClientOpenId)用于将电子签系统员工UserId与客户系统员工OpenId进行绑定。
///
/// 此OpenId只在 [更新企业员工信息 ](https://qian.tencent.com/developers/companyApis/staffs/UpdateIntegrationEmployees)、[移除企业员工](https://qian.tencent.com/developers/companyApis/staffs/DeleteIntegrationEmployees) 等场景下可以使用
/// </summary>
/// <param name="req"><see cref="BindEmployeeUserIdWithClientOpenIdRequest"/></param>
/// <returns><see cref="BindEmployeeUserIdWithClientOpenIdResponse"/></returns>
public Task<BindEmployeeUserIdWithClientOpenIdResponse> BindEmployeeUserIdWithClientOpenId(BindEmployeeUserIdWithClientOpenIdRequest req)
{
return InternalRequestAsync<BindEmployeeUserIdWithClientOpenIdResponse>(req, "BindEmployeeUserIdWithClientOpenId");
}
/// <summary>
/// 此接口(BindEmployeeUserIdWithClientOpenId)用于将电子签系统员工UserId与客户系统员工OpenId进行绑定。
///
/// 此OpenId只在 [更新企业员工信息 ](https://qian.tencent.com/developers/companyApis/staffs/UpdateIntegrationEmployees)、[移除企业员工](https://qian.tencent.com/developers/companyApis/staffs/DeleteIntegrationEmployees) 等场景下可以使用
/// </summary>
/// <param name="req"><see cref="BindEmployeeUserIdWithClientOpenIdRequest"/></param>
/// <returns><see cref="BindEmployeeUserIdWithClientOpenIdResponse"/></returns>
public BindEmployeeUserIdWithClientOpenIdResponse BindEmployeeUserIdWithClientOpenIdSync(BindEmployeeUserIdWithClientOpenIdRequest req)
{
return InternalRequestAsync<BindEmployeeUserIdWithClientOpenIdResponse>(req, "BindEmployeeUserIdWithClientOpenId")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 用于撤销合同流程<br/>
/// 适用场景:如果某个合同流程当前至少还有一方没有签署,则可通过该接口取消该合同流程。常用于合同发错、内容填错,需要及时撤销的场景。<br/>
/// - **可撤回合同状态**:未全部签署完成
/// - **不撤回合同状态**:已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
///
/// 注:
/// 1. 如果合同流程中的参与方均已签署完毕,则无法通过该接口撤销合同,签署完毕的合同需要双方走解除流程将合同作废,可以参考<a href="https://qian.tencent.com/developers/companyApis/operateFlows/CreateReleaseFlow" target="_blank">发起解除合同流程</a>接口。
///
/// 2. 有对应合同撤销权限的人: <font color='red'>合同的发起人(并已经授予撤销权限)或者发起人所在企业的超管、法人</font>
/// ![image](https://qcloudimg.tencent-cloud.cn/raw/1f9f07fea6a70766cd286e0d58682ee2.png)
///
/// 3. <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。</font>
///
/// 4. 撤销后可以看合同PDF内容的人员: 发起方的超管, 发起方自己,发起方撤销合同的操作人员,已经签署合同、已经填写合同、邀请填写已经补充信息的参与人员
/// </summary>
/// <param name="req"><see cref="CancelFlowRequest"/></param>
/// <returns><see cref="CancelFlowResponse"/></returns>
public Task<CancelFlowResponse> CancelFlow(CancelFlowRequest req)
{
return InternalRequestAsync<CancelFlowResponse>(req, "CancelFlow");
}
/// <summary>
/// 用于撤销合同流程<br/>
/// 适用场景:如果某个合同流程当前至少还有一方没有签署,则可通过该接口取消该合同流程。常用于合同发错、内容填错,需要及时撤销的场景。<br/>
/// - **可撤回合同状态**:未全部签署完成
/// - **不撤回合同状态**:已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
///
/// 注:
/// 1. 如果合同流程中的参与方均已签署完毕,则无法通过该接口撤销合同,签署完毕的合同需要双方走解除流程将合同作废,可以参考<a href="https://qian.tencent.com/developers/companyApis/operateFlows/CreateReleaseFlow" target="_blank">发起解除合同流程</a>接口。
///
/// 2. 有对应合同撤销权限的人: <font color='red'>合同的发起人(并已经授予撤销权限)或者发起人所在企业的超管、法人</font>
/// ![image](https://qcloudimg.tencent-cloud.cn/raw/1f9f07fea6a70766cd286e0d58682ee2.png)
///
/// 3. <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。</font>
///
/// 4. 撤销后可以看合同PDF内容的人员: 发起方的超管, 发起方自己,发起方撤销合同的操作人员,已经签署合同、已经填写合同、邀请填写已经补充信息的参与人员
/// </summary>
/// <param name="req"><see cref="CancelFlowRequest"/></param>
/// <returns><see cref="CancelFlowResponse"/></returns>
public CancelFlowResponse CancelFlowSync(CancelFlowRequest req)
{
return InternalRequestAsync<CancelFlowResponse>(req, "CancelFlow")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 此接口(CancelMultiFlowSignQRCode)用于废除一码多签签署码。
/// 该接口所需的二维码ID,源自[创建一码多签签署码](https://qian.tencent.com/developers/companyApis/startFlows/CreateMultiFlowSignQRCode)生成的。
/// 如果该签署码尚处于有效期内,可通过本接口将其设置为失效状态。
/// </summary>
/// <param name="req"><see cref="CancelMultiFlowSignQRCodeRequest"/></param>
/// <returns><see cref="CancelMultiFlowSignQRCodeResponse"/></returns>
public Task<CancelMultiFlowSignQRCodeResponse> CancelMultiFlowSignQRCode(CancelMultiFlowSignQRCodeRequest req)
{
return InternalRequestAsync<CancelMultiFlowSignQRCodeResponse>(req, "CancelMultiFlowSignQRCode");
}
/// <summary>
/// 此接口(CancelMultiFlowSignQRCode)用于废除一码多签签署码。
/// 该接口所需的二维码ID,源自[创建一码多签签署码](https://qian.tencent.com/developers/companyApis/startFlows/CreateMultiFlowSignQRCode)生成的。
/// 如果该签署码尚处于有效期内,可通过本接口将其设置为失效状态。
/// </summary>
/// <param name="req"><see cref="CancelMultiFlowSignQRCodeRequest"/></param>
/// <returns><see cref="CancelMultiFlowSignQRCodeResponse"/></returns>
public CancelMultiFlowSignQRCodeResponse CancelMultiFlowSignQRCodeSync(CancelMultiFlowSignQRCodeRequest req)
{
return InternalRequestAsync<CancelMultiFlowSignQRCodeResponse>(req, "CancelMultiFlowSignQRCode")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 用来撤销<a href="https://qian.tencent.com/developers/companyApis/users/CreateUserAutoSignEnableUrl" target="_blank">获取个人用户自动签的开通状态</a>生成的开通链接,撤销生成的链接失效。
///
/// 注:
/// <ul><li>若个人用户已经用生成的完成自动签署的开通,撤销链接无效不会对开通结果产生影响(此情况接口会报错)。</li>
/// <li>处方单等特殊场景专用,此接口为白名单功能,使用前请联系对接的客户经理沟通。</li></ul>
/// </summary>
/// <param name="req"><see cref="CancelUserAutoSignEnableUrlRequest"/></param>
/// <returns><see cref="CancelUserAutoSignEnableUrlResponse"/></returns>
public Task<CancelUserAutoSignEnableUrlResponse> CancelUserAutoSignEnableUrl(CancelUserAutoSignEnableUrlRequest req)
{
return InternalRequestAsync<CancelUserAutoSignEnableUrlResponse>(req, "CancelUserAutoSignEnableUrl");
}
/// <summary>
/// 用来撤销<a href="https://qian.tencent.com/developers/companyApis/users/CreateUserAutoSignEnableUrl" target="_blank">获取个人用户自动签的开通状态</a>生成的开通链接,撤销生成的链接失效。
///
/// 注:
/// <ul><li>若个人用户已经用生成的完成自动签署的开通,撤销链接无效不会对开通结果产生影响(此情况接口会报错)。</li>
/// <li>处方单等特殊场景专用,此接口为白名单功能,使用前请联系对接的客户经理沟通。</li></ul>
/// </summary>
/// <param name="req"><see cref="CancelUserAutoSignEnableUrlRequest"/></param>
/// <returns><see cref="CancelUserAutoSignEnableUrlResponse"/></returns>
public CancelUserAutoSignEnableUrlResponse CancelUserAutoSignEnableUrlSync(CancelUserAutoSignEnableUrlRequest req)
{
return InternalRequestAsync<CancelUserAutoSignEnableUrlResponse>(req, "CancelUserAutoSignEnableUrl")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 指定需要批量撤回的签署流程Id,以获取批量撤销链接。
/// 客户需指定要撤回的签署流程Id,最多可指定100个,超过100则不处理。
/// 接口调用成功后,将返回批量撤回合同的链接。通过点击链接,可跳转至电子签小程序完成批量撤回操作。
///
/// - **可撤回合同状态**:未全部签署完成
/// - **不撤回合同状态**:已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
///
/// 批量撤销结果可以通过接口返回的TaskId关联[批量撤销任务结果回调](https://qian.tencent.com/developers/company/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/companyApis/operateFlows/CreateBatchCancelFlowUrl)
///
///
/// 注:
/// 1. 如果合同流程中的参与方均已签署完毕,则无法通过该接口撤销合同,签署完毕的合同需要双方走解除流程将合同作废,可以参考<a href="https://qian.tencent.com/developers/companyApis/operateFlows/CreateReleaseFlow" target="_blank">发起解除合同流程</a>接口。
///
/// 2. 有对应合同撤销权限的人: <font color='red'>合同的发起人(并已经授予撤销权限)或者发起人所在企业的超管、法人</font>
/// ![image](https://qcloudimg.tencent-cloud.cn/raw/1f9f07fea6a70766cd286e0d58682ee2.png)
///
/// 3. <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。</font>
/// </summary>
/// <param name="req"><see cref="CreateBatchCancelFlowUrlRequest"/></param>
/// <returns><see cref="CreateBatchCancelFlowUrlResponse"/></returns>
public Task<CreateBatchCancelFlowUrlResponse> CreateBatchCancelFlowUrl(CreateBatchCancelFlowUrlRequest req)
{
return InternalRequestAsync<CreateBatchCancelFlowUrlResponse>(req, "CreateBatchCancelFlowUrl");
}
/// <summary>
/// 指定需要批量撤回的签署流程Id,以获取批量撤销链接。
/// 客户需指定要撤回的签署流程Id,最多可指定100个,超过100则不处理。
/// 接口调用成功后,将返回批量撤回合同的链接。通过点击链接,可跳转至电子签小程序完成批量撤回操作。
///
/// - **可撤回合同状态**:未全部签署完成
/// - **不撤回合同状态**:已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
///
/// 批量撤销结果可以通过接口返回的TaskId关联[批量撤销任务结果回调](https://qian.tencent.com/developers/company/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/companyApis/operateFlows/CreateBatchCancelFlowUrl)
///
///
/// 注:
/// 1. 如果合同流程中的参与方均已签署完毕,则无法通过该接口撤销合同,签署完毕的合同需要双方走解除流程将合同作废,可以参考<a href="https://qian.tencent.com/developers/companyApis/operateFlows/CreateReleaseFlow" target="_blank">发起解除合同流程</a>接口。
///
/// 2. 有对应合同撤销权限的人: <font color='red'>合同的发起人(并已经授予撤销权限)或者发起人所在企业的超管、法人</font>
/// ![image](https://qcloudimg.tencent-cloud.cn/raw/1f9f07fea6a70766cd286e0d58682ee2.png)
///
/// 3. <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。</font>
/// </summary>
/// <param name="req"><see cref="CreateBatchCancelFlowUrlRequest"/></param>
/// <returns><see cref="CreateBatchCancelFlowUrlResponse"/></returns>
public CreateBatchCancelFlowUrlResponse CreateBatchCancelFlowUrlSync(CreateBatchCancelFlowUrlRequest req)
{
return InternalRequestAsync<CreateBatchCancelFlowUrlResponse>(req, "CreateBatchCancelFlowUrl")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 本接口(CreateBatchOrganizationRegistrationTasks)用于批量创建企业认证链接
/// 该接口为异步提交任务接口,需要跟查询企业批量认证链接(DescribeBatchOrganizationRegistrationUrls) 配合使用.
///
/// 批量创建链接有以下限制:
///
/// 1. 单次最多创建10个企业。
/// 2. 一天同一家企业最多创建8000家企业。
/// 3. 同一批创建的企业不能重复 其中包括 企业名称,企业统一信用代码
/// 4. 跳转到小程序的实现,参考微信官方文档(分为全屏、半屏两种方式),如何配置也可以请参考: 跳转电子签小程序配置
///
/// 注:
///
/// 1. **此接口需要购买单独的实名套餐包方可调用,如有需求请联系对接人员评估**
///
/// 2. 如果生成的链接是APP链接,跳转到小程序的实现,参考微信官方文档(分为<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>
///
///
/// **腾讯电子签小程序的AppID 和 原始Id如下:**
///
/// | 小程序 | AppID | 原始ID |
/// | --- | --- | --- |
/// | 腾讯电子签(正式版) | wxa023b292fd19d41d | gh_da88f6188665 |
/// | 腾讯电子签Demo | wx371151823f6f3edf | gh_39a5d3de69fa |
/// </summary>
/// <param name="req"><see cref="CreateBatchOrganizationRegistrationTasksRequest"/></param>
/// <returns><see cref="CreateBatchOrganizationRegistrationTasksResponse"/></returns>
public Task<CreateBatchOrganizationRegistrationTasksResponse> CreateBatchOrganizationRegistrationTasks(CreateBatchOrganizationRegistrationTasksRequest req)
{
return InternalRequestAsync<CreateBatchOrganizationRegistrationTasksResponse>(req, "CreateBatchOrganizationRegistrationTasks");
}
/// <summary>
/// 本接口(CreateBatchOrganizationRegistrationTasks)用于批量创建企业认证链接
/// 该接口为异步提交任务接口,需要跟查询企业批量认证链接(DescribeBatchOrganizationRegistrationUrls) 配合使用.
///
/// 批量创建链接有以下限制:
///
/// 1. 单次最多创建10个企业。
/// 2. 一天同一家企业最多创建8000家企业。
/// 3. 同一批创建的企业不能重复 其中包括 企业名称,企业统一信用代码
/// 4. 跳转到小程序的实现,参考微信官方文档(分为全屏、半屏两种方式),如何配置也可以请参考: 跳转电子签小程序配置
///
/// 注:
///
/// 1. **此接口需要购买单独的实名套餐包方可调用,如有需求请联系对接人员评估**
///
/// 2. 如果生成的链接是APP链接,跳转到小程序的实现,参考微信官方文档(分为<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>
///
///
/// **腾讯电子签小程序的AppID 和 原始Id如下:**
///
/// | 小程序 | AppID | 原始ID |
/// | --- | --- | --- |
/// | 腾讯电子签(正式版) | wxa023b292fd19d41d | gh_da88f6188665 |
/// | 腾讯电子签Demo | wx371151823f6f3edf | gh_39a5d3de69fa |
/// </summary>
/// <param name="req"><see cref="CreateBatchOrganizationRegistrationTasksRequest"/></param>
/// <returns><see cref="CreateBatchOrganizationRegistrationTasksResponse"/></returns>
public CreateBatchOrganizationRegistrationTasksResponse CreateBatchOrganizationRegistrationTasksSync(CreateBatchOrganizationRegistrationTasksRequest req)
{
return InternalRequestAsync<CreateBatchOrganizationRegistrationTasksResponse>(req, "CreateBatchOrganizationRegistrationTasks")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 该接口用于发起合同后,生成个人用户的批量签署链接, 暂时不支持企业端签署。
/// **注意:**
/// 1. 该接口目前仅支持签署人类型是**个人签署方的批量签署场景**(ApproverType=1)。
/// 2. 该接口可生成批量签署链接的C端签署人**必须仅有手写签名(控件类型为SIGN_SIGNATURE)和时间类型的签署控件**,**不支持填写控件** 。
/// 3. 请确保C端签署人在批量签署合同中**为待签署状态**,如需顺序签署请待前一位参与人签署完成后,再创建该C端用户的签署链接。
/// 4. 该签署链接**有效期为30分钟**,过期后将失效,如需签署可重新创建批量签署链接 。
/// 5. 该接口返回的签署链接适用于APP集成的场景,支持APP打开或浏览器直接打开,**不支持微信小程序嵌入**。
/// 跳转到小程序的实现,参考微信官方文档(分为<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>。
/// 6. 因h5涉及人脸身份认证能力基于慧眼人脸核身,对Android和iOS系统均有一定要求, 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
/// </summary>
/// <param name="req"><see cref="CreateBatchQuickSignUrlRequest"/></param>
/// <returns><see cref="CreateBatchQuickSignUrlResponse"/></returns>
public Task<CreateBatchQuickSignUrlResponse> CreateBatchQuickSignUrl(CreateBatchQuickSignUrlRequest req)
{
return InternalRequestAsync<CreateBatchQuickSignUrlResponse>(req, "CreateBatchQuickSignUrl");
}
/// <summary>
/// 该接口用于发起合同后,生成个人用户的批量签署链接, 暂时不支持企业端签署。
/// **注意:**
/// 1. 该接口目前仅支持签署人类型是**个人签署方的批量签署场景**(ApproverType=1)。
/// 2. 该接口可生成批量签署链接的C端签署人**必须仅有手写签名(控件类型为SIGN_SIGNATURE)和时间类型的签署控件**,**不支持填写控件** 。
/// 3. 请确保C端签署人在批量签署合同中**为待签署状态**,如需顺序签署请待前一位参与人签署完成后,再创建该C端用户的签署链接。
/// 4. 该签署链接**有效期为30分钟**,过期后将失效,如需签署可重新创建批量签署链接 。
/// 5. 该接口返回的签署链接适用于APP集成的场景,支持APP打开或浏览器直接打开,**不支持微信小程序嵌入**。
/// 跳转到小程序的实现,参考微信官方文档(分为<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>。
/// 6. 因h5涉及人脸身份认证能力基于慧眼人脸核身,对Android和iOS系统均有一定要求, 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
/// </summary>
/// <param name="req"><see cref="CreateBatchQuickSignUrlRequest"/></param>
/// <returns><see cref="CreateBatchQuickSignUrlResponse"/></returns>
public CreateBatchQuickSignUrlResponse CreateBatchQuickSignUrlSync(CreateBatchQuickSignUrlRequest req)
{
return InternalRequestAsync<CreateBatchQuickSignUrlResponse>(req, "CreateBatchQuickSignUrl")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 通过此接口,可以创建小程序批量签署链接,个人/企业员工可通过此链接跳转至小程序进行批量签署。请确保生成链接时的身份信息与签署合同参与方的信息保持一致。
///
/// 注意事项:
/// - 使用此接口生成链接,需要贵企业先开通 <font color="red">使用手机号验证签署方身份 </font>功能。您可以在 <b>【腾讯电子签网页端】->【企业设置】->【拓展服务】</b>中找到该功能。
/// - 生成批量签署链接时,<font color="red">合同目标参与方的状态必须为<b>待签署</b>状态</font>。签署人点击链接后需要输入短信验证码才能查看合同内容。
/// - 企业员工批量签署链接:需要传入签署方所在企业名称,用户名字和手机号(或者身份证件信息)参数来生成签署链接。<font color="red">该签署方企业必须已完成腾讯电子签企业认证</font>
/// - 个人批量签署链接:需要传入签署方用户名字和手机号(或者身份证件信息)参数来生成签署链接。个人批量签署进行的合同的签名区, 全部变成<font color="red">手写签名</font>(不管合同里边设置的签名限制)来进行。
/// </summary>
/// <param name="req"><see cref="CreateBatchSignUrlRequest"/></param>
/// <returns><see cref="CreateBatchSignUrlResponse"/></returns>
public Task<CreateBatchSignUrlResponse> CreateBatchSignUrl(CreateBatchSignUrlRequest req)
{
return InternalRequestAsync<CreateBatchSignUrlResponse>(req, "CreateBatchSignUrl");
}
/// <summary>
/// 通过此接口,可以创建小程序批量签署链接,个人/企业员工可通过此链接跳转至小程序进行批量签署。请确保生成链接时的身份信息与签署合同参与方的信息保持一致。
///
/// 注意事项:
/// - 使用此接口生成链接,需要贵企业先开通 <font color="red">使用手机号验证签署方身份 </font>功能。您可以在 <b>【腾讯电子签网页端】->【企业设置】->【拓展服务】</b>中找到该功能。
/// - 生成批量签署链接时,<font color="red">合同目标参与方的状态必须为<b>待签署</b>状态</font>。签署人点击链接后需要输入短信验证码才能查看合同内容。
/// - 企业员工批量签署链接:需要传入签署方所在企业名称,用户名字和手机号(或者身份证件信息)参数来生成签署链接。<font color="red">该签署方企业必须已完成腾讯电子签企业认证</font>
/// - 个人批量签署链接:需要传入签署方用户名字和手机号(或者身份证件信息)参数来生成签署链接。个人批量签署进行的合同的签名区, 全部变成<font color="red">手写签名</font>(不管合同里边设置的签名限制)来进行。
/// </summary>
/// <param name="req"><see cref="CreateBatchSignUrlRequest"/></param>
/// <returns><see cref="CreateBatchSignUrlResponse"/></returns>
public CreateBatchSignUrlResponse CreateBatchSignUrlSync(CreateBatchSignUrlRequest req)
{
return InternalRequestAsync<CreateBatchSignUrlResponse>(req, "CreateBatchSignUrl")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 此接口(CreateConvertTaskApi)用来将word、excel、html、图片、txt类型文件转换为PDF文件。<br />
/// 前提条件:源文件已经通过 <a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles" target="_blank">文件上传接口</a>完成上传,并得到了源文件的资源Id。<br />
/// 适用场景1:已经上传了一个word文件,希望将该word文件转换成pdf文件后发起合同
/// 适用场景2:已经上传了一个jpg图片文件,希望将该图片文件转换成pdf文件后发起合同<br />
/// 转换文件是一个耗时操作,若想查看转换任务是否完成,可以通过<a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/GetTaskResultApi" target="_blank">查询转换任务状态</a>接口获取任务状态。<br />
/// 注:
/// 1. `支持的文件类型有doc、docx、xls、xlsx、html、jpg、jpeg、png、bmp、txt`
/// 2. `可通过发起合同时设置预览来检查转换文件是否达到预期效果`
/// </summary>
/// <param name="req"><see cref="CreateConvertTaskApiRequest"/></param>
/// <returns><see cref="CreateConvertTaskApiResponse"/></returns>
public Task<CreateConvertTaskApiResponse> CreateConvertTaskApi(CreateConvertTaskApiRequest req)
{
return InternalRequestAsync<CreateConvertTaskApiResponse>(req, "CreateConvertTaskApi");
}
/// <summary>
/// 此接口(CreateConvertTaskApi)用来将word、excel、html、图片、txt类型文件转换为PDF文件。<br />
/// 前提条件:源文件已经通过 <a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles" target="_blank">文件上传接口</a>完成上传,并得到了源文件的资源Id。<br />
/// 适用场景1:已经上传了一个word文件,希望将该word文件转换成pdf文件后发起合同
/// 适用场景2:已经上传了一个jpg图片文件,希望将该图片文件转换成pdf文件后发起合同<br />
/// 转换文件是一个耗时操作,若想查看转换任务是否完成,可以通过<a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/GetTaskResultApi" target="_blank">查询转换任务状态</a>接口获取任务状态。<br />
/// 注:
/// 1. `支持的文件类型有doc、docx、xls、xlsx、html、jpg、jpeg、png、bmp、txt`
/// 2. `可通过发起合同时设置预览来检查转换文件是否达到预期效果`
/// </summary>
/// <param name="req"><see cref="CreateConvertTaskApiRequest"/></param>
/// <returns><see cref="CreateConvertTaskApiResponse"/></returns>
public CreateConvertTaskApiResponse CreateConvertTaskApiSync(CreateConvertTaskApiRequest req)
{
return InternalRequestAsync<CreateConvertTaskApiResponse>(req, "CreateConvertTaskApi")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 创建签署流程电子文档<br />
///
/// ### 调用流程
/// 该接口需要给对应的流程指定一个模板id,并且填充该模板中需要补充的信息。需要配置<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow" target="_blank">创建签署流程</a>和<a href="https://qian.tencent.com/developers/companyApis/startFlows/StartFlow" target="_blank">发起签署流程</a>接口使用。具体逻辑可以参考下图:
///
/// ![image](https://qcloudimg.tencent-cloud.cn/raw/06f2bc0f1772d8deac2f92b5df61a5ac.png)
///
///
/// ### 填充模板中定义的填写控件
/// 模板中配置的<font color="red">发起人填充控件</font>可以通过本接口的**FormFields数组**字段填充
///
/// ![image](https://qcloudimg.tencent-cloud.cn/raw/37457e0e450fc221effddfcb8b1bad55.png)
///
/// 填充的传参示例如下
///
/// ```
/// request.FormFields = [{
/// "ComponentName": "项目的名字",
/// "ComponentValue": "休闲山庄"
/// }, {
/// "ComponentName": "项目的地址",
/// "ComponentValue": "凤凰山北侧",
/// }, {
/// "ComponentName": "范围",
/// "ComponentValue": "凤凰山至107国道",
/// }, {
/// "ComponentName": "面积",
/// "ComponentValue": "100亩",
/// }, {
/// "ComponentName": "基本情况",
/// "ComponentValue": "完好",
/// }, , {
/// "ComponentName": "用途",
/// "ComponentValue": "经营农家乐",
/// }
/// ]
/// ```
/// 合成后合同样子示例
///
/// ![image](https://qcloudimg.tencent-cloud.cn/raw/140a2fb771ac66a185d0a000d37485f6.png)
/// </summary>
/// <param name="req"><see cref="CreateDocumentRequest"/></param>
/// <returns><see cref="CreateDocumentResponse"/></returns>
public Task<CreateDocumentResponse> CreateDocument(CreateDocumentRequest req)
{
return InternalRequestAsync<CreateDocumentResponse>(req, "CreateDocument");
}
/// <summary>
/// 创建签署流程电子文档<br />
///
/// ### 调用流程
/// 该接口需要给对应的流程指定一个模板id,并且填充该模板中需要补充的信息。需要配置<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow" target="_blank">创建签署流程</a>和<a href="https://qian.tencent.com/developers/companyApis/startFlows/StartFlow" target="_blank">发起签署流程</a>接口使用。具体逻辑可以参考下图:
///
/// ![image](https://qcloudimg.tencent-cloud.cn/raw/06f2bc0f1772d8deac2f92b5df61a5ac.png)
///
///
/// ### 填充模板中定义的填写控件
/// 模板中配置的<font color="red">发起人填充控件</font>可以通过本接口的**FormFields数组**字段填充
///
/// ![image](https://qcloudimg.tencent-cloud.cn/raw/37457e0e450fc221effddfcb8b1bad55.png)
///
/// 填充的传参示例如下
///
/// ```
/// request.FormFields = [{
/// "ComponentName": "项目的名字",
/// "ComponentValue": "休闲山庄"
/// }, {
/// "ComponentName": "项目的地址",
/// "ComponentValue": "凤凰山北侧",
/// }, {
/// "ComponentName": "范围",
/// "ComponentValue": "凤凰山至107国道",
/// }, {
/// "ComponentName": "面积",
/// "ComponentValue": "100亩",
/// }, {
/// "ComponentName": "基本情况",
/// "ComponentValue": "完好",
/// }, , {
/// "ComponentName": "用途",
/// "ComponentValue": "经营农家乐",
/// }
/// ]
/// ```
/// 合成后合同样子示例
///
/// ![image](https://qcloudimg.tencent-cloud.cn/raw/140a2fb771ac66a185d0a000d37485f6.png)
/// </summary>
/// <param name="req"><see cref="CreateDocumentRequest"/></param>
/// <returns><see cref="CreateDocumentResponse"/></returns>
public CreateDocumentResponse CreateDocumentSync(CreateDocumentRequest req)
{
return InternalRequestAsync<CreateDocumentResponse>(req, "CreateDocument")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 本接口(CreateEmbedWebUrl)用于创建嵌入Web的链接,支持以下类型的Web链接创建:
/// 1. 创建印章
/// 2. 创建模板
/// 3. 修改模板
/// 4. 预览模板
/// 5. 预览合同流程
///
/// 用户可以通过这些链接快速将其集成到自己的系统中。
/// </summary>
/// <param name="req"><see cref="CreateEmbedWebUrlRequest"/></param>
/// <returns><see cref="CreateEmbedWebUrlResponse"/></returns>
public Task<CreateEmbedWebUrlResponse> CreateEmbedWebUrl(CreateEmbedWebUrlRequest req)
{
return InternalRequestAsync<CreateEmbedWebUrlResponse>(req, "CreateEmbedWebUrl");
}
/// <summary>
/// 本接口(CreateEmbedWebUrl)用于创建嵌入Web的链接,支持以下类型的Web链接创建:
/// 1. 创建印章
/// 2. 创建模板
/// 3. 修改模板
/// 4. 预览模板
/// 5. 预览合同流程
///
/// 用户可以通过这些链接快速将其集成到自己的系统中。
/// </summary>
/// <param name="req"><see cref="CreateEmbedWebUrlRequest"/></param>
/// <returns><see cref="CreateEmbedWebUrlResponse"/></returns>
public CreateEmbedWebUrlResponse CreateEmbedWebUrlSync(CreateEmbedWebUrlRequest req)
{
return InternalRequestAsync<CreateEmbedWebUrlResponse>(req, "CreateEmbedWebUrl")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 创建企业扩展服务授权,当前仅支持授权 “企业自动签” 和 “批量签署” 给企业员工。
/// 该接口作用和电子签控制台 企业设置-扩展服务-企业自动签署和批量签署授权 两个模块功能相同,可通过该接口授权给企业员工。
///
/// 注:“企业自动签授权”支持集团代子企业操作,请联系运营开通此功能。
/// </summary>
/// <param name="req"><see cref="CreateExtendedServiceAuthInfosRequest"/></param>
/// <returns><see cref="CreateExtendedServiceAuthInfosResponse"/></returns>
public Task<CreateExtendedServiceAuthInfosResponse> CreateExtendedServiceAuthInfos(CreateExtendedServiceAuthInfosRequest req)
{
return InternalRequestAsync<CreateExtendedServiceAuthInfosResponse>(req, "CreateExtendedServiceAuthInfos");
}
/// <summary>
/// 创建企业扩展服务授权,当前仅支持授权 “企业自动签” 和 “批量签署” 给企业员工。
/// 该接口作用和电子签控制台 企业设置-扩展服务-企业自动签署和批量签署授权 两个模块功能相同,可通过该接口授权给企业员工。
///
/// 注:“企业自动签授权”支持集团代子企业操作,请联系运营开通此功能。
/// </summary>
/// <param name="req"><see cref="CreateExtendedServiceAuthInfosRequest"/></param>
/// <returns><see cref="CreateExtendedServiceAuthInfosResponse"/></returns>
public CreateExtendedServiceAuthInfosResponse CreateExtendedServiceAuthInfosSync(CreateExtendedServiceAuthInfosRequest req)
{
return InternalRequestAsync<CreateExtendedServiceAuthInfosResponse>(req, "CreateExtendedServiceAuthInfos")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 通过模板创建签署流程<br/>
/// 适用场景:在标准制式的合同场景中,可通过提前预制好模板文件,每次调用模板文件的id,补充合同内容信息及签署信息生成电子合同。
/// <table>
/// <thead>
/// <tr>
/// <th>签署人类别</th>
/// <th>需要提前准备的信息</th>
/// </tr>
/// </thead>
/// <tbody>
/// <tr>
/// <td>自己企业的员工签署(未认证加入或已认证加入)</td>
/// <td>签署企业的名字、员工的真实名字、员工的触达手机号、员工的证件号(证件号非必传)</td>
/// </tr>
/// <tr>
/// <td>自己企业的员工签署(已认证加入)</td>
/// <td>签署企业的名字、员工在电子签平台的ID(UserId)</td>
/// </tr>
/// <tr>
/// <td>其他企业的员工签署</td>
/// <td>签署企业的名字、员工的真实名字、员工的触达手机号、员工的证件号(证件号非必传)</td>
/// </tr>
/// <tr>
/// <td>个人(自然人)签署</td>
/// <td>个人的真实名字、个人的触达手机号、个人的身份证(证件号非必传)</td>
/// </tr>
/// </tbody>
/// </table>
///
///
/// 注:配合<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateDocument" target="_blank">创建电子文档</a>和<a href="https://qian.tencent.com/developers/companyApis/startFlows/StartFlow" target="_blank">发起签署流程</a>接口使用。整体的逻辑如下图
///
/// ![image](https://qcloudimg.tencent-cloud.cn/raw/06f2bc0f1772d8deac2f92b5df61a5ac.png)
///
/// 注:**静默(自动)签署不支持合同签署方存在填写**功能
/// <br>
///
/// <font color="red">相关视频指引</font> <br>
/// 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/createflow_seversign.mp4" target="_blank">创建静默(自动)签署模板和开通自动签署</a><br>
/// 2. <a href="https://dyn.ess.tencent.cn/guide/apivideo/flow_document_start.mp4" target="_blank">用模板创建发起合同</a><br>
/// </summary>
/// <param name="req"><see cref="CreateFlowRequest"/></param>
/// <returns><see cref="CreateFlowResponse"/></returns>
public Task<CreateFlowResponse> CreateFlow(CreateFlowRequest req)
{
return InternalRequestAsync<CreateFlowResponse>(req, "CreateFlow");
}
/// <summary>
/// 通过模板创建签署流程<br/>
/// 适用场景:在标准制式的合同场景中,可通过提前预制好模板文件,每次调用模板文件的id,补充合同内容信息及签署信息生成电子合同。
/// <table>
/// <thead>
/// <tr>
/// <th>签署人类别</th>
/// <th>需要提前准备的信息</th>
/// </tr>
/// </thead>
/// <tbody>
/// <tr>
/// <td>自己企业的员工签署(未认证加入或已认证加入)</td>
/// <td>签署企业的名字、员工的真实名字、员工的触达手机号、员工的证件号(证件号非必传)</td>
/// </tr>
/// <tr>
/// <td>自己企业的员工签署(已认证加入)</td>
/// <td>签署企业的名字、员工在电子签平台的ID(UserId)</td>
/// </tr>
/// <tr>
/// <td>其他企业的员工签署</td>
/// <td>签署企业的名字、员工的真实名字、员工的触达手机号、员工的证件号(证件号非必传)</td>
/// </tr>
/// <tr>
/// <td>个人(自然人)签署</td>
/// <td>个人的真实名字、个人的触达手机号、个人的身份证(证件号非必传)</td>
/// </tr>
/// </tbody>
/// </table>
///
///
/// 注:配合<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateDocument" target="_blank">创建电子文档</a>和<a href="https://qian.tencent.com/developers/companyApis/startFlows/StartFlow" target="_blank">发起签署流程</a>接口使用。整体的逻辑如下图
///
/// ![image](https://qcloudimg.tencent-cloud.cn/raw/06f2bc0f1772d8deac2f92b5df61a5ac.png)
///
/// 注:**静默(自动)签署不支持合同签署方存在填写**功能
/// <br>
///
/// <font color="red">相关视频指引</font> <br>
/// 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/createflow_seversign.mp4" target="_blank">创建静默(自动)签署模板和开通自动签署</a><br>
/// 2. <a href="https://dyn.ess.tencent.cn/guide/apivideo/flow_document_start.mp4" target="_blank">用模板创建发起合同</a><br>
/// </summary>
/// <param name="req"><see cref="CreateFlowRequest"/></param>
/// <returns><see cref="CreateFlowResponse"/></returns>
public CreateFlowResponse CreateFlowSync(CreateFlowRequest req)
{
return InternalRequestAsync<CreateFlowResponse>(req, "CreateFlow")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 适用场景: 当通过模板或文件发起合同时,若未指定企业签署人信息,则可调用此接口补充或添加签署人。同一签署人可补充多个员工作为或签署人,最终实际签署人取决于谁先领取合同完成签署。
///
/// 限制条件:
///
/// 1.本企业(发起方企业)企业微信签署人仅支持通过企业微信UserId或姓名+手机号进行补充。
/// 2.本企业(发起方企业)非企业微信签署人仅支持通过姓名+手机号进行补充。
/// 3.他方企业仅支持通过姓名+手机号进行补充。
/// 4.个人签署人支持通过姓名+手机号进行补充,补充动态签署人时:若个人用户已完成实名,则可通过姓名+证件号码进行补充。
/// </summary>
/// <param name="req"><see cref="CreateFlowApproversRequest"/></param>
/// <returns><see cref="CreateFlowApproversResponse"/></returns>
public Task<CreateFlowApproversResponse> CreateFlowApprovers(CreateFlowApproversRequest req)
{
return InternalRequestAsync<CreateFlowApproversResponse>(req, "CreateFlowApprovers");
}
/// <summary>
/// 适用场景: 当通过模板或文件发起合同时,若未指定企业签署人信息,则可调用此接口补充或添加签署人。同一签署人可补充多个员工作为或签署人,最终实际签署人取决于谁先领取合同完成签署。
///
/// 限制条件:
///
/// 1.本企业(发起方企业)企业微信签署人仅支持通过企业微信UserId或姓名+手机号进行补充。
/// 2.本企业(发起方企业)非企业微信签署人仅支持通过姓名+手机号进行补充。
/// 3.他方企业仅支持通过姓名+手机号进行补充。
/// 4.个人签署人支持通过姓名+手机号进行补充,补充动态签署人时:若个人用户已完成实名,则可通过姓名+证件号码进行补充。
/// </summary>
/// <param name="req"><see cref="CreateFlowApproversRequest"/></param>
/// <returns><see cref="CreateFlowApproversResponse"/></returns>
public CreateFlowApproversResponse CreateFlowApproversSync(CreateFlowApproversRequest req)
{
return InternalRequestAsync<CreateFlowApproversResponse>(req, "CreateFlowApprovers")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 获取区块链存证报告查看链接/二维码接口
///
/// 适用场景:企业员工可以通过此接口生成合同区块链存证报告的查看链接/二维码,以供他人扫码打开腾讯电子签小程序查看。
///
/// [点击查看区块链存证报告样式](https://qcloudimg.tencent-cloud.cn/raw/47d5e9c2ffa90ad4e27b3cd14095aa08.jpg)
///
/// 注:
/// <ul><li>1. 二维码下载链接过期时间为5分钟,请尽快下载保存。二维码/短链的过期时间为<font color="red">7天</font>,超过有效期则不可用。</li>
/// <li>2. 合同状态需为<font color="red">签署完成</font> 、<font color="red">已解除</font>才能生成报告查看二维码/短链。</li>
/// <li>3. 调用接口时,需确保接口调用身份拥有此合同的访问数据权限或为合同参与方。</li>
/// <li>4. 通过扫码或者点击链接,用户无需登录或者鉴权即可查看对应合同的区块链存证报告,请妥善保管好二维码或链接。</li></ul>
/// </summary>
/// <param name="req"><see cref="CreateFlowBlockchainEvidenceUrlRequest"/></param>
/// <returns><see cref="CreateFlowBlockchainEvidenceUrlResponse"/></returns>
public Task<CreateFlowBlockchainEvidenceUrlResponse> CreateFlowBlockchainEvidenceUrl(CreateFlowBlockchainEvidenceUrlRequest req)
{
return InternalRequestAsync<CreateFlowBlockchainEvidenceUrlResponse>(req, "CreateFlowBlockchainEvidenceUrl");
}
/// <summary>
/// 获取区块链存证报告查看链接/二维码接口
///
/// 适用场景:企业员工可以通过此接口生成合同区块链存证报告的查看链接/二维码,以供他人扫码打开腾讯电子签小程序查看。
///
/// [点击查看区块链存证报告样式](https://qcloudimg.tencent-cloud.cn/raw/47d5e9c2ffa90ad4e27b3cd14095aa08.jpg)
///
/// 注:
/// <ul><li>1. 二维码下载链接过期时间为5分钟,请尽快下载保存。二维码/短链的过期时间为<font color="red">7天</font>,超过有效期则不可用。</li>
/// <li>2. 合同状态需为<font color="red">签署完成</font> 、<font color="red">已解除</font>才能生成报告查看二维码/短链。</li>
/// <li>3. 调用接口时,需确保接口调用身份拥有此合同的访问数据权限或为合同参与方。</li>
/// <li>4. 通过扫码或者点击链接,用户无需登录或者鉴权即可查看对应合同的区块链存证报告,请妥善保管好二维码或链接。</li></ul>
/// </summary>
/// <param name="req"><see cref="CreateFlowBlockchainEvidenceUrlRequest"/></param>
/// <returns><see cref="CreateFlowBlockchainEvidenceUrlResponse"/></returns>
public CreateFlowBlockchainEvidenceUrlResponse CreateFlowBlockchainEvidenceUrlSync(CreateFlowBlockchainEvidenceUrlRequest req)
{
return InternalRequestAsync<CreateFlowBlockchainEvidenceUrlResponse>(req, "CreateFlowBlockchainEvidenceUrl")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 此接口(CreateFlowByFiles)用来通过上传后的pdf资源编号来创建待签署的合同流程。<br/>
/// 适用场景:适用非制式的合同文件签署。一般开发者自己有完整的签署文件,可以通过该接口传入完整的PDF文件及流程信息生成待签署的合同流程。<br/>
///
/// <table>
/// <thead>
/// <tr>
/// <th>签署人类别</th>
/// <th>需要提前准备的信息</th>
/// </tr>
/// </thead>
/// <tbody>
/// <tr>
/// <td>自己企业的员工签署(未认证加入或已认证加入)</td>
/// <td>签署企业的名字、员工的真实名字、员工的触达手机号、员工的证件号(证件号非必传)</td>
/// </tr>
/// <tr>
/// <td>自己企业的员工签署(已认证加入)</td>
/// <td>签署企业的名字、员工在电子签平台的ID(UserId)</td>
/// </tr>
/// <tr>
/// <td>其他企业的员工签署</td>
/// <td>签署企业的名字、员工的真实名字、员工的触达手机号、员工的证件号(证件号非必传)</td>
/// </tr>
/// <tr>
/// <td>个人(自然人)签署</td>
/// <td>个人的真实名字、个人的触达手机号、个人的身份证(证件号非必传)</td>
/// </tr>
/// </tbody>
/// </table>
///
///
///
/// 该接口需要依赖[上传文件](https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles)接口生成pdf资源编号(FileIds)进行使用。(如果非pdf文件需要调用[创建文件转换任务](https://qian.tencent.com/developers/companyApis/templatesAndFiles/CreateConvertTaskApi)接口转换成pdf资源)<br/>
///
///
/// ![image](https://qcloudimg.tencent-cloud.cn/raw/f097a74b289e3e1acd740936bdfe9843.png)
///
/// 注:
/// - 合同**发起后就会扣减合同的额度**, 只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。(**过期,拒签,签署完成,解除完成等状态不会返还额度**)
/// - **静默(自动)签署不支持合同签署方存在填写**功能
///
///
/// <font color="red">相关视频指引</font> <br>
/// 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/ess_uploadfiles.mp4" target="_blank">上传用于合同发起的PDF文件代码编写示例</a><br>
/// 2. <a href="https://dyn.ess.tencent.cn/guide/apivideo/ess-CreateFlowByFiles.mp4" target="_blank">用PDF文件创建签署流程编写示例</a><br>
/// </summary>
/// <param name="req"><see cref="CreateFlowByFilesRequest"/></param>
/// <returns><see cref="CreateFlowByFilesResponse"/></returns>
public Task<CreateFlowByFilesResponse> CreateFlowByFiles(CreateFlowByFilesRequest req)
{
return InternalRequestAsync<CreateFlowByFilesResponse>(req, "CreateFlowByFiles");
}
/// <summary>
/// 此接口(CreateFlowByFiles)用来通过上传后的pdf资源编号来创建待签署的合同流程。<br/>
/// 适用场景:适用非制式的合同文件签署。一般开发者自己有完整的签署文件,可以通过该接口传入完整的PDF文件及流程信息生成待签署的合同流程。<br/>
///
/// <table>
/// <thead>
/// <tr>
/// <th>签署人类别</th>
/// <th>需要提前准备的信息</th>
/// </tr>
/// </thead>
/// <tbody>
/// <tr>
/// <td>自己企业的员工签署(未认证加入或已认证加入)</td>
/// <td>签署企业的名字、员工的真实名字、员工的触达手机号、员工的证件号(证件号非必传)</td>
/// </tr>
/// <tr>
/// <td>自己企业的员工签署(已认证加入)</td>
/// <td>签署企业的名字、员工在电子签平台的ID(UserId)</td>
/// </tr>
/// <tr>
/// <td>其他企业的员工签署</td>
/// <td>签署企业的名字、员工的真实名字、员工的触达手机号、员工的证件号(证件号非必传)</td>
/// </tr>
/// <tr>
/// <td>个人(自然人)签署</td>
/// <td>个人的真实名字、个人的触达手机号、个人的身份证(证件号非必传)</td>
/// </tr>
/// </tbody>
/// </table>
///
///
///
/// 该接口需要依赖[上传文件](https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles)接口生成pdf资源编号(FileIds)进行使用。(如果非pdf文件需要调用[创建文件转换任务](https://qian.tencent.com/developers/companyApis/templatesAndFiles/CreateConvertTaskApi)接口转换成pdf资源)<br/>
///
///
/// ![image](https://qcloudimg.tencent-cloud.cn/raw/f097a74b289e3e1acd740936bdfe9843.png)
///
/// 注:
/// - 合同**发起后就会扣减合同的额度**, 只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。(**过期,拒签,签署完成,解除完成等状态不会返还额度**)
/// - **静默(自动)签署不支持合同签署方存在填写**功能
///
///
/// <font color="red">相关视频指引</font> <br>
/// 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/ess_uploadfiles.mp4" target="_blank">上传用于合同发起的PDF文件代码编写示例</a><br>
/// 2. <a href="https://dyn.ess.tencent.cn/guide/apivideo/ess-CreateFlowByFiles.mp4" target="_blank">用PDF文件创建签署流程编写示例</a><br>
/// </summary>
/// <param name="req"><see cref="CreateFlowByFilesRequest"/></param>
/// <returns><see cref="CreateFlowByFilesResponse"/></returns>
public CreateFlowByFilesResponse CreateFlowByFilesSync(CreateFlowByFilesRequest req)
{
return InternalRequestAsync<CreateFlowByFilesResponse>(req, "CreateFlowByFiles")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 提交申请出证报告任务并返回报告ID。
///
/// 注意:
/// <ul><li>使用此功能`需搭配出证套餐` ,使用前请联系对接的客户经理沟通。</li>
/// <li>操作人必须是`发起方或者签署方企业的(非走授权书认证)法人或者超管`。</li>
/// <li>合同流程必须所有参与方`已经签署完成`。</li>
/// <li>出证过程需一定时间,建议在`提交出证任务后的24小时之后`,通过<a href="https://qian.tencent.com/developers/companyApis/certificate/DescribeFlowEvidenceReport" target="_blank">获取出证报告任务执行结果</a>接口进行查询执行结果和出证报告的下载URL。</li></ul>
///
/// <svg id="SvgjsSvg1006" width="262" height="229" xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svgjs="http://svgjs.com/svgjs"><defs id="SvgjsDefs1007"><pattern patternUnits="userSpaceOnUse" id="pattern_mark_0" width="300" height="300"><text x="150" y="100" fill="rgba(229,229,229,0.8)" font-size="18" transform="rotate(-45, 150, 150)" style="dominant-baseline: middle; text-anchor: middle;"></text></pattern><pattern patternUnits="userSpaceOnUse" id="pattern_mark_1" width="300" height="300"><text x="150" y="200" fill="rgba(229,229,229,0.8)" font-size="18" transform="rotate(-45, 150, 150)" style="dominant-baseline: middle; text-anchor: middle;"></text></pattern><marker id="SvgjsMarker1021" markerWidth="12" markerHeight="8" refX="9" refY="4" viewBox="0 0 12 8" orient="auto" markerUnits="userSpaceOnUse" stroke-dasharray="0,0"><path id="SvgjsPath1022" d="M0,0 L12,4 L0,8 L0,0" fill="#323232" stroke="#323232" stroke-width="1"></path></marker></defs><rect id="svgbackgroundid" width="262" height="229" fill="transparent"></rect><rect id="SvgjsRect1009" width="262" height="229" fill="url(#pattern_mark_0)"></rect><rect id="SvgjsRect1010" width="262" height="229" fill="url(#pattern_mark_1)"></rect><g id="SvgjsG1011" transform="translate(31.75,25)"><path id="SvgjsPath1012" d="M 0 0L 198 0L 198 59L 0 59Z" stroke="rgba(86,146,48,1)" stroke-width="1" fill-opacity="1" fill="#e7ebed"></path><g id="SvgjsG1013"><text id="SvgjsText1014" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="178px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="10.375" transform="rotate(0)"><tspan id="SvgjsTspan1015" dy="16" x="99"><tspan id="SvgjsTspan1016" style="text-decoration:;fill: rgb(28, 30, 33);">CreateFlowEvidenceReport</tspan></tspan><tspan id="SvgjsTspan1017" dy="16" x="99"><tspan id="SvgjsTspan1018" style="text-decoration:;fill: rgb(51, 51, 51);">提交申请出证报告任务</tspan></tspan></text></g></g><g id="SvgjsG1019"><path id="SvgjsPath1020" d="M130.75 84.5L130.75 114.5L130.75 114.5L130.75 143.2" stroke="#323232" stroke-width="1" fill="none" marker-end="url(#SvgjsMarker1021)"></path></g><g id="SvgjsG1023" transform="translate(25,145)"><path id="SvgjsPath1024" d="M 0 0L 211.5 0L 211.5 59L 0 59Z" stroke="rgba(86,146,48,1)" stroke-width="1" fill-opacity="1" fill="#e7ebed"></path><g id="SvgjsG1025"><text id="SvgjsText1026" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="192px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="10.375" transform="rotate(0)"><tspan id="SvgjsTspan1027" dy="16" x="106"><tspan id="SvgjsTspan1028" style="text-decoration:;fill: rgb(28, 30, 33);">DescribeFlowEvidenceReport</tspan></tspan><tspan id="SvgjsTspan1029" dy="16" x="106"><tspan id="SvgjsTspan1030" style="text-decoration:;fill: rgb(51, 51, 51);">获取出证报告任务执行结果</tspan></tspan></text></g></g></svg>
/// </summary>
/// <param name="req"><see cref="CreateFlowEvidenceReportRequest"/></param>
/// <returns><see cref="CreateFlowEvidenceReportResponse"/></returns>
public Task<CreateFlowEvidenceReportResponse> CreateFlowEvidenceReport(CreateFlowEvidenceReportRequest req)
{
return InternalRequestAsync<CreateFlowEvidenceReportResponse>(req, "CreateFlowEvidenceReport");
}
/// <summary>
/// 提交申请出证报告任务并返回报告ID。
///
/// 注意:
/// <ul><li>使用此功能`需搭配出证套餐` ,使用前请联系对接的客户经理沟通。</li>
/// <li>操作人必须是`发起方或者签署方企业的(非走授权书认证)法人或者超管`。</li>
/// <li>合同流程必须所有参与方`已经签署完成`。</li>
/// <li>出证过程需一定时间,建议在`提交出证任务后的24小时之后`,通过<a href="https://qian.tencent.com/developers/companyApis/certificate/DescribeFlowEvidenceReport" target="_blank">获取出证报告任务执行结果</a>接口进行查询执行结果和出证报告的下载URL。</li></ul>
///
/// <svg id="SvgjsSvg1006" width="262" height="229" xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svgjs="http://svgjs.com/svgjs"><defs id="SvgjsDefs1007"><pattern patternUnits="userSpaceOnUse" id="pattern_mark_0" width="300" height="300"><text x="150" y="100" fill="rgba(229,229,229,0.8)" font-size="18" transform="rotate(-45, 150, 150)" style="dominant-baseline: middle; text-anchor: middle;"></text></pattern><pattern patternUnits="userSpaceOnUse" id="pattern_mark_1" width="300" height="300"><text x="150" y="200" fill="rgba(229,229,229,0.8)" font-size="18" transform="rotate(-45, 150, 150)" style="dominant-baseline: middle; text-anchor: middle;"></text></pattern><marker id="SvgjsMarker1021" markerWidth="12" markerHeight="8" refX="9" refY="4" viewBox="0 0 12 8" orient="auto" markerUnits="userSpaceOnUse" stroke-dasharray="0,0"><path id="SvgjsPath1022" d="M0,0 L12,4 L0,8 L0,0" fill="#323232" stroke="#323232" stroke-width="1"></path></marker></defs><rect id="svgbackgroundid" width="262" height="229" fill="transparent"></rect><rect id="SvgjsRect1009" width="262" height="229" fill="url(#pattern_mark_0)"></rect><rect id="SvgjsRect1010" width="262" height="229" fill="url(#pattern_mark_1)"></rect><g id="SvgjsG1011" transform="translate(31.75,25)"><path id="SvgjsPath1012" d="M 0 0L 198 0L 198 59L 0 59Z" stroke="rgba(86,146,48,1)" stroke-width="1" fill-opacity="1" fill="#e7ebed"></path><g id="SvgjsG1013"><text id="SvgjsText1014" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="178px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="10.375" transform="rotate(0)"><tspan id="SvgjsTspan1015" dy="16" x="99"><tspan id="SvgjsTspan1016" style="text-decoration:;fill: rgb(28, 30, 33);">CreateFlowEvidenceReport</tspan></tspan><tspan id="SvgjsTspan1017" dy="16" x="99"><tspan id="SvgjsTspan1018" style="text-decoration:;fill: rgb(51, 51, 51);">提交申请出证报告任务</tspan></tspan></text></g></g><g id="SvgjsG1019"><path id="SvgjsPath1020" d="M130.75 84.5L130.75 114.5L130.75 114.5L130.75 143.2" stroke="#323232" stroke-width="1" fill="none" marker-end="url(#SvgjsMarker1021)"></path></g><g id="SvgjsG1023" transform="translate(25,145)"><path id="SvgjsPath1024" d="M 0 0L 211.5 0L 211.5 59L 0 59Z" stroke="rgba(86,146,48,1)" stroke-width="1" fill-opacity="1" fill="#e7ebed"></path><g id="SvgjsG1025"><text id="SvgjsText1026" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="192px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="10.375" transform="rotate(0)"><tspan id="SvgjsTspan1027" dy="16" x="106"><tspan id="SvgjsTspan1028" style="text-decoration:;fill: rgb(28, 30, 33);">DescribeFlowEvidenceReport</tspan></tspan><tspan id="SvgjsTspan1029" dy="16" x="106"><tspan id="SvgjsTspan1030" style="text-decoration:;fill: rgb(51, 51, 51);">获取出证报告任务执行结果</tspan></tspan></text></g></g></svg>
/// </summary>
/// <param name="req"><see cref="CreateFlowEvidenceReportRequest"/></param>
/// <returns><see cref="CreateFlowEvidenceReportResponse"/></returns>
public CreateFlowEvidenceReportResponse CreateFlowEvidenceReportSync(CreateFlowEvidenceReportRequest req)
{
return InternalRequestAsync<CreateFlowEvidenceReportResponse>(req, "CreateFlowEvidenceReport")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 此接口(CreateFlowGroupByFiles)可用于通过多个文件创建合同组签署流程。
///
/// 适用场景:该接口适用于需要一次性完成多份合同签署的情况,多份合同一般具有关联性,用户以目录的形式查看合同。
///
/// 注意事项:使用该接口需要先依赖[多文件上传](https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles)接口返回的FileIds。
///
/// 注:`合同发起后就会扣减合同的额度, 如果未签署完成时撤销合同会返还此额度(过期,拒签,签署完成,解除完成等状态不会返还额度),合同组中每个合同会扣减一个合同额度`
/// </summary>
/// <param name="req"><see cref="CreateFlowGroupByFilesRequest"/></param>
/// <returns><see cref="CreateFlowGroupByFilesResponse"/></returns>
public Task<CreateFlowGroupByFilesResponse> CreateFlowGroupByFiles(CreateFlowGroupByFilesRequest req)
{
return InternalRequestAsync<CreateFlowGroupByFilesResponse>(req, "CreateFlowGroupByFiles");
}
/// <summary>
/// 此接口(CreateFlowGroupByFiles)可用于通过多个文件创建合同组签署流程。
///
/// 适用场景:该接口适用于需要一次性完成多份合同签署的情况,多份合同一般具有关联性,用户以目录的形式查看合同。
///
/// 注意事项:使用该接口需要先依赖[多文件上传](https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles)接口返回的FileIds。
///
/// 注:`合同发起后就会扣减合同的额度, 如果未签署完成时撤销合同会返还此额度(过期,拒签,签署完成,解除完成等状态不会返还额度),合同组中每个合同会扣减一个合同额度`
/// </summary>
/// <param name="req"><see cref="CreateFlowGroupByFilesRequest"/></param>
/// <returns><see cref="CreateFlowGroupByFilesResponse"/></returns>
public CreateFlowGroupByFilesResponse CreateFlowGroupByFilesSync(CreateFlowGroupByFilesRequest req)
{
return InternalRequestAsync<CreateFlowGroupByFilesResponse>(req, "CreateFlowGroupByFiles")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 此接口(CreateFlowGroupByTemplates)可用于通过多个模板创建合同组签署流程。
///
/// 适用场景:该接口适用于需要一次性完成多份合同签署的情况,多份合同一般具有关联性,用户以目录的形式查看合同。
///
/// 注:`合同发起后就会扣减合同的额度, 如果未签署完成时撤销合同会返还此额度(过期,拒签,签署完成,解除完成等状态不会返还额度),合同组中每个合同会扣减一个合同额度`
/// </summary>
/// <param name="req"><see cref="CreateFlowGroupByTemplatesRequest"/></param>
/// <returns><see cref="CreateFlowGroupByTemplatesResponse"/></returns>
public Task<CreateFlowGroupByTemplatesResponse> CreateFlowGroupByTemplates(CreateFlowGroupByTemplatesRequest req)
{
return InternalRequestAsync<CreateFlowGroupByTemplatesResponse>(req, "CreateFlowGroupByTemplates");
}
/// <summary>
/// 此接口(CreateFlowGroupByTemplates)可用于通过多个模板创建合同组签署流程。
///
/// 适用场景:该接口适用于需要一次性完成多份合同签署的情况,多份合同一般具有关联性,用户以目录的形式查看合同。
///
/// 注:`合同发起后就会扣减合同的额度, 如果未签署完成时撤销合同会返还此额度(过期,拒签,签署完成,解除完成等状态不会返还额度),合同组中每个合同会扣减一个合同额度`
/// </summary>
/// <param name="req"><see cref="CreateFlowGroupByTemplatesRequest"/></param>
/// <returns><see cref="CreateFlowGroupByTemplatesResponse"/></returns>
public CreateFlowGroupByTemplatesResponse CreateFlowGroupByTemplatesSync(CreateFlowGroupByTemplatesRequest req)
{
return InternalRequestAsync<CreateFlowGroupByTemplatesResponse>(req, "CreateFlowGroupByTemplates")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 提交合同组签署流程审批结果的适用场景包括:
///
/// 1. 在使用[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByFiles)或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByTemplates)创建合同组签署流程时,若指定了以下参数 为true,则可以调用此接口提交企业内部签署审批结果。即使是自动签署也需要进行审核通过才会进行签署。
/// - [FlowGroupInfo.NeedSignReview](https://qian.tencent.com/developers/companyApis/dataTypes/#flowgroupinfo)
/// - [ApproverInfo.ApproverNeedSignReview](https://qian.tencent.com/developers/companyApis/dataTypes/#approverinfo)
///
///
/// 2. 同一合同组,同一签署人可以多次提交签署审批结果,签署时的最后一个“审批结果”有效。
/// </summary>
/// <param name="req"><see cref="CreateFlowGroupSignReviewRequest"/></param>
/// <returns><see cref="CreateFlowGroupSignReviewResponse"/></returns>
public Task<CreateFlowGroupSignReviewResponse> CreateFlowGroupSignReview(CreateFlowGroupSignReviewRequest req)
{
return InternalRequestAsync<CreateFlowGroupSignReviewResponse>(req, "CreateFlowGroupSignReview");
}
/// <summary>
/// 提交合同组签署流程审批结果的适用场景包括:
///
/// 1. 在使用[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByFiles)或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByTemplates)创建合同组签署流程时,若指定了以下参数 为true,则可以调用此接口提交企业内部签署审批结果。即使是自动签署也需要进行审核通过才会进行签署。
/// - [FlowGroupInfo.NeedSignReview](https://qian.tencent.com/developers/companyApis/dataTypes/#flowgroupinfo)
/// - [ApproverInfo.ApproverNeedSignReview](https://qian.tencent.com/developers/companyApis/dataTypes/#approverinfo)
///
///
/// 2. 同一合同组,同一签署人可以多次提交签署审批结果,签署时的最后一个“审批结果”有效。
/// </summary>
/// <param name="req"><see cref="CreateFlowGroupSignReviewRequest"/></param>
/// <returns><see cref="CreateFlowGroupSignReviewResponse"/></returns>
public CreateFlowGroupSignReviewResponse CreateFlowGroupSignReviewSync(CreateFlowGroupSignReviewRequest req)
{
return InternalRequestAsync<CreateFlowGroupSignReviewResponse>(req, "CreateFlowGroupSignReview")
.ConfigureAwait(false).GetAwaiter().GetResult();
}
/// <summary>
/// 指定需要批量催办的签署流程ID,批量催办合同,最多100个。需要符合以下条件的合同才可被催办:
///
/// 1. 发起合同时,**签署人的NotifyType需设置为sms**
/// 2. 合同中当前状态为 **待签署** 的签署人是催办的对象
/// 3. **每个合同只能催办一次**
///
/// **催办的效果**: 对方会收到如下的短信通知
///
/// ![image](https://qcloudimg.tencent-cloud.cn/raw/3caf94b7f540fa5736270d38528d3a7b.png)
///
/// 注:`合同催办是白名单功能,请联系客户经理申请开白后使用`
/// </summary>
/// <param name="req"><see cref="CreateFlowRemindsRequest"/></param>
/// <returns><see cref="CreateFlowRemindsResponse"/></returns>
public Task<CreateFlowRemindsResponse> CreateFlowReminds(CreateFlowRemindsRequest req)
{