@satorijs/adapter-lark 3.11.8 → 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 (68) hide show
  1. package/lib/bot.d.ts +5 -5
  2. package/lib/http.d.ts +6 -3
  3. package/lib/index.cjs +634 -261
  4. package/lib/types/acs.d.ts +4 -1
  5. package/lib/types/aily.d.ts +3 -3
  6. package/lib/types/apaas.d.ts +190 -28
  7. package/lib/types/application.d.ts +20 -4
  8. package/lib/types/approval.d.ts +0 -13
  9. package/lib/types/attendance.d.ts +11 -5
  10. package/lib/types/authen.d.ts +8 -2
  11. package/lib/types/bitable.d.ts +25 -4
  12. package/lib/types/board.d.ts +56 -0
  13. package/lib/types/calendar.d.ts +71 -5
  14. package/lib/types/cardkit.d.ts +2 -2
  15. package/lib/types/compensation.d.ts +400 -0
  16. package/lib/types/contact.d.ts +55 -12
  17. package/lib/types/corehr.d.ts +1287 -79
  18. package/lib/types/directory.d.ts +3 -41
  19. package/lib/types/docx.d.ts +23 -0
  20. package/lib/types/drive.d.ts +107 -90
  21. package/lib/types/ehr.d.ts +11 -2
  22. package/lib/types/helpdesk.d.ts +15 -6
  23. package/lib/types/hire.d.ts +52 -3
  24. package/lib/types/human_authentication.d.ts +1 -1
  25. package/lib/types/im.d.ts +77 -21
  26. package/lib/types/index.d.ts +1670 -105
  27. package/lib/types/mail.d.ts +106 -16
  28. package/lib/types/payroll.d.ts +117 -81
  29. package/lib/types/performance.d.ts +1 -1
  30. package/lib/types/search.d.ts +4 -1
  31. package/lib/types/security_and_compliance.d.ts +254 -1
  32. package/lib/ws.d.ts +30 -0
  33. package/package.json +6 -3
  34. package/src/bot.ts +28 -15
  35. package/src/http.ts +10 -4
  36. package/src/types/acs.ts +4 -1
  37. package/src/types/aily.ts +3 -3
  38. package/src/types/apaas.ts +237 -38
  39. package/src/types/application.ts +20 -4
  40. package/src/types/approval.ts +0 -15
  41. package/src/types/attendance.ts +11 -5
  42. package/src/types/authen.ts +8 -2
  43. package/src/types/bitable.ts +25 -4
  44. package/src/types/board.ts +75 -2
  45. package/src/types/calendar.ts +88 -5
  46. package/src/types/cardkit.ts +2 -2
  47. package/src/types/compensation.ts +485 -0
  48. package/src/types/contact.ts +55 -12
  49. package/src/types/corehr.ts +1480 -123
  50. package/src/types/directory.ts +3 -53
  51. package/src/types/docx.ts +29 -0
  52. package/src/types/drive.ts +129 -112
  53. package/src/types/ehr.ts +11 -2
  54. package/src/types/helpdesk.ts +15 -6
  55. package/src/types/hire.ts +66 -3
  56. package/src/types/human_authentication.ts +1 -1
  57. package/src/types/im.ts +77 -21
  58. package/src/types/index.ts +1751 -107
  59. package/src/types/mail.ts +106 -16
  60. package/src/types/payroll.ts +146 -103
  61. package/src/types/performance.ts +1 -1
  62. package/src/types/search.ts +4 -1
  63. package/src/types/security_and_compliance.ts +292 -1
  64. package/src/ws.ts +183 -0
  65. package/lib/types/api.d.ts +0 -28510
  66. package/lib/types/internal.d.ts +0 -21
  67. package/lib/types/message/content.d.ts +0 -433
  68. package/lib/types/message/index.d.ts +0 -95
@@ -27,17 +27,24 @@ export declare namespace Corehr {
27
27
  company: Company.Methods;
28
28
  costCenter: CostCenter.Methods;
29
29
  customOrg: CustomOrg.Methods;
30
+ draft: Draft.Methods;
30
31
  approvalGroups: ApprovalGroups.Methods;
31
32
  jobFamily: JobFamily.Methods;
32
33
  jobLevel: JobLevel.Methods;
33
34
  jobGrade: JobGrade.Methods;
35
+ pathway: Pathway.Methods;
34
36
  job: Job.Methods;
37
+ position: Position.Methods;
35
38
  preHire: PreHire.Methods;
36
39
  probation: Probation.Methods;
37
40
  jobChange: JobChange.Methods;
38
41
  transferType: TransferType.Methods;
39
42
  transferReason: TransferReason.Methods;
40
43
  offboarding: Offboarding.Methods;
44
+ signatureFile: SignatureFile.Methods;
45
+ signatureNode: SignatureNode.Methods;
46
+ signatureTemplate: SignatureTemplate.Methods;
47
+ signatureTemplateInfoWithThumbnail: SignatureTemplateInfoWithThumbnail.Methods;
41
48
  contract: Contract.Methods;
42
49
  workforcePlanDetailRow: WorkforcePlanDetailRow.Methods;
43
50
  reportDetailRow: ReportDetailRow.Methods;
@@ -78,7 +85,10 @@ export declare namespace Corehr {
78
85
  getByParam(query?: GetByParamQuery): Promise<GetByParamResponse>;
79
86
  }
80
87
  interface QueryQuery {
81
- /** 所属对象 apiname,支持一个或多个当前数量限制为 20 个 */
88
+ /**
89
+ * 所属对象 apiname,支持一个或多个
90
+ * 当前数量限制为 20 个
91
+ */
82
92
  object_api_name_list: string[];
83
93
  }
84
94
  interface QueryResponse {
@@ -115,9 +125,9 @@ export declare namespace Corehr {
115
125
  editEnumOption(body: EditEnumOptionRequest, query?: EditEnumOptionQuery): Promise<EditEnumOptionResponse>;
116
126
  }
117
127
  interface AddEnumOptionRequest {
118
- /** 所属对象 API name,可通过[获取飞书人事对象列表](/ssl:ttdoc/server-docs/corehr-v1/basic-infomation/custom_field/list_object_api_name)接口中返回的 `object_api_name` 字段获取 */
128
+ /** 所属对象 API name,可通过[获取飞书人事对象列表](https://open.feishu.cn/document/server-docs/corehr-v1/basic-infomation/custom_field/list_object_api_name)接口中返回的 `object_api_name` 字段获取 */
119
129
  object_api_name: string;
120
- /** 枚举字段 API name,可通过[获取自定义字段列表](/ssl:ttdoc/server-docs/corehr-v1/basic-infomation/custom_field/query)接口中返回的 `custom_api_name` 字段获取 */
130
+ /** 枚举字段 API name,可通过[获取自定义字段列表](https://open.feishu.cn/document/server-docs/corehr-v1/basic-infomation/custom_field/query)接口中返回的 `custom_api_name` 字段获取 */
121
131
  enum_field_api_name: string;
122
132
  /** 新增枚举选项列表 */
123
133
  enum_field_options: Lark.EnumFieldOption[];
@@ -133,9 +143,9 @@ export declare namespace Corehr {
133
143
  enum_field_options?: Lark.EnumFieldOption[];
134
144
  }
135
145
  interface EditEnumOptionRequest {
136
- /** 所属对象 API name,可通过[获取飞书人事对象列表](/ssl:ttdoc/server-docs/corehr-v1/basic-infomation/custom_field/list_object_api_name)接口中返回的 `object_api_name` 字段获取 */
146
+ /** 所属对象 API name,可通过[获取飞书人事对象列表](https://open.feishu.cn/document/server-docs/corehr-v1/basic-infomation/custom_field/list_object_api_name)接口中返回的 `object_api_name` 字段获取 */
137
147
  object_api_name: string;
138
- /** 枚举字段 API name,可通过[获取自定义字段列表](/ssl:ttdoc/server-docs/corehr-v1/basic-infomation/custom_field/query)接口中返回的 `custom_api_name` 字段获取 */
148
+ /** 枚举字段 API name,可通过[获取自定义字段列表](https://open.feishu.cn/document/server-docs/corehr-v1/basic-infomation/custom_field/query)接口中返回的 `custom_api_name` 字段获取 */
139
149
  enum_field_api_name: string;
140
150
  /** 枚举选项 */
141
151
  enum_field_option: Lark.EnumFieldOption;
@@ -234,7 +244,7 @@ export declare namespace Corehr {
234
244
  Inactive = 0
235
245
  }
236
246
  interface SearchRequest {
237
- /** 国家/地区 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` 等字段中获取 */
247
+ /** 国家/地区 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` 等字段中获取 */
238
248
  country_region_id_list?: string[];
239
249
  /** 状态列表 */
240
250
  status_list?: SearchRequestStatus[];
@@ -278,9 +288,9 @@ export declare namespace Corehr {
278
288
  Inactive = 0
279
289
  }
280
290
  interface SearchRequest {
281
- /** 省份/主要行政区 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` 等字段中获取 */
291
+ /** 省份/主要行政区 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` 等字段中获取 */
282
292
  country_region_subdivision_id_list?: string[];
283
- /** 城市 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` 等字段中获取 */
293
+ /** 城市 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` 等字段中获取 */
284
294
  city_id_list?: string[];
285
295
  /** 状态列表 */
286
296
  status_list?: SearchRequestStatus[];
@@ -301,9 +311,9 @@ export declare namespace Corehr {
301
311
  Inactive = 0
302
312
  }
303
313
  interface SearchRequest {
304
- /** 所属城市 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` 等字段中获取 */
314
+ /** 所属城市 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` 等字段中获取 */
305
315
  city_id_list?: string[];
306
- /** 区/县 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` 等字段中获取 */
316
+ /** 区/县 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` 等字段中获取 */
307
317
  district_id_list?: string[];
308
318
  /** 状态列表 */
309
319
  status_list?: SearchRequestStatus[];
@@ -324,9 +334,9 @@ export declare namespace Corehr {
324
334
  Inactive = 0
325
335
  }
326
336
  interface SearchRequest {
327
- /** 国籍 ID 列表,可从[搜索员工信息](/ssl:ttdoc/server-docs/corehr-v1/employee/search)接口返回的 `person_info.nationality_id_v2` 等字段中获取 */
337
+ /** 国籍 ID 列表,可从[搜索员工信息](https://open.feishu.cn/document/server-docs/corehr-v1/employee/search)接口返回的 `person_info.nationality_id_v2` 等字段中获取 */
328
338
  nationality_id_list?: string[];
329
- /** 国家/地区 ID 列表,可通过[查询国家/地区信息](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口列举 */
339
+ /** 国家/地区 ID 列表,可通过[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口列举 */
330
340
  country_region_id_list?: string[];
331
341
  /** 状态列表 */
332
342
  status_list?: SearchRequestStatus[];
@@ -347,7 +357,7 @@ export declare namespace Corehr {
347
357
  Disabled = 0
348
358
  }
349
359
  interface SearchRequest {
350
- /** 银行 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` 字段获取 */
360
+ /** 银行 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` 字段获取 */
351
361
  bank_id_list?: string[];
352
362
  /** 银行名称列表,支持对银行名称精确搜索 */
353
363
  bank_name_list?: string[];
@@ -374,9 +384,9 @@ export declare namespace Corehr {
374
384
  Inactive = 0
375
385
  }
376
386
  interface SearchRequest {
377
- /** 银行 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` 字段中获取 */
387
+ /** 银行 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` 字段中获取 */
378
388
  bank_id_list?: string[];
379
- /** 支行 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` 字段获取 */
389
+ /** 支行 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` 字段获取 */
380
390
  bank_branch_id_list?: string[];
381
391
  /** 支行名称列表,支持对支行名称精确搜索 */
382
392
  bank_branch_name_list?: string[];
@@ -405,7 +415,7 @@ export declare namespace Corehr {
405
415
  Inactive = 0
406
416
  }
407
417
  interface SearchRequest {
408
- /** 货币 ID 列表,可通过[批量查询薪资方案](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/compensation-v1/plan/list)、[批量查询员工薪资档案](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/compensation-v1/archive/query)等接口返回的 `currency_id` 字段获取 */
418
+ /** 货币 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` 字段获取 */
409
419
  currency_id_list?: string[];
410
420
  /** 状态列表 */
411
421
  status_list?: SearchRequestStatus[];
@@ -778,37 +788,98 @@ export declare namespace Corehr {
778
788
  additional_national_id_number_list?: string[];
779
789
  /** 公民身份类型列表,精确匹配查询 */
780
790
  citizenship_status_list?: string[];
781
- /** 成本中心 ID 列表- 可通过 [【搜索成本中心信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search) 获取 */
791
+ /**
792
+ * 成本中心 ID 列表
793
+ * - 可通过 [【搜索成本中心信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/cost_center/search) 获取
794
+ */
782
795
  cost_center_id_list?: string[];
783
- /** 任职公司 ID 列表- [【批量查询公司】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取 */
796
+ /**
797
+ * 任职公司 ID 列表
798
+ * - [【批量查询公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取
799
+ */
784
800
  service_company_list?: string[];
785
- /** 任职公司 ID 列表(含下级)- [【批量查询公司】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取 */
801
+ /**
802
+ * 任职公司 ID 列表(含下级)
803
+ * - [【批量查询公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取
804
+ */
786
805
  service_company_list_include_sub?: string[];
787
- /** 序列 ID 列表 - [【批量查询序列】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取 */
806
+ /**
807
+ * 序列 ID 列表
808
+ * - [【批量查询序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取
809
+ */
788
810
  job_family_id_list?: string[];
789
- /** 序列 ID 列表(含下级) - [【批量查询序列】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取 */
811
+ /**
812
+ * 序列 ID 列表(含下级)
813
+ * - [【批量查询序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取
814
+ */
790
815
  job_family_id_list_include_sub?: string[];
791
- /** 职级 ID 列表- 可通过[【批量查询职级】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取- 需要有字段读取权限 */
816
+ /**
817
+ * 职级 ID 列表
818
+ * - 可通过[【批量查询职级】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取
819
+ * - 需要有字段读取权限
820
+ */
792
821
  job_level_id_list?: string[];
793
- /** 职等 ID 列表- 可通过[【查询职等】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)获取- 需要有字段读取权限 */
822
+ /**
823
+ * 职等 ID 列表
824
+ * - 可通过[【查询职等】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)获取
825
+ * - 需要有字段读取权限
826
+ */
794
827
  job_grade_id_list?: string[];
795
- /** 职务 ID 列表- 可通过[【批量查询职务】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取- 需要有字段读取权限 */
828
+ /**
829
+ * 职务 ID 列表
830
+ * - 可通过[【批量查询职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取
831
+ * - 需要有字段读取权限
832
+ */
796
833
  job_id_list?: string[];
797
- /** 岗位 ID 列表 - 功能灰度中,如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) - 需要有字段读取权限 */
834
+ /**
835
+ * 岗位 ID 列表
836
+ * - 功能灰度中,如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
837
+ * - 需要有字段读取权限
838
+ */
798
839
  position_id_list?: string[];
799
- /** 岗位 ID 列表(含下级) - 功能灰度中,如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) - 需要有字段读取权限 */
840
+ /**
841
+ * 岗位 ID 列表(含下级)
842
+ * - 功能灰度中,如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
843
+ * - 需要有字段读取权限
844
+ */
800
845
  position_id_list_include_sub?: string[];
801
- /** 工时制度 ID 列表- 可通过[【批量查询工时制度】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取- 需要有字段读取权限 */
846
+ /**
847
+ * 工时制度 ID 列表
848
+ * - 可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取
849
+ * - 需要有字段读取权限
850
+ */
802
851
  working_hours_type_id_list?: string[];
803
- /** 国籍 ID 列表- 可通过[【查询国籍信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)获取- 需要有字段读取权限 */
852
+ /**
853
+ * 国籍 ID 列表
854
+ * - 可通过[【查询国籍信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)获取
855
+ * - 需要有字段读取权限
856
+ */
804
857
  nationality_id_list?: string[];
805
- /** 员工所属薪资组 ID 列表 - 可通过 [【获取薪资组基本信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/payroll-v1/paygroup/list) 获取 - 需要有字段读取权限 */
858
+ /**
859
+ * 员工所属薪资组 ID 列表
860
+ * - 可通过 [【获取薪资组基本信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/payroll-v1/paygroup/list) 获取
861
+ * - 需要有字段读取权限
862
+ */
806
863
  pay_group_id_list?: string[];
807
- /** 员工所属外派薪资组 ID 列表- 可通过 [【获取薪资组基本信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/payroll-v1/paygroup/list) 获取- 需要有字段读取权限 */
864
+ /**
865
+ * 员工所属外派薪资组 ID 列表
866
+ * - 可通过 [【获取薪资组基本信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/payroll-v1/paygroup/list) 获取
867
+ * - 需要有字段读取权限
868
+ */
808
869
  assignment_pay_group_id_list?: string[];
809
- /** 员工当前合同类型列表- 可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)查询 - object_api_name:contract - custom_api_name:contract_type- 需要有字段读取权限 */
870
+ /**
871
+ * 员工当前合同类型列表
872
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)查询
873
+ * - object_api_name:contract
874
+ * - custom_api_name:contract_type
875
+ * - 需要有字段读取权限
876
+ */
810
877
  contract_type_list?: string[];
811
- /** 员工当前所属薪资方案 ID 列表- 可通过[【批量查询薪资方案】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/compensation-v1/plan/list)获取- 需要有字段读取权限 */
878
+ /**
879
+ * 员工当前所属薪资方案 ID 列表
880
+ * - 可通过[【批量查询薪资方案】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/compensation-v1/plan/list)获取
881
+ * - 需要有字段读取权限
882
+ */
812
883
  archive_cpst_plan_id_list?: string[];
813
884
  }
814
885
  interface SearchQuery extends Pagination {
@@ -830,7 +901,11 @@ export declare namespace Corehr {
830
901
  interface CreateQuery {
831
902
  /** 幂等标识,服务端会忽略client_token重复的请求 */
832
903
  client_token?: string;
833
- /** 是否为离职重聘:false: 否,系统直接标为非离职重聘人员,不再做重复判断"true: 是,要求rehire_employment_id */
904
+ /**
905
+ * 是否为离职重聘:
906
+ * false: 否,系统直接标为非离职重聘人员,不再做重复判断"
907
+ * true: 是,要求rehire_employment_id
908
+ */
834
909
  rehire?: boolean;
835
910
  /** 离职重聘员工雇佣ID, rehire */
836
911
  rehire_employment_id?: string;
@@ -1293,7 +1368,11 @@ export declare namespace Corehr {
1293
1368
  user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id';
1294
1369
  /** 此次调用中使用的部门 ID 类型 */
1295
1370
  department_id_type?: 'open_department_id' | 'department_id' | 'people_corehr_department_id';
1296
- /** 是否强校验。值为 true 时,会对入参进行业务校验,并产生异动记录、发送异动事件。- 默认值:false- 仅在新增任职版本时生效,当 version_id 不为空时该字段不生效 */
1371
+ /**
1372
+ * 是否强校验。值为 true 时,会对入参进行业务校验,并产生异动记录、发送异动事件。
1373
+ * - 默认值:false
1374
+ * - 仅在新增任职版本时生效,当 version_id 不为空时该字段不生效
1375
+ */
1297
1376
  strict_verify?: string;
1298
1377
  }
1299
1378
  interface PatchResponse {
@@ -1329,6 +1408,7 @@ export declare namespace Corehr {
1329
1408
  namespace Employees {
1330
1409
  interface Methods {
1331
1410
  jobData: JobData.Methods;
1411
+ internationalAssignment: InternationalAssignment.Methods;
1332
1412
  additionalJob: AdditionalJob.Methods;
1333
1413
  bp: Bp.Methods;
1334
1414
  }
@@ -1358,9 +1438,19 @@ export declare namespace Corehr {
1358
1438
  department_id?: string;
1359
1439
  /** 员工雇佣 ID 列表 */
1360
1440
  employment_ids?: string[];
1361
- /** 是否仅查询主职- true:仅返回 primary_job_data 为 true 的任职记录- false:仅返回 primary_job_data 为 false 的任职记录- 不传:返回全部 */
1441
+ /**
1442
+ * 是否仅查询主职
1443
+ * - true:仅返回 primary_job_data 为 true 的任职记录
1444
+ * - false:仅返回 primary_job_data 为 false 的任职记录
1445
+ * - 不传:返回全部
1446
+ */
1362
1447
  primary_job_data?: boolean;
1363
- /** 任职原因- 可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下: - object_api_name:job_data - custom_api_name:assignment_start_reason */
1448
+ /**
1449
+ * 任职原因
1450
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:
1451
+ * - object_api_name:job_data
1452
+ * - custom_api_name:assignment_start_reason
1453
+ */
1364
1454
  assignment_start_reasons?: string[];
1365
1455
  }
1366
1456
  interface QueryQuery extends Pagination {
@@ -1380,9 +1470,19 @@ export declare namespace Corehr {
1380
1470
  effective_date_end?: string;
1381
1471
  /** 查看数据日期,默认为今天 */
1382
1472
  data_date?: string;
1383
- /** 是否仅查询主职- true:仅返回 primary_job_data 为 true 的任职记录- false:仅返回 primary_job_data 为 false 的任职记录- 不传:返回全部 */
1473
+ /**
1474
+ * 是否仅查询主职
1475
+ * - true:仅返回 primary_job_data 为 true 的任职记录
1476
+ * - false:仅返回 primary_job_data 为 false 的任职记录
1477
+ * - 不传:返回全部
1478
+ */
1384
1479
  primary_job_data?: boolean;
1385
- /** 任职原因- 可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下: - object_api_name:job_data - custom_api_name:assignment_start_reason */
1480
+ /**
1481
+ * 任职原因
1482
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:
1483
+ * - object_api_name:job_data
1484
+ * - custom_api_name:assignment_start_reason
1485
+ */
1386
1486
  assignment_start_reasons?: string[];
1387
1487
  }
1388
1488
  interface BatchGetQuery {
@@ -1396,6 +1496,475 @@ export declare namespace Corehr {
1396
1496
  items?: Lark.EmployeeJobData[];
1397
1497
  }
1398
1498
  }
1499
+ namespace InternationalAssignment {
1500
+ interface Methods {
1501
+ /**
1502
+ * 创建外派信息
1503
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employees-international_assignment/create
1504
+ */
1505
+ create(body: CreateRequest, query?: CreateQuery): Promise<CreateResponse>;
1506
+ /**
1507
+ * 更新外派信息
1508
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employees-international_assignment/patch
1509
+ */
1510
+ patch(international_assignment_id: string, body: PatchRequest, query?: PatchQuery): Promise<PatchResponse>;
1511
+ /**
1512
+ * 批量查询外派信息
1513
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employees-international_assignment/list
1514
+ */
1515
+ list(query?: ListQuery): Promise<ListResponse>;
1516
+ /**
1517
+ * 删除外派信息
1518
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employees-international_assignment/delete
1519
+ */
1520
+ delete(international_assignment_id: string): Promise<void>;
1521
+ }
1522
+ interface CreateRequest {
1523
+ /**
1524
+ * 外派工作地点 ID
1525
+ * - 可通过[【批量查询地点】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获取
1526
+ */
1527
+ work_location_id: string;
1528
+ /**
1529
+ * 外派任职公司 ID
1530
+ * - 可通过[【批量查询公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取
1531
+ */
1532
+ service_company?: string;
1533
+ /**
1534
+ * 排班类型
1535
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:
1536
+ * - object_api_name:job_data
1537
+ * - custom_api_name:work_shift
1538
+ */
1539
+ work_shift?: string;
1540
+ /**
1541
+ * 周工作时长
1542
+ * - 限制两位小数
1543
+ */
1544
+ weekly_working_hours_v2?: number;
1545
+ /**
1546
+ * 工时制度ID
1547
+ * - 可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取
1548
+ */
1549
+ working_hours_type_id?: string;
1550
+ /**
1551
+ * 人员类型ID
1552
+ * - 可通过[【批量查询人员类型】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/list)获取
1553
+ */
1554
+ employee_type_id?: string;
1555
+ /**
1556
+ * 部门 ID
1557
+ * - 可通过[【批量查询部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获取
1558
+ * - 类型与 department_id_type 一致
1559
+ */
1560
+ department_id?: string;
1561
+ /**
1562
+ * 职务 ID
1563
+ * - 可通过[【批量查询职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取
1564
+ */
1565
+ job_id?: string;
1566
+ /**
1567
+ * 序列 ID
1568
+ * - 可通过[【批量查询序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取
1569
+ */
1570
+ job_family_id?: string;
1571
+ /**
1572
+ * 职级 ID
1573
+ * - 可通过[【批量查询职级】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取
1574
+ */
1575
+ job_level_id?: string;
1576
+ /**
1577
+ * 职等 ID
1578
+ * - 可通过[【查询职等】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)获取
1579
+ */
1580
+ job_grade_id?: string;
1581
+ /**
1582
+ * 薪资类型
1583
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:
1584
+ * - object_api_name:job_data
1585
+ * - custom_api_name:compensation_type
1586
+ */
1587
+ compensation_type?: string;
1588
+ /**
1589
+ * 直属上级雇佣 ID
1590
+ * - 可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取
1591
+ * - 类型与 user_id_type 一致
1592
+ */
1593
+ direct_manager_id?: string;
1594
+ /**
1595
+ * 虚线上级雇佣 ID
1596
+ * - 可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取
1597
+ * - 类型与 user_id_type 一致
1598
+ */
1599
+ dotted_line_manager_id?: string;
1600
+ /**
1601
+ * 工作日历 ID
1602
+ * - 可通过[【查询工作日历】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/work_calendar)获取
1603
+ */
1604
+ work_calendar_id?: string;
1605
+ /**
1606
+ * 岗位 ID
1607
+ * - 功能灰度中,请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
1608
+ */
1609
+ position_id?: string;
1610
+ /**
1611
+ * 雇佣 ID
1612
+ * - 可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取
1613
+ * - 类型与 user_id_type 一致
1614
+ */
1615
+ employment_id: string;
1616
+ /**
1617
+ * 自定义字段
1618
+ * - 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
1619
+ */
1620
+ custom_fields?: Lark.ObjectFieldData[];
1621
+ /** 外派原因说明 */
1622
+ international_assignment_reason?: string;
1623
+ /** 备注 */
1624
+ description?: string;
1625
+ /**
1626
+ * 预计结束日期
1627
+ * - 格式:yyyy-mm-dd
1628
+ */
1629
+ international_assignment_expected_end_date?: string;
1630
+ /**
1631
+ * 外派类型
1632
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:
1633
+ * - object_api_name:international_assignment
1634
+ * - custom_api_name:international_assignment_type
1635
+ */
1636
+ international_assignment_type: string;
1637
+ /**
1638
+ * 开始日期
1639
+ * - 格式:yyyy-mm-dd
1640
+ */
1641
+ effective_time: string;
1642
+ /**
1643
+ * 结束日期
1644
+ * - 格式:yyyy-mm-dd
1645
+ */
1646
+ expiration_time?: string;
1647
+ }
1648
+ interface CreateQuery {
1649
+ /** 幂等标识,服务端会忽略 client_token 重复的请求 */
1650
+ client_token?: string;
1651
+ /** 用户 ID 类型 */
1652
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id';
1653
+ /** 此次调用中使用的部门 ID 类型 */
1654
+ department_id_type?: 'open_department_id' | 'department_id' | 'people_corehr_department_id';
1655
+ }
1656
+ interface CreateResponse {
1657
+ /** 外派信息 */
1658
+ international_assignment?: Lark.EmployeesInternationalAssignmentResp;
1659
+ }
1660
+ interface PatchRequest {
1661
+ /**
1662
+ * 外派工作地点 ID
1663
+ * - 可通过[【批量查询地点】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获取
1664
+ */
1665
+ work_location_id?: string;
1666
+ /**
1667
+ * 外派任职公司 ID
1668
+ * - 可通过[【批量查询公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取
1669
+ */
1670
+ service_company?: string;
1671
+ /**
1672
+ * 排班类型
1673
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:
1674
+ * - object_api_name:job_data
1675
+ * - custom_api_name:work_shift
1676
+ */
1677
+ work_shift?: string;
1678
+ /**
1679
+ * 周工作时长
1680
+ * - 限制两位小数
1681
+ */
1682
+ weekly_working_hours_v2?: number;
1683
+ /**
1684
+ * 工时制度ID
1685
+ * - 可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取
1686
+ */
1687
+ working_hours_type_id?: string;
1688
+ /**
1689
+ * 人员类型ID
1690
+ * - 可通过[【批量查询人员类型】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/list)获取
1691
+ */
1692
+ employee_type_id?: string;
1693
+ /**
1694
+ * 部门 ID
1695
+ * - 可通过[【批量查询部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获取
1696
+ * - 类型与 department_id_type 一致
1697
+ */
1698
+ department_id?: string;
1699
+ /**
1700
+ * 职务 ID
1701
+ * - 可通过[【批量查询职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取
1702
+ */
1703
+ job_id?: string;
1704
+ /**
1705
+ * 序列 ID
1706
+ * - 可通过[【批量查询序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取
1707
+ */
1708
+ job_family_id?: string;
1709
+ /**
1710
+ * 职级 ID
1711
+ * - 可通过[【批量查询职级】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取
1712
+ */
1713
+ job_level_id?: string;
1714
+ /**
1715
+ * 职等 ID
1716
+ * - 可通过[【查询职等】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)获取
1717
+ */
1718
+ job_grade_id?: string;
1719
+ /**
1720
+ * 薪资类型
1721
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:
1722
+ * - object_api_name:job_data
1723
+ * - custom_api_name:compensation_type
1724
+ */
1725
+ compensation_type?: string;
1726
+ /**
1727
+ * 直属上级雇佣 ID
1728
+ * - 可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取
1729
+ * - 类型与 user_id_type 一致
1730
+ */
1731
+ direct_manager_id?: string;
1732
+ /**
1733
+ * 虚线上级雇佣 ID
1734
+ * - 可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取
1735
+ * - 类型与 user_id_type 一致
1736
+ */
1737
+ dotted_line_manager_id?: string;
1738
+ /**
1739
+ * 工作日历 ID
1740
+ * - 可通过[【查询工作日历】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/work_calendar)获取
1741
+ */
1742
+ work_calendar_id?: string;
1743
+ /**
1744
+ * 岗位 ID
1745
+ * - 功能灰度中,请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
1746
+ */
1747
+ position_id?: string;
1748
+ /**
1749
+ * 自定义字段
1750
+ * - 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
1751
+ */
1752
+ custom_fields?: Lark.ObjectFieldData[];
1753
+ /** 外派原因说明 */
1754
+ international_assignment_reason?: string;
1755
+ /** 备注 */
1756
+ description?: string;
1757
+ /**
1758
+ * 预计结束日期
1759
+ * - 格式:yyyy-mm-dd
1760
+ */
1761
+ international_assignment_expected_end_date?: string;
1762
+ /**
1763
+ * 外派类型
1764
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:
1765
+ * - object_api_name:international_assignment
1766
+ * - custom_api_name:international_assignment_type
1767
+ */
1768
+ international_assignment_type?: string;
1769
+ /**
1770
+ * 开始日期
1771
+ * - 格式:yyyy-mm-dd
1772
+ */
1773
+ effective_time?: string;
1774
+ /**
1775
+ * 结束日期
1776
+ * - 格式:yyyy-mm-dd
1777
+ */
1778
+ expiration_time?: string;
1779
+ }
1780
+ interface PatchQuery {
1781
+ /** 幂等标识,服务端会忽略client_token重复的请求 */
1782
+ client_token?: string;
1783
+ /** 用户 ID 类型 */
1784
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id';
1785
+ /** 此次调用中使用的部门 ID 类型 */
1786
+ department_id_type?: 'open_department_id' | 'department_id' | 'people_corehr_department_id';
1787
+ }
1788
+ interface PatchResponse {
1789
+ /** 外派信息 */
1790
+ international_assignment?: Lark.EmployeesInternationalAssignmentResp;
1791
+ }
1792
+ interface ListQuery extends Pagination {
1793
+ /** 用户 ID 类型 */
1794
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id';
1795
+ /** 此次调用中使用的部门 ID 类型 */
1796
+ department_id_type?: 'open_department_id' | 'department_id' | 'people_corehr_department_id';
1797
+ /**
1798
+ * 雇佣ID
1799
+ * - 可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息
1800
+ * - 类型必须与 user_id_type 一致
1801
+ */
1802
+ employment_ids?: string[];
1803
+ /** 外派 ID */
1804
+ international_assignment_ids?: string[];
1805
+ /**
1806
+ * 外派开始日期
1807
+ * - 范围筛选,格式:yyyy-mm-dd~yyyy-mm-dd
1808
+ */
1809
+ effective_time?: string;
1810
+ /**
1811
+ * 外派结束日期
1812
+ * - 范围筛选,格式:yyyy-mm-dd~yyyy-mm-dd
1813
+ */
1814
+ expiration_time?: string;
1815
+ /**
1816
+ * 雇佣状态
1817
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:
1818
+ * - object_api_name:employment
1819
+ * - custom_api_name:employment_status
1820
+ */
1821
+ employment_status_list?: string[];
1822
+ /**
1823
+ * 外派工作地点
1824
+ * - 可通过[【批量查询地点】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获取
1825
+ * - 需要以下权限点之一:
1826
+ * - [读取外派地点](corehr:employment.international_assignment.work_location:read)
1827
+ * - [读写外派地点](corehr:employment.international_assignment.work_location:write)
1828
+ */
1829
+ work_location_id_list?: string[];
1830
+ /**
1831
+ * 外派部门
1832
+ * - 可通过[【批量查询部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获取
1833
+ * - 类型与 department_id_type 一致
1834
+ */
1835
+ department_id_list?: string[];
1836
+ /**
1837
+ * 外派直属上级
1838
+ * - 可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取
1839
+ * - 类型与 user_id_type 一致
1840
+ */
1841
+ direct_manager_id_list?: string[];
1842
+ /**
1843
+ * 外派虚线上级
1844
+ * - 可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取
1845
+ * - 类型与 user_id_type 一致
1846
+ */
1847
+ dotted_line_manager_id_list?: string[];
1848
+ /**
1849
+ * 外派岗位
1850
+ * - 功能灰度中,请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)
1851
+ * - 需要以下权限点之一:
1852
+ * - [读取外派岗位](corehr:employment.international_assignment.position:read)
1853
+ * - [读写外派岗位](corehr:employment.international_assignment.position:write)
1854
+ */
1855
+ position_id_list?: string[];
1856
+ /**
1857
+ * 外派职务
1858
+ * - 可通过[【批量查询职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取
1859
+ * - 需要以下权限点之一:
1860
+ * - [读取外派职务](corehr:employment.international_assignment.job:read)
1861
+ * - [读写外派职务](corehr:employment.international_assignment.job:write)
1862
+ */
1863
+ job_id_list?: string[];
1864
+ /**
1865
+ * 外派序列
1866
+ * - 可通过[【批量查询序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取
1867
+ */
1868
+ job_family_id_list?: string[];
1869
+ /**
1870
+ * 外派职级
1871
+ * - 可通过[【批量查询职级】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取
1872
+ * - 需要以下权限点之一:
1873
+ * - [读取外派职级](corehr:employment.international_assignment.job_level:read)
1874
+ * - [读写外派职级](corehr:employment.international_assignment.job_level:write)
1875
+ */
1876
+ job_level_id_list?: string[];
1877
+ /**
1878
+ * 外派职等
1879
+ * - 可通过[【查询职等】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_grade/query)获取
1880
+ * - 需要以下权限点之一:
1881
+ * - [读取外派职等](corehr:employment.international_assignment.job_grade:read)
1882
+ * - [读写外派职等](corehr:employment.international_assignment.job_grade:write)
1883
+ */
1884
+ job_grade_id_list?: string[];
1885
+ /**
1886
+ * 外派工时制度
1887
+ * - 可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取
1888
+ * - 需要以下权限点之一:
1889
+ * - [读取外派工时制度](corehr:employment.international_assignment.working_hours_type:read)
1890
+ * - [读写外派工时制度](corehr:employment.international_assignment.working_hours_type:write)
1891
+ */
1892
+ working_hours_type_id_list?: string[];
1893
+ /**
1894
+ * 外派任职公司
1895
+ * - 可通过[【批量查询公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取
1896
+ * - 需要以下权限点之一:
1897
+ * - [读取外派公司](corehr:employment.international_assignment.service_company:read)
1898
+ * - [读写外派公司](corehr:employment.international_assignment.service_company:write)
1899
+ */
1900
+ service_company_list?: string[];
1901
+ /**
1902
+ * 外派周工作时长
1903
+ * - 限制两位小数
1904
+ * - 需要以下权限点之一:
1905
+ * - [读取外派周工作时长](corehr:employment.international_assignment.weekly_working_hours:read)
1906
+ * - [读写外派周工作时长](corehr:employment.international_assignment.weekly_working_hours:write)
1907
+ */
1908
+ weekly_working_hours_v2?: number;
1909
+ /**
1910
+ * 外派排班类型
1911
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:
1912
+ * - object_api_name:job_data
1913
+ * - custom_api_name:work_shift
1914
+ * - 需要以下权限点之一:
1915
+ * - [读取外派排班类型](corehr:employment.international_assignment.work_shift:read)
1916
+ * - [读写外派排班类型](corehr:employment.international_assignment.work_shift:write)
1917
+ */
1918
+ work_shift_list?: string[];
1919
+ /**
1920
+ * 外派薪资类型
1921
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:
1922
+ * - object_api_name:job_data
1923
+ * - custom_api_name:compensation_type
1924
+ * - 需要以下权限点之一:
1925
+ * - [读取外派薪资类型](corehr:employment.international_assignment.compensation_type:read)
1926
+ * - [读写外派薪资类型](corehr:employment.international_assignment.compensation_type:write)
1927
+ */
1928
+ compensation_type_list?: string[];
1929
+ /**
1930
+ * 外派预计结束日期
1931
+ * - 范围筛选,格式:yyyy-mm-dd~yyyy-mm-dd
1932
+ */
1933
+ international_assignment_expected_end_date?: string;
1934
+ /**
1935
+ * 外派状态
1936
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:
1937
+ * - object_api_name:international_assignment
1938
+ * - custom_api_name:international_assignment_status
1939
+ */
1940
+ international_assignment_status_list?: string[];
1941
+ /**
1942
+ * 外派类型
1943
+ * - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:
1944
+ * - object_api_name:international_assignment
1945
+ * - custom_api_name:international_assignment_type
1946
+ */
1947
+ international_assignment_type_list?: string[];
1948
+ /**
1949
+ * 外派工作日历
1950
+ * - 可通过[【查询工作日历】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/work_calendar)获取详细信息
1951
+ * - 需要以下权限点之一:
1952
+ * - [读取外派工作日历](corehr:employment.international_assignment.work_calendar:read)
1953
+ * - [读写外派工作日历](corehr:employment.international_assignment.work_calendar:write)
1954
+ */
1955
+ work_calendar_id_list?: string[];
1956
+ }
1957
+ interface ListResponse {
1958
+ /** 外派信息 */
1959
+ items?: Lark.EmployeesInternationalAssignment[];
1960
+ /** 无权限的雇佣ID - 在指定雇佣ID查询时请检查该参数 - 类型与 user_id_type 一致 */
1961
+ no_authority_ids?: string[];
1962
+ /** 翻页 */
1963
+ page_token?: string;
1964
+ /** 是否有更多项 */
1965
+ has_more?: boolean;
1966
+ }
1967
+ }
1399
1968
  namespace AdditionalJob {
1400
1969
  interface Methods {
1401
1970
  /**
@@ -1420,39 +1989,47 @@ export declare namespace Corehr {
1420
1989
  batch(body: BatchRequest, query?: BatchQuery): Paginated<Lark.EmployeesAdditionalJob>;
1421
1990
  }
1422
1991
  interface CreateRequest {
1423
- /** 人员类型 ID,可通过[【批量查询人员类型】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/list)获取 */
1992
+ /** 人员类型 ID,可通过[【批量查询人员类型】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/list)获取 */
1424
1993
  employee_type_id: string;
1425
- /** 工时制度 ID,可通过[【批量查询工时制度】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取详细信息 */
1994
+ /** 工时制度 ID,可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取详细信息 */
1426
1995
  working_hours_type_id?: string;
1427
- /** 工作地点 ID,可通过[【批量查询地点】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获取详细信息 */
1996
+ /** 工作地点 ID,可通过[【批量查询地点】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获取详细信息 */
1428
1997
  work_location_id?: string;
1429
- /** 部门 ID,可通过[【批量查询部门】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获取详细信息;类型与department_id_type一致 */
1998
+ /** 部门 ID,可通过[【批量查询部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获取详细信息;类型与department_id_type一致 */
1430
1999
  department_id: string;
1431
- /** 职务 ID,可通过[【批量查询职务】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取详细信息 */
2000
+ /** 职务 ID,可通过[【批量查询职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取详细信息 */
1432
2001
  job_id?: string;
1433
- /** 职级 ID,可通过[【批量查询职级】](/ssl:ttdoc//uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取详细信息 */
2002
+ /** 职级 ID,可通过[【批量查询职级】](https://open.feishu.cn/document//uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取详细信息 */
1434
2003
  job_level_id?: string;
1435
- /** 序列 ID,可通过[【批量查询序列】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取详细信息 */
2004
+ /** 序列 ID,可通过[【批量查询序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取详细信息 */
1436
2005
  job_family_id?: string;
1437
- /** 雇佣 ID,可通过[【批量查询员工信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息;类型与user_id_type一致 */
2006
+ /** 雇佣 ID,可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息;类型与user_id_type一致 */
1438
2007
  employment_id: string;
1439
2008
  /** 兼职开始日期 */
1440
2009
  start_date: string;
1441
2010
  /** 兼职结束日期,不可清空 */
1442
2011
  end_date?: string;
1443
- /** 直属上级的雇佣ID,可通过[【批量查询员工信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息;类型与user_id_type一致 */
2012
+ /** 直属上级的雇佣ID,可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息;类型与user_id_type一致 */
1444
2013
  direct_manager_id?: string;
1445
- /** 虚线上级的雇佣ID,可通过[【批量查询员工信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息;类型与user_id_type一致 */
2014
+ /** 虚线上级的雇佣ID,可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息;类型与user_id_type一致 */
1446
2015
  dotted_line_manager_id?: string;
1447
- /** 排班类型,可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:- object_api_name = "job_data"- custom_api_name = "work_shift" */
2016
+ /**
2017
+ * 排班类型,可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:
2018
+ * - object_api_name = "job_data"
2019
+ * - custom_api_name = "work_shift"
2020
+ */
1448
2021
  work_shift?: Lark.Enum;
1449
- /** 薪资类型,可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:- object_api_name = "job_data"- custom_api_name = "compensation_type" */
2022
+ /**
2023
+ * 薪资类型,可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:
2024
+ * - object_api_name = "job_data"
2025
+ * - custom_api_name = "compensation_type"
2026
+ */
1450
2027
  compensation_type?: Lark.Enum;
1451
- /** 任职公司,可通过[【批量查询公司】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取详细信息 */
2028
+ /** 任职公司,可通过[【批量查询公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取详细信息 */
1452
2029
  service_company?: string;
1453
2030
  /** 周工作时长【0~168】 */
1454
2031
  weekly_working_hours?: string;
1455
- /** 工作日历ID,可通过[【查询工作日历】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/work_calendar)获取详细信息 */
2032
+ /** 工作日历ID,可通过[【查询工作日历】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/work_calendar)获取详细信息 */
1456
2033
  work_calendar_id?: string;
1457
2034
  /** 岗位 ID */
1458
2035
  position_id?: string;
@@ -1471,37 +2048,45 @@ export declare namespace Corehr {
1471
2048
  additional_job?: Lark.EmployeesAdditionalJobWriteResp;
1472
2049
  }
1473
2050
  interface PatchRequest {
1474
- /** 人员类型 ID,可通过[【批量查询人员类型】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/list)获取 */
2051
+ /** 人员类型 ID,可通过[【批量查询人员类型】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employee_type/list)获取 */
1475
2052
  employee_type_id?: string;
1476
- /** 工时制度 ID,可通过[【批量查询工时制度】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取详细信息 */
2053
+ /** 工时制度 ID,可通过[【批量查询工时制度】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/working_hours_type/list)获取详细信息 */
1477
2054
  working_hours_type_id?: string;
1478
- /** 工作地点 ID,可通过[【批量查询地点】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获取详细信息 */
2055
+ /** 工作地点 ID,可通过[【批量查询地点】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/location/list)获取详细信息 */
1479
2056
  work_location_id?: string;
1480
- /** 部门 ID,可通过[【批量查询部门】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获取详细信息;类型与department_id_type一致 */
2057
+ /** 部门 ID,可通过[【批量查询部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)获取详细信息;类型与department_id_type一致 */
1481
2058
  department_id?: string;
1482
- /** 职务 ID,可通过[【批量查询职务】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取详细信息 */
2059
+ /** 职务 ID,可通过[【批量查询职务】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)获取详细信息 */
1483
2060
  job_id?: string;
1484
- /** 职级 ID,可通过[【批量查询职级】](/ssl:ttdoc//uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取详细信息 */
2061
+ /** 职级 ID,可通过[【批量查询职级】](https://open.feishu.cn/document//uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_level/list)获取详细信息 */
1485
2062
  job_level_id?: string;
1486
- /** 序列 ID,可通过[【批量查询序列】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取详细信息 */
2063
+ /** 序列 ID,可通过[【批量查询序列】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)获取详细信息 */
1487
2064
  job_family_id?: string;
1488
2065
  /** 兼职开始日期 */
1489
2066
  start_date?: string;
1490
2067
  /** 兼职结束日期,不可清空 */
1491
2068
  end_date?: string;
1492
- /** 直属上级的雇佣ID,可通过[【批量查询员工信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息;类型与user_id_type一致 */
2069
+ /** 直属上级的雇佣ID,可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息;类型与user_id_type一致 */
1493
2070
  direct_manager_id?: string;
1494
- /** 虚线上级的雇佣ID,可通过[【批量查询员工信息】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息;类型与user_id_type一致 */
2071
+ /** 虚线上级的雇佣ID,可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息;类型与user_id_type一致 */
1495
2072
  dotted_line_manager_id?: string;
1496
- /** 排班类型,可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:- object_api_name = "job_data"- custom_api_name = "work_shift" */
2073
+ /**
2074
+ * 排班类型,可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:
2075
+ * - object_api_name = "job_data"
2076
+ * - custom_api_name = "work_shift"
2077
+ */
1497
2078
  work_shift?: Lark.Enum;
1498
- /** 薪资类型,可通过[【获取字段详情】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:- object_api_name = "job_data"- custom_api_name = "compensation_type" */
2079
+ /**
2080
+ * 薪资类型,可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询,查询参数如下:
2081
+ * - object_api_name = "job_data"
2082
+ * - custom_api_name = "compensation_type"
2083
+ */
1499
2084
  compensation_type?: Lark.Enum;
1500
- /** 任职公司,可通过[【批量查询公司】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取详细信息 */
2085
+ /** 任职公司,可通过[【批量查询公司】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)获取详细信息 */
1501
2086
  service_company?: string;
1502
2087
  /** 周工作时长【0~168】 */
1503
2088
  weekly_working_hours?: string;
1504
- /** 工作日历ID,可通过[【查询工作日历】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/work_calendar)获取详细信息 */
2089
+ /** 工作日历ID,可通过[【查询工作日历】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/leave/work_calendar)获取详细信息 */
1505
2090
  work_calendar_id?: string;
1506
2091
  /** 岗位 ID */
1507
2092
  position_id?: string;
@@ -1964,13 +2549,19 @@ export declare namespace Corehr {
1964
2549
  active?: boolean;
1965
2550
  /** 当通过上级部门 ID 查询时,填写 true 返回所有子部门,填写 false 只返回直接下级部门 */
1966
2551
  get_all_children?: boolean;
1967
- /** manager ID 列表**字段权限要求:按照部门负责人搜索 (corehr:department.manager.search:read)** */
2552
+ /**
2553
+ * manager ID 列表
2554
+ * **字段权限要求:按照部门负责人搜索 (corehr:department.manager.search:read)**
2555
+ */
1968
2556
  manager_list?: string[];
1969
2557
  /** 部门 ID 列表 */
1970
2558
  department_id_list?: string[];
1971
2559
  /** 部门名称列表,需精确匹配 */
1972
2560
  name_list?: string[];
1973
- /** 上级部门 ID ,可查询直接下级部门**字段权限要求:按照上级部门搜索 (corehr:department.organize.search:read) ** */
2561
+ /**
2562
+ * 上级部门 ID ,可查询直接下级部门
2563
+ * **字段权限要求:按照上级部门搜索 (corehr:department.organize.search:read) **
2564
+ */
1974
2565
  parent_department_id?: string;
1975
2566
  /** 部门 code 列表 */
1976
2567
  code_list?: string[];
@@ -2737,8 +3328,34 @@ export declare namespace Corehr {
2737
3328
  object_api_name: string;
2738
3329
  }
2739
3330
  }
3331
+ namespace Draft {
3332
+ interface Methods {
3333
+ /**
3334
+ * 根据组织架构调整 ID 查询发起的流程信息
3335
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/draft/get
3336
+ */
3337
+ get(draft_id: string, query?: GetQuery): Promise<GetResponse>;
3338
+ }
3339
+ interface GetQuery {
3340
+ /** 用户 ID 类型 */
3341
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id';
3342
+ }
3343
+ interface GetResponse {
3344
+ /** 组织架构调整 ID */
3345
+ draft_id?: string;
3346
+ /** 组织架构调整状态 */
3347
+ draft_status?: '0' | '1' | '2' | '3';
3348
+ /** 组织架构调整流程信息列表 */
3349
+ process_infos?: Lark.ProcessInfo[];
3350
+ }
3351
+ }
2740
3352
  namespace ApprovalGroups {
2741
3353
  interface Methods {
3354
+ /**
3355
+ * 批量查询岗位调整内容
3356
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/approval_groups/open_query_position_change_list_by_ids
3357
+ */
3358
+ openQueryPositionChangeListByIds(body: OpenQueryPositionChangeListByIdsRequest, query?: OpenQueryPositionChangeListByIdsQuery): Promise<OpenQueryPositionChangeListByIdsResponse>;
2742
3359
  /**
2743
3360
  * 根据流程 ID 查询组织架构调整记录
2744
3361
  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/approval_groups/get
@@ -2755,6 +3372,24 @@ export declare namespace Corehr {
2755
3372
  */
2756
3373
  openQueryJobChangeListByIds(body: OpenQueryJobChangeListByIdsRequest, query?: OpenQueryJobChangeListByIdsQuery): Promise<OpenQueryJobChangeListByIdsResponse>;
2757
3374
  }
3375
+ interface OpenQueryPositionChangeListByIdsRequest {
3376
+ /** 岗位调整记录 ID List */
3377
+ position_change_ids?: string[];
3378
+ /** 是否返回部门全路径 */
3379
+ need_department_path?: boolean;
3380
+ }
3381
+ interface OpenQueryPositionChangeListByIdsQuery {
3382
+ /** 组织架构调整流程 ID */
3383
+ process_id: string;
3384
+ /** 用户 ID 类型 */
3385
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id';
3386
+ /** 此次调用中使用的部门 ID 类型 */
3387
+ department_id_type?: 'open_department_id' | 'department_id' | 'people_corehr_department_id';
3388
+ }
3389
+ interface OpenQueryPositionChangeListByIdsResponse {
3390
+ /** 岗位调整记录信息列表 */
3391
+ position_changes?: Lark.PositionChange[];
3392
+ }
2758
3393
  interface GetQuery {
2759
3394
  /** 用户 ID 类型 */
2760
3395
  user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id';
@@ -2828,10 +3463,15 @@ export declare namespace Corehr {
2828
3463
  */
2829
3464
  queryRecentChange(query?: QueryRecentChangeQuery): Promise<QueryRecentChangeResponse>;
2830
3465
  /**
2831
- * 通过序列 ID 批量获取序列信息
3466
+ * 根据条件批量获取序列信息
2832
3467
  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_family/batch_get
2833
3468
  */
2834
3469
  batchGet(body: BatchGetRequest): Promise<BatchGetResponse>;
3470
+ /**
3471
+ * 查询指定时间范围序列版本
3472
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_family/query_multi_timeline
3473
+ */
3474
+ queryMultiTimeline(body: QueryMultiTimelineRequest): Promise<QueryMultiTimelineResponse>;
2835
3475
  /**
2836
3476
  * 删除序列
2837
3477
  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/delete
@@ -2908,6 +3548,20 @@ export declare namespace Corehr {
2908
3548
  /** 查询的序列信息 */
2909
3549
  items?: Lark.JobFamily[];
2910
3550
  }
3551
+ interface QueryMultiTimelineRequest {
3552
+ /** 序列 ID 列表 */
3553
+ job_family_ids: string[];
3554
+ /** 查询开始时间(包含) */
3555
+ start_date?: string;
3556
+ /** 查询结束时间(包含) */
3557
+ end_date?: string;
3558
+ /** 返回数据的字段列表,可选["job_family_name", "code", "active", "parent_job_family_id", "description", "effective_date"] */
3559
+ fields?: string[];
3560
+ }
3561
+ interface QueryMultiTimelineResponse {
3562
+ /** 序列信息 */
3563
+ items?: Lark.JobFamilyTimeline[];
3564
+ }
2911
3565
  }
2912
3566
  namespace JobLevel {
2913
3567
  interface Methods {
@@ -2937,7 +3591,7 @@ export declare namespace Corehr {
2937
3591
  */
2938
3592
  queryRecentChange(query?: QueryRecentChangeQuery): Promise<QueryRecentChangeResponse>;
2939
3593
  /**
2940
- * 通过职级 ID 批量获取职级信息
3594
+ * 根据条件批量获取职级信息
2941
3595
  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job_level/batch_get
2942
3596
  */
2943
3597
  batchGet(body: BatchGetRequest): Promise<BatchGetResponse>;
@@ -3109,6 +3763,77 @@ export declare namespace Corehr {
3109
3763
  deleted_job_grade_ids?: string[];
3110
3764
  }
3111
3765
  }
3766
+ namespace Pathway {
3767
+ interface Methods {
3768
+ /**
3769
+ * 创建通道
3770
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/pathway/create
3771
+ */
3772
+ create(body: CreateRequest, query?: CreateQuery): Promise<CreateResponse>;
3773
+ /**
3774
+ * 更新通道
3775
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/pathway/patch
3776
+ */
3777
+ patch(pathway_id: string, body: PatchRequest, query?: PatchQuery): Promise<void>;
3778
+ /**
3779
+ * 删除通道
3780
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/pathway/delete
3781
+ */
3782
+ delete(pathway_id: string): Promise<void>;
3783
+ /**
3784
+ * 启停用通道
3785
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/pathway/active
3786
+ */
3787
+ active(body: ActiveRequest): Promise<void>;
3788
+ /**
3789
+ * 获取通道信息
3790
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/pathway/batch_get
3791
+ */
3792
+ batchGet(body: BatchGetRequest): Promise<BatchGetResponse>;
3793
+ }
3794
+ interface CreateRequest {
3795
+ /** 编码 */
3796
+ code?: string;
3797
+ /** 名称 */
3798
+ names: Lark.I18n[];
3799
+ /** 描述 */
3800
+ descriptions?: Lark.I18n[];
3801
+ }
3802
+ interface CreateQuery {
3803
+ /** 根据client_token是否一致来判断是否为同一请求 */
3804
+ client_token?: string;
3805
+ }
3806
+ interface CreateResponse {
3807
+ /** 通道ID */
3808
+ pathway_id?: string;
3809
+ }
3810
+ interface PatchRequest {
3811
+ /** 编码 */
3812
+ code?: string;
3813
+ /** 名称 */
3814
+ names?: Lark.I18n[];
3815
+ /** 描述 */
3816
+ descriptions?: Lark.I18n[];
3817
+ }
3818
+ interface PatchQuery {
3819
+ /** 根据client_token是否一致来判断是否为同一请求 */
3820
+ client_token?: string;
3821
+ }
3822
+ interface ActiveRequest {
3823
+ /** 通道ID */
3824
+ pathway_id: string;
3825
+ /** 启用停用状态 */
3826
+ active: boolean;
3827
+ }
3828
+ interface BatchGetRequest {
3829
+ /** 通道 ID 列表 */
3830
+ pathway_ids: string[];
3831
+ }
3832
+ interface BatchGetResponse {
3833
+ /** 查询的通道信息 */
3834
+ items?: Lark.Pathway[];
3835
+ }
3836
+ }
3112
3837
  namespace Job {
3113
3838
  interface Methods {
3114
3839
  /**
@@ -3136,6 +3861,16 @@ export declare namespace Corehr {
3136
3861
  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list
3137
3862
  */
3138
3863
  list(query?: ListQuery): Paginated<Lark.Job>;
3864
+ /**
3865
+ * 根据条件批量获取职务
3866
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/batch_get
3867
+ */
3868
+ batchGet(body: BatchGetRequest, query?: BatchGetQuery): Promise<BatchGetResponse>;
3869
+ /**
3870
+ * 查询指定时间范围职务版本
3871
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/query_multi_timeline
3872
+ */
3873
+ queryMultiTimeline(body: QueryMultiTimelineRequest): Promise<QueryMultiTimelineResponse>;
3139
3874
  /**
3140
3875
  * 查询当前生效信息发生变更的职务
3141
3876
  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/query_recent_change
@@ -3210,6 +3945,36 @@ export declare namespace Corehr {
3210
3945
  /** 语言 */
3211
3946
  query_language?: string;
3212
3947
  }
3948
+ interface BatchGetRequest {
3949
+ /** 职务 ID 列表 */
3950
+ job_ids?: string[];
3951
+ /** 职务 Code 列表 */
3952
+ job_codes?: string[];
3953
+ /** 返回数据的字段列表 */
3954
+ fields?: string[];
3955
+ }
3956
+ interface BatchGetQuery {
3957
+ /** 用户 ID 类型 */
3958
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id';
3959
+ }
3960
+ interface BatchGetResponse {
3961
+ /** 查询的职务信息 */
3962
+ items?: Lark.Job[];
3963
+ }
3964
+ interface QueryMultiTimelineRequest {
3965
+ /** 职务 ID 列表 */
3966
+ job_ids: string[];
3967
+ /** 查询开始时间(包含) */
3968
+ start_date?: string;
3969
+ /** 查询结束时间(包含) */
3970
+ end_date?: string;
3971
+ /** 返回数据的字段列表,可选["job_name", "code", "active", "parent_job", "description", "effective_date", "expiration_date"] */
3972
+ fields?: string[];
3973
+ }
3974
+ interface QueryMultiTimelineResponse {
3975
+ /** 职务信息 */
3976
+ items?: Lark.JobTimeline[];
3977
+ }
3213
3978
  interface QueryRecentChangeQuery extends Pagination {
3214
3979
  /** 查询的开始时间,支持"yyyy-MM-dd HH:MM:SS" */
3215
3980
  start_date: string;
@@ -3227,6 +3992,176 @@ export declare namespace Corehr {
3227
3992
  deleted_job_ids?: string[];
3228
3993
  }
3229
3994
  }
3995
+ namespace Position {
3996
+ interface Methods {
3997
+ /**
3998
+ * 创建岗位信息
3999
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/position/create
4000
+ */
4001
+ create(body: CreateRequest, query?: CreateQuery): Promise<CreateResponse>;
4002
+ /**
4003
+ * 更新岗位信息
4004
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/position/patch
4005
+ */
4006
+ patch(position_id: string, body: PatchRequest, query?: PatchQuery): Promise<void>;
4007
+ /**
4008
+ * 查询岗位信息
4009
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/position/query
4010
+ */
4011
+ query(body: QueryRequest, query?: QueryQuery): Paginated<Lark.Position>;
4012
+ /**
4013
+ * 查询指定时范围内当前版本信息发生变更的岗位
4014
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/position/query_recent_change
4015
+ */
4016
+ queryRecentChange(query?: QueryRecentChangeQuery): Promise<QueryRecentChangeResponse>;
4017
+ /**
4018
+ * 启停用岗位
4019
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/position/active
4020
+ */
4021
+ active(body: ActiveRequest): Promise<void>;
4022
+ /**
4023
+ * 删除岗位
4024
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/position/del_position
4025
+ */
4026
+ delPosition(body: DelPositionRequest): Promise<void>;
4027
+ }
4028
+ interface CreateRequest {
4029
+ /** 编码 */
4030
+ code?: string;
4031
+ /** 名称 */
4032
+ names: Lark.I18n[];
4033
+ /** 描述 */
4034
+ descriptions?: Lark.I18n[];
4035
+ /** 序列 */
4036
+ job_family_ids?: string[];
4037
+ /** 成本中心 */
4038
+ cost_center_id?: string;
4039
+ /** 职务 */
4040
+ job_id: string;
4041
+ /** 职级 */
4042
+ job_level_ids?: string[];
4043
+ /** 人员类型 */
4044
+ employee_type_ids?: string[];
4045
+ /** 职等 */
4046
+ job_grade_ids?: string[];
4047
+ /** 工作地点 */
4048
+ work_location_ids?: string[];
4049
+ /** 工时制度 */
4050
+ working_hours_type_id?: string;
4051
+ /** 部门 */
4052
+ department_id: string;
4053
+ /** 直属上级岗位 */
4054
+ direct_leader_id?: string;
4055
+ /** 虚线上级岗位 */
4056
+ dotted_line_leader_id?: string;
4057
+ /** 是否关键岗位 */
4058
+ is_key_position?: boolean;
4059
+ /** 生效日期 */
4060
+ effective_time: string;
4061
+ /** 自定义字段 */
4062
+ custom_fields?: Lark.CustomFieldData[];
4063
+ }
4064
+ interface CreateQuery {
4065
+ /** 根据client_token是否一致来判断是否为同一请求 */
4066
+ client_token?: string;
4067
+ /** 此次调用中使用的部门 ID 类型 */
4068
+ department_id_type?: 'open_department_id' | 'department_id' | 'people_corehr_department_id';
4069
+ }
4070
+ interface CreateResponse {
4071
+ /** 岗位ID */
4072
+ position_id?: string;
4073
+ }
4074
+ interface PatchRequest {
4075
+ /** 编码 */
4076
+ code?: string;
4077
+ /** 名称 */
4078
+ names?: Lark.I18n[];
4079
+ /** 描述 */
4080
+ descriptions?: Lark.I18n[];
4081
+ /** 序列 */
4082
+ job_family_ids?: string[];
4083
+ /** 成本中心 */
4084
+ cost_center_id?: string;
4085
+ /** 职务 */
4086
+ job_id?: string;
4087
+ /** 职级 */
4088
+ job_level_ids?: string[];
4089
+ /** 人员类型 */
4090
+ employee_type_ids?: string[];
4091
+ /** 职等 */
4092
+ job_grade_ids?: string[];
4093
+ /** 工作地点 */
4094
+ work_location_ids?: string[];
4095
+ /** 工时制度 */
4096
+ working_hours_type_id?: string;
4097
+ /** 部门 */
4098
+ department_id?: string;
4099
+ /** 直属上级岗位 */
4100
+ direct_leader_id?: string;
4101
+ /** 虚线上级岗位 */
4102
+ dotted_line_leader_id?: string;
4103
+ /** 是否关键岗位 */
4104
+ is_key_position?: boolean;
4105
+ /** 生效日期 */
4106
+ effective_time: string;
4107
+ /** 自定义字段 */
4108
+ custom_fields?: Lark.CustomFieldData[];
4109
+ }
4110
+ interface PatchQuery {
4111
+ /** 根据client_token是否一致来判断是否为同一请求 */
4112
+ client_token?: string;
4113
+ /** 此次调用中使用的部门 ID 类型 */
4114
+ department_id_type?: 'open_department_id' | 'department_id' | 'people_corehr_department_id';
4115
+ }
4116
+ interface QueryRequest {
4117
+ /** 部门 ID 列表 */
4118
+ department_ids?: string[];
4119
+ /** 生效日期 */
4120
+ effective_time?: string;
4121
+ /** 启停用状态 */
4122
+ active?: boolean;
4123
+ /** 返回数据的字段列表 */
4124
+ fields?: string[];
4125
+ /** 岗位 ID 列表 */
4126
+ position_ids?: string[];
4127
+ /** 岗位 Code 列表 */
4128
+ position_codes?: string[];
4129
+ }
4130
+ interface QueryQuery extends Pagination {
4131
+ /** 此次调用中使用的部门 ID 类型 */
4132
+ department_id_type?: 'open_department_id' | 'department_id' | 'people_corehr_department_id';
4133
+ /** 用户 ID 类型 */
4134
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id';
4135
+ }
4136
+ interface QueryRecentChangeQuery extends Pagination {
4137
+ /** 查询的开始时间,支持"yyyy-MM-dd HH:MM:SS" */
4138
+ start_date: string;
4139
+ /** 查询的结束时间,格式 "yyyy-MM-dd HH:MM:SS" */
4140
+ end_date: string;
4141
+ }
4142
+ interface QueryRecentChangeResponse {
4143
+ /** 岗位 ID 列表 */
4144
+ position_ids?: string[];
4145
+ /** 下一页页码 */
4146
+ page_token?: string;
4147
+ /** 是否有下一页 */
4148
+ has_more?: boolean;
4149
+ /** 删除的岗位 ID 列表 */
4150
+ deleted_position_ids?: string[];
4151
+ }
4152
+ interface ActiveRequest {
4153
+ /** 岗位ID */
4154
+ position_id: string;
4155
+ /** 启用停用状态 */
4156
+ active: boolean;
4157
+ /** 生效时间 */
4158
+ effective_time: string;
4159
+ }
4160
+ interface DelPositionRequest {
4161
+ /** 岗位ID */
4162
+ position_id: string;
4163
+ }
4164
+ }
3230
4165
  namespace PreHire {
3231
4166
  interface Methods {
3232
4167
  /**
@@ -3269,6 +4204,11 @@ export declare namespace Corehr {
3269
4204
  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/pre_hire/transit_task
3270
4205
  */
3271
4206
  transitTask(pre_hire_id: string, body: TransitTaskRequest): Promise<TransitTaskResponse>;
4207
+ /**
4208
+ * 流转入职任务
4209
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/pre_hire/transform_onboarding_task
4210
+ */
4211
+ transformOnboardingTask(body: TransformOnboardingTaskRequest): Promise<TransformOnboardingTaskResponse>;
3272
4212
  /**
3273
4213
  * 操作员工完成入职
3274
4214
  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/pre_hire/complete
@@ -3328,11 +4268,22 @@ export declare namespace Corehr {
3328
4268
  basic_info_update?: Lark.BasicInfoUpdate;
3329
4269
  /** 更新待入职(prehire)信息 */
3330
4270
  offer_info_update?: Lark.OfferInfoUpdate;
3331
- /** 指定需要更新的系统字段,只支持最多下钻一层,格式如下: - basic_info_update字段:basic_info_update.name(对name整体进行覆盖更新);basic_info_update.emails(对邮箱整体进行更新) - offer_info_update字段:offer_info_update.onboarding_method - 招聘ID:ats_application_id */
4271
+ /**
4272
+ * 指定需要更新的系统字段,只支持最多下钻一层,格式如下:
4273
+ * - basic_info_update字段:basic_info_update.name(对name整体进行覆盖更新);basic_info_update.emails(对邮箱整体进行更新)
4274
+ * - offer_info_update字段:offer_info_update.onboarding_method
4275
+ * - 招聘ID:ats_application_id
4276
+ */
3332
4277
  standard_update_fields?: string[];
3333
- /** 指定需要更新的PreHire对象上的自定义字段,格式如下: - custom_field1__c */
4278
+ /**
4279
+ * 指定需要更新的PreHire对象上的自定义字段,格式如下:
4280
+ * - custom_field1__c
4281
+ */
3334
4282
  custom_update_fields?: string[];
3335
- /** 指定需要更新的Person对象上的自定义字段,格式如下: - custom_field1__c */
4283
+ /**
4284
+ * 指定需要更新的Person对象上的自定义字段,格式如下:
4285
+ * - custom_field1__c
4286
+ */
3336
4287
  person_custom_update_fields?: string[];
3337
4288
  }
3338
4289
  interface PatchResponse {
@@ -3342,7 +4293,18 @@ export declare namespace Corehr {
3342
4293
  interface QueryRequest {
3343
4294
  /** 待入职人员 ID 列表;如果该字段非空,则不按照page_size、page_token分页方式查询 */
3344
4295
  pre_hire_ids?: string[];
3345
- /** 返回数据的字段列表,填写方式:- 为空时只返回 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- 返回数据越多,查询接口性能越慢,请按需填写返回字段 */
4296
+ /**
4297
+ * 返回数据的字段列表,填写方式:
4298
+ * - 为空时只返回 pre_hire_id
4299
+ * - 不为空时按照传入的字段返回数据,格式如下:
4300
+ * - person_info 字段:person_info.gender,person_info.age
4301
+ * - employment_info 字段:employment_info.department
4302
+ * - onboarding_info 字段:onboarding_info.onboarding_date
4303
+ * - probation_info 字段:probation_info.probation_period
4304
+ * - contract_info 字段:contract_info.contract_type
4305
+ * - 如果要返回所有下级,只用传上级结构体名称,例如 person_info
4306
+ * - 返回数据越多,查询接口性能越慢,请按需填写返回字段
4307
+ */
3346
4308
  fields?: string[];
3347
4309
  }
3348
4310
  interface QueryQuery extends Pagination {
@@ -3384,7 +4346,18 @@ export declare namespace Corehr {
3384
4346
  key_word?: string;
3385
4347
  /** 是否离职重聘 */
3386
4348
  rehire?: 'to_be_confirmed' | 'no' | 'yes';
3387
- /** 返回数据的字段列表,填写方式:- 为空时只返回 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- 返回数据越多,查询接口性能越慢,请按需填写返回字段 */
4349
+ /**
4350
+ * 返回数据的字段列表,填写方式:
4351
+ * - 为空时只返回 pre_hire_id
4352
+ * - 不为空时按照传入的字段返回数据,格式如下:
4353
+ * - person_info 字段:person_info.gender,person_info.age
4354
+ * - employment_info 字段:employment_info.department
4355
+ * - onboarding_info 字段:onboarding_info.onboarding_date
4356
+ * - probation_info 字段:probation_info.probation_period
4357
+ * - contract_info 字段:contract_info.contract_type
4358
+ * - 如果要返回所有下级,只用传上级结构体名称,例如 person_info
4359
+ * - 返回数据越多,查询接口性能越慢,请按需填写返回字段
4360
+ */
3388
4361
  fields?: string[];
3389
4362
  }
3390
4363
  interface SearchQuery extends Pagination {
@@ -3401,6 +4374,22 @@ export declare namespace Corehr {
3401
4374
  /** 是否成功流转任务 */
3402
4375
  success?: boolean;
3403
4376
  }
4377
+ interface TransformOnboardingTaskRequest {
4378
+ /** 待入职ID,可从待入职列表接口获取 */
4379
+ pre_hire_id: string;
4380
+ /** 任务的标识ID,入职系统的任务分为预置任务和自定义任务,预置任务的task_code是系统写死的,如职位信息任务的task_code为1,自定义任务的task_code为一串UUID。待入职人员任务的task_code可以通过查询待入职接口获取 */
4381
+ task_code: string;
4382
+ /** 流转类型,描述对任务做何种流转,manual_start_task表示手动开启任务,submit_task表示提交任务,review_task表示审批任务 */
4383
+ transform_type: string;
4384
+ /** 审批结果,approve表示通过,reject表示拒绝,当审批任务时,该字段需要传值,否则报错 */
4385
+ review_decision?: string;
4386
+ /** 审批原因,审批任务时,如果审批通过,审批原因可以不填;如果审批拒绝,审批原因必填 */
4387
+ reason?: string;
4388
+ }
4389
+ interface TransformOnboardingTaskResponse {
4390
+ /** 是否成功流转任务 */
4391
+ success?: boolean;
4392
+ }
3404
4393
  interface CompleteResponse {
3405
4394
  /** 是否成功完成入职 */
3406
4395
  success?: boolean;
@@ -3887,7 +4876,10 @@ export declare namespace Corehr {
3887
4876
  employment_id: string;
3888
4877
  /** 离职日期 */
3889
4878
  offboarding_date: string;
3890
- /** 离职原因,可通过接口[【查询员工离职原因列表】](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/offboarding/query)获取 */
4879
+ /**
4880
+ * 离职原因,可通过接口
4881
+ * [【查询员工离职原因列表】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/offboarding/query)获取
4882
+ */
3891
4883
  offboarding_reason_unique_identifier: string;
3892
4884
  /** 离职原因说明,长度限制6000 */
3893
4885
  offboarding_reason_explanation?: string;
@@ -3927,6 +4919,176 @@ export declare namespace Corehr {
3927
4919
  created_time?: string;
3928
4920
  }
3929
4921
  }
4922
+ namespace SignatureFile {
4923
+ interface Methods {
4924
+ /**
4925
+ * 终止电子签文件
4926
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/signature_file/terminate
4927
+ */
4928
+ terminate(body: TerminateRequest, query?: TerminateQuery): Promise<TerminateResponse>;
4929
+ /**
4930
+ * 获取电子签文件列表
4931
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/signature_file/list
4932
+ */
4933
+ list(query?: ListQuery): Paginated<Lark.SignatureFile>;
4934
+ /**
4935
+ * 查询电子签文件详情
4936
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/signature_file/query
4937
+ */
4938
+ query(body: QueryRequest, query?: QueryQuery): Paginated<Lark.SignatureFile>;
4939
+ /**
4940
+ * 根据流程获取电子签文件信息
4941
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/signature_file/list_by_biz_id
4942
+ */
4943
+ listByBizId(query?: ListByBizIdQuery): Promise<ListByBizIdResponse>;
4944
+ /**
4945
+ * 下载电子签文件
4946
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/signature_file/download
4947
+ */
4948
+ download(signature_file_id: string): Promise<ArrayBuffer>;
4949
+ }
4950
+ interface TerminateRequest {
4951
+ /** 欲终止的电子签文件id列表 */
4952
+ ids: string[];
4953
+ /** 操作人ID */
4954
+ operator: string;
4955
+ /** 终止原因 */
4956
+ terminate_reason: string;
4957
+ }
4958
+ interface TerminateQuery {
4959
+ /** 用户 ID 类型 */
4960
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id';
4961
+ }
4962
+ interface TerminateResponse {
4963
+ /** 欲终止的文件总数量 */
4964
+ total_count?: number;
4965
+ /** 成功总数量 */
4966
+ success_count?: number;
4967
+ /** 失败总数量 */
4968
+ fail_count?: number;
4969
+ /** 终止成功的文件id列表 */
4970
+ success_file_id_list?: string[];
4971
+ /** 终止失败的文件id和对应的原因列表 */
4972
+ fail_file_id_and_reasons?: Lark.TerminateSignatureFailIdAndReason[];
4973
+ }
4974
+ interface ListQuery extends Pagination {
4975
+ /** 电子签文件id */
4976
+ signature_file_id?: string;
4977
+ /** 电子签文件状态状态,多个状态之间为「或」的关系 */
4978
+ states?: string;
4979
+ /** 更新时间早于等于某个时间点,按照东八区时区 */
4980
+ update_time_start?: string;
4981
+ /** 更新时间晚于等于某个时间点,按照东八区时区 */
4982
+ update_time_end?: string;
4983
+ /** 用户 ID 类型 */
4984
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id';
4985
+ /** 根据电子签模板id列表筛选电子签文件,返回的电子签文件使用的模板id在该list中 */
4986
+ template_ids?: string;
4987
+ }
4988
+ interface QueryRequest {
4989
+ /** 电子签文件状态状态列表,多个状态之间为「或」的关系 */
4990
+ states?: string[];
4991
+ /** 电子签模板ID列表,返回的电子签文件使用的模板id在该list中 */
4992
+ template_ids?: string[];
4993
+ }
4994
+ interface QueryQuery extends Pagination {
4995
+ /** 电子签文件id */
4996
+ signature_file_id?: string;
4997
+ /** 更新时间早于等于某个时间点,按照东八区时区 */
4998
+ update_time_start?: string;
4999
+ /** 更新时间晚于等于某个时间点,按照东八区时区 */
5000
+ update_time_end?: string;
5001
+ /** 用户 ID 类型 */
5002
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id';
5003
+ }
5004
+ interface ListByBizIdQuery {
5005
+ /** 业务自定义流程ID */
5006
+ biz_process_id: string;
5007
+ /** 业务类型,开放平台平应用可以传递"OpenAPI" */
5008
+ biz_type: string;
5009
+ /** 用户 ID 类型 */
5010
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id';
5011
+ /** 是否需要签署链接 */
5012
+ select_sign_url?: boolean;
5013
+ }
5014
+ interface ListByBizIdResponse {
5015
+ /** 返回的流程关联的电子签文件列表 */
5016
+ signature_files?: Lark.SignatureFile[];
5017
+ /** 批量签署链接 */
5018
+ batch_sign_url?: string;
5019
+ }
5020
+ }
5021
+ namespace SignatureNode {
5022
+ interface Methods {
5023
+ /**
5024
+ * 获取文件签署节点信息
5025
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/signature_node/list_by_file_id
5026
+ */
5027
+ listByFileId(query?: ListByFileIdQuery): Promise<ListByFileIdResponse>;
5028
+ }
5029
+ interface ListByFileIdQuery {
5030
+ /** 电子签文件id */
5031
+ file_id: string;
5032
+ /** 用户 ID 类型 */
5033
+ user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id';
5034
+ }
5035
+ interface ListByFileIdResponse {
5036
+ /** 返回的电子签节点列表 */
5037
+ signature_nodes?: Lark.SignatureNode[];
5038
+ }
5039
+ }
5040
+ namespace SignatureTemplate {
5041
+ interface Methods {
5042
+ /**
5043
+ * 获取电子签模板内容
5044
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/signature_template/search
5045
+ */
5046
+ search(query?: SearchQuery): Promise<SearchResponse>;
5047
+ }
5048
+ interface SearchQuery {
5049
+ /** 电子签模板ids,用英文逗号分隔;如果不传 则返回所有模版信息(字节线上几百条) */
5050
+ template_ids?: string;
5051
+ /** 是否需要自定义字段,如-自定义签署方、合同变更前后公司等 */
5052
+ select_custom_field?: boolean;
5053
+ }
5054
+ interface SearchResponse {
5055
+ /** 返回的电子签模板list */
5056
+ signature_templates?: Lark.SignatureTemplate[];
5057
+ }
5058
+ }
5059
+ namespace SignatureTemplateInfoWithThumbnail {
5060
+ interface Methods {
5061
+ /**
5062
+ * 获取电子签模板列表
5063
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/signature_template_info_with_thumbnail/list
5064
+ */
5065
+ list(query?: ListQuery): Promise<ListResponse> & AsyncIterableIterator<Lark.SignatureTemplateInfoWithThumbnail>;
5066
+ }
5067
+ interface ListQuery extends Pagination {
5068
+ /** 模版名 */
5069
+ name?: string;
5070
+ /** 模板类别;多个类别之间使用英文,分隔 */
5071
+ category_apiname?: string;
5072
+ /** 模板用途;多个用途之间使用英文,分隔 */
5073
+ usage_apiname?: string;
5074
+ /** 是否停用 */
5075
+ active?: boolean;
5076
+ /** 是否需要模板适用区域信息;默认false,不会返回region_info信息 */
5077
+ need_region_info?: boolean;
5078
+ /** 电子签适用范围 */
5079
+ applicability_apinames?: string[];
5080
+ /** 此次调用中使用的用户ID的类型 */
5081
+ user_id_type?: 'user_id' | 'union_id' | 'open_id';
5082
+ }
5083
+ interface ListResponse {
5084
+ /** 电子签模板缩略图列表 */
5085
+ items?: Lark.SignatureTemplateInfoWithThumbnail[];
5086
+ /** 查询偏移量;下次查询可以从page_token开始查询 */
5087
+ page_token?: number;
5088
+ /** 数据总数 */
5089
+ count?: number;
5090
+ }
5091
+ }
3930
5092
  namespace Contract {
3931
5093
  interface Methods {
3932
5094
  /**
@@ -4208,7 +5370,12 @@ export declare namespace Corehr {
4208
5370
  employment_id: string;
4209
5371
  /** 授予数量 */
4210
5372
  granting_quantity: string;
4211
- /** 授予时长单位可选值有:- 1: 天- 2: 小时 */
5373
+ /**
5374
+ * 授予时长单位
5375
+ * 可选值有:
5376
+ * - 1: 天
5377
+ * - 2: 小时
5378
+ */
4212
5379
  granting_unit: number;
4213
5380
  /** 生效时间 */
4214
5381
  effective_date: string;
@@ -4264,7 +5431,12 @@ export declare namespace Corehr {
4264
5431
  workCalendarDate(body: WorkCalendarDateRequest): Promise<WorkCalendarDateResponse>;
4265
5432
  }
4266
5433
  interface LeaveTypesQuery extends Pagination {
4267
- /** 假期类型状态(不传则为全部)可选值有:- 1:已启用- 2:已停用 */
5434
+ /**
5435
+ * 假期类型状态(不传则为全部)
5436
+ * 可选值有:
5437
+ * - 1:已启用
5438
+ * - 2:已停用
5439
+ */
4268
5440
  status?: string;
4269
5441
  /** 用户 ID 类型 */
4270
5442
  user_id_type?: 'user_id' | 'union_id' | 'open_id' | 'people_corehr_id';
@@ -4286,7 +5458,19 @@ export declare namespace Corehr {
4286
5458
  employment_id_list?: string[];
4287
5459
  /** 休假发起人 ID 列表,最大 100 个 */
4288
5460
  initiator_id_list?: string[];
4289
- /** 请假记录的状态可选值有:- 1:已通过- 2:审批中- 3:审批中(更正)- 4:审批中(取消休假)- 5:审批中(返岗)- 6:已返岗- 7:已拒绝- 8:已取消- 9:已撤回 */
5461
+ /**
5462
+ * 请假记录的状态
5463
+ * 可选值有:
5464
+ * - 1:已通过
5465
+ * - 2:审批中
5466
+ * - 3:审批中(更正)
5467
+ * - 4:审批中(取消休假)
5468
+ * - 5:审批中(返岗)
5469
+ * - 6:已返岗
5470
+ * - 7:已拒绝
5471
+ * - 8:已取消
5472
+ * - 9:已撤回
5473
+ */
4290
5474
  leave_request_status?: string[];
4291
5475
  /** 假期类型 ID 列表,枚举值可通过【获取假期类型列表】接口获取 */
4292
5476
  leave_type_id_list?: string[];
@@ -4556,7 +5740,12 @@ export declare namespace Corehr {
4556
5740
  role_id: string;
4557
5741
  /** 管理范围信息 */
4558
5742
  management_scope_list: Lark.ManagementScope[];
4559
- /** 查找方式可选值有:- 1:只查找指定 部门/工作地点/公司/社保城市,如无授权信息则返回为空- 2:当指定的 部门/工作地点/公司/社保城市 无授权信息,向上查找第一个授权记录并直接返回 */
5743
+ /**
5744
+ * 查找方式
5745
+ * 可选值有:
5746
+ * - 1:只查找指定 部门/工作地点/公司/社保城市,如无授权信息则返回为空
5747
+ * - 2:当指定的 部门/工作地点/公司/社保城市 无授权信息,向上查找第一个授权记录并直接返回
5748
+ */
4560
5749
  search_method: string;
4561
5750
  /** 页码标识,获取第一页传空,每次查询会返回下一页的page_token */
4562
5751
  page_token?: string;
@@ -4584,6 +5773,11 @@ export declare namespace Corehr {
4584
5773
  * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/process/get
4585
5774
  */
4586
5775
  get(process_id: string, query?: GetQuery): Promise<GetResponse>;
5776
+ /**
5777
+ * 获取流程数据
5778
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/process/flow_variable_data
5779
+ */
5780
+ flowVariableData(process_id: string, query?: FlowVariableDataQuery): Promise<FlowVariableDataResponse>;
4587
5781
  }
4588
5782
  interface ListQuery extends Pagination {
4589
5783
  /** 查询流程状态列表。 */
@@ -4663,6 +5857,20 @@ export declare namespace Corehr {
4663
5857
  /** 是否最新的「已完成」的更正流程 */
4664
5858
  is_last_completed_correct_process?: boolean;
4665
5859
  }
5860
+ interface FlowVariableDataQuery {
5861
+ /** 用户 ID 类型 */
5862
+ user_id_type?: 'open_id' | 'union_id' | 'user_id' | 'people_corehr_id';
5863
+ /** 此次调用中使用的部门 ID 类型 */
5864
+ department_id_type?: 'open_department_id' | 'department_id' | 'people_corehr_department_id';
5865
+ /** 需要查询变量key */
5866
+ variable_keys?: string[];
5867
+ }
5868
+ interface FlowVariableDataResponse {
5869
+ /** 流程数据 */
5870
+ field_variable_values?: Lark.FieldVariableValue[];
5871
+ /** 流程实例id */
5872
+ process_id?: string;
5873
+ }
4666
5874
  namespace FormVariableData {
4667
5875
  interface Methods {
4668
5876
  /**