@satorijs/adapter-lark 3.11.9 → 3.12.0

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.
Files changed (52) hide show
  1. package/lib/bot.d.ts +5 -5
  2. package/lib/http.d.ts +6 -3
  3. package/lib/index.cjs +293 -223
  4. package/lib/types/acs.d.ts +4 -1
  5. package/lib/types/apaas.d.ts +152 -0
  6. package/lib/types/application.d.ts +20 -4
  7. package/lib/types/approval.d.ts +0 -13
  8. package/lib/types/attendance.d.ts +11 -5
  9. package/lib/types/authen.d.ts +8 -2
  10. package/lib/types/bitable.d.ts +25 -4
  11. package/lib/types/board.d.ts +17 -0
  12. package/lib/types/calendar.d.ts +16 -5
  13. package/lib/types/contact.d.ts +55 -12
  14. package/lib/types/corehr.d.ts +754 -142
  15. package/lib/types/drive.d.ts +20 -3
  16. package/lib/types/ehr.d.ts +11 -2
  17. package/lib/types/helpdesk.d.ts +15 -6
  18. package/lib/types/hire.d.ts +13 -13
  19. package/lib/types/human_authentication.d.ts +1 -1
  20. package/lib/types/im.d.ts +76 -20
  21. package/lib/types/index.d.ts +712 -115
  22. package/lib/types/mail.d.ts +106 -16
  23. package/lib/types/search.d.ts +4 -1
  24. package/lib/ws.d.ts +30 -0
  25. package/package.json +6 -3
  26. package/src/bot.ts +28 -15
  27. package/src/http.ts +10 -4
  28. package/src/types/acs.ts +4 -1
  29. package/src/types/apaas.ts +185 -0
  30. package/src/types/application.ts +20 -4
  31. package/src/types/approval.ts +0 -15
  32. package/src/types/attendance.ts +11 -5
  33. package/src/types/authen.ts +8 -2
  34. package/src/types/bitable.ts +25 -4
  35. package/src/types/board.ts +22 -0
  36. package/src/types/calendar.ts +16 -5
  37. package/src/types/contact.ts +55 -12
  38. package/src/types/corehr.ts +796 -142
  39. package/src/types/drive.ts +20 -3
  40. package/src/types/ehr.ts +11 -2
  41. package/src/types/helpdesk.ts +15 -6
  42. package/src/types/hire.ts +17 -17
  43. package/src/types/human_authentication.ts +1 -1
  44. package/src/types/im.ts +76 -20
  45. package/src/types/index.ts +738 -115
  46. package/src/types/mail.ts +106 -16
  47. package/src/types/search.ts +4 -1
  48. package/src/ws.ts +183 -0
  49. package/lib/types/api.d.ts +0 -28510
  50. package/lib/types/internal.d.ts +0 -21
  51. package/lib/types/message/content.d.ts +0 -433
  52. package/lib/types/message/index.d.ts +0 -95
package/src/types/corehr.ts CHANGED
@@ -43,6 +43,10 @@ export namespace Corehr {
43
43
  transferType: TransferType.Methods
44
44
  transferReason: TransferReason.Methods
45
45
  offboarding: Offboarding.Methods
46
+ signatureFile: SignatureFile.Methods
47
+ signatureNode: SignatureNode.Methods
48
+ signatureTemplate: SignatureTemplate.Methods
49
+ signatureTemplateInfoWithThumbnail: SignatureTemplateInfoWithThumbnail.Methods
46
50
  contract: Contract.Methods
47
51
  workforcePlanDetailRow: WorkforcePlanDetailRow.Methods
48
52
  reportDetailRow: ReportDetailRow.Methods
@@ -85,7 +89,10 @@ export namespace Corehr {
85
89
  }
86
90
 
87
91
  export interface QueryQuery {
88
- /** 所属对象 apiname，支持一个或多个当前数量限制为 20 个 */
92
+ /**
93
+ * 所属对象 apiname，支持一个或多个
94
+ * 当前数量限制为 20 个
95
+ */
89
96
  object_api_name_list: string[]
90
97
  }
91
98
 
@@ -128,9 +135,9 @@ export namespace Corehr {
128
135
  }
129
136
 
130
137
  export interface AddEnumOptionRequest {
131
- /** 所属对象 API name，可通过[获取飞书人事对象列表](/ssl:ttdoc/server-docs/corehr-v1/basic-infomation/custom_field/list_object_api_name)接口中返回的 `object_api_name` 字段获取 */
138
+ /** 所属对象 API name，可通过[获取飞书人事对象列表](https://open.feishu.cn/document/server-docs/corehr-v1/basic-infomation/custom_field/list_object_api_name)接口中返回的 `object_api_name` 字段获取 */
132
139
  object_api_name: string
133
- /** 枚举字段 API name，可通过[获取自定义字段列表](/ssl:ttdoc/server-docs/corehr-v1/basic-infomation/custom_field/query)接口中返回的 `custom_api_name` 字段获取 */
140
+ /** 枚举字段 API name，可通过[获取自定义字段列表](https://open.feishu.cn/document/server-docs/corehr-v1/basic-infomation/custom_field/query)接口中返回的 `custom_api_name` 字段获取 */
134
141
  enum_field_api_name: string
135
142
  /** 新增枚举选项列表 */
136
143
  enum_field_options: Lark.EnumFieldOption[]
@@ -149,9 +156,9 @@ export namespace Corehr {
149
156
  }
150
157
 
151
158
  export interface EditEnumOptionRequest {
152
- /** 所属对象 API name，可通过[获取飞书人事对象列表](/ssl:ttdoc/server-docs/corehr-v1/basic-infomation/custom_field/list_object_api_name)接口中返回的 `object_api_name` 字段获取 */
159
+ /** 所属对象 API name，可通过[获取飞书人事对象列表](https://open.feishu.cn/document/server-docs/corehr-v1/basic-infomation/custom_field/list_object_api_name)接口中返回的 `object_api_name` 字段获取 */
153
160
  object_api_name: string
154
- /** 枚举字段 API name，可通过[获取自定义字段列表](/ssl:ttdoc/server-docs/corehr-v1/basic-infomation/custom_field/query)接口中返回的 `custom_api_name` 字段获取 */
161
+ /** 枚举字段 API name，可通过[获取自定义字段列表](https://open.feishu.cn/document/server-docs/corehr-v1/basic-infomation/custom_field/query)接口中返回的 `custom_api_name` 字段获取 */
155
162
  enum_field_api_name: string
156
163
  /** 枚举选项 */
157
164
  enum_field_option: Lark.EnumFieldOption
@@ -264,7 +271,7 @@ export namespace Corehr {
264
271
  }
265
272
 
266
273
  export interface SearchRequest {
267
- /** 国家/地区 ID 列表，可从[批量查询地点](/ssl:ttdoc/server-docs/corehr-v1/organization-management/location/list)接口返回的 `location.address.country_region_id`、[搜索员工信息](/ssl:ttdoc/server-docs/corehr-v1/employee/search)接口返回的 `person_info.address_list.country_region_id` 等字段中获取 */
274
+ /** 国家/地区 ID 列表，可从[批量查询地点](https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/location/list)接口返回的 `location.address.country_region_id`、[搜索员工信息](https://open.feishu.cn/document/server-docs/corehr-v1/employee/search)接口返回的 `person_info.address_list.country_region_id` 等字段中获取 */
268
275
  country_region_id_list?: string[]
269
276
  /** 状态列表 */
270
277
  status_list?: SearchRequestStatus[]
@@ -314,9 +321,9 @@ export namespace Corehr {
314
321
  }
315
322
 
316
323
  export interface SearchRequest {
317
- /** 省份/主要行政区 ID 列表，可通过[查询省份/主要行政区信息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)接口列举，或从[批量查询地点](/ssl:ttdoc/server-docs/corehr-v1/organization-management/location/list)接口返回的 `location.address.region_id`、[搜索员工信息](/ssl:ttdoc/server-docs/corehr-v1/employee/search)接口返回的 `person_info.address_list.region_id` 等字段中获取 */
324
+ /** 省份/主要行政区 ID 列表，可通过[查询省份/主要行政区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)接口列举，或从[批量查询地点](https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/location/list)接口返回的 `location.address.region_id`、[搜索员工信息](https://open.feishu.cn/document/server-docs/corehr-v1/employee/search)接口返回的 `person_info.address_list.region_id` 等字段中获取 */
318
325
  country_region_subdivision_id_list?: string[]
319
- /** 城市 ID 列表，可从[批量查询地点](/ssl:ttdoc/server-docs/corehr-v1/organization-management/location/list)接口返回的 `location.address.city_id_v2`、[搜索员工信息](/ssl:ttdoc/server-docs/corehr-v1/employee/search)接口返回的 `person_info.address_list.city_id_v2` 等字段中获取 */
326
+ /** 城市 ID 列表，可从[批量查询地点](https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/location/list)接口返回的 `location.address.city_id_v2`、[搜索员工信息](https://open.feishu.cn/document/server-docs/corehr-v1/employee/search)接口返回的 `person_info.address_list.city_id_v2` 等字段中获取 */
320
327
  city_id_list?: string[]
321
328
  /** 状态列表 */
322
329
  status_list?: SearchRequestStatus[]
@@ -340,9 +347,9 @@ export namespace Corehr {
340
347
  }
341
348
 
342
349
  export interface SearchRequest {
343
- /** 所属城市 ID 列表，可通过[查询城市信息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-city/search)接口列举，或从[批量查询地点](/ssl:ttdoc/server-docs/corehr-v1/organization-management/location/list)接口返回的 `location.address.city_v2_id`、[搜索员工信息](/ssl:ttdoc/server-docs/corehr-v1/employee/search)接口返回的 `person_info.address_list.city_v2_id` 等字段中获取 */
350
+ /** 所属城市 ID 列表，可通过[查询城市信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-city/search)接口列举，或从[批量查询地点](https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/location/list)接口返回的 `location.address.city_v2_id`、[搜索员工信息](https://open.feishu.cn/document/server-docs/corehr-v1/employee/search)接口返回的 `person_info.address_list.city_v2_id` 等字段中获取 */
344
351
  city_id_list?: string[]
345
- /** 区/县 ID 列表，可从[批量查询地点](/ssl:ttdoc/server-docs/corehr-v1/organization-management/location/list)接口返回的 `location.address.district_id_v2`、[搜索员工信息](/ssl:ttdoc/server-docs/corehr-v1/employee/search)接口返回的 `person_info.address_list.district_id_v2` 等字段中获取 */
352
+ /** 区/县 ID 列表，可从[批量查询地点](https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/location/list)接口返回的 `location.address.district_id_v2`、[搜索员工信息](https://open.feishu.cn/document/server-docs/corehr-v1/employee/search)接口返回的 `person_info.address_list.district_id_v2` 等字段中获取 */
346
353
  district_id_list?: string[]
347
354
  /** 状态列表 */
348
355
  status_list?: SearchRequestStatus[]
@@ -366,9 +373,9 @@ export namespace Corehr {
366
373
  }
367
374
 
368
375
  export interface SearchRequest {
369
- /** 国籍 ID 列表，可从[搜索员工信息](/ssl:ttdoc/server-docs/corehr-v1/employee/search)接口返回的 `person_info.nationality_id_v2` 等字段中获取 */
376
+ /** 国籍 ID 列表，可从[搜索员工信息](https://open.feishu.cn/document/server-docs/corehr-v1/employee/search)接口返回的 `person_info.nationality_id_v2` 等字段中获取 */
370
377
  nationality_id_list?: string[]
371
- /** 国家/地区 ID 列表，可通过[查询国家/地区信息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口列举 */
378
+ /** 国家/地区 ID 列表，可通过[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口列举 */
372
379
  country_region_id_list?: string[]
373
380
  /** 状态列表 */
374
381
  status_list?: SearchRequestStatus[]
@@ -392,7 +399,7 @@ export namespace Corehr {
392
399
  }
393
400
 
394
401
  export interface SearchRequest {
395
- /** 银行 ID 列表，可通过[搜索员工信息](/ssl:ttdoc/server-docs/corehr-v1/employee/search)、[批量查询员工信息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)等接口返回的 `person_info.bank_account_list.bank_id_v2` 字段获取 */
402
+ /** 银行 ID 列表，可通过[搜索员工信息](https://open.feishu.cn/document/server-docs/corehr-v1/employee/search)、[批量查询员工信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)等接口返回的 `person_info.bank_account_list.bank_id_v2` 字段获取 */
396
403
  bank_id_list?: string[]
397
404
  /** 银行名称列表，支持对银行名称精确搜索 */
398
405
  bank_name_list?: string[]
@@ -422,9 +429,9 @@ export namespace Corehr {
422
429
  }
423
430
 
424
431
  export interface SearchRequest {
425
- /** 银行 ID 列表，可通过[查询银行信息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-bank/search)列举，或从[搜索员工信息](/ssl:ttdoc/server-docs/corehr-v1/employee/search)、[批量查询员工信息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)等接口返回的 `person_info.bank_account_list.bank_id_v2` 字段中获取 */
432
+ /** 银行 ID 列表，可通过[查询银行信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-bank/search)列举，或从[搜索员工信息](https://open.feishu.cn/document/server-docs/corehr-v1/employee/search)、[批量查询员工信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)等接口返回的 `person_info.bank_account_list.bank_id_v2` 字段中获取 */
426
433
  bank_id_list?: string[]
427
- /** 支行 ID 列表，可通过[搜索员工信息](/ssl:ttdoc/server-docs/corehr-v1/employee/search)、[批量查询员工信息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)等接口返回的 `person_info.bank_account_list.bank_branch_id_v2` 字段获取 */
434
+ /** 支行 ID 列表，可通过[搜索员工信息](https://open.feishu.cn/document/server-docs/corehr-v1/employee/search)、[批量查询员工信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)等接口返回的 `person_info.bank_account_list.bank_branch_id_v2` 字段获取 */
428
435
  bank_branch_id_list?: string[]
429
436
  /** 支行名称列表，支持对支行名称精确搜索 */
430
437
  bank_branch_name_list?: string[]
@@ -456,7 +463,7 @@ export namespace Corehr {
456
463
  }
457
464
 
458
465
  export interface SearchRequest {
459
- /** 货币 ID 列表，可通过[批量查询薪资方案](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/compensation-v1/plan/list)、[批量查询员工薪资档案](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/compensation-v1/archive/query)等接口返回的 `currency_id` 字段获取 */
466
+ /** 货币 ID 列表，可通过[批量查询薪资方案](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/compensation-v1/plan/list)、[批量查询员工薪资档案](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/compensation-v1/archive/query)等接口返回的 `currency_id` 字段获取 */
460
467
  currency_id_list?: string[]
461
468
  /** 状态列表 */
462
469
  status_list?: SearchRequestStatus[]
@@ -865,37 +872,98 @@ export namespace Corehr {
865
872
  additional_national_id_number_list?: string[]
866
873
  /** 公民身份类型列表，精确匹配查询 */
867
874
  citizenship_status_list?: string[]
868
- /** 成本中心 ID 列表- 可通过 [【搜索成本中心信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search) 获取 */
875
+ /**
876
+ * 成本中心 ID 列表
877
+ * - 可通过 [【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search) 获取
878
+ */
869
879
  cost_center_id_list?: string[]
870
- /** 任职公司 ID 列表- [【批量查询公司】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取 */
880
+ /**
881
+ * 任职公司 ID 列表
882
+ * - [【批量查询公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取
883
+ */
871
884
  service_company_list?: string[]
872
- /** 任职公司 ID 列表（含下级）- [【批量查询公司】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取 */
885
+ /**
886
+ * 任职公司 ID 列表（含下级）
887
+ * - [【批量查询公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取
888
+ */
873
889
  service_company_list_include_sub?: string[]
874
- /** 序列 ID 列表 - [【批量查询序列】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取 */
890
+ /**
891
+ * 序列 ID 列表
892
+ * - [【批量查询序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取
893
+ */
875
894
  job_family_id_list?: string[]
876
- /** 序列 ID 列表（含下级） - [【批量查询序列】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取 */
895
+ /**
896
+ * 序列 ID 列表（含下级）
897
+ * - [【批量查询序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取
898
+ */
877
899
  job_family_id_list_include_sub?: string[]
878
- /** 职级 ID 列表- 可通过[【批量查询职级】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取- 需要有字段读取权限 */
900
+ /**
901
+ * 职级 ID 列表
902
+ * - 可通过[【批量查询职级】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取
903
+ * - 需要有字段读取权限
904
+ */
879
905
  job_level_id_list?: string[]
880
- /** 职等 ID 列表- 可通过[【查询职等】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)获取- 需要有字段读取权限 */
906
+ /**
907
+ * 职等 ID 列表
908
+ * - 可通过[【查询职等】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)获取
909
+ * - 需要有字段读取权限
910
+ */
881
911
  job_grade_id_list?: string[]
882
- /** 职务 ID 列表- 可通过[【批量查询职务】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取- 需要有字段读取权限 */
912
+ /**
913
+ * 职务 ID 列表
914
+ * - 可通过[【批量查询职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取
915
+ * - 需要有字段读取权限
916
+ */
883
917
  job_id_list?: string[]
884
- /** 岗位 ID 列表 - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) - 需要有字段读取权限 */
918
+ /**
919
+ * 岗位 ID 列表
920
+ * - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
921
+ * - 需要有字段读取权限
922
+ */
885
923
  position_id_list?: string[]
886
- /** 岗位 ID 列表（含下级） - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) - 需要有字段读取权限 */
924
+ /**
925
+ * 岗位 ID 列表（含下级）
926
+ * - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
927
+ * - 需要有字段读取权限
928
+ */
887
929
  position_id_list_include_sub?: string[]
888
- /** 工时制度 ID 列表- 可通过[【批量查询工时制度】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取- 需要有字段读取权限 */
930
+ /**
931
+ * 工时制度 ID 列表
932
+ * - 可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取
933
+ * - 需要有字段读取权限
934
+ */
889
935
  working_hours_type_id_list?: string[]
890
- /** 国籍 ID 列表- 可通过[【查询国籍信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)获取- 需要有字段读取权限 */
936
+ /**
937
+ * 国籍 ID 列表
938
+ * - 可通过[【查询国籍信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)获取
939
+ * - 需要有字段读取权限
940
+ */
891
941
  nationality_id_list?: string[]
892
- /** 员工所属薪资组 ID 列表 - 可通过 [【获取薪资组基本信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/payroll-v1/paygroup/list) 获取 - 需要有字段读取权限 */
942
+ /**
943
+ * 员工所属薪资组 ID 列表
944
+ * - 可通过 [【获取薪资组基本信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/payroll-v1/paygroup/list) 获取
945
+ * - 需要有字段读取权限
946
+ */
893
947
  pay_group_id_list?: string[]
894
- /** 员工所属外派薪资组 ID 列表- 可通过 [【获取薪资组基本信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/payroll-v1/paygroup/list) 获取- 需要有字段读取权限 */
948
+ /**
949
+ * 员工所属外派薪资组 ID 列表
950
+ * - 可通过 [【获取薪资组基本信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/payroll-v1/paygroup/list) 获取
951
+ * - 需要有字段读取权限
952
+ */
895
953
  assignment_pay_group_id_list?: string[]
896
- /** 员工当前合同类型列表- 可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)查询 - object_api_name：contract - custom_api_name：contract_type- 需要有字段读取权限 */
954
+ /**
955
+ * 员工当前合同类型列表
956
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)查询
957
+ * - object_api_name：contract
958
+ * - custom_api_name：contract_type
959
+ * - 需要有字段读取权限
960
+ */
897
961
  contract_type_list?: string[]
898
- /** 员工当前所属薪资方案 ID 列表- 可通过[【批量查询薪资方案】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/compensation-v1/plan/list)获取- 需要有字段读取权限 */
962
+ /**
963
+ * 员工当前所属薪资方案 ID 列表
964
+ * - 可通过[【批量查询薪资方案】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/compensation-v1/plan/list)获取
965
+ * - 需要有字段读取权限
966
+ */
899
967
  archive_cpst_plan_id_list?: string[]
900
968
  }
901
969
 
@@ -920,7 +988,11 @@ export namespace Corehr {
920
988
  export interface CreateQuery {
921
989
  /** 幂等标识，服务端会忽略client_token重复的请求 */
922
990
  client_token?: string
923
- /** 是否为离职重聘：false: 否，系统直接标为非离职重聘人员，不再做重复判断"true: 是，要求rehire_employment_id */
991
+ /**
992
+ * 是否为离职重聘：
993
+ * false: 否，系统直接标为非离职重聘人员，不再做重复判断"
994
+ * true: 是，要求rehire_employment_id
995
+ */
924
996
  rehire?: boolean
925
997
  /** 离职重聘员工雇佣ID, rehire */
926
998
  rehire_employment_id?: string
@@ -1411,7 +1483,11 @@ export namespace Corehr {
1411
1483
  user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id'
1412
1484
  /** 此次调用中使用的部门 ID 类型 */
1413
1485
  department_id_type?: 'open_department_id' | 'department_id' | 'people_corehr_department_id'
1414
- /** 是否强校验。值为 true 时，会对入参进行业务校验，并产生异动记录、发送异动事件。- 默认值：false- 仅在新增任职版本时生效，当 version_id 不为空时该字段不生效 */
1486
+ /**
1487
+ * 是否强校验。值为 true 时，会对入参进行业务校验，并产生异动记录、发送异动事件。
1488
+ * - 默认值：false
1489
+ * - 仅在新增任职版本时生效，当 version_id 不为空时该字段不生效
1490
+ */
1415
1491
  strict_verify?: string
1416
1492
  }
1417
1493
 
@@ -1484,9 +1560,19 @@ export namespace Corehr {
1484
1560
  department_id?: string
1485
1561
  /** 员工雇佣 ID 列表 */
1486
1562
  employment_ids?: string[]
1487
- /** 是否仅查询主职- true：仅返回 primary_job_data 为 true 的任职记录- false：仅返回 primary_job_data 为 false 的任职记录- 不传：返回全部 */
1563
+ /**
1564
+ * 是否仅查询主职
1565
+ * - true：仅返回 primary_job_data 为 true 的任职记录
1566
+ * - false：仅返回 primary_job_data 为 false 的任职记录
1567
+ * - 不传：返回全部
1568
+ */
1488
1569
  primary_job_data?: boolean
1489
- /** 任职原因- 可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - object_api_name：job_data - custom_api_name：assignment_start_reason */
1570
+ /**
1571
+ * 任职原因
1572
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
1573
+ * - object_api_name：job_data
1574
+ * - custom_api_name：assignment_start_reason
1575
+ */
1490
1576
  assignment_start_reasons?: string[]
1491
1577
  }
1492
1578
 
@@ -1508,9 +1594,19 @@ export namespace Corehr {
1508
1594
  effective_date_end?: string
1509
1595
  /** 查看数据日期，默认为今天 */
1510
1596
  data_date?: string
1511
- /** 是否仅查询主职- true：仅返回 primary_job_data 为 true 的任职记录- false：仅返回 primary_job_data 为 false 的任职记录- 不传：返回全部 */
1597
+ /**
1598
+ * 是否仅查询主职
1599
+ * - true：仅返回 primary_job_data 为 true 的任职记录
1600
+ * - false：仅返回 primary_job_data 为 false 的任职记录
1601
+ * - 不传：返回全部
1602
+ */
1512
1603
  primary_job_data?: boolean
1513
- /** 任职原因- 可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - object_api_name：job_data - custom_api_name：assignment_start_reason */
1604
+ /**
1605
+ * 任职原因
1606
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
1607
+ * - object_api_name：job_data
1608
+ * - custom_api_name：assignment_start_reason
1609
+ */
1514
1610
  assignment_start_reasons?: string[]
1515
1611
  }
1516
1612
 
@@ -1552,53 +1648,129 @@ export namespace Corehr {
1552
1648
  }
1553
1649
 
1554
1650
  export interface CreateRequest {
1555
- /** 外派工作地点 ID - 可通过[【批量查询地点】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获取 */
1651
+ /**
1652
+ * 外派工作地点 ID
1653
+ * - 可通过[【批量查询地点】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获取
1654
+ */
1556
1655
  work_location_id: string
1557
- /** 外派任职公司 ID- 可通过[【批量查询公司】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取 */
1656
+ /**
1657
+ * 外派任职公司 ID
1658
+ * - 可通过[【批量查询公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取
1659
+ */
1558
1660
  service_company?: string
1559
- /** 排班类型- 可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - object_api_name：job_data - custom_api_name：work_shift */
1661
+ /**
1662
+ * 排班类型
1663
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
1664
+ * - object_api_name：job_data
1665
+ * - custom_api_name：work_shift
1666
+ */
1560
1667
  work_shift?: string
1561
- /** 周工作时长- 限制两位小数 */
1668
+ /**
1669
+ * 周工作时长
1670
+ * - 限制两位小数
1671
+ */
1562
1672
  weekly_working_hours_v2?: number
1563
- /** 工时制度ID- 可通过[【批量查询工时制度】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取 */
1673
+ /**
1674
+ * 工时制度ID
1675
+ * - 可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取
1676
+ */
1564
1677
  working_hours_type_id?: string
1565
- /** 人员类型ID- 可通过[【批量查询人员类型】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/list)获取 */
1678
+ /**
1679
+ * 人员类型ID
1680
+ * - 可通过[【批量查询人员类型】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/list)获取
1681
+ */
1566
1682
  employee_type_id?: string
1567
- /** 部门 ID- 可通过[【批量查询部门】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获取- 类型与 department_id_type 一致 */
1683
+ /**
1684
+ * 部门 ID
1685
+ * - 可通过[【批量查询部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获取
1686
+ * - 类型与 department_id_type 一致
1687
+ */
1568
1688
  department_id?: string
1569
- /** 职务 ID- 可通过[【批量查询职务】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取 */
1689
+ /**
1690
+ * 职务 ID
1691
+ * - 可通过[【批量查询职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取
1692
+ */
1570
1693
  job_id?: string
1571
- /** 序列 ID- 可通过[【批量查询序列】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取 */
1694
+ /**
1695
+ * 序列 ID
1696
+ * - 可通过[【批量查询序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取
1697
+ */
1572
1698
  job_family_id?: string
1573
- /** 职级 ID- 可通过[【批量查询职级】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取 */
1699
+ /**
1700
+ * 职级 ID
1701
+ * - 可通过[【批量查询职级】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取
1702
+ */
1574
1703
  job_level_id?: string
1575
- /** 职等 ID- 可通过[【查询职等】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)获取 */
1704
+ /**
1705
+ * 职等 ID
1706
+ * - 可通过[【查询职等】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)获取
1707
+ */
1576
1708
  job_grade_id?: string
1577
- /** 薪资类型- 可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - object_api_name：job_data - custom_api_name：compensation_type */
1709
+ /**
1710
+ * 薪资类型
1711
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
1712
+ * - object_api_name：job_data
1713
+ * - custom_api_name：compensation_type
1714
+ */
1578
1715
  compensation_type?: string
1579
- /** 直属上级雇佣 ID- 可通过[【批量查询员工信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取- 类型与 user_id_type 一致 */
1716
+ /**
1717
+ * 直属上级雇佣 ID
1718
+ * - 可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取
1719
+ * - 类型与 user_id_type 一致
1720
+ */
1580
1721
  direct_manager_id?: string
1581
- /** 虚线上级雇佣 ID- 可通过[【批量查询员工信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取- 类型与 user_id_type 一致 */
1722
+ /**
1723
+ * 虚线上级雇佣 ID
1724
+ * - 可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取
1725
+ * - 类型与 user_id_type 一致
1726
+ */
1582
1727
  dotted_line_manager_id?: string
1583
- /** 工作日历 ID- 可通过[【查询工作日历】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/work_calendar)获取 */
1728
+ /**
1729
+ * 工作日历 ID
1730
+ * - 可通过[【查询工作日历】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/work_calendar)获取
1731
+ */
1584
1732
  work_calendar_id?: string
1585
- /** 岗位 ID- 功能灰度中，请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) */
1733
+ /**
1734
+ * 岗位 ID
1735
+ * - 功能灰度中，请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
1736
+ */
1586
1737
  position_id?: string
1587
- /** 雇佣 ID- 可通过[【批量查询员工信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取- 类型与 user_id_type 一致 */
1738
+ /**
1739
+ * 雇佣 ID
1740
+ * - 可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取
1741
+ * - 类型与 user_id_type 一致
1742
+ */
1588
1743
  employment_id: string
1589
- /** 自定义字段- 请参考[【自定义字段说明】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide) */
1744
+ /**
1745
+ * 自定义字段
1746
+ * - 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
1747
+ */
1590
1748
  custom_fields?: Lark.ObjectFieldData[]
1591
1749
  /** 外派原因说明 */
1592
1750
  international_assignment_reason?: string
1593
1751
  /** 备注 */
1594
1752
  description?: string
1595
- /** 预计结束日期- 格式：yyyy-mm-dd */
1753
+ /**
1754
+ * 预计结束日期
1755
+ * - 格式：yyyy-mm-dd
1756
+ */
1596
1757
  international_assignment_expected_end_date?: string
1597
- /** 外派类型- 可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - object_api_name：international_assignment - custom_api_name：international_assignment_type */
1758
+ /**
1759
+ * 外派类型
1760
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
1761
+ * - object_api_name：international_assignment
1762
+ * - custom_api_name：international_assignment_type
1763
+ */
1598
1764
  international_assignment_type: string
1599
- /** 开始日期- 格式：yyyy-mm-dd */
1765
+ /**
1766
+ * 开始日期
1767
+ * - 格式：yyyy-mm-dd
1768
+ */
1600
1769
  effective_time: string
1601
- /** 结束日期- 格式：yyyy-mm-dd */
1770
+ /**
1771
+ * 结束日期
1772
+ * - 格式：yyyy-mm-dd
1773
+ */
1602
1774
  expiration_time?: string
1603
1775
  }
1604
1776
 
@@ -1617,51 +1789,123 @@ export namespace Corehr {
1617
1789
  }
1618
1790
 
1619
1791
  export interface PatchRequest {
1620
- /** 外派工作地点 ID - 可通过[【批量查询地点】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获取 */
1792
+ /**
1793
+ * 外派工作地点 ID
1794
+ * - 可通过[【批量查询地点】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获取
1795
+ */
1621
1796
  work_location_id?: string
1622
- /** 外派任职公司 ID- 可通过[【批量查询公司】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取 */
1797
+ /**
1798
+ * 外派任职公司 ID
1799
+ * - 可通过[【批量查询公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取
1800
+ */
1623
1801
  service_company?: string
1624
- /** 排班类型- 可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - object_api_name：job_data - custom_api_name：work_shift */
1802
+ /**
1803
+ * 排班类型
1804
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
1805
+ * - object_api_name：job_data
1806
+ * - custom_api_name：work_shift
1807
+ */
1625
1808
  work_shift?: string
1626
- /** 周工作时长- 限制两位小数 */
1809
+ /**
1810
+ * 周工作时长
1811
+ * - 限制两位小数
1812
+ */
1627
1813
  weekly_working_hours_v2?: number
1628
- /** 工时制度ID- 可通过[【批量查询工时制度】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取 */
1814
+ /**
1815
+ * 工时制度ID
1816
+ * - 可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取
1817
+ */
1629
1818
  working_hours_type_id?: string
1630
- /** 人员类型ID- 可通过[【批量查询人员类型】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/list)获取 */
1819
+ /**
1820
+ * 人员类型ID
1821
+ * - 可通过[【批量查询人员类型】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/list)获取
1822
+ */
1631
1823
  employee_type_id?: string
1632
- /** 部门 ID- 可通过[【批量查询部门】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获取- 类型与 department_id_type 一致 */
1824
+ /**
1825
+ * 部门 ID
1826
+ * - 可通过[【批量查询部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获取
1827
+ * - 类型与 department_id_type 一致
1828
+ */
1633
1829
  department_id?: string
1634
- /** 职务 ID- 可通过[【批量查询职务】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取 */
1830
+ /**
1831
+ * 职务 ID
1832
+ * - 可通过[【批量查询职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取
1833
+ */
1635
1834
  job_id?: string
1636
- /** 序列 ID- 可通过[【批量查询序列】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取 */
1835
+ /**
1836
+ * 序列 ID
1837
+ * - 可通过[【批量查询序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取
1838
+ */
1637
1839
  job_family_id?: string
1638
- /** 职级 ID- 可通过[【批量查询职级】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取 */
1840
+ /**
1841
+ * 职级 ID
1842
+ * - 可通过[【批量查询职级】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取
1843
+ */
1639
1844
  job_level_id?: string
1640
- /** 职等 ID- 可通过[【查询职等】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)获取 */
1845
+ /**
1846
+ * 职等 ID
1847
+ * - 可通过[【查询职等】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)获取
1848
+ */
1641
1849
  job_grade_id?: string
1642
- /** 薪资类型- 可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - object_api_name：job_data - custom_api_name：compensation_type */
1850
+ /**
1851
+ * 薪资类型
1852
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
1853
+ * - object_api_name：job_data
1854
+ * - custom_api_name：compensation_type
1855
+ */
1643
1856
  compensation_type?: string
1644
- /** 直属上级雇佣 ID- 可通过[【批量查询员工信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取- 类型与 user_id_type 一致 */
1857
+ /**
1858
+ * 直属上级雇佣 ID
1859
+ * - 可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取
1860
+ * - 类型与 user_id_type 一致
1861
+ */
1645
1862
  direct_manager_id?: string
1646
- /** 虚线上级雇佣 ID- 可通过[【批量查询员工信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取- 类型与 user_id_type 一致 */
1863
+ /**
1864
+ * 虚线上级雇佣 ID
1865
+ * - 可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取
1866
+ * - 类型与 user_id_type 一致
1867
+ */
1647
1868
  dotted_line_manager_id?: string
1648
- /** 工作日历 ID- 可通过[【查询工作日历】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/work_calendar)获取 */
1869
+ /**
1870
+ * 工作日历 ID
1871
+ * - 可通过[【查询工作日历】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/work_calendar)获取
1872
+ */
1649
1873
  work_calendar_id?: string
1650
- /** 岗位 ID- 功能灰度中，请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) */
1874
+ /**
1875
+ * 岗位 ID
1876
+ * - 功能灰度中，请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
1877
+ */
1651
1878
  position_id?: string
1652
- /** 自定义字段- 请参考[【自定义字段说明】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide) */
1879
+ /**
1880
+ * 自定义字段
1881
+ * - 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
1882
+ */
1653
1883
  custom_fields?: Lark.ObjectFieldData[]
1654
1884
  /** 外派原因说明 */
1655
1885
  international_assignment_reason?: string
1656
1886
  /** 备注 */
1657
1887
  description?: string
1658
- /** 预计结束日期- 格式：yyyy-mm-dd */
1888
+ /**
1889
+ * 预计结束日期
1890
+ * - 格式：yyyy-mm-dd
1891
+ */
1659
1892
  international_assignment_expected_end_date?: string
1660
- /** 外派类型- 可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - object_api_name：international_assignment - custom_api_name：international_assignment_type */
1893
+ /**
1894
+ * 外派类型
1895
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
1896
+ * - object_api_name：international_assignment
1897
+ * - custom_api_name：international_assignment_type
1898
+ */
1661
1899
  international_assignment_type?: string
1662
- /** 开始日期- 格式：yyyy-mm-dd */
1900
+ /**
1901
+ * 开始日期
1902
+ * - 格式：yyyy-mm-dd
1903
+ */
1663
1904
  effective_time?: string
1664
- /** 结束日期- 格式：yyyy-mm-dd */
1905
+ /**
1906
+ * 结束日期
1907
+ * - 格式：yyyy-mm-dd
1908
+ */
1665
1909
  expiration_time?: string
1666
1910
  }
1667
1911
 
@@ -1684,51 +1928,164 @@ export namespace Corehr {
1684
1928
  user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id'
1685
1929
  /** 此次调用中使用的部门 ID 类型 */
1686
1930
  department_id_type?: 'open_department_id' | 'department_id' | 'people_corehr_department_id'
1687
- /** 雇佣ID- 可通过[【批量查询员工信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息- 类型必须与 user_id_type 一致 */
1931
+ /**
1932
+ * 雇佣ID
1933
+ * - 可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息
1934
+ * - 类型必须与 user_id_type 一致
1935
+ */
1688
1936
  employment_ids?: string[]
1689
1937
  /** 外派 ID */
1690
1938
  international_assignment_ids?: string[]
1691
- /** 外派开始日期- 范围筛选，格式：yyyy-mm-dd~yyyy-mm-dd */
1939
+ /**
1940
+ * 外派开始日期
1941
+ * - 范围筛选，格式：yyyy-mm-dd~yyyy-mm-dd
1942
+ */
1692
1943
  effective_time?: string
1693
- /** 外派结束日期- 范围筛选，格式：yyyy-mm-dd~yyyy-mm-dd */
1944
+ /**
1945
+ * 外派结束日期
1946
+ * - 范围筛选，格式：yyyy-mm-dd~yyyy-mm-dd
1947
+ */
1694
1948
  expiration_time?: string
1695
- /** 雇佣状态- 可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - object_api_name：employment - custom_api_name：employment_status */
1949
+ /**
1950
+ * 雇佣状态
1951
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
1952
+ * - object_api_name：employment
1953
+ * - custom_api_name：employment_status
1954
+ */
1696
1955
  employment_status_list?: string[]
1697
- /** 外派工作地点- 可通过[【批量查询地点】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获取- 需要以下权限点之一： - [读取外派地点](corehr:employment.international_assignment.work_location:read) - [读写外派地点](corehr:employment.international_assignment.work_location:write) */
1956
+ /**
1957
+ * 外派工作地点
1958
+ * - 可通过[【批量查询地点】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获取
1959
+ * - 需要以下权限点之一：
1960
+ * - [读取外派地点](corehr:employment.international_assignment.work_location:read)
1961
+ * - [读写外派地点](corehr:employment.international_assignment.work_location:write)
1962
+ */
1698
1963
  work_location_id_list?: string[]
1699
- /** 外派部门- 可通过[【批量查询部门】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获取- 类型与 department_id_type 一致 */
1964
+ /**
1965
+ * 外派部门
1966
+ * - 可通过[【批量查询部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获取
1967
+ * - 类型与 department_id_type 一致
1968
+ */
1700
1969
  department_id_list?: string[]
1701
- /** 外派直属上级- 可通过[【批量查询员工信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取- 类型与 user_id_type 一致 */
1970
+ /**
1971
+ * 外派直属上级
1972
+ * - 可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取
1973
+ * - 类型与 user_id_type 一致
1974
+ */
1702
1975
  direct_manager_id_list?: string[]
1703
- /** 外派虚线上级- 可通过[【批量查询员工信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取- 类型与 user_id_type 一致 */
1976
+ /**
1977
+ * 外派虚线上级
1978
+ * - 可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取
1979
+ * - 类型与 user_id_type 一致
1980
+ */
1704
1981
  dotted_line_manager_id_list?: string[]
1705
- /** 外派岗位- 功能灰度中，请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)- 需要以下权限点之一： - [读取外派岗位](corehr:employment.international_assignment.position:read) - [读写外派岗位](corehr:employment.international_assignment.position:write) */
1982
+ /**
1983
+ * 外派岗位
1984
+ * - 功能灰度中，请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
1985
+ * - 需要以下权限点之一：
1986
+ * - [读取外派岗位](corehr:employment.international_assignment.position:read)
1987
+ * - [读写外派岗位](corehr:employment.international_assignment.position:write)
1988
+ */
1706
1989
  position_id_list?: string[]
1707
- /** 外派职务- 可通过[【批量查询职务】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取- 需要以下权限点之一： - [读取外派职务](corehr:employment.international_assignment.job:read) - [读写外派职务](corehr:employment.international_assignment.job:write) */
1990
+ /**
1991
+ * 外派职务
1992
+ * - 可通过[【批量查询职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取
1993
+ * - 需要以下权限点之一：
1994
+ * - [读取外派职务](corehr:employment.international_assignment.job:read)
1995
+ * - [读写外派职务](corehr:employment.international_assignment.job:write)
1996
+ */
1708
1997
  job_id_list?: string[]
1709
- /** 外派序列- 可通过[【批量查询序列】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取 */
1998
+ /**
1999
+ * 外派序列
2000
+ * - 可通过[【批量查询序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取
2001
+ */
1710
2002
  job_family_id_list?: string[]
1711
- /** 外派职级- 可通过[【批量查询职级】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取- 需要以下权限点之一： - [读取外派职级](corehr:employment.international_assignment.job_level:read) - [读写外派职级](corehr:employment.international_assignment.job_level:write) */
2003
+ /**
2004
+ * 外派职级
2005
+ * - 可通过[【批量查询职级】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取
2006
+ * - 需要以下权限点之一：
2007
+ * - [读取外派职级](corehr:employment.international_assignment.job_level:read)
2008
+ * - [读写外派职级](corehr:employment.international_assignment.job_level:write)
2009
+ */
1712
2010
  job_level_id_list?: string[]
1713
- /** 外派职等- 可通过[【查询职等】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)获取- 需要以下权限点之一： - [读取外派职等](corehr:employment.international_assignment.job_grade:read) - [读写外派职等](corehr:employment.international_assignment.job_grade:write) */
2011
+ /**
2012
+ * 外派职等
2013
+ * - 可通过[【查询职等】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)获取
2014
+ * - 需要以下权限点之一：
2015
+ * - [读取外派职等](corehr:employment.international_assignment.job_grade:read)
2016
+ * - [读写外派职等](corehr:employment.international_assignment.job_grade:write)
2017
+ */
1714
2018
  job_grade_id_list?: string[]
1715
- /** 外派工时制度- 可通过[【批量查询工时制度】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取- 需要以下权限点之一： - [读取外派工时制度](corehr:employment.international_assignment.working_hours_type:read) - [读写外派工时制度](corehr:employment.international_assignment.working_hours_type:write) */
2019
+ /**
2020
+ * 外派工时制度
2021
+ * - 可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取
2022
+ * - 需要以下权限点之一：
2023
+ * - [读取外派工时制度](corehr:employment.international_assignment.working_hours_type:read)
2024
+ * - [读写外派工时制度](corehr:employment.international_assignment.working_hours_type:write)
2025
+ */
1716
2026
  working_hours_type_id_list?: string[]
1717
- /** 外派任职公司- 可通过[【批量查询公司】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取- 需要以下权限点之一： - [读取外派公司](corehr:employment.international_assignment.service_company:read) - [读写外派公司](corehr:employment.international_assignment.service_company:write) */
2027
+ /**
2028
+ * 外派任职公司
2029
+ * - 可通过[【批量查询公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取
2030
+ * - 需要以下权限点之一：
2031
+ * - [读取外派公司](corehr:employment.international_assignment.service_company:read)
2032
+ * - [读写外派公司](corehr:employment.international_assignment.service_company:write)
2033
+ */
1718
2034
  service_company_list?: string[]
1719
- /** 外派周工作时长- 限制两位小数- 需要以下权限点之一： - [读取外派周工作时长](corehr:employment.international_assignment.weekly_working_hours:read) - [读写外派周工作时长](corehr:employment.international_assignment.weekly_working_hours:write) */
2035
+ /**
2036
+ * 外派周工作时长
2037
+ * - 限制两位小数
2038
+ * - 需要以下权限点之一：
2039
+ * - [读取外派周工作时长](corehr:employment.international_assignment.weekly_working_hours:read)
2040
+ * - [读写外派周工作时长](corehr:employment.international_assignment.weekly_working_hours:write)
2041
+ */
1720
2042
  weekly_working_hours_v2?: number
1721
- /** 外派排班类型- 可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - object_api_name：job_data - custom_api_name：work_shift- 需要以下权限点之一： - [读取外派排班类型](corehr:employment.international_assignment.work_shift:read) - [读写外派排班类型](corehr:employment.international_assignment.work_shift:write) */
2043
+ /**
2044
+ * 外派排班类型
2045
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
2046
+ * - object_api_name：job_data
2047
+ * - custom_api_name：work_shift
2048
+ * - 需要以下权限点之一：
2049
+ * - [读取外派排班类型](corehr:employment.international_assignment.work_shift:read)
2050
+ * - [读写外派排班类型](corehr:employment.international_assignment.work_shift:write)
2051
+ */
1722
2052
  work_shift_list?: string[]
1723
- /** 外派薪资类型- 可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - object_api_name：job_data - custom_api_name：compensation_type- 需要以下权限点之一： - [读取外派薪资类型](corehr:employment.international_assignment.compensation_type:read) - [读写外派薪资类型](corehr:employment.international_assignment.compensation_type:write) */
2053
+ /**
2054
+ * 外派薪资类型
2055
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
2056
+ * - object_api_name：job_data
2057
+ * - custom_api_name：compensation_type
2058
+ * - 需要以下权限点之一：
2059
+ * - [读取外派薪资类型](corehr:employment.international_assignment.compensation_type:read)
2060
+ * - [读写外派薪资类型](corehr:employment.international_assignment.compensation_type:write)
2061
+ */
1724
2062
  compensation_type_list?: string[]
1725
- /** 外派预计结束日期- 范围筛选，格式：yyyy-mm-dd~yyyy-mm-dd */
2063
+ /**
2064
+ * 外派预计结束日期
2065
+ * - 范围筛选，格式：yyyy-mm-dd~yyyy-mm-dd
2066
+ */
1726
2067
  international_assignment_expected_end_date?: string
1727
- /** 外派状态- 可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - object_api_name：international_assignment - custom_api_name：international_assignment_status */
2068
+ /**
2069
+ * 外派状态
2070
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
2071
+ * - object_api_name：international_assignment
2072
+ * - custom_api_name：international_assignment_status
2073
+ */
1728
2074
  international_assignment_status_list?: string[]
1729
- /** 外派类型- 可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - object_api_name：international_assignment - custom_api_name：international_assignment_type */
2075
+ /**
2076
+ * 外派类型
2077
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
2078
+ * - object_api_name：international_assignment
2079
+ * - custom_api_name：international_assignment_type
2080
+ */
1730
2081
  international_assignment_type_list?: string[]
1731
- /** 外派工作日历- 可通过[【查询工作日历】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/work_calendar)获取详细信息- 需要以下权限点之一： - [读取外派工作日历](corehr:employment.international_assignment.work_calendar:read) - [读写外派工作日历](corehr:employment.international_assignment.work_calendar:write) */
2082
+ /**
2083
+ * 外派工作日历
2084
+ * - 可通过[【查询工作日历】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/work_calendar)获取详细信息
2085
+ * - 需要以下权限点之一：
2086
+ * - [读取外派工作日历](corehr:employment.international_assignment.work_calendar:read)
2087
+ * - [读写外派工作日历](corehr:employment.international_assignment.work_calendar:write)
2088
+ */
1732
2089
  work_calendar_id_list?: string[]
1733
2090
  }
1734
2091
 
@@ -1769,39 +2126,47 @@ export namespace Corehr {
1769
2126
  }
1770
2127
 
1771
2128
  export interface CreateRequest {
1772
- /** 人员类型 ID，可通过[【批量查询人员类型】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/list)获取 */
2129
+ /** 人员类型 ID，可通过[【批量查询人员类型】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/list)获取 */
1773
2130
  employee_type_id: string
1774
- /** 工时制度 ID，可通过[【批量查询工时制度】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取详细信息 */
2131
+ /** 工时制度 ID，可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取详细信息 */
1775
2132
  working_hours_type_id?: string
1776
- /** 工作地点 ID，可通过[【批量查询地点】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获取详细信息 */
2133
+ /** 工作地点 ID，可通过[【批量查询地点】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获取详细信息 */
1777
2134
  work_location_id?: string
1778
- /** 部门 ID，可通过[【批量查询部门】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获取详细信息；类型与department_id_type一致 */
2135
+ /** 部门 ID，可通过[【批量查询部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获取详细信息；类型与department_id_type一致 */
1779
2136
  department_id: string
1780
- /** 职务 ID，可通过[【批量查询职务】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取详细信息 */
2137
+ /** 职务 ID，可通过[【批量查询职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取详细信息 */
1781
2138
  job_id?: string
1782
- /** 职级 ID，可通过[【批量查询职级】](/ssl:ttdoc//uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取详细信息 */
2139
+ /** 职级 ID，可通过[【批量查询职级】](https://open.feishu.cn/document//uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取详细信息 */
1783
2140
  job_level_id?: string
1784
- /** 序列 ID，可通过[【批量查询序列】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取详细信息 */
2141
+ /** 序列 ID，可通过[【批量查询序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取详细信息 */
1785
2142
  job_family_id?: string
1786
- /** 雇佣 ID，可通过[【批量查询员工信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息；类型与user_id_type一致 */
2143
+ /** 雇佣 ID，可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息；类型与user_id_type一致 */
1787
2144
  employment_id: string
1788
2145
  /** 兼职开始日期 */
1789
2146
  start_date: string
1790
2147
  /** 兼职结束日期，不可清空 */
1791
2148
  end_date?: string
1792
- /** 直属上级的雇佣ID，可通过[【批量查询员工信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息；类型与user_id_type一致 */
2149
+ /** 直属上级的雇佣ID，可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息；类型与user_id_type一致 */
1793
2150
  direct_manager_id?: string
1794
- /** 虚线上级的雇佣ID，可通过[【批量查询员工信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息；类型与user_id_type一致 */
2151
+ /** 虚线上级的雇佣ID，可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息；类型与user_id_type一致 */
1795
2152
  dotted_line_manager_id?: string
1796
- /** 排班类型，可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：- object_api_name = "job_data"- custom_api_name = "work_shift" */
2153
+ /**
2154
+ * 排班类型，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
2155
+ * - object_api_name = "job_data"
2156
+ * - custom_api_name = "work_shift"
2157
+ */
1797
2158
  work_shift?: Lark.Enum
1798
- /** 薪资类型，可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：- object_api_name = "job_data"- custom_api_name = "compensation_type" */
2159
+ /**
2160
+ * 薪资类型，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
2161
+ * - object_api_name = "job_data"
2162
+ * - custom_api_name = "compensation_type"
2163
+ */
1799
2164
  compensation_type?: Lark.Enum
1800
- /** 任职公司，可通过[【批量查询公司】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取详细信息 */
2165
+ /** 任职公司，可通过[【批量查询公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取详细信息 */
1801
2166
  service_company?: string
1802
2167
  /** 周工作时长【0~168】 */
1803
2168
  weekly_working_hours?: string
1804
- /** 工作日历ID，可通过[【查询工作日历】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/work_calendar)获取详细信息 */
2169
+ /** 工作日历ID，可通过[【查询工作日历】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/work_calendar)获取详细信息 */
1805
2170
  work_calendar_id?: string
1806
2171
  /** 岗位 ID */
1807
2172
  position_id?: string
@@ -1823,37 +2188,45 @@ export namespace Corehr {
1823
2188
  }
1824
2189
 
1825
2190
  export interface PatchRequest {
1826
- /** 人员类型 ID，可通过[【批量查询人员类型】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/list)获取 */
2191
+ /** 人员类型 ID，可通过[【批量查询人员类型】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/list)获取 */
1827
2192
  employee_type_id?: string
1828
- /** 工时制度 ID，可通过[【批量查询工时制度】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取详细信息 */
2193
+ /** 工时制度 ID，可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取详细信息 */
1829
2194
  working_hours_type_id?: string
1830
- /** 工作地点 ID，可通过[【批量查询地点】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获取详细信息 */
2195
+ /** 工作地点 ID，可通过[【批量查询地点】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获取详细信息 */
1831
2196
  work_location_id?: string
1832
- /** 部门 ID，可通过[【批量查询部门】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获取详细信息；类型与department_id_type一致 */
2197
+ /** 部门 ID，可通过[【批量查询部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获取详细信息；类型与department_id_type一致 */
1833
2198
  department_id?: string
1834
- /** 职务 ID，可通过[【批量查询职务】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取详细信息 */
2199
+ /** 职务 ID，可通过[【批量查询职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取详细信息 */
1835
2200
  job_id?: string
1836
- /** 职级 ID，可通过[【批量查询职级】](/ssl:ttdoc//uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取详细信息 */
2201
+ /** 职级 ID，可通过[【批量查询职级】](https://open.feishu.cn/document//uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取详细信息 */
1837
2202
  job_level_id?: string
1838
- /** 序列 ID，可通过[【批量查询序列】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取详细信息 */
2203
+ /** 序列 ID，可通过[【批量查询序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取详细信息 */
1839
2204
  job_family_id?: string
1840
2205
  /** 兼职开始日期 */
1841
2206
  start_date?: string
1842
2207
  /** 兼职结束日期，不可清空 */
1843
2208
  end_date?: string
1844
- /** 直属上级的雇佣ID，可通过[【批量查询员工信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息；类型与user_id_type一致 */
2209
+ /** 直属上级的雇佣ID，可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息；类型与user_id_type一致 */
1845
2210
  direct_manager_id?: string
1846
- /** 虚线上级的雇佣ID，可通过[【批量查询员工信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息；类型与user_id_type一致 */
2211
+ /** 虚线上级的雇佣ID，可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息；类型与user_id_type一致 */
1847
2212
  dotted_line_manager_id?: string
1848
- /** 排班类型，可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：- object_api_name = "job_data"- custom_api_name = "work_shift" */
2213
+ /**
2214
+ * 排班类型，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
2215
+ * - object_api_name = "job_data"
2216
+ * - custom_api_name = "work_shift"
2217
+ */
1849
2218
  work_shift?: Lark.Enum
1850
- /** 薪资类型，可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：- object_api_name = "job_data"- custom_api_name = "compensation_type" */
2219
+ /**
2220
+ * 薪资类型，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
2221
+ * - object_api_name = "job_data"
2222
+ * - custom_api_name = "compensation_type"
2223
+ */
1851
2224
  compensation_type?: Lark.Enum
1852
- /** 任职公司，可通过[【批量查询公司】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取详细信息 */
2225
+ /** 任职公司，可通过[【批量查询公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取详细信息 */
1853
2226
  service_company?: string
1854
2227
  /** 周工作时长【0~168】 */
1855
2228
  weekly_working_hours?: string
1856
- /** 工作日历ID，可通过[【查询工作日历】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/work_calendar)获取详细信息 */
2229
+ /** 工作日历ID，可通过[【查询工作日历】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/work_calendar)获取详细信息 */
1857
2230
  work_calendar_id?: string
1858
2231
  /** 岗位 ID */
1859
2232
  position_id?: string
@@ -2371,13 +2744,19 @@ export namespace Corehr {
2371
2744
  active?: boolean
2372
2745
  /** 当通过上级部门 ID 查询时，填写 true 返回所有子部门，填写 false 只返回直接下级部门 */
2373
2746
  get_all_children?: boolean
2374
- /** manager ID 列表**字段权限要求：按照部门负责人搜索 (corehr:department.manager.search:read)** */
2747
+ /**
2748
+ * manager ID 列表
2749
+ * **字段权限要求：按照部门负责人搜索 (corehr:department.manager.search:read)**
2750
+ */
2375
2751
  manager_list?: string[]
2376
2752
  /** 部门 ID 列表 */
2377
2753
  department_id_list?: string[]
2378
2754
  /** 部门名称列表，需精确匹配 */
2379
2755
  name_list?: string[]
2380
- /** 上级部门 ID ，可查询直接下级部门**字段权限要求：按照上级部门搜索 (corehr:department.organize.search:read) ** */
2756
+ /**
2757
+ * 上级部门 ID ，可查询直接下级部门
2758
+ * **字段权限要求：按照上级部门搜索 (corehr:department.organize.search:read) **
2759
+ */
2381
2760
  parent_department_id?: string
2382
2761
  /** 部门 code 列表 */
2383
2762
  code_list?: string[]
@@ -4248,11 +4627,22 @@ export namespace Corehr {
4248
4627
  basic_info_update?: Lark.BasicInfoUpdate
4249
4628
  /** 更新待入职（prehire）信息 */
4250
4629
  offer_info_update?: Lark.OfferInfoUpdate
4251
- /** 指定需要更新的系统字段，只支持最多下钻一层，格式如下： - basic_info_update字段：basic_info_update.name（对name整体进行覆盖更新）；basic_info_update.emails（对邮箱整体进行更新） - offer_info_update字段：offer_info_update.onboarding_method - 招聘ID：ats_application_id */
4630
+ /**
4631
+ * 指定需要更新的系统字段，只支持最多下钻一层，格式如下：
4632
+ * - basic_info_update字段：basic_info_update.name（对name整体进行覆盖更新）；basic_info_update.emails（对邮箱整体进行更新）
4633
+ * - offer_info_update字段：offer_info_update.onboarding_method
4634
+ * - 招聘ID：ats_application_id
4635
+ */
4252
4636
  standard_update_fields?: string[]
4253
- /** 指定需要更新的PreHire对象上的自定义字段，格式如下： - custom_field1__c */
4637
+ /**
4638
+ * 指定需要更新的PreHire对象上的自定义字段，格式如下：
4639
+ * - custom_field1__c
4640
+ */
4254
4641
  custom_update_fields?: string[]
4255
- /** 指定需要更新的Person对象上的自定义字段，格式如下： - custom_field1__c */
4642
+ /**
4643
+ * 指定需要更新的Person对象上的自定义字段，格式如下：
4644
+ * - custom_field1__c
4645
+ */
4256
4646
  person_custom_update_fields?: string[]
4257
4647
  }
4258
4648
 
@@ -4264,7 +4654,18 @@ export namespace Corehr {
4264
4654
  export interface QueryRequest {
4265
4655
  /** 待入职人员 ID 列表；如果该字段非空，则不按照page_size、page_token分页方式查询 */
4266
4656
  pre_hire_ids?: string[]
4267
- /** 返回数据的字段列表，填写方式：- 为空时只返回 pre_hire_id- 不为空时按照传入的字段返回数据，格式如下： - person_info 字段：person_info.gender，person_info.age - employment_info 字段：employment_info.department - onboarding_info 字段：onboarding_info.onboarding_date - probation_info 字段：probation_info.probation_period - contract_info 字段：contract_info.contract_type- 如果要返回所有下级，只用传上级结构体名称，例如 person_info- 返回数据越多，查询接口性能越慢，请按需填写返回字段 */
4657
+ /**
4658
+ * 返回数据的字段列表，填写方式：
4659
+ * - 为空时只返回 pre_hire_id
4660
+ * - 不为空时按照传入的字段返回数据，格式如下：
4661
+ * - person_info 字段：person_info.gender，person_info.age
4662
+ * - employment_info 字段：employment_info.department
4663
+ * - onboarding_info 字段：onboarding_info.onboarding_date
4664
+ * - probation_info 字段：probation_info.probation_period
4665
+ * - contract_info 字段：contract_info.contract_type
4666
+ * - 如果要返回所有下级，只用传上级结构体名称，例如 person_info
4667
+ * - 返回数据越多，查询接口性能越慢，请按需填写返回字段
4668
+ */
4268
4669
  fields?: string[]
4269
4670
  }
4270
4671
 
@@ -4308,7 +4709,18 @@ export namespace Corehr {
4308
4709
  key_word?: string
4309
4710
  /** 是否离职重聘 */
4310
4711
  rehire?: 'to_be_confirmed' | 'no' | 'yes'
4311
- /** 返回数据的字段列表，填写方式：- 为空时只返回 pre_hire_id- 不为空时按照传入的字段返回数据，格式如下： - person_info 字段：person_info.gender，person_info.age - employment_info 字段：employment_info.department - onboarding_info 字段：onboarding_info.onboarding_date - probation_info 字段：probation_info.probation_period - contract_info 字段：contract_info.contract_type- 如果要返回所有下级，只用传上级结构体名称，例如 person_info- 返回数据越多，查询接口性能越慢，请按需填写返回字段 */
4712
+ /**
4713
+ * 返回数据的字段列表，填写方式：
4714
+ * - 为空时只返回 pre_hire_id
4715
+ * - 不为空时按照传入的字段返回数据，格式如下：
4716
+ * - person_info 字段：person_info.gender，person_info.age
4717
+ * - employment_info 字段：employment_info.department
4718
+ * - onboarding_info 字段：onboarding_info.onboarding_date
4719
+ * - probation_info 字段：probation_info.probation_period
4720
+ * - contract_info 字段：contract_info.contract_type
4721
+ * - 如果要返回所有下级，只用传上级结构体名称，例如 person_info
4722
+ * - 返回数据越多，查询接口性能越慢，请按需填写返回字段
4723
+ */
4312
4724
  fields?: string[]
4313
4725
  }
4314
4726
 
@@ -4881,7 +5293,10 @@ export namespace Corehr {
4881
5293
  employment_id: string
4882
5294
  /** 离职日期 */
4883
5295
  offboarding_date: string
4884
- /** 离职原因，可通过接口[【查询员工离职原因列表】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/offboarding/query)获取 */
5296
+ /**
5297
+ * 离职原因，可通过接口
5298
+ * [【查询员工离职原因列表】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/offboarding/query)获取
5299
+ */
4885
5300
  offboarding_reason_unique_identifier: string
4886
5301
  /** 离职原因说明，长度限制6000 */
4887
5302
  offboarding_reason_explanation?: string
@@ -4924,6 +5339,194 @@ export namespace Corehr {
4924
5339
  }
4925
5340
  }
4926
5341
 
5342
+ export namespace SignatureFile {
5343
+ export interface Methods {
5344
+ /**
5345
+ * 终止电子签文件
5346
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/signature_file/terminate
5347
+ */
5348
+ terminate(body: TerminateRequest, query?: TerminateQuery): Promise<TerminateResponse>
5349
+ /**
5350
+ * 获取电子签文件列表
5351
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/signature_file/list
5352
+ */
5353
+ list(query?: ListQuery): Paginated<Lark.SignatureFile>
5354
+ /**
5355
+ * 查询电子签文件详情
5356
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/signature_file/query
5357
+ */
5358
+ query(body: QueryRequest, query?: QueryQuery): Paginated<Lark.SignatureFile>
5359
+ /**
5360
+ * 根据流程获取电子签文件信息
5361
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/signature_file/list_by_biz_id
5362
+ */
5363
+ listByBizId(query?: ListByBizIdQuery): Promise<ListByBizIdResponse>
5364
+ /**
5365
+ * 下载电子签文件
5366
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/signature_file/download
5367
+ */
5368
+ download(signature_file_id: string): Promise<ArrayBuffer>
5369
+ }
5370
+
5371
+ export interface TerminateRequest {
5372
+ /** 欲终止的电子签文件id列表 */
5373
+ ids: string[]
5374
+ /** 操作人ID */
5375
+ operator: string
5376
+ /** 终止原因 */
5377
+ terminate_reason: string
5378
+ }
5379
+
5380
+ export interface TerminateQuery {
5381
+ /** 用户 ID 类型 */
5382
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id'
5383
+ }
5384
+
5385
+ export interface TerminateResponse {
5386
+ /** 欲终止的文件总数量 */
5387
+ total_count?: number
5388
+ /** 成功总数量 */
5389
+ success_count?: number
5390
+ /** 失败总数量 */
5391
+ fail_count?: number
5392
+ /** 终止成功的文件id列表 */
5393
+ success_file_id_list?: string[]
5394
+ /** 终止失败的文件id和对应的原因列表 */
5395
+ fail_file_id_and_reasons?: Lark.TerminateSignatureFailIdAndReason[]
5396
+ }
5397
+
5398
+ export interface ListQuery extends Pagination {
5399
+ /** 电子签文件id */
5400
+ signature_file_id?: string
5401
+ /** 电子签文件状态状态，多个状态之间为「或」的关系 */
5402
+ states?: string
5403
+ /** 更新时间早于等于某个时间点，按照东八区时区 */
5404
+ update_time_start?: string
5405
+ /** 更新时间晚于等于某个时间点，按照东八区时区 */
5406
+ update_time_end?: string
5407
+ /** 用户 ID 类型 */
5408
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id'
5409
+ /** 根据电子签模板id列表筛选电子签文件,返回的电子签文件使用的模板id在该list中 */
5410
+ template_ids?: string
5411
+ }
5412
+
5413
+ export interface QueryRequest {
5414
+ /** 电子签文件状态状态列表，多个状态之间为「或」的关系 */
5415
+ states?: string[]
5416
+ /** 电子签模板ID列表，返回的电子签文件使用的模板id在该list中 */
5417
+ template_ids?: string[]
5418
+ }
5419
+
5420
+ export interface QueryQuery extends Pagination {
5421
+ /** 电子签文件id */
5422
+ signature_file_id?: string
5423
+ /** 更新时间早于等于某个时间点，按照东八区时区 */
5424
+ update_time_start?: string
5425
+ /** 更新时间晚于等于某个时间点，按照东八区时区 */
5426
+ update_time_end?: string
5427
+ /** 用户 ID 类型 */
5428
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id'
5429
+ }
5430
+
5431
+ export interface ListByBizIdQuery {
5432
+ /** 业务自定义流程ID */
5433
+ biz_process_id: string
5434
+ /** 业务类型，开放平台平应用可以传递"OpenAPI" */
5435
+ biz_type: string
5436
+ /** 用户 ID 类型 */
5437
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id'
5438
+ /** 是否需要签署链接 */
5439
+ select_sign_url?: boolean
5440
+ }
5441
+
5442
+ export interface ListByBizIdResponse {
5443
+ /** 返回的流程关联的电子签文件列表 */
5444
+ signature_files?: Lark.SignatureFile[]
5445
+ /** 批量签署链接 */
5446
+ batch_sign_url?: string
5447
+ }
5448
+ }
5449
+
5450
+ export namespace SignatureNode {
5451
+ export interface Methods {
5452
+ /**
5453
+ * 获取文件签署节点信息
5454
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/signature_node/list_by_file_id
5455
+ */
5456
+ listByFileId(query?: ListByFileIdQuery): Promise<ListByFileIdResponse>
5457
+ }
5458
+
5459
+ export interface ListByFileIdQuery {
5460
+ /** 电子签文件id */
5461
+ file_id: string
5462
+ /** 用户 ID 类型 */
5463
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id'
5464
+ }
5465
+
5466
+ export interface ListByFileIdResponse {
5467
+ /** 返回的电子签节点列表 */
5468
+ signature_nodes?: Lark.SignatureNode[]
5469
+ }
5470
+ }
5471
+
5472
+ export namespace SignatureTemplate {
5473
+ export interface Methods {
5474
+ /**
5475
+ * 获取电子签模板内容
5476
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/signature_template/search
5477
+ */
5478
+ search(query?: SearchQuery): Promise<SearchResponse>
5479
+ }
5480
+
5481
+ export interface SearchQuery {
5482
+ /** 电子签模板ids,用英文逗号分隔;如果不传 则返回所有模版信息（字节线上几百条） */
5483
+ template_ids?: string
5484
+ /** 是否需要自定义字段,如-自定义签署方、合同变更前后公司等 */
5485
+ select_custom_field?: boolean
5486
+ }
5487
+
5488
+ export interface SearchResponse {
5489
+ /** 返回的电子签模板list */
5490
+ signature_templates?: Lark.SignatureTemplate[]
5491
+ }
5492
+ }
5493
+
5494
+ export namespace SignatureTemplateInfoWithThumbnail {
5495
+ export interface Methods {
5496
+ /**
5497
+ * 获取电子签模板列表
5498
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/signature_template_info_with_thumbnail/list
5499
+ */
5500
+ list(query?: ListQuery): Promise<ListResponse> & AsyncIterableIterator<Lark.SignatureTemplateInfoWithThumbnail>
5501
+ }
5502
+
5503
+ export interface ListQuery extends Pagination {
5504
+ /** 模版名 */
5505
+ name?: string
5506
+ /** 模板类别;多个类别之间使用英文,分隔 */
5507
+ category_apiname?: string
5508
+ /** 模板用途;多个用途之间使用英文,分隔 */
5509
+ usage_apiname?: string
5510
+ /** 是否停用 */
5511
+ active?: boolean
5512
+ /** 是否需要模板适用区域信息;默认false，不会返回region_info信息 */
5513
+ need_region_info?: boolean
5514
+ /** 电子签适用范围 */
5515
+ applicability_apinames?: string[]
5516
+ /** 此次调用中使用的用户ID的类型 */
5517
+ user_id_type?: 'user_id' | 'union_id' | 'open_id'
5518
+ }
5519
+
5520
+ export interface ListResponse {
5521
+ /** 电子签模板缩略图列表 */
5522
+ items?: Lark.SignatureTemplateInfoWithThumbnail[]
5523
+ /** 查询偏移量；下次查询可以从page_token开始查询 */
5524
+ page_token?: number
5525
+ /** 数据总数 */
5526
+ count?: number
5527
+ }
5528
+ }
5529
+
4927
5530
  export namespace Contract {
4928
5531
  export interface Methods {
4929
5532
  /**
@@ -5230,7 +5833,12 @@ export namespace Corehr {
5230
5833
  employment_id: string
5231
5834
  /** 授予数量 */
5232
5835
  granting_quantity: string
5233
- /** 授予时长单位可选值有：- 1: 天- 2: 小时 */
5836
+ /**
5837
+ * 授予时长单位
5838
+ * 可选值有：
5839
+ * - 1: 天
5840
+ * - 2: 小时
5841
+ */
5234
5842
  granting_unit: number
5235
5843
  /** 生效时间 */
5236
5844
  effective_date: string
@@ -5290,7 +5898,12 @@ export namespace Corehr {
5290
5898
  }
5291
5899
 
5292
5900
  export interface LeaveTypesQuery extends Pagination {
5293
- /** 假期类型状态（不传则为全部）可选值有：- 1：已启用- 2：已停用 */
5901
+ /**
5902
+ * 假期类型状态（不传则为全部）
5903
+ * 可选值有：
5904
+ * - 1：已启用
5905
+ * - 2：已停用
5906
+ */
5294
5907
  status?: string
5295
5908
  /** 用户 ID 类型 */
5296
5909
  user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id'
@@ -5314,7 +5927,19 @@ export namespace Corehr {
5314
5927
  employment_id_list?: string[]
5315
5928
  /** 休假发起人 ID 列表，最大 100 个 */
5316
5929
  initiator_id_list?: string[]
5317
- /** 请假记录的状态可选值有：- 1：已通过- 2：审批中- 3：审批中（更正）- 4：审批中（取消休假）- 5：审批中（返岗）- 6：已返岗- 7：已拒绝- 8：已取消- 9：已撤回 */
5930
+ /**
5931
+ * 请假记录的状态
5932
+ * 可选值有：
5933
+ * - 1：已通过
5934
+ * - 2：审批中
5935
+ * - 3：审批中（更正）
5936
+ * - 4：审批中（取消休假）
5937
+ * - 5：审批中（返岗）
5938
+ * - 6：已返岗
5939
+ * - 7：已拒绝
5940
+ * - 8：已取消
5941
+ * - 9：已撤回
5942
+ */
5318
5943
  leave_request_status?: string[]
5319
5944
  /** 假期类型 ID 列表，枚举值可通过【获取假期类型列表】接口获取 */
5320
5945
  leave_type_id_list?: string[]
@@ -5613,7 +6238,12 @@ export namespace Corehr {
5613
6238
  role_id: string
5614
6239
  /** 管理范围信息 */
5615
6240
  management_scope_list: Lark.ManagementScope[]
5616
- /** 查找方式可选值有：- 1：只查找指定 部门/工作地点/公司/社保城市，如无授权信息则返回为空- 2：当指定的 部门/工作地点/公司/社保城市 无授权信息，向上查找第一个授权记录并直接返回 */
6241
+ /**
6242
+ * 查找方式
6243
+ * 可选值有：
6244
+ * - 1：只查找指定 部门/工作地点/公司/社保城市，如无授权信息则返回为空
6245
+ * - 2：当指定的 部门/工作地点/公司/社保城市 无授权信息，向上查找第一个授权记录并直接返回
6246
+ */
5617
6247
  search_method: string
5618
6248
  /** 页码标识，获取第一页传空，每次查询会返回下一页的page_token */
5619
6249
  page_token?: string
@@ -6585,6 +7215,30 @@ Internal.define({
6585
7215
  '/corehr/v1/offboardings/search': {
6586
7216
  POST: { name: 'corehr.offboarding.search', pagination: { argIndex: 1 } },
6587
7217
  },
7218
+ '/corehr/v2/signature_files/terminate': {
7219
+ POST: 'corehr.signatureFile.terminate',
7220
+ },
7221
+ '/corehr/v2/signature_files': {
7222
+ GET: { name: 'corehr.signatureFile.list', pagination: { argIndex: 0 } },
7223
+ },
7224
+ '/corehr/v2/signature_files/query': {
7225
+ POST: { name: 'corehr.signatureFile.query', pagination: { argIndex: 1 } },
7226
+ },
7227
+ '/corehr/v2/signature_nodes/list_by_file_id': {
7228
+ GET: 'corehr.signatureNode.listByFileId',
7229
+ },
7230
+ '/corehr/v2/signature_files/list_by_biz_id': {
7231
+ GET: 'corehr.signatureFile.listByBizId',
7232
+ },
7233
+ '/corehr/v2/signature_files/{signature_file_id}/download': {
7234
+ POST: { name: 'corehr.signatureFile.download', type: 'binary' },
7235
+ },
7236
+ '/corehr/v2/signature_templates/search': {
7237
+ GET: 'corehr.signatureTemplate.search',
7238
+ },
7239
+ '/corehr/v2/signature_template_info_with_thumbnails': {
7240
+ GET: { name: 'corehr.signatureTemplateInfoWithThumbnail.list', pagination: { argIndex: 0 } },
7241
+ },
6588
7242
  '/corehr/v1/contracts': {
6589
7243
  POST: 'corehr.contract.create',
6590
7244
  GET: { name: 'corehr.contract.list', pagination: { argIndex: 0 } },