-
-
Notifications
You must be signed in to change notification settings - Fork 72
/
Copy pathapi_corehr_person_create.go
1840 lines (1604 loc) · 155 KB
/
api_corehr_person_create.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
// Code generated by lark_sdk_gen. DO NOT EDIT.
/**
* Copyright 2022 chyroc
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package lark
import (
"context"
)
// CreateCoreHRPerson 创建员工的个人信息
//
// doc: https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/person/create
// new doc: https://open.feishu.cn/document/server-docs/corehr-v1/employee/person/create-2
func (r *CoreHRService) CreateCoreHRPerson(ctx context.Context, request *CreateCoreHRPersonReq, options ...MethodOptionFunc) (*CreateCoreHRPersonResp, *Response, error) {
if r.cli.mock.mockCoreHRCreateCoreHRPerson != nil {
r.cli.Log(ctx, LogLevelDebug, "[lark] CoreHR#CreateCoreHRPerson mock enable")
return r.cli.mock.mockCoreHRCreateCoreHRPerson(ctx, request, options...)
}
req := &RawRequestReq{
Scope: "CoreHR",
API: "CreateCoreHRPerson",
Method: "POST",
URL: r.cli.openBaseURL + "/open-apis/corehr/v2/persons",
Body: request,
MethodOption: newMethodOption(options),
NeedTenantAccessToken: true,
}
resp := new(createCoreHRPersonResp)
response, err := r.cli.RawRequest(ctx, req, resp)
return resp.Data, response, err
}
// MockCoreHRCreateCoreHRPerson mock CoreHRCreateCoreHRPerson method
func (r *Mock) MockCoreHRCreateCoreHRPerson(f func(ctx context.Context, request *CreateCoreHRPersonReq, options ...MethodOptionFunc) (*CreateCoreHRPersonResp, *Response, error)) {
r.mockCoreHRCreateCoreHRPerson = f
}
// UnMockCoreHRCreateCoreHRPerson un-mock CoreHRCreateCoreHRPerson method
func (r *Mock) UnMockCoreHRCreateCoreHRPerson() {
r.mockCoreHRCreateCoreHRPerson = nil
}
// CreateCoreHRPersonReq ...
type CreateCoreHRPersonReq struct {
ClientToken *string `query:"client_token" json:"-"` // 操作的唯一标识, 用于幂等的进行更新操作, 格式为标准的 UUIDV4。此值为空表示将发起一次新的请求, 此值非空表示幂等的进行更新操作, 示例值: "fe599b60-450f-46ff-b2ef-9f6675625b97"
NameList []*CreateCoreHRPersonReqName `json:"name_list,omitempty"` // 姓名列表, 当不为离职重聘员工时, 该字段必填, <b>字段权限要求: </b>, 读写法定姓名信息(corehr:person.legal_name:write)
Gender *CreateCoreHRPersonReqGender `json:"gender,omitempty"` // 性别, 枚举值 api_name 可通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询, 查询参数如下: object_api_name = "person", custom_api_name = "gender", <b>字段权限要求: </b>, 读写性别信息(corehr:person.gender:write)
DateOfBirth *string `json:"date_of_birth,omitempty"` // 出生日期, <b>字段权限要求: </b>, 读写生日信息(corehr:person.date_of_birth:write), 示例值: "2020-01-01"
NationalityIDV2 *string `json:"nationality_id_v2,omitempty"` // 国籍 ID, 可通过[查询国籍信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)接口查询, 示例值: "6862995757234914821"
Race *CreateCoreHRPersonReqRace `json:"race,omitempty"` // 民族 / 种族, 枚举值 api_name 可通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询, 查询参数如下: object_api_name = "person", custom_api_name = "race"
MaritalStatus *CreateCoreHRPersonReqMaritalStatus `json:"marital_status,omitempty"` // 婚姻状况, 枚举值 api_name 可通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询, 查询参数如下: object_api_name = "person", custom_api_name = "marital_status", <b>字段权限要求: </b>, 读写婚姻状况信息(corehr:person.marital_status:write)
PhoneList []*CreateCoreHRPersonReqPhone `json:"phone_list,omitempty"` // 电话列表
AddressList []*CreateCoreHRPersonReqAddress `json:"address_list,omitempty"` // 地址列表, <b>字段权限要求: </b>, 读取个人地址信息(corehr:person.address:write)
EmailList []*CreateCoreHRPersonReqEmail `json:"email_list,omitempty"` // 邮箱列表, <b>字段权限要求: </b>, 读写个人邮箱信息(corehr:person.email:write)
WorkExperienceList []*CreateCoreHRPersonReqWorkExperience `json:"work_experience_list,omitempty"` // 工作经历列表, <b>字段权限要求: </b>, 读写工作履历信息(corehr:person.work_experience:write)
EducationList []*CreateCoreHRPersonReqEducation `json:"education_list,omitempty"` // 教育经历列表, <b>字段权限要求: </b>, 读写教育经历信息(corehr:person.education:write)
BankAccountList []*CreateCoreHRPersonReqBankAccount `json:"bank_account_list,omitempty"` // 银行账户, <b>字段权限要求: </b>, 读写银行账号列表信息(corehr:person.bank_account:write)
NationalIDList []*CreateCoreHRPersonReqNationalID `json:"national_id_list,omitempty"` // 证件列表, <b>字段权限要求: </b>, 读写证件信息(corehr:person.national_id:write)
DependentList []*CreateCoreHRPersonReqDependent `json:"dependent_list,omitempty"` // 家庭成员列表, <b>字段权限要求: </b>, 读写家庭成员信息(corehr:person.dependent:write)
EmergencyContactList []*CreateCoreHRPersonReqEmergencyContact `json:"emergency_contact_list,omitempty"` // 紧急联系人列表, <b>字段权限要求: </b>, 读写紧急联系人信息(corehr:person.emergency_contact:write)
DateEnteredWorkforce *string `json:"date_entered_workforce,omitempty"` // 参加工作日期, <b>字段权限要求: </b>, 读写参加工作日期(corehr:person.date_entered_workforce:write), 示例值: "2020-10-01"
ProfileImageID *string `json:"profile_image_id,omitempty"` // 头像资源的 ID, 示例值: "dfysuc8x76dsfsw"
PersonalProfile []*CreateCoreHRPersonReqPersonalProfile `json:"personal_profile,omitempty"` // 个人资料附件, <b>字段权限要求: </b>, 读写个人资料信息(corehr:person.personal_profile:write)
NativeRegion *string `json:"native_region,omitempty"` // 籍贯 ID, 详细数据可通过[查询单条省份/行政区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/subdivision/get)接口查询, <b>字段权限要求: </b>, 读写籍贯信息(corehr:person.native_region:write), 示例值: "6863326262618752111"
HukouType *CreateCoreHRPersonReqHukouType `json:"hukou_type,omitempty"` // 户口类型, 枚举值 api_name 可通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询, 查询参数如下: object_api_name = "person_info_chn", custom_api_name = "hukou_type", <b>字段权限要求: </b>, 读写户口信息(corehr:person.hukou:write)
HukouLocation *string `json:"hukou_location,omitempty"` // 户口所在地, <b>字段权限要求: </b>, 读写户口信息(corehr:person.hukou:write), 示例值: "山东省平阴县"
PoliticalAffiliations []*CreateCoreHRPersonReqPoliticalAffiliation `json:"political_affiliations,omitempty"` // 政治面貌, 枚举值可通过文档[飞书人事枚举常量](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)政治面貌（political_affiliation）枚举定义部分获得
TalentID *string `json:"talent_id,omitempty"` // 人才 ID, 示例值: "6863326262618752123"
CustomFields []*CreateCoreHRPersonReqCustomField `json:"custom_fields,omitempty"` // 自定义字段
BornCountryRegion *string `json:"born_country_region,omitempty"` // 出生国家/地区, 示例值: "中国"
IsDisabled *bool `json:"is_disabled,omitempty"` // 是否残疾, 示例值: true
DisableCardNumber *string `json:"disable_card_number,omitempty"` // 残疾证号, 示例值: "1110000"
IsMartyrFamily *bool `json:"is_martyr_family,omitempty"` // 是否烈属, 示例值: true
MartyrCardNumber *string `json:"martyr_card_number,omitempty"` // 烈属证号, 示例值: "1110000"
IsOldAlone *bool `json:"is_old_alone,omitempty"` // 是否孤老, 示例值: true
ResidentTaxes []*CreateCoreHRPersonReqResidentTaxe `json:"resident_taxes,omitempty"` // 居民身份信息, 示例值: 6863326262618752123
FirstEntryTime *string `json:"first_entry_time,omitempty"` // 首次入境日期, 示例值: "2021-01-02"
LeaveTime *string `json:"leave_time,omitempty"` // 预计离境日期, 示例值: "2022-01-02"
}
// CreateCoreHRPersonReqAddress ...
type CreateCoreHRPersonReqAddress struct {
AddressID *string `json:"address_id,omitempty"` // 地址 ID, 示例值: "6989822217869624863"
CountryRegionID string `json:"country_region_id,omitempty"` // 国家 / 地区, 示例值: "6862995757234914824"
RegionID *string `json:"region_id,omitempty"` // 主要行政区, 示例值: "6863326815667095047"
AddressLine1 *string `json:"address_line1,omitempty"` // 地址行 1, 示例值: "丹佛测试地址-纽埃时区"
AddressLine2 *string `json:"address_line2,omitempty"` // 地址行 2, 示例值: "PoewH"
AddressLine3 *string `json:"address_line3,omitempty"` // 地址行 3, 示例值: "PoewH"
AddressLine4 *string `json:"address_line4,omitempty"` // 地址行 4, 示例值: "jmwJc"
AddressLine5 *string `json:"address_line5,omitempty"` // 地址行 5, 示例值: "jmwJc"
AddressLine6 *string `json:"address_line6,omitempty"` // 地址行 6, 示例值: "jmwJc"
AddressLine7 *string `json:"address_line7,omitempty"` // 地址行 7, 示例值: "jmwJc"
AddressLine8 *string `json:"address_line8,omitempty"` // 地址行 8, 示例值: "rafSu"
AddressLine9 *string `json:"address_line9,omitempty"` // 地址行 9, 示例值: "McPRG"
LocalAddressLine1 *string `json:"local_address_line1,omitempty"` // 地址行 1（非拉丁语系的本地文字）, 示例值: "丹佛测试地址-纽埃时区"
LocalAddressLine2 *string `json:"local_address_line2,omitempty"` // 地址行 2（非拉丁语系的本地文字）, 示例值: "PoewH"
LocalAddressLine3 *string `json:"local_address_line3,omitempty"` // 地址行 3（非拉丁语系的本地文字）, 示例值: "PoewH"
LocalAddressLine4 *string `json:"local_address_line4,omitempty"` // 地址行 4（非拉丁语系的本地文字）, 示例值: "jmwJc"
LocalAddressLine5 *string `json:"local_address_line5,omitempty"` // 地址行 5（非拉丁语系的本地文字）, 示例值: "jmwJc"
LocalAddressLine6 *string `json:"local_address_line6,omitempty"` // 地址行 6（非拉丁语系的本地文字）, 示例值: "jmwJc"
LocalAddressLine7 *string `json:"local_address_line7,omitempty"` // 地址行 7（非拉丁语系的本地文字）, 示例值: "jmwJc"
LocalAddressLine8 *string `json:"local_address_line8,omitempty"` // 地址行 8（非拉丁语系的本地文字）, 示例值: "rafSu"
LocalAddressLine9 *string `json:"local_address_line9,omitempty"` // 地址行 9（非拉丁语系的本地文字）, 示例值: "McPRG"
PostalCode *string `json:"postal_code,omitempty"` // 邮政编码, 示例值: "611530"
AddressTypeList []*CreateCoreHRPersonReqAddressAddressType `json:"address_type_list,omitempty"` // 地址类型
IsPrimary bool `json:"is_primary,omitempty"` // 主要地址, 示例值: true
IsPublic bool `json:"is_public,omitempty"` // 公开地址, 示例值: true
CustomFields []*CreateCoreHRPersonReqAddressCustomField `json:"custom_fields,omitempty"` // 自定义字段
}
// CreateCoreHRPersonReqAddressAddressType ...
type CreateCoreHRPersonReqAddressAddressType struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqAddressCustomField ...
type CreateCoreHRPersonReqAddressCustomField struct {
CustomApiName string `json:"custom_api_name,omitempty"` // 自定义字段 apiname, 即自定义字段的唯一标识, 示例值: "name"
Value string `json:"value,omitempty"` // 字段值, 是 json 转义后的字符串, 根据元数据定义不同, 字段格式不同。使用方式可参考[操作手册]如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7), 示例值: "231"
}
// CreateCoreHRPersonReqBankAccount ...
type CreateCoreHRPersonReqBankAccount struct {
BankName *string `json:"bank_name,omitempty"` // 银行名称, 示例值: "中国农业银行"
BankAccountNumber string `json:"bank_account_number,omitempty"` // 银行账号, 示例值: "6231200000001223"
AccountHolder string `json:"account_holder,omitempty"` // 开户人姓名, 示例值: "孟十五"
BranchName *string `json:"branch_name,omitempty"` // 支行名称, 示例值: "中国农业银行支行"
BankIDV2 *string `json:"bank_id_v2,omitempty"` // 银行 ID, 详细信息可通过[查询银行信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-bank/search)接口查询获得, 示例值: "MDBH00000001"
BranchIDV2 *string `json:"branch_id_v2,omitempty"` // 支行 ID, 要求必须为填入银行的支行, 详细信息可通过[查询支行信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-bank_branch/search)接口查询获得, 示例值: "MDBK00000017"
CountryRegionID *string `json:"country_region_id,omitempty"` // 国家/地区 ID, 详细信息可通过[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口查询获得, 示例值: "12"
BankAccountUsage []*CreateCoreHRPersonReqBankAccountBankAccountUsage `json:"bank_account_usage,omitempty"` // 银行卡用途, 枚举值可通过文档[飞书人事枚举常量](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)银行卡用途（Bank Account Usage）枚举定义部分获得
BankAccountType *CreateCoreHRPersonReqBankAccountBankAccountType `json:"bank_account_type,omitempty"` // 银行卡类型, 枚举值可通过文档[飞书人事枚举常量](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)银行卡类型（Bank Account Type）枚举定义部分获得
CurrencyID *string `json:"currency_id,omitempty"` // 货币id, 示例值: "12QueryCountryRegionSubdivisionDataReq"
CustomFields []*CreateCoreHRPersonReqBankAccountCustomField `json:"custom_fields,omitempty"` // 自定义字段
}
// CreateCoreHRPersonReqBankAccountBankAccountType ...
type CreateCoreHRPersonReqBankAccountBankAccountType struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqBankAccountBankAccountUsage ...
type CreateCoreHRPersonReqBankAccountBankAccountUsage struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqBankAccountCustomField ...
type CreateCoreHRPersonReqBankAccountCustomField struct {
CustomApiName string `json:"custom_api_name,omitempty"` // 自定义字段 apiname, 即自定义字段的唯一标识, 示例值: "name"
Value string `json:"value,omitempty"` // 字段值, 是 json 转义后的字符串, 根据元数据定义不同, 字段格式不同。使用方式可参考[操作手册]如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7), 示例值: "231"
}
// CreateCoreHRPersonReqCustomField ...
type CreateCoreHRPersonReqCustomField struct {
CustomApiName string `json:"custom_api_name,omitempty"` // 自定义字段 apiname, 即自定义字段的唯一标识, 示例值: "name"
Value string `json:"value,omitempty"` // 字段值, 是 json 转义后的字符串, 根据元数据定义不同, 字段格式不同。使用方式可参考[操作手册]如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7), 示例值: "231"
}
// CreateCoreHRPersonReqDependent ...
type CreateCoreHRPersonReqDependent struct {
Relationship *CreateCoreHRPersonReqDependentRelationship `json:"relationship,omitempty"` // 关系
Gender *CreateCoreHRPersonReqDependentGender `json:"gender,omitempty"` // 性别
DateOfBirth *string `json:"date_of_birth,omitempty"` // 生日, 示例值: "2020-01-01"
NationalityIDV2 *string `json:"nationality_id_v2,omitempty"` // 国籍 ID, 可通过[查询国籍信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)接口查询, 示例值: "6862995745046267401"
NationalIDList []*CreateCoreHRPersonReqDependentNationalID `json:"national_id_list,omitempty"` // 证件号码
SpousesWorkingStatus *CreateCoreHRPersonReqDependentSpousesWorkingStatus `json:"spouses_working_status,omitempty"` // 配偶工作状态
IsThisPersonCoveredByHealthInsurance *bool `json:"is_this_person_covered_by_health_insurance,omitempty"` // 包含家属医疗保险, 示例值: true
IsThisPersonAllowedForTaxDeduction *bool `json:"is_this_person_allowed_for_tax_deduction,omitempty"` // 允许家属抵扣税款, 示例值: false
CustomFields []*CreateCoreHRPersonReqDependentCustomField `json:"custom_fields,omitempty"` // 自定义字段
DependentName *string `json:"dependent_name,omitempty"` // 家庭成员姓名, 示例值: "张三"
Employer *string `json:"employer,omitempty"` // 工作单位, 示例值: "海淀区交警大队"
Job *string `json:"job,omitempty"` // 岗位, 示例值: "保安"
Phone *CreateCoreHRPersonReqDependentPhone `json:"phone,omitempty"` // 电话
Address *CreateCoreHRPersonReqDependentAddress `json:"address,omitempty"` // 联系地址
BirthCertificateOfChild *CreateCoreHRPersonReqDependentBirthCertificateOfChild `json:"birth_certificate_of_child,omitempty"` // 出生证明
}
// CreateCoreHRPersonReqDependentAddress ...
type CreateCoreHRPersonReqDependentAddress struct {
AddressID *string `json:"address_id,omitempty"` // 地址 ID, 示例值: "6989822217869624863"
CountryRegionID string `json:"country_region_id,omitempty"` // 国家 / 地区, 示例值: "6862995757234914824"
RegionID *string `json:"region_id,omitempty"` // 主要行政区, 示例值: "6863326815667095047"
AddressLine1 *string `json:"address_line1,omitempty"` // 地址行 1, 示例值: "丹佛测试地址-纽埃时区"
AddressLine2 *string `json:"address_line2,omitempty"` // 地址行 2, 示例值: "PoewH"
AddressLine3 *string `json:"address_line3,omitempty"` // 地址行 3, 示例值: "PoewH"
AddressLine4 *string `json:"address_line4,omitempty"` // 地址行 4, 示例值: "jmwJc"
AddressLine5 *string `json:"address_line5,omitempty"` // 地址行 5, 示例值: "jmwJc"
AddressLine6 *string `json:"address_line6,omitempty"` // 地址行 6, 示例值: "jmwJc"
AddressLine7 *string `json:"address_line7,omitempty"` // 地址行 7, 示例值: "jmwJc"
AddressLine8 *string `json:"address_line8,omitempty"` // 地址行 8, 示例值: "rafSu"
AddressLine9 *string `json:"address_line9,omitempty"` // 地址行 9, 示例值: "McPRG"
LocalAddressLine1 *string `json:"local_address_line1,omitempty"` // 地址行 1（非拉丁语系的本地文字）, 示例值: "丹佛测试地址-纽埃时区"
LocalAddressLine2 *string `json:"local_address_line2,omitempty"` // 地址行 2（非拉丁语系的本地文字）, 示例值: "PoewH"
LocalAddressLine3 *string `json:"local_address_line3,omitempty"` // 地址行 3（非拉丁语系的本地文字）, 示例值: "PoewH"
LocalAddressLine4 *string `json:"local_address_line4,omitempty"` // 地址行 4（非拉丁语系的本地文字）, 示例值: "jmwJc"
LocalAddressLine5 *string `json:"local_address_line5,omitempty"` // 地址行 5（非拉丁语系的本地文字）, 示例值: "jmwJc"
LocalAddressLine6 *string `json:"local_address_line6,omitempty"` // 地址行 6（非拉丁语系的本地文字）, 示例值: "jmwJc"
LocalAddressLine7 *string `json:"local_address_line7,omitempty"` // 地址行 7（非拉丁语系的本地文字）, 示例值: "jmwJc"
LocalAddressLine8 *string `json:"local_address_line8,omitempty"` // 地址行 8（非拉丁语系的本地文字）, 示例值: "rafSu"
LocalAddressLine9 *string `json:"local_address_line9,omitempty"` // 地址行 9（非拉丁语系的本地文字）, 示例值: "McPRG"
PostalCode *string `json:"postal_code,omitempty"` // 邮政编码, 示例值: "611530"
CustomFields []*CreateCoreHRPersonReqDependentAddressCustomField `json:"custom_fields,omitempty"` // 自定义字段
}
// CreateCoreHRPersonReqDependentAddressCustomField ...
type CreateCoreHRPersonReqDependentAddressCustomField struct {
CustomApiName string `json:"custom_api_name,omitempty"` // 自定义字段 apiname, 即自定义字段的唯一标识, 示例值: "name"
Value string `json:"value,omitempty"` // 字段值, 是 json 转义后的字符串, 根据元数据定义不同, 字段格式不同。使用方式可参考[操作手册]如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7), 示例值: "231"
}
// CreateCoreHRPersonReqDependentBirthCertificateOfChild ...
type CreateCoreHRPersonReqDependentBirthCertificateOfChild struct {
ID *string `json:"id,omitempty"` // 上传文件ID, 示例值: "150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200"
}
// CreateCoreHRPersonReqDependentCustomField ...
type CreateCoreHRPersonReqDependentCustomField struct {
CustomApiName string `json:"custom_api_name,omitempty"` // 自定义字段 apiname, 即自定义字段的唯一标识, 示例值: "name"
Value string `json:"value,omitempty"` // 字段值, 是 json 转义后的字符串, 根据元数据定义不同, 字段格式不同。使用方式可参考[操作手册]如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7), 示例值: "231"
}
// CreateCoreHRPersonReqDependentGender ...
type CreateCoreHRPersonReqDependentGender struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqDependentNationalID ...
type CreateCoreHRPersonReqDependentNationalID struct {
NationalIDTypeID string `json:"national_id_type_id,omitempty"` // 国家证件类型, 示例值: "6863330041896371725"
NationalIDNumber string `json:"national_id_number,omitempty"` // 证件号码, 示例值: "1231131333"
IssueDate *string `json:"issue_date,omitempty"` // 证件签发日期, 示例值: "2020-04-01"
ExpirationDate *string `json:"expiration_date,omitempty"` // 证件到期日期, 示例值: "2020-05-21"
CountryRegionID string `json:"country_region_id,omitempty"` // 国家 / 地区, 示例值: "6862995757234914824"
IssuedBy *string `json:"issued_by,omitempty"` // 证件签发机构, 示例值: "北京市公安局"
CustomFields []*CreateCoreHRPersonReqDependentNationalIDCustomField `json:"custom_fields,omitempty"` // 自定义字段
}
// CreateCoreHRPersonReqDependentNationalIDCustomField ...
type CreateCoreHRPersonReqDependentNationalIDCustomField struct {
CustomApiName string `json:"custom_api_name,omitempty"` // 自定义字段 apiname, 即自定义字段的唯一标识, 示例值: "name"
Value string `json:"value,omitempty"` // 字段值, 是 json 转义后的字符串, 根据元数据定义不同, 字段格式不同。使用方式可参考[操作手册]如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7), 示例值: "231"
}
// CreateCoreHRPersonReqDependentPhone ...
type CreateCoreHRPersonReqDependentPhone struct {
InternationalAreaCode *CreateCoreHRPersonReqDependentPhoneInternationalAreaCode `json:"international_area_code,omitempty"` // 国家区号, 枚举值 api_name 可通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询, 查询参数如下: object_api_name = "phone", custom_api_name = "international_area_code"
PhoneNumber string `json:"phone_number,omitempty"` // 电话号码, 示例值: "010-12345678"
}
// CreateCoreHRPersonReqDependentPhoneInternationalAreaCode ...
type CreateCoreHRPersonReqDependentPhoneInternationalAreaCode struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqDependentRelationship ...
type CreateCoreHRPersonReqDependentRelationship struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqDependentSpousesWorkingStatus ...
type CreateCoreHRPersonReqDependentSpousesWorkingStatus struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqEducation ...
type CreateCoreHRPersonReqEducation struct {
School []*CreateCoreHRPersonReqEducationSchool `json:"school,omitempty"` // 学校
LevelOfEducation *CreateCoreHRPersonReqEducationLevelOfEducation `json:"level_of_education,omitempty"` // 学历
StartDate *string `json:"start_date,omitempty"` // 开始日期, 示例值: "2011-09-01"
EndDate *string `json:"end_date,omitempty"` // 结束日期, 示例值: "2015-06-30"
FieldOfStudy []*CreateCoreHRPersonReqEducationFieldOfStudy `json:"field_of_study,omitempty"` // 专业
Degree *CreateCoreHRPersonReqEducationDegree `json:"degree,omitempty"` // 学位
SchoolName *CreateCoreHRPersonReqEducationSchoolName `json:"school_name,omitempty"` // 学校名称
FieldOfStudyName *CreateCoreHRPersonReqEducationFieldOfStudyName `json:"field_of_study_name,omitempty"` // 专业名称
CountryRegionID *string `json:"country_region_id,omitempty"` // 国家地区ID, 示例值: "1"
ExpectedEndDate *string `json:"expected_end_date,omitempty"` // 预期结束日期, 示例值: "2011-09-01"
CustomFields []*CreateCoreHRPersonReqEducationCustomField `json:"custom_fields,omitempty"` // 自定义字段
}
// CreateCoreHRPersonReqEducationCustomField ...
type CreateCoreHRPersonReqEducationCustomField struct {
CustomApiName string `json:"custom_api_name,omitempty"` // 自定义字段 apiname, 即自定义字段的唯一标识, 示例值: "name"
Value string `json:"value,omitempty"` // 字段值, 是 json 转义后的字符串, 根据元数据定义不同, 字段格式不同。使用方式可参考[操作手册]如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7), 示例值: "231"
}
// CreateCoreHRPersonReqEducationDegree ...
type CreateCoreHRPersonReqEducationDegree struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqEducationFieldOfStudy ...
type CreateCoreHRPersonReqEducationFieldOfStudy struct {
Lang string `json:"lang,omitempty"` // 语言, 示例值: "zh-CN"
Value string `json:"value,omitempty"` // 内容, 示例值: "张三"
}
// CreateCoreHRPersonReqEducationFieldOfStudyName ...
type CreateCoreHRPersonReqEducationFieldOfStudyName struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqEducationLevelOfEducation ...
type CreateCoreHRPersonReqEducationLevelOfEducation struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqEducationSchool ...
type CreateCoreHRPersonReqEducationSchool struct {
Lang string `json:"lang,omitempty"` // 语言, 示例值: "zh-CN"
Value string `json:"value,omitempty"` // 内容, 示例值: "张三"
}
// CreateCoreHRPersonReqEducationSchoolName ...
type CreateCoreHRPersonReqEducationSchoolName struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqEmail ...
type CreateCoreHRPersonReqEmail struct {
Email string `json:"email,omitempty"` // 邮箱地址, 示例值: "[email protected]"
IsPrimary *bool `json:"is_primary,omitempty"` // 是否为主要邮箱, 示例值: true
IsPublic *bool `json:"is_public,omitempty"` // 是否为公开邮箱, 示例值: true
EmailUsage *CreateCoreHRPersonReqEmailEmailUsage `json:"email_usage,omitempty"` // 邮箱用途, 枚举值 api_name 可通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询, 查询参数如下: object_api_name = "email", custom_api_name = "email_usage"
}
// CreateCoreHRPersonReqEmailEmailUsage ...
type CreateCoreHRPersonReqEmailEmailUsage struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqEmergencyContact ...
type CreateCoreHRPersonReqEmergencyContact struct {
Name *CreateCoreHRPersonReqEmergencyContactName `json:"name,omitempty"` // 姓名
Relationship *CreateCoreHRPersonReqEmergencyContactRelationship `json:"relationship,omitempty"` // 关系
PhoneIst []*CreateCoreHRPersonReqEmergencyContactPhoneIst `json:"phone_ist,omitempty"` // 电话
LegalName *string `json:"legal_name,omitempty"` // 法定姓名, 示例值: "张三"
}
// CreateCoreHRPersonReqEmergencyContactName ...
type CreateCoreHRPersonReqEmergencyContactName struct {
LocalPrimary *string `json:"local_primary,omitempty"` // 姓 - 本地文字, 示例值: "黄"
LocalFirstName *string `json:"local_first_name,omitempty"` // 名 - 本地文字, 示例值: "四"
CountryRegionID string `json:"country_region_id,omitempty"` // 国家 / 地区, 示例值: "6862995757234914824"
NameType *CreateCoreHRPersonReqEmergencyContactNameNameType `json:"name_type,omitempty"` // 姓名类型
LocalFirstName2 *string `json:"local_first_name_2,omitempty"` // 名 - 第二本地文字, 示例值: "五"
LocalPrimary2 *string `json:"local_primary_2,omitempty"` // 姓 - 第二本地文字, 示例值: "王"
AdditionalNameType *CreateCoreHRPersonReqEmergencyContactNameAdditionalNameType `json:"additional_name_type,omitempty"` // 补充姓名类型
FirstName *string `json:"first_name,omitempty"` // 名, 示例值: "帅"
FullName *string `json:"full_name,omitempty"` // 全名, 示例值: "王大帅"
Hereditary *string `json:"hereditary,omitempty"` // 姓氏称谓, 示例值: "王"
CustomName *string `json:"custom_name,omitempty"` // 自定义姓名（未传入时, 姓名将默认根据所属国家 / 地区规则对相关姓、名字段拼接）, 示例值: "王大帅"
CustomLocalName *string `json:"custom_local_name,omitempty"` // 本地文字的自定义姓名（未传入时, 本地文字的姓名将默认根据所属国家 / 地区规则对本地文字的相关姓、名字段拼接）, 示例值: "王大帅"
MiddleName *string `json:"middle_name,omitempty"` // 中间名, 示例值: "大"
NamePrimary *string `json:"name_primary,omitempty"` // 姓, 示例值: "王"
Secondary *string `json:"secondary,omitempty"` // 第二姓氏, 示例值: "王"
Social *CreateCoreHRPersonReqEmergencyContactNameSocial `json:"social,omitempty"` // 尊称, 示例值: 王大帅
Tertiary *string `json:"tertiary,omitempty"` // 婚后姓氏, 示例值: "王"
Title *CreateCoreHRPersonReqEmergencyContactNameTitle `json:"title,omitempty"` // 头衔, 示例值: 王
LocalMiddleName *string `json:"local_middle_name,omitempty"` // 本地中间名, 示例值: "大"
LocalSecondary *string `json:"local_secondary,omitempty"` // 第二姓氏 - 本地文字, 示例值: "王"
}
// CreateCoreHRPersonReqEmergencyContactNameAdditionalNameType ...
type CreateCoreHRPersonReqEmergencyContactNameAdditionalNameType struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqEmergencyContactNameNameType ...
type CreateCoreHRPersonReqEmergencyContactNameNameType struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqEmergencyContactNameSocial ...
type CreateCoreHRPersonReqEmergencyContactNameSocial struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqEmergencyContactNameTitle ...
type CreateCoreHRPersonReqEmergencyContactNameTitle struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqEmergencyContactPhoneIst ...
type CreateCoreHRPersonReqEmergencyContactPhoneIst struct {
InternationalAreaCode *CreateCoreHRPersonReqEmergencyContactPhoneIstInternationalAreaCode `json:"international_area_code,omitempty"` // 国家区号, 枚举值 api_name 可通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询, 查询参数如下: object_api_name = "phone", custom_api_name = "international_area_code"
PhoneNumber string `json:"phone_number,omitempty"` // 电话号码, 示例值: "010-12345678"
}
// CreateCoreHRPersonReqEmergencyContactPhoneIstInternationalAreaCode ...
type CreateCoreHRPersonReqEmergencyContactPhoneIstInternationalAreaCode struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqEmergencyContactRelationship ...
type CreateCoreHRPersonReqEmergencyContactRelationship struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqGender ...
type CreateCoreHRPersonReqGender struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqHukouType ...
type CreateCoreHRPersonReqHukouType struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqMaritalStatus ...
type CreateCoreHRPersonReqMaritalStatus struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqName ...
type CreateCoreHRPersonReqName struct {
LocalPrimary *string `json:"local_primary,omitempty"` // 姓 - 本地文字, 示例值: "黄"
LocalFirstName *string `json:"local_first_name,omitempty"` // 名 - 本地文字, 示例值: "四"
CountryRegionID string `json:"country_region_id,omitempty"` // 国家 / 地区, 示例值: "6862995757234914824"
NameType *CreateCoreHRPersonReqNameNameType `json:"name_type,omitempty"` // 姓名类型
LocalFirstName2 *string `json:"local_first_name_2,omitempty"` // 名 - 第二本地文字, 示例值: "五"
LocalPrimary2 *string `json:"local_primary_2,omitempty"` // 姓 - 第二本地文字, 示例值: "王"
AdditionalNameType *CreateCoreHRPersonReqNameAdditionalNameType `json:"additional_name_type,omitempty"` // 补充姓名类型
FirstName *string `json:"first_name,omitempty"` // 名, 示例值: "帅"
FullName *string `json:"full_name,omitempty"` // 全名, 示例值: "王大帅"
Hereditary *string `json:"hereditary,omitempty"` // 姓氏称谓, 示例值: "王"
CustomName *string `json:"custom_name,omitempty"` // 自定义姓名（未传入时, 姓名将默认根据所属国家 / 地区规则对相关姓、名字段拼接）, 示例值: "王大帅"
CustomLocalName *string `json:"custom_local_name,omitempty"` // 本地文字的自定义姓名（未传入时, 本地文字的姓名将默认根据所属国家 / 地区规则对本地文字的相关姓、名字段拼接）, 示例值: "王大帅"
MiddleName *string `json:"middle_name,omitempty"` // 中间名, 示例值: "大"
NamePrimary *string `json:"name_primary,omitempty"` // 姓, 示例值: "王"
Secondary *string `json:"secondary,omitempty"` // 第二姓氏, 示例值: "王"
Social *CreateCoreHRPersonReqNameSocial `json:"social,omitempty"` // 尊称, 示例值: 王大帅
Tertiary *string `json:"tertiary,omitempty"` // 婚后姓氏, 示例值: "王"
Title *CreateCoreHRPersonReqNameTitle `json:"title,omitempty"` // 头衔, 示例值: 王
LocalMiddleName *string `json:"local_middle_name,omitempty"` // 本地中间名, 示例值: "大"
LocalSecondary *string `json:"local_secondary,omitempty"` // 第二姓氏 - 本地文字, 示例值: "王"
}
// CreateCoreHRPersonReqNameAdditionalNameType ...
type CreateCoreHRPersonReqNameAdditionalNameType struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqNameNameType ...
type CreateCoreHRPersonReqNameNameType struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqNameSocial ...
type CreateCoreHRPersonReqNameSocial struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqNameTitle ...
type CreateCoreHRPersonReqNameTitle struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqNationalID ...
type CreateCoreHRPersonReqNationalID struct {
NationalIDTypeID string `json:"national_id_type_id,omitempty"` // 国家证件类型, 示例值: "6863330041896371725"
NationalIDNumber string `json:"national_id_number,omitempty"` // 证件号码, 示例值: "1231131333"
IssueDate *string `json:"issue_date,omitempty"` // 证件签发日期, 示例值: "2020-04-01"
ExpirationDate *string `json:"expiration_date,omitempty"` // 证件到期日期, 示例值: "2020-05-21"
CountryRegionID string `json:"country_region_id,omitempty"` // 国家 / 地区, 示例值: "6862995757234914824"
IssuedBy *string `json:"issued_by,omitempty"` // 证件签发机构, 示例值: "北京市公安局"
CustomFields []*CreateCoreHRPersonReqNationalIDCustomField `json:"custom_fields,omitempty"` // 自定义字段
}
// CreateCoreHRPersonReqNationalIDCustomField ...
type CreateCoreHRPersonReqNationalIDCustomField struct {
CustomApiName string `json:"custom_api_name,omitempty"` // 自定义字段 apiname, 即自定义字段的唯一标识, 示例值: "name"
Value string `json:"value,omitempty"` // 字段值, 是 json 转义后的字符串, 根据元数据定义不同, 字段格式不同。使用方式可参考[操作手册]如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7), 示例值: "231"
}
// CreateCoreHRPersonReqPersonalProfile ...
type CreateCoreHRPersonReqPersonalProfile struct {
PersonalProfileType *CreateCoreHRPersonReqPersonalProfilePersonalProfileType `json:"personal_profile_type,omitempty"` // 资料类型
Files []*CreateCoreHRPersonReqPersonalProfileFile `json:"files,omitempty"` // 上传文件列表
}
// CreateCoreHRPersonReqPersonalProfileFile ...
type CreateCoreHRPersonReqPersonalProfileFile struct {
ID *string `json:"id,omitempty"` // 上传文件ID, 示例值: "150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200"
}
// CreateCoreHRPersonReqPersonalProfilePersonalProfileType ...
type CreateCoreHRPersonReqPersonalProfilePersonalProfileType struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqPhone ...
type CreateCoreHRPersonReqPhone struct {
InternationalAreaCode *CreateCoreHRPersonReqPhoneInternationalAreaCode `json:"international_area_code,omitempty"` // 国家区号
PhoneNumber string `json:"phone_number,omitempty"` // 电话号码, 示例值: "010-12345678"
}
// CreateCoreHRPersonReqPhoneInternationalAreaCode ...
type CreateCoreHRPersonReqPhoneInternationalAreaCode struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqPoliticalAffiliation ...
type CreateCoreHRPersonReqPoliticalAffiliation struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqRace ...
type CreateCoreHRPersonReqRace struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqResidentTaxe ...
type CreateCoreHRPersonReqResidentTaxe struct {
YearResidentTax string `json:"year_resident_tax,omitempty"` // 年度, 示例值: "2023"
ResidentStatus *CreateCoreHRPersonReqResidentTaxeResidentStatus `json:"resident_status,omitempty"` // 居民身份, 枚举值 api_name 可通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询, 查询参数如下: object_api_name = "resident_tax" - custom_api_name = "resident_status"
TaxCountryRegionID *string `json:"tax_country_region_id,omitempty"` // 国家/地区, 可通过[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口查询, 示例值: "中国"
CustomFields []*CreateCoreHRPersonReqResidentTaxeCustomField `json:"custom_fields,omitempty"` // 自定义字段
}
// CreateCoreHRPersonReqResidentTaxeCustomField ...
type CreateCoreHRPersonReqResidentTaxeCustomField struct {
FieldName string `json:"field_name,omitempty"` // 字段名, 示例值: "name"
Value string `json:"value,omitempty"` // 字段值, 是json转义后的字符串, 根据元数据定义不同, 字段格式不同(123, 123.23, true, [\"id1\", \"id2\], 2006-01-02 15:04:05]), 示例值: "Sandy"
}
// CreateCoreHRPersonReqResidentTaxeResidentStatus ...
type CreateCoreHRPersonReqResidentTaxeResidentStatus struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值, 示例值: "phone_type"
}
// CreateCoreHRPersonReqWorkExperience ...
type CreateCoreHRPersonReqWorkExperience struct {
CompanyOrganization []*CreateCoreHRPersonReqWorkExperienceCompanyOrganization `json:"company_organization,omitempty"` // 公司 / 组织
Department []*CreateCoreHRPersonReqWorkExperienceDepartment `json:"department,omitempty"` // 部门
Job []*CreateCoreHRPersonReqWorkExperienceJob `json:"job,omitempty"` // 岗位
Description []*CreateCoreHRPersonReqWorkExperienceDescription `json:"description,omitempty"` // 工作描述
StartDate *string `json:"start_date,omitempty"` // 开始日期, 示例值: "2020-01-01"
EndDate *string `json:"end_date,omitempty"` // 结束日期, 示例值: "2020-01-01"
CustomFields []*CreateCoreHRPersonReqWorkExperienceCustomField `json:"custom_fields,omitempty"` // 自定义字段
}
// CreateCoreHRPersonReqWorkExperienceCompanyOrganization ...
type CreateCoreHRPersonReqWorkExperienceCompanyOrganization struct {
Lang string `json:"lang,omitempty"` // 语言, 示例值: "zh-CN"
Value string `json:"value,omitempty"` // 内容, 示例值: "张三"
}
// CreateCoreHRPersonReqWorkExperienceCustomField ...
type CreateCoreHRPersonReqWorkExperienceCustomField struct {
CustomApiName string `json:"custom_api_name,omitempty"` // 自定义字段 apiname, 即自定义字段的唯一标识, 示例值: "name"
Value string `json:"value,omitempty"` // 字段值, 是 json 转义后的字符串, 根据元数据定义不同, 字段格式不同。使用方式可参考[操作手册]如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7), 示例值: "231"
}
// CreateCoreHRPersonReqWorkExperienceDepartment ...
type CreateCoreHRPersonReqWorkExperienceDepartment struct {
Lang string `json:"lang,omitempty"` // 语言, 示例值: "zh-CN"
Value string `json:"value,omitempty"` // 内容, 示例值: "张三"
}
// CreateCoreHRPersonReqWorkExperienceDescription ...
type CreateCoreHRPersonReqWorkExperienceDescription struct {
Lang string `json:"lang,omitempty"` // 语言, 示例值: "zh-CN"
Value string `json:"value,omitempty"` // 内容, 示例值: "张三"
}
// CreateCoreHRPersonReqWorkExperienceJob ...
type CreateCoreHRPersonReqWorkExperienceJob struct {
Lang string `json:"lang,omitempty"` // 语言, 示例值: "zh-CN"
Value string `json:"value,omitempty"` // 内容, 示例值: "张三"
}
// CreateCoreHRPersonResp ...
type CreateCoreHRPersonResp struct {
Person *CreateCoreHRPersonRespPerson `json:"person,omitempty"` // 个人信息
}
// CreateCoreHRPersonRespPerson ...
type CreateCoreHRPersonRespPerson struct {
PersonID string `json:"person_id,omitempty"` // 个人信息 ID
PhoneNumber string `json:"phone_number,omitempty"` // 个人电话, 字段权限要求（满足任一）: 获取个人手机号信息, 读写个人手机号信息
LegalName string `json:"legal_name,omitempty"` // 法定姓名, 字段权限要求（满足任一）: 获取法定姓名信息, 读写法定姓名信息
PreferredName string `json:"preferred_name,omitempty"` // 常用名
PreferredLocalFullName string `json:"preferred_local_full_name,omitempty"` // 常用本地全名
PreferredEnglishFullName string `json:"preferred_english_full_name,omitempty"` // 常用英文全名
NameList []*CreateCoreHRPersonRespPersonName `json:"name_list,omitempty"` // 姓名列表, 字段权限要求（满足任一）: 获取法定姓名信息, 读写法定姓名信息
Gender *CreateCoreHRPersonRespPersonGender `json:"gender,omitempty"` // 性别, 枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取, 按如下参数查询即可: custom_api_name: gender - object_api_name: person, 字段权限要求（满足任一）: 获取性别信息, 读写性别信息
DateOfBirth string `json:"date_of_birth,omitempty"` // 出生日期, 字段权限要求（满足任一）: 获取生日信息, 读写生日信息
NationalityIDV2 string `json:"nationality_id_v2,omitempty"` // 国籍 ID, 可通过[查询国籍信息](/ssl:ttdo/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)接口查询, 字段权限要求（满足任一）: 获取国籍信息, 读写国籍信息
Race *CreateCoreHRPersonRespPersonRace `json:"race,omitempty"` // 民族 / 种族, 枚举值 api_name 可通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询, 查询参数如下: object_api_name = "person", custom_api_name = "race", 字段权限要求: 获取民族/种族信息
MaritalStatus *CreateCoreHRPersonRespPersonMaritalStatus `json:"marital_status,omitempty"` // 婚姻状况, 枚举值 api_name 可通过[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询, 查询参数如下: object_api_name = "person", custom_api_name = "marital_status", <b>字段权限要求: </b>, 读写婚姻状况信息(corehr:person.marital_status:write), 字段权限要求（满足任一）: 获取婚姻状况信息, 读写婚姻状况信息
PhoneList []*CreateCoreHRPersonRespPersonPhone `json:"phone_list,omitempty"` // 电话列表, 字段权限要求（满足任一）: 获取个人手机号信息, 读写个人手机号信息
AddressList []*CreateCoreHRPersonRespPersonAddress `json:"address_list,omitempty"` // 地址列表, 字段权限要求（满足任一）: 读取个人地址信息, 读写个人地址信息
EmailList []*CreateCoreHRPersonRespPersonEmail `json:"email_list,omitempty"` // 邮箱列表, 字段权限要求（满足任一）: 获取个人邮箱信息, 读写个人邮箱信息
WorkExperienceList []*CreateCoreHRPersonRespPersonWorkExperience `json:"work_experience_list,omitempty"` // 工作经历列表, 字段权限要求（满足任一）: 获取工作履历信息, 读写工作履历信息
EducationList []*CreateCoreHRPersonRespPersonEducation `json:"education_list,omitempty"` // 教育经历列表, 字段权限要求（满足任一）: 获取教育经历信息, 读写教育经历信息
BankAccountList []*CreateCoreHRPersonRespPersonBankAccount `json:"bank_account_list,omitempty"` // 银行账户, 字段权限要求（满足任一）: 获取银行账号列表信息, 读写银行账号信息
NationalIDList []*CreateCoreHRPersonRespPersonNationalID `json:"national_id_list,omitempty"` // 证件, 字段权限要求（满足任一）: 获取证件信息, 读写证件信息
DependentList []*CreateCoreHRPersonRespPersonDependent `json:"dependent_list,omitempty"` // 家庭成员列表, 字段权限要求（满足任一）: 获取家庭成员信息, 读写家庭成员信息
EmergencyContactList []*CreateCoreHRPersonRespPersonEmergencyContact `json:"emergency_contact_list,omitempty"` // 紧急联系人列表, 字段权限要求（满足任一）: 获取紧急联系人信息, 读写紧急联系人信息
DateEnteredWorkforce string `json:"date_entered_workforce,omitempty"` // 参加工作日期, 字段权限要求（满足任一）: 获取参加工作日期, 读写参加工作日期
WorkingYears int64 `json:"working_years,omitempty"` // 工龄
ProfileImageID string `json:"profile_image_id,omitempty"` // 头像资源的 ID
EmailAddress string `json:"email_address,omitempty"` // 邮箱地址, 字段权限要求（满足任一）: 获取个人邮箱信息, 读写个人邮箱信息
Age int64 `json:"age,omitempty"` // 年龄, 字段权限要求（满足任一）: 获取生日信息, 读写生日信息
HighestLevelOfEducation *CreateCoreHRPersonRespPersonHighestLevelOfEducation `json:"highest_level_of_education,omitempty"` // 最高学历教育经历, 字段权限要求（满足任一）: 获取教育经历信息, 读写教育经历信息
HighestDegreeOfEducation *CreateCoreHRPersonRespPersonHighestDegreeOfEducation `json:"highest_degree_of_education,omitempty"` // 最高学位教育经历, 字段权限要求（满足任一）: 获取教育经历信息, 读写教育经历信息
PersonalProfile []*CreateCoreHRPersonRespPersonPersonalProfile `json:"personal_profile,omitempty"` // 个人资料附件, 字段权限要求（满足任一）: 获取个人资料信息, 读写个人资料信息
NativeRegion string `json:"native_region,omitempty"` // 籍贯 ID, 详细信息可通过[查询省份/行政区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)接口查询获得, 字段权限要求（满足任一）: 获取籍贯信息, 读写籍贯信息
HukouType *CreateCoreHRPersonRespPersonHukouType `json:"hukou_type,omitempty"` // 户口类型, 枚举值可通过文档[飞书人事枚举常量]户口类型（hukou_type）枚举定义部分获得, 字段权限要求（满足任一）: 获取户口信息, 读写户口信息
HukouLocation string `json:"hukou_location,omitempty"` // 户口所在地, 字段权限要求（满足任一）: 获取户口信息, 读写户口信息
TalentID string `json:"talent_id,omitempty"` // 人才 ID
CustomFields []*CreateCoreHRPersonRespPersonCustomField `json:"custom_fields,omitempty"` // 自定义字段, 字段权限要求（满足任一）: 获取个人信息自定义字段信息, 读写个人信息中的自定义字段信息
NationalIDNumber string `json:"national_id_number,omitempty"` // 居民身份证件号码, 字段权限要求（满足任一）: 获取证件信息, 读写证件信息
FamilyAddress string `json:"family_address,omitempty"` // 家庭地址, 字段权限要求（满足任一）: 读取个人地址信息, 读写个人地址信息
BornCountryRegion string `json:"born_country_region,omitempty"` // 出生国家/地区, 字段权限要求（满足任一）: 获取出生国家/地区信息, 读写出生国家/地区信息
IsDisabled bool `json:"is_disabled,omitempty"` // 是否残疾, 字段权限要求（满足任一）: 获取残疾信息, 读写残疾信息
DisableCardNumber string `json:"disable_card_number,omitempty"` // 残疾证号, 字段权限要求（满足任一）: 获取残疾信息, 读写残疾信息
IsMartyrFamily bool `json:"is_martyr_family,omitempty"` // 是否烈属, 字段权限要求（满足任一）: 获取烈属信息, 读写烈属信息
MartyrCardNumber string `json:"martyr_card_number,omitempty"` // 烈属证号, 字段权限要求（满足任一）: 获取烈属信息, 读写烈属信息
IsOldAlone bool `json:"is_old_alone,omitempty"` // 是否孤老, 字段权限要求（满足任一）: 获取孤老信息, 读写孤老信息
ResidentTaxes []*CreateCoreHRPersonRespPersonResidentTaxe `json:"resident_taxes,omitempty"` // 居民身份信息, 字段权限要求（满足任一）: 获取居民身份信息, 读写居民身份信息
FirstEntryTime string `json:"first_entry_time,omitempty"` // 首次入境日期, 字段权限要求（满足任一）: 获取出入境日期信息, 读写出入境日期信息
LeaveTime string `json:"leave_time,omitempty"` // 预计离境日期, 字段权限要求（满足任一）: 获取出入境日期信息, 读写出入境日期信息
}
// CreateCoreHRPersonRespPersonAddress ...
type CreateCoreHRPersonRespPersonAddress struct {
FullAddressLocalScript string `json:"full_address_local_script,omitempty"` // 完整地址（本地文字）
FullAddressWesternScript string `json:"full_address_western_script,omitempty"` // 完整地址（西方文字）
AddressID string `json:"address_id,omitempty"` // 地址 ID
CountryRegionID string `json:"country_region_id,omitempty"` // 国家 / 地区
RegionID string `json:"region_id,omitempty"` // 主要行政区
AddressLine1 string `json:"address_line1,omitempty"` // 地址行 1
AddressLine2 string `json:"address_line2,omitempty"` // 地址行 2
AddressLine3 string `json:"address_line3,omitempty"` // 地址行 3
AddressLine4 string `json:"address_line4,omitempty"` // 地址行 4
AddressLine5 string `json:"address_line5,omitempty"` // 地址行 5
AddressLine6 string `json:"address_line6,omitempty"` // 地址行 6
AddressLine7 string `json:"address_line7,omitempty"` // 地址行 7
AddressLine8 string `json:"address_line8,omitempty"` // 地址行 8
AddressLine9 string `json:"address_line9,omitempty"` // 地址行 9
LocalAddressLine1 string `json:"local_address_line1,omitempty"` // 地址行 1（非拉丁语系的本地文字）
LocalAddressLine2 string `json:"local_address_line2,omitempty"` // 地址行 2（非拉丁语系的本地文字）
LocalAddressLine3 string `json:"local_address_line3,omitempty"` // 地址行 3（非拉丁语系的本地文字）
LocalAddressLine4 string `json:"local_address_line4,omitempty"` // 地址行 4（非拉丁语系的本地文字）
LocalAddressLine5 string `json:"local_address_line5,omitempty"` // 地址行 5（非拉丁语系的本地文字）
LocalAddressLine6 string `json:"local_address_line6,omitempty"` // 地址行 6（非拉丁语系的本地文字）
LocalAddressLine7 string `json:"local_address_line7,omitempty"` // 地址行 7（非拉丁语系的本地文字）
LocalAddressLine8 string `json:"local_address_line8,omitempty"` // 地址行 8（非拉丁语系的本地文字）
LocalAddressLine9 string `json:"local_address_line9,omitempty"` // 地址行 9（非拉丁语系的本地文字）
PostalCode string `json:"postal_code,omitempty"` // 邮政编码
AddressTypeList []*CreateCoreHRPersonRespPersonAddressAddressType `json:"address_type_list,omitempty"` // 地址类型, 枚举值可通过文档[飞书人事枚举常量](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)地址类型（address_type）枚举定义部分获得
IsPrimary bool `json:"is_primary,omitempty"` // 主要地址
IsPublic bool `json:"is_public,omitempty"` // 公开地址
CustomFields []*CreateCoreHRPersonRespPersonAddressCustomField `json:"custom_fields,omitempty"` // 自定义字段
}
// CreateCoreHRPersonRespPersonAddressAddressType ...
type CreateCoreHRPersonRespPersonAddressAddressType struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值
Display []*CreateCoreHRPersonRespPersonAddressAddressTypeDisplay `json:"display,omitempty"` // 枚举多语展示
}
// CreateCoreHRPersonRespPersonAddressAddressTypeDisplay ...
type CreateCoreHRPersonRespPersonAddressAddressTypeDisplay struct {
Lang string `json:"lang,omitempty"` // 语言
Value string `json:"value,omitempty"` // 内容
}
// CreateCoreHRPersonRespPersonAddressCustomField ...
type CreateCoreHRPersonRespPersonAddressCustomField struct {
CustomApiName string `json:"custom_api_name,omitempty"` // 自定义字段 apiname, 即自定义字段的唯一标识
Name *CreateCoreHRPersonRespPersonAddressCustomFieldName `json:"name,omitempty"` // 自定义字段名称
Type int64 `json:"type,omitempty"` // 自定义字段类型
Value string `json:"value,omitempty"` // 字段值, 是 json 转义后的字符串, 根据元数据定义不同, 字段格式不同。使用方式可参考[操作手册]如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
}
// CreateCoreHRPersonRespPersonAddressCustomFieldName ...
type CreateCoreHRPersonRespPersonAddressCustomFieldName struct {
ZhCn string `json:"zh_cn,omitempty"` // 中文
EnUs string `json:"en_us,omitempty"` // 英文
}
// CreateCoreHRPersonRespPersonBankAccount ...
type CreateCoreHRPersonRespPersonBankAccount struct {
BankName string `json:"bank_name,omitempty"` // 银行名称
BankAccountNumber string `json:"bank_account_number,omitempty"` // 银行账号
AccountHolder string `json:"account_holder,omitempty"` // 开户人姓名
BranchName string `json:"branch_name,omitempty"` // 支行名称
BankIDV2 string `json:"bank_id_v2,omitempty"` // 银行 ID, 详细信息可通过[查询银行信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-bank/search)接口查询获得
BranchIDV2 string `json:"branch_id_v2,omitempty"` // 支行 ID, 要求必须为填入银行的支行, 详细信息可通过[查询支行信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-bank_branch/search)接口查询获得
CountryRegionID string `json:"country_region_id,omitempty"` // 国家/地区 ID, 详细信息可通过[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口查询获得
BankAccountUsage []*CreateCoreHRPersonRespPersonBankAccountBankAccountUsage `json:"bank_account_usage,omitempty"` // 银行卡用途, 枚举值可通过文档[飞书人事枚举常量](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)银行卡用途（Bank Account Usage）枚举定义部分获得
BankAccountType *CreateCoreHRPersonRespPersonBankAccountBankAccountType `json:"bank_account_type,omitempty"` // 银行卡类型, 枚举值可通过文档[飞书人事枚举常量](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)银行卡类型（Bank Account Type）枚举定义部分获得
CurrencyID string `json:"currency_id,omitempty"` // 货币 ID, 详细信息可通过[查询货币信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-currency/search)接口查询获得
CustomFields []*CreateCoreHRPersonRespPersonBankAccountCustomField `json:"custom_fields,omitempty"` // 自定义字段
}
// CreateCoreHRPersonRespPersonBankAccountBankAccountType ...
type CreateCoreHRPersonRespPersonBankAccountBankAccountType struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值
Display []*CreateCoreHRPersonRespPersonBankAccountBankAccountTypeDisplay `json:"display,omitempty"` // 枚举多语展示
}
// CreateCoreHRPersonRespPersonBankAccountBankAccountTypeDisplay ...
type CreateCoreHRPersonRespPersonBankAccountBankAccountTypeDisplay struct {
Lang string `json:"lang,omitempty"` // 语言
Value string `json:"value,omitempty"` // 内容
}
// CreateCoreHRPersonRespPersonBankAccountBankAccountUsage ...
type CreateCoreHRPersonRespPersonBankAccountBankAccountUsage struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值
Display []*CreateCoreHRPersonRespPersonBankAccountBankAccountUsageDisplay `json:"display,omitempty"` // 枚举多语展示
}
// CreateCoreHRPersonRespPersonBankAccountBankAccountUsageDisplay ...
type CreateCoreHRPersonRespPersonBankAccountBankAccountUsageDisplay struct {
Lang string `json:"lang,omitempty"` // 语言
Value string `json:"value,omitempty"` // 内容
}
// CreateCoreHRPersonRespPersonBankAccountCustomField ...
type CreateCoreHRPersonRespPersonBankAccountCustomField struct {
CustomApiName string `json:"custom_api_name,omitempty"` // 自定义字段 apiname, 即自定义字段的唯一标识
Name *CreateCoreHRPersonRespPersonBankAccountCustomFieldName `json:"name,omitempty"` // 自定义字段名称
Type int64 `json:"type,omitempty"` // 自定义字段类型
Value string `json:"value,omitempty"` // 字段值, 是 json 转义后的字符串, 根据元数据定义不同, 字段格式不同。使用方式可参考[操作手册]如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
}
// CreateCoreHRPersonRespPersonBankAccountCustomFieldName ...
type CreateCoreHRPersonRespPersonBankAccountCustomFieldName struct {
ZhCn string `json:"zh_cn,omitempty"` // 中文
EnUs string `json:"en_us,omitempty"` // 英文
}
// CreateCoreHRPersonRespPersonCustomField ...
type CreateCoreHRPersonRespPersonCustomField struct {
CustomApiName string `json:"custom_api_name,omitempty"` // 自定义字段 apiname, 即自定义字段的唯一标识
Name *CreateCoreHRPersonRespPersonCustomFieldName `json:"name,omitempty"` // 自定义字段名称
Type int64 `json:"type,omitempty"` // 自定义字段类型
Value string `json:"value,omitempty"` // 字段值, 是 json 转义后的字符串, 根据元数据定义不同, 字段格式不同。使用方式可参考[操作手册]如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
}
// CreateCoreHRPersonRespPersonCustomFieldName ...
type CreateCoreHRPersonRespPersonCustomFieldName struct {
ZhCn string `json:"zh_cn,omitempty"` // 中文
EnUs string `json:"en_us,omitempty"` // 英文
}
// CreateCoreHRPersonRespPersonDependent ...
type CreateCoreHRPersonRespPersonDependent struct {
Name *CreateCoreHRPersonRespPersonDependentName `json:"name,omitempty"` // 姓名
Relationship *CreateCoreHRPersonRespPersonDependentRelationship `json:"relationship,omitempty"` // 关系
Gender *CreateCoreHRPersonRespPersonDependentGender `json:"gender,omitempty"` // 性别
DateOfBirth string `json:"date_of_birth,omitempty"` // 生日
NationalityIDV2 string `json:"nationality_id_v2,omitempty"` // 国籍 ID, 可通过[查询国籍信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)接口查询
NationalIDList []*CreateCoreHRPersonRespPersonDependentNationalID `json:"national_id_list,omitempty"` // 证件号码
SpousesWorkingStatus *CreateCoreHRPersonRespPersonDependentSpousesWorkingStatus `json:"spouses_working_status,omitempty"` // 配偶工作状态
IsThisPersonCoveredByHealthInsurance bool `json:"is_this_person_covered_by_health_insurance,omitempty"` // 包含家属医疗保险
IsThisPersonAllowedForTaxDeduction bool `json:"is_this_person_allowed_for_tax_deduction,omitempty"` // 允许家属抵扣税款
CustomFields []*CreateCoreHRPersonRespPersonDependentCustomField `json:"custom_fields,omitempty"` // 自定义字段
DependentName string `json:"dependent_name,omitempty"` // 家庭成员姓名
Employer string `json:"employer,omitempty"` // 工作单位
Job string `json:"job,omitempty"` // 岗位
Phone *CreateCoreHRPersonRespPersonDependentPhone `json:"phone,omitempty"` // 电话
Address *CreateCoreHRPersonRespPersonDependentAddress `json:"address,omitempty"` // 联系地址
BirthCertificateOfChild *CreateCoreHRPersonRespPersonDependentBirthCertificateOfChild `json:"birth_certificate_of_child,omitempty"` // 出生证明
}
// CreateCoreHRPersonRespPersonDependentAddress ...
type CreateCoreHRPersonRespPersonDependentAddress struct {
FullAddressLocalScript string `json:"full_address_local_script,omitempty"` // 完整地址（本地文字）
FullAddressWesternScript string `json:"full_address_western_script,omitempty"` // 完整地址（西方文字）
AddressID string `json:"address_id,omitempty"` // 地址 ID
CountryRegionID string `json:"country_region_id,omitempty"` // 国家 / 地区
RegionID string `json:"region_id,omitempty"` // 主要行政区
AddressLine1 string `json:"address_line1,omitempty"` // 地址行 1
AddressLine2 string `json:"address_line2,omitempty"` // 地址行 2
AddressLine3 string `json:"address_line3,omitempty"` // 地址行 3
AddressLine4 string `json:"address_line4,omitempty"` // 地址行 4
AddressLine5 string `json:"address_line5,omitempty"` // 地址行 5
AddressLine6 string `json:"address_line6,omitempty"` // 地址行 6
AddressLine7 string `json:"address_line7,omitempty"` // 地址行 7
AddressLine8 string `json:"address_line8,omitempty"` // 地址行 8
AddressLine9 string `json:"address_line9,omitempty"` // 地址行 9
LocalAddressLine1 string `json:"local_address_line1,omitempty"` // 地址行 1（非拉丁语系的本地文字）
LocalAddressLine2 string `json:"local_address_line2,omitempty"` // 地址行 2（非拉丁语系的本地文字）
LocalAddressLine3 string `json:"local_address_line3,omitempty"` // 地址行 3（非拉丁语系的本地文字）
LocalAddressLine4 string `json:"local_address_line4,omitempty"` // 地址行 4（非拉丁语系的本地文字）
LocalAddressLine5 string `json:"local_address_line5,omitempty"` // 地址行 5（非拉丁语系的本地文字）
LocalAddressLine6 string `json:"local_address_line6,omitempty"` // 地址行 6（非拉丁语系的本地文字）
LocalAddressLine7 string `json:"local_address_line7,omitempty"` // 地址行 7（非拉丁语系的本地文字）
LocalAddressLine8 string `json:"local_address_line8,omitempty"` // 地址行 8（非拉丁语系的本地文字）
LocalAddressLine9 string `json:"local_address_line9,omitempty"` // 地址行 9（非拉丁语系的本地文字）
PostalCode string `json:"postal_code,omitempty"` // 邮政编码
AddressTypeList []*CreateCoreHRPersonRespPersonDependentAddressAddressType `json:"address_type_list,omitempty"` // 地址类型, 枚举值可通过文档[飞书人事枚举常量](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)地址类型（address_type）枚举定义部分获得
IsPrimary bool `json:"is_primary,omitempty"` // 主要地址
IsPublic bool `json:"is_public,omitempty"` // 公开地址
CustomFields []*CreateCoreHRPersonRespPersonDependentAddressCustomField `json:"custom_fields,omitempty"` // 自定义字段
}
// CreateCoreHRPersonRespPersonDependentAddressAddressType ...
type CreateCoreHRPersonRespPersonDependentAddressAddressType struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值
Display []*CreateCoreHRPersonRespPersonDependentAddressAddressTypeDisplay `json:"display,omitempty"` // 枚举多语展示
}
// CreateCoreHRPersonRespPersonDependentAddressAddressTypeDisplay ...
type CreateCoreHRPersonRespPersonDependentAddressAddressTypeDisplay struct {
Lang string `json:"lang,omitempty"` // 语言
Value string `json:"value,omitempty"` // 内容
}
// CreateCoreHRPersonRespPersonDependentAddressCustomField ...
type CreateCoreHRPersonRespPersonDependentAddressCustomField struct {
CustomApiName string `json:"custom_api_name,omitempty"` // 自定义字段 apiname, 即自定义字段的唯一标识
Name *CreateCoreHRPersonRespPersonDependentAddressCustomFieldName `json:"name,omitempty"` // 自定义字段名称
Type int64 `json:"type,omitempty"` // 自定义字段类型
Value string `json:"value,omitempty"` // 字段值, 是 json 转义后的字符串, 根据元数据定义不同, 字段格式不同。使用方式可参考[操作手册]如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
}
// CreateCoreHRPersonRespPersonDependentAddressCustomFieldName ...
type CreateCoreHRPersonRespPersonDependentAddressCustomFieldName struct {
ZhCn string `json:"zh_cn,omitempty"` // 中文
EnUs string `json:"en_us,omitempty"` // 英文
}
// CreateCoreHRPersonRespPersonDependentBirthCertificateOfChild ...
type CreateCoreHRPersonRespPersonDependentBirthCertificateOfChild struct {
ID string `json:"id,omitempty"` // 上传文件 ID, 可通过[上传文件](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/person/upload)接口获得
Name string `json:"name,omitempty"` // 文件名
}
// CreateCoreHRPersonRespPersonDependentCustomField ...
type CreateCoreHRPersonRespPersonDependentCustomField struct {
CustomApiName string `json:"custom_api_name,omitempty"` // 自定义字段 apiname, 即自定义字段的唯一标识
Name *CreateCoreHRPersonRespPersonDependentCustomFieldName `json:"name,omitempty"` // 自定义字段名称
Type int64 `json:"type,omitempty"` // 自定义字段类型
Value string `json:"value,omitempty"` // 字段值, 是 json 转义后的字符串, 根据元数据定义不同, 字段格式不同。使用方式可参考[操作手册]如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
}
// CreateCoreHRPersonRespPersonDependentCustomFieldName ...
type CreateCoreHRPersonRespPersonDependentCustomFieldName struct {
ZhCn string `json:"zh_cn,omitempty"` // 中文
EnUs string `json:"en_us,omitempty"` // 英文
}
// CreateCoreHRPersonRespPersonDependentGender ...
type CreateCoreHRPersonRespPersonDependentGender struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值
Display []*CreateCoreHRPersonRespPersonDependentGenderDisplay `json:"display,omitempty"` // 枚举多语展示
}
// CreateCoreHRPersonRespPersonDependentGenderDisplay ...
type CreateCoreHRPersonRespPersonDependentGenderDisplay struct {
Lang string `json:"lang,omitempty"` // 语言
Value string `json:"value,omitempty"` // 内容
}
// CreateCoreHRPersonRespPersonDependentName ...
type CreateCoreHRPersonRespPersonDependentName struct {
LocalPrimary string `json:"local_primary,omitempty"` // 姓 - 本地文字
LocalFirstName string `json:"local_first_name,omitempty"` // 名 - 本地文字
CountryRegionID string `json:"country_region_id,omitempty"` // 国家 / 地区
NameType *CreateCoreHRPersonRespPersonDependentNameNameType `json:"name_type,omitempty"` // 姓名类型
LocalFirstName2 string `json:"local_first_name_2,omitempty"` // 名 - 第二本地文字
LocalPrimary2 string `json:"local_primary_2,omitempty"` // 姓 - 第二本地文字
AdditionalNameType *CreateCoreHRPersonRespPersonDependentNameAdditionalNameType `json:"additional_name_type,omitempty"` // 补充姓名类型
FirstName string `json:"first_name,omitempty"` // 名
FullName string `json:"full_name,omitempty"` // 全名
Hereditary string `json:"hereditary,omitempty"` // 姓氏称谓
CustomName string `json:"custom_name,omitempty"` // 自定义姓名（未传入时, 姓名将默认根据所属国家 / 地区规则对相关姓、名字段拼接）
CustomLocalName string `json:"custom_local_name,omitempty"` // 本地文字的自定义姓名（未传入时, 本地文字的姓名将默认根据所属国家 / 地区规则对本地文字的相关姓、名字段拼接）
MiddleName string `json:"middle_name,omitempty"` // 中间名
NamePrimary string `json:"name_primary,omitempty"` // 姓
Secondary string `json:"secondary,omitempty"` // 第二姓氏
Social *CreateCoreHRPersonRespPersonDependentNameSocial `json:"social,omitempty"` // 尊称
Tertiary string `json:"tertiary,omitempty"` // 婚后姓氏
Title *CreateCoreHRPersonRespPersonDependentNameTitle `json:"title,omitempty"` // 头衔
LocalMiddleName string `json:"local_middle_name,omitempty"` // 本地中间名
LocalSecondary string `json:"local_secondary,omitempty"` // 第二姓氏 - 本地文字
DisplayNameLocalAndWesternScript string `json:"display_name_local_and_western_script,omitempty"` // 展示姓名（本地和西方文字）
DisplayNameLocalScript string `json:"display_name_local_script,omitempty"` // 展示姓名（本地文字）
DisplayNameWesternScript string `json:"display_name_western_script,omitempty"` // 展示姓名（西方文字）
}
// CreateCoreHRPersonRespPersonDependentNameAdditionalNameType ...
type CreateCoreHRPersonRespPersonDependentNameAdditionalNameType struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值
Display []*CreateCoreHRPersonRespPersonDependentNameAdditionalNameTypeDisplay `json:"display,omitempty"` // 枚举多语展示
}
// CreateCoreHRPersonRespPersonDependentNameAdditionalNameTypeDisplay ...
type CreateCoreHRPersonRespPersonDependentNameAdditionalNameTypeDisplay struct {
Lang string `json:"lang,omitempty"` // 语言
Value string `json:"value,omitempty"` // 内容
}
// CreateCoreHRPersonRespPersonDependentNameNameType ...
type CreateCoreHRPersonRespPersonDependentNameNameType struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值
Display []*CreateCoreHRPersonRespPersonDependentNameNameTypeDisplay `json:"display,omitempty"` // 枚举多语展示
}
// CreateCoreHRPersonRespPersonDependentNameNameTypeDisplay ...
type CreateCoreHRPersonRespPersonDependentNameNameTypeDisplay struct {
Lang string `json:"lang,omitempty"` // 语言
Value string `json:"value,omitempty"` // 内容
}
// CreateCoreHRPersonRespPersonDependentNameSocial ...
type CreateCoreHRPersonRespPersonDependentNameSocial struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值
Display []*CreateCoreHRPersonRespPersonDependentNameSocialDisplay `json:"display,omitempty"` // 枚举多语展示
}
// CreateCoreHRPersonRespPersonDependentNameSocialDisplay ...
type CreateCoreHRPersonRespPersonDependentNameSocialDisplay struct {
Lang string `json:"lang,omitempty"` // 语言
Value string `json:"value,omitempty"` // 内容
}
// CreateCoreHRPersonRespPersonDependentNameTitle ...
type CreateCoreHRPersonRespPersonDependentNameTitle struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值
Display []*CreateCoreHRPersonRespPersonDependentNameTitleDisplay `json:"display,omitempty"` // 枚举多语展示
}
// CreateCoreHRPersonRespPersonDependentNameTitleDisplay ...
type CreateCoreHRPersonRespPersonDependentNameTitleDisplay struct {
Lang string `json:"lang,omitempty"` // 语言
Value string `json:"value,omitempty"` // 内容
}
// CreateCoreHRPersonRespPersonDependentNationalID ...
type CreateCoreHRPersonRespPersonDependentNationalID struct {
NationalIDTypeID string `json:"national_id_type_id,omitempty"` // 国家证件类型
NationalIDNumber string `json:"national_id_number,omitempty"` // 证件号码
IssueDate string `json:"issue_date,omitempty"` // 证件签发日期
ExpirationDate string `json:"expiration_date,omitempty"` // 证件到期日期
CountryRegionID string `json:"country_region_id,omitempty"` // 国家 / 地区
IssuedBy string `json:"issued_by,omitempty"` // 证件签发机构
CustomFields []*CreateCoreHRPersonRespPersonDependentNationalIDCustomField `json:"custom_fields,omitempty"` // 自定义字段
}
// CreateCoreHRPersonRespPersonDependentNationalIDCustomField ...
type CreateCoreHRPersonRespPersonDependentNationalIDCustomField struct {
CustomApiName string `json:"custom_api_name,omitempty"` // 自定义字段 apiname, 即自定义字段的唯一标识
Name *CreateCoreHRPersonRespPersonDependentNationalIDCustomFieldName `json:"name,omitempty"` // 自定义字段名称
Type int64 `json:"type,omitempty"` // 自定义字段类型
Value string `json:"value,omitempty"` // 字段值, 是 json 转义后的字符串, 根据元数据定义不同, 字段格式不同。使用方式可参考[操作手册]如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
}
// CreateCoreHRPersonRespPersonDependentNationalIDCustomFieldName ...
type CreateCoreHRPersonRespPersonDependentNationalIDCustomFieldName struct {
ZhCn string `json:"zh_cn,omitempty"` // 中文
EnUs string `json:"en_us,omitempty"` // 英文
}
// CreateCoreHRPersonRespPersonDependentPhone ...
type CreateCoreHRPersonRespPersonDependentPhone struct {
InternationalAreaCode *CreateCoreHRPersonRespPersonDependentPhoneInternationalAreaCode `json:"international_area_code,omitempty"` // 国家区号
PhoneNumber string `json:"phone_number,omitempty"` // 电话号码
FormattedPhoneNumber string `json:"formatted_phone_number,omitempty"` // 完整电话号码
DeviceType *CreateCoreHRPersonRespPersonDependentPhoneDeviceType `json:"device_type,omitempty"` // 设备类型, 可选值如下: mobile_phone: 手机, landline: 座机, fax: 传真类型
PhoneUsage *CreateCoreHRPersonRespPersonDependentPhonePhoneUsage `json:"phone_usage,omitempty"` // 电话用途, 可选值如下: home: 家庭, work: 工作, emergency_contact: 紧急联系人, company: 公司
IsPrimary bool `json:"is_primary,omitempty"` // 主要电话
IsPublic bool `json:"is_public,omitempty"` // 公开电话
}
// CreateCoreHRPersonRespPersonDependentPhoneDeviceType ...
type CreateCoreHRPersonRespPersonDependentPhoneDeviceType struct {
EnumName string `json:"enum_name,omitempty"` // 枚举值
Display []*CreateCoreHRPersonRespPersonDependentPhoneDeviceTypeDisplay `json:"display,omitempty"` // 枚举多语展示
}
// CreateCoreHRPersonRespPersonDependentPhoneDeviceTypeDisplay ...
type CreateCoreHRPersonRespPersonDependentPhoneDeviceTypeDisplay struct {
Lang string `json:"lang,omitempty"` // 语言
Value string `json:"value,omitempty"` // 内容
}
// CreateCoreHRPersonRespPersonDependentPhoneInternationalAreaCode ...