diff --git a/TenantAccessList.md b/TenantAccessList.md index d02b9e2c..0dba54b5 100644 --- a/TenantAccessList.md +++ b/TenantAccessList.md @@ -33,7 +33,7 @@ PostImV1ChatsByChatIdManagersDeleteManagers 172024-10-30✓消息与群组将用户或机器人拉入群聊 PostImV1ChatsByChatIdMembers -182024-10-30✓消息与群组用户或机器人主动加入群聊 +182025-01-17✓消息与群组用户或机器人主动加入群聊 PatchImV1ChatsByChatIdMembersMeJoin 192024-10-30✓消息与群组将用户或机器人移出群聊 DeleteImV1ChatsByChatIdMembers @@ -527,7 +527,7 @@ PostCalendarV4CalendarsByCalendarIdEventsByEventIdAttendees 2642024-07-16✓日历删除日程参与人 PostCalendarV4CalendarsByCalendarIdEventsByEventIdAttendeesBatchDelete -2652024-07-16✓日历获取日程参与人列表 +2652025-01-13✓日历获取日程参与人列表 GetCalendarV4CalendarsByCalendarIdEventsByEventIdAttendees 2662024-07-16✓日历获取日程参与群成员列表 GetCalendarV4CalendarsByCalendarIdEventsByEventIdAttendeesByAttendeeIdChatMembers @@ -671,7 +671,7 @@ DeleteContactV3UsersByUserId 3362024-07-05✓通讯录获取单位列表 GetContactV3Unit -3372025-01-08✓考勤打卡获取审批通过数据 +3372025-01-13✓考勤打卡获取审批数据 PostAttendanceV1UserApprovalsQuery 3382024-12-24✓考勤打卡写入审批结果 PostAttendanceV1UserApprovals @@ -683,7 +683,7 @@ PostAttendanceV1UserTaskRemedysQueryUserAllowedRemedys 3422024-08-19✓考勤打卡获取补卡记录 PostAttendanceV1UserTaskRemedysQuery -3432024-08-13✓考勤打卡导入打卡流水 +3432025-01-14✓考勤打卡导入打卡流水 PostAttendanceV1UserFlowsBatchCreate 3442024-08-13✓考勤打卡查询打卡流水 GetAttendanceV1UserFlowsByUserFlowId @@ -751,7 +751,7 @@ PostApprovalV4ExternalApprovals 3762023-07-13✓审批查看指定三方审批定义 GetApprovalV4ExternalApprovalsByApprovalCode -3772024-09-18✓审批同步三方审批实例 +3772025-01-14✓审批同步三方审批实例 PostApprovalV4ExternalInstances 3782022-12-28✓审批校验三方审批实例 PostApprovalV4ExternalInstancesCheck @@ -1243,7 +1243,7 @@ PostSpeechToTextV1SpeechStreamRecognize 6222024-01-03✓AI 能力识别文本语种 PostTranslationV1TextDetect -6232024-01-03✓AI 能力翻译文本 +6232025-01-13✓AI 能力翻译文本 PostTranslationV1TextTranslate 6242024-07-05✓通讯录获取单个工作城市信息 GetContactV3WorkCitiesByWorkCityId @@ -1455,7 +1455,7 @@ GetCorehrV1JobsByJobId 7282024-02-06✓飞书人事批量查询职务 GetCorehrV1Jobs -7292024-07-26✓飞书人事（企业版）直接创建待入职 +7292025-01-16✓飞书人事（企业版）直接创建待入职 PostCorehrV2PreHires 7302024-07-12✓飞书人事[不推荐] 更新待入职信息（不推荐） PatchCorehrV1PreHiresByPreHireId @@ -1465,11 +1465,11 @@ GetCorehrV1PreHiresByPreHireId 7332024-07-15✓飞书人事[不推荐] 批量查询待入职信息 GetCorehrV1PreHires -7342024-08-26✓飞书人事（企业版）搜索合同 +7342025-01-15✓飞书人事（企业版）搜索合同 PostCorehrV2ContractsSearch 7352025-01-02✓消息与群组获取消息中的资源文件 GetImV1MessagesByMessageIdResourcesByFileKey -7362024-08-26✓飞书人事新建合同 +7362025-01-15✓飞书人事新建合同 PostCorehrV1Contracts 7372024-07-23✓飞书人事删除合同 DeleteCorehrV1ContractsByContractId @@ -1503,7 +1503,7 @@ PostCorehrV1OffboardingsQuery 7522024-10-25✓飞书人事操作员工离职 PostCorehrV1OffboardingsSubmit -7532025-01-06✓飞书人事搜索离职信息 +7532025-01-14✓飞书人事搜索离职信息 PostCorehrV1OffboardingsSearch 7542024-08-20✓飞书人事创建假期发放记录 PostCorehrV1LeaveGrantingRecords @@ -1515,7 +1515,7 @@ PatchImV1MessagesByMessageIdUrgentApp 7582024-10-23✓飞书人事批量查询员工假期余额 GetCorehrV1LeavesLeaveBalances -7592024-11-07✓飞书人事批量查询员工请假记录 +7592025-01-14✓飞书人事批量查询员工请假记录 GetCorehrV1LeavesLeaveRequestHistory 7602024-12-17✓飞书人事（企业版）查询员工 HRBP / 属地 BP PostCorehrV2EmployeesBpsBatchGet @@ -1645,7 +1645,7 @@ PatchHireV1NotesByNoteId 8232024-07-12✓招聘获取备注 GetHireV1NotesByNoteId -8242024-12-11✓消息与群组查询批量消息整体进度 +8242025-01-13✓消息与群组查询批量消息整体进度 GetImV1BatchMessagesByBatchMessageIdGetProgress 8252024-07-10✓招聘获取备注列表 GetHireV1Notes @@ -2095,13 +2095,13 @@ GetImV2BizEntityTagRelation 10482024-04-09✓OKR查询复盘信息 GetOkrV1ReviewsQuery -10492024-09-24✓飞书人事（企业版）搜索待入职信息 +10492025-01-16✓飞书人事（企业版）搜索待入职信息 PostCorehrV2PreHiresSearch 10502024-08-23✓消息与群组更新 URL 预览 PostImV2UrlPreviewsBatchUpdate 10512024-12-30✓飞书人事（企业版）查询指定生效日期的部门基本信息 PostCorehrV2DepartmentsQueryTimeline -10522024-07-24✓飞书人事（企业版）更新待入职信息 +10522025-01-16✓飞书人事（企业版）更新待入职信息 PatchCorehrV2PreHiresByPreHireId 10532025-01-03✓飞书人事（企业版）获取流程表单数据 GetCorehrV2ProcessesByProcessIdFormVariableData @@ -2243,7 +2243,7 @@ PostCorehrV2PreHiresByPreHireIdComplete 11222024-08-28✓飞书人事（企业版）流转入职任务 PostCorehrV2PreHiresByPreHireIdTransitTask -11232024-07-15✓飞书人事（企业版）查询待入职信息 +11232025-01-16✓飞书人事（企业版）查询待入职信息 PostCorehrV2PreHiresQuery 11242024-08-29✓招聘发布职位广告 PostHireV1AdvertisementsByAdvertisementIdPublish @@ -2495,7 +2495,7 @@ PatchCorehrV2LocationsByLocationId 12482024-10-29✓飞书人事（企业版）删除地点地址 DeleteCorehrV2LocationsByLocationIdAddressesByAddressId -12492024-11-28✓飞书人事（企业版）操作员工离职 +12492025-01-14✓飞书人事（企业版）操作员工离职 PostCorehrV2OffboardingsSubmitV2 12502024-11-14✓飞书人事（企业版）创建兼职 PostCorehrV2EmployeesAdditionalJobs @@ -2613,7 +2613,7 @@ PostCorehrV2JobChanges 13072024-12-20✓云文档获取云文档的点赞者列表 GetDriveV2FilesByFileTokenLikes -13082024-12-19✓云文档在群公告中创建块 +13082025-01-16✓云文档在群公告中创建块 PostDocxV1ChatsByChatIdAnnouncementBlocksByBlockIdChildren 13092024-12-19✓云文档批量更新群公告块的内容 PatchDocxV1ChatsByChatIdAnnouncementBlocksBatchUpdate @@ -2653,16 +2653,16 @@ PostCardkitV1Cards 13272024-12-31✓卡片更新组件 PutCardkitV1CardsByCardIdElementsByElementId -13282025-01-07新增飞书人事（企业版）查询当前生效信息发生变更的地点 +13282025-01-10✓飞书人事（企业版）查询当前生效信息发生变更的地点 GetCorehrV2LocationsQueryRecentChange -13292025-01-07新增飞书人事（企业版）查询当前生效信息发生变更的成本中心 +13292025-01-10✓飞书人事（企业版）查询当前生效信息发生变更的成本中心 GetCorehrV2CostCentersQueryRecentChange -13302025-01-07新增飞书人事（企业版）查询当前生效信息发生变更的序列 +13302025-01-10✓飞书人事（企业版）查询当前生效信息发生变更的序列 GetCorehrV2JobFamiliesQueryRecentChange -13312025-01-07新增飞书人事（企业版）查询当前生效信息发生变更的职级 +13312025-01-10✓飞书人事（企业版）查询当前生效信息发生变更的职级 GetCorehrV2JobLevelsQueryRecentChange -13322025-01-07新增飞书人事（企业版）查询当前生效信息发生变更的职等 +13322025-01-10✓飞书人事（企业版）查询当前生效信息发生变更的职等 GetCorehrV2JobGradesQueryRecentChange -13332025-01-10新增飞书人事（企业版）查询枚举信息 +13332025-01-10✓飞书人事（企业版）查询枚举信息 PostCorehrV2EnumsSearch diff --git a/UserAccessList.md b/UserAccessList.md index 08f67f75..7727bf6d 100644 --- a/UserAccessList.md +++ b/UserAccessList.md @@ -363,7 +363,7 @@ PostCalendarV4CalendarsByCalendarIdEventsByEventIdAttendees 1822024-07-16✓日历删除日程参与人 PostCalendarV4CalendarsByCalendarIdEventsByEventIdAttendeesBatchDelete -1832024-07-16✓日历获取日程参与人列表 +1832025-01-13✓日历获取日程参与人列表 GetCalendarV4CalendarsByCalendarIdEventsByEventIdAttendees 1842024-07-16✓日历获取日程参与群成员列表 GetCalendarV4CalendarsByCalendarIdEventsByEventIdAttendeesByAttendeeIdChatMembers @@ -503,7 +503,7 @@ PatchHelpdeskV1AgentSkillsByAgentSkillId 2522024-03-06✓服务台更新工单详情 PutHelpdeskV1TicketsByTicketId -2532024-03-06✓服务台创建工单自定义字段 +2532025-01-14✓服务台创建工单自定义字段 PostHelpdeskV1TicketCustomizedFields 2542024-03-06✓服务台删除工单自定义字段 DeleteHelpdeskV1TicketCustomizedFieldsByTicketCustomizedFieldId @@ -579,7 +579,7 @@ DeleteTaskV1TasksByTaskIdFollowersByFollowerId 2902023-07-13✓任务批量删除关注人 PostTaskV1TasksByTaskIdBatchDeleteFollower -2912024-10-30✓消息与群组用户或机器人主动加入群聊 +2912025-01-17✓消息与群组用户或机器人主动加入群聊 PatchImV1ChatsByChatIdMembersMeJoin 2922022-12-23✓任务获取关注人列表 GetTaskV1TasksByTaskIdFollowers @@ -1043,7 +1043,7 @@ GetWikiV2SpacesBySpaceIdMembers 5222024-08-02✓画板获取画板缩略图片 GetBoardV1WhiteboardsByWhiteboardIdDownloadAsImage -5232025-01-07✓邮箱发送邮件 +5232025-01-13✓邮箱发送邮件 PostMailV1UserMailboxesByUserMailboxIdMessagesSend 5242024-08-30删除公司圈查询帖子信息 GetMomentsV1PostsByPostId @@ -1089,7 +1089,7 @@ GetPayrollV1AcctItems 5452024-12-20✓云文档获取云文档的点赞者列表 GetDriveV2FilesByFileTokenLikes -5462024-12-19✓云文档在群公告中创建块 +5462025-01-16✓云文档在群公告中创建块 PostDocxV1ChatsByChatIdAnnouncementBlocksByBlockIdChildren 5472024-12-19✓云文档批量更新群公告块的内容 PatchDocxV1ChatsByChatIdAnnouncementBlocksBatchUpdate @@ -1103,8 +1103,8 @@ GetDocxV1ChatsByChatIdAnnouncement 5522024-12-19✓云文档获取群公告所有块 GetDocxV1ChatsByChatIdAnnouncementBlocks -5532025-01-10新增飞书低代码平台查询席位活跃详情 +5532025-01-10✓飞书低代码平台查询席位活跃详情 GetApaasV1SeatActivities -5542025-01-10新增飞书低代码平台查询席位分配详情 +5542025-01-10✓飞书低代码平台查询席位分配详情 GetApaasV1SeatAssignments diff --git a/src/Ai/PostTranslationV1TextTranslateBodyDto.cs b/src/Ai/PostTranslationV1TextTranslateBodyDto.cs index de4d982f..2d3b12df 100644 --- a/src/Ai/PostTranslationV1TextTranslateBodyDto.cs +++ b/src/Ai/PostTranslationV1TextTranslateBodyDto.cs @@ -46,7 +46,7 @@ public record PostTranslationV1TextTranslateBodyDto public string SourceLanguage { get; set; } = string.Empty; /// - /// 源文本 + /// 源文本，字符上限为 1,000。 /// 必填：是 /// 示例值：尝试使用一下飞书吧 /// diff --git a/src/Approval/PostApprovalV4ExternalInstancesBodyDto.cs b/src/Approval/PostApprovalV4ExternalInstancesBodyDto.cs index c4d129d9..ba90ad9a 100644 --- a/src/Approval/PostApprovalV4ExternalInstancesBodyDto.cs +++ b/src/Approval/PostApprovalV4ExternalInstancesBodyDto.cs @@ -102,7 +102,7 @@ public record ExternalInstanceLink public string? Title { get; set; } /// - /// 用户提交审批时填写的表单数据，用于所有审批列表中展示。可传多个值，但审批中心pc展示前2个,移动端展示前3个,长度不超过2048字符 + /// 用户提交审批时填写的表单数据，用于所有审批列表中展示。可传多个值，但审批中心仅展示前 3 个，长度不超过 2048 字符。 /// 必填：否 /// 示例值：[{ "name": "@i18n@2", "value": "@i18n@3" }] /// @@ -110,7 +110,7 @@ public record ExternalInstanceLink public ExternalInstanceForm[]? Forms { get; set; } /// - /// 用户提交审批时填写的表单数据，用于所有审批列表中展示。可传多个值，但审批中心pc展示前2个,移动端展示前3个,长度不超过2048字符 + /// 用户提交审批时填写的表单数据，用于所有审批列表中展示。可传多个值，但审批中心仅展示前 3 个，长度不超过 2048 字符。 /// public record ExternalInstanceForm { diff --git a/src/Attendance/PostAttendanceV1UserApprovalsQueryBodyDto.cs b/src/Attendance/PostAttendanceV1UserApprovalsQueryBodyDto.cs index d5ae942f..4856673c 100644 --- a/src/Attendance/PostAttendanceV1UserApprovalsQueryBodyDto.cs +++ b/src/Attendance/PostAttendanceV1UserApprovalsQueryBodyDto.cs @@ -9,11 +9,11 @@ // // MIT // -// 获取审批通过数据 请求体 +// 获取审批数据 请求体 // ************************************************************************ namespace FeishuNetSdk.Attendance; /// -/// 获取审批通过数据 请求体 +/// 获取审批数据 请求体 /// 获取员工在某段时间内的请假、加班、外出和出差四种审批数据。 /// 接口ID：7108645368100257794 /// 文档地址：https://open.feishu.cn/document/server-docs/attendance-v1/user_approval/query @@ -61,6 +61,8 @@ public record PostAttendanceV1UserApprovalsQueryBodyDto /// /// 查询状态（不填默认查询已通过状态） + /// 请假、加班：仅支持已通过和已撤回状态 + /// 外出、出差：支持查询所有状态 /// 必填：否 /// 示例值：2 /// 可选值： diff --git a/src/Attendance/PostAttendanceV1UserApprovalsQueryResponseDto.cs b/src/Attendance/PostAttendanceV1UserApprovalsQueryResponseDto.cs index 315d23cb..eac6ea06 100644 --- a/src/Attendance/PostAttendanceV1UserApprovalsQueryResponseDto.cs +++ b/src/Attendance/PostAttendanceV1UserApprovalsQueryResponseDto.cs @@ -9,11 +9,11 @@ // // MIT // -// 获取审批通过数据 响应体 +// 获取审批数据 响应体 // ************************************************************************ namespace FeishuNetSdk.Attendance; /// -/// 获取审批通过数据 响应体 +/// 获取审批数据 响应体 /// 获取员工在某段时间内的请假、加班、外出和出差四种审批数据。 /// 接口ID：7108645368100257794 /// 文档地址：https://open.feishu.cn/document/server-docs/attendance-v1/user_approval/query diff --git a/src/Attendance/PostAttendanceV1UserFlowsBatchCreateBodyDto.cs b/src/Attendance/PostAttendanceV1UserFlowsBatchCreateBodyDto.cs index 86726bcc..0aa67d4a 100644 --- a/src/Attendance/PostAttendanceV1UserFlowsBatchCreateBodyDto.cs +++ b/src/Attendance/PostAttendanceV1UserFlowsBatchCreateBodyDto.cs @@ -114,7 +114,7 @@ public record UserFlow public bool? IsWifi { get; set; } /// - /// 记录生成方式。在开放平台调用时，此参数无效，内部值始终是7 + /// 记录的生成方式。举例：type=0表示「开放平台导入」的「用户打卡」流水；type=1表示「开放平台导入」的「管理员修改」流水。若不设置type，则默认是0。 /// 必填：否 /// 示例值：7 /// 可选值： diff --git a/src/Corehr/PatchCorehrV2PreHiresByPreHireIdBodyDto.cs b/src/Corehr/PatchCorehrV2PreHiresByPreHireIdBodyDto.cs index 3d75adcf..7949cf59 100644 --- a/src/Corehr/PatchCorehrV2PreHiresByPreHireIdBodyDto.cs +++ b/src/Corehr/PatchCorehrV2PreHiresByPreHireIdBodyDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-07-04 +// Last Modified On : 2025-01-17 // ************************************************************************ // // MIT @@ -136,6 +136,14 @@ public record NameForUpdate /// [JsonPropertyName("name_type")] public string NameType { get; set; } = string.Empty; + + /// + /// 别名 + /// 必填：否 + /// 示例值：别名 + /// + [JsonPropertyName("additional_name")] + public string? AdditionalName { get; set; } } /// @@ -430,6 +438,22 @@ public record AddressForUpdate /// [JsonPropertyName("is_public")] public bool IsPublic { get; set; } + + /// + /// 城市，可以通过接口[查询城市信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-city/search)获取详情 + /// 必填：否 + /// 示例值：6863333254578046471 + /// + [JsonPropertyName("city_id_v2")] + public string? CityIdV2 { get; set; } + + /// + /// 区/县，可以通过接口[查询区/县信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-district/search)获取详情 + /// 必填：否 + /// 示例值：6863333516579440141 + /// + [JsonPropertyName("district_id_v2")] + public string? DistrictIdV2 { get; set; } } /// @@ -851,6 +875,22 @@ public record AddressForUpdate /// [JsonPropertyName("is_public")] public bool IsPublic { get; set; } + + /// + /// 城市 + /// 必填：否 + /// 示例值：6863333254578046471 + /// + [JsonPropertyName("city_id_v2")] + public string? CityIdV2 { get; set; } + + /// + /// 区/县 + /// 必填：否 + /// 示例值：6863333516579440141 + /// + [JsonPropertyName("district_id_v2")] + public string? DistrictIdV2 { get; set; } } } @@ -1278,6 +1318,22 @@ public record AddressForUpdate /// [JsonPropertyName("is_public")] public bool IsPublic { get; set; } + + /// + /// 城市 + /// 必填：否 + /// 示例值：6863333254578046471 + /// + [JsonPropertyName("city_id_v2")] + public string? CityIdV2 { get; set; } + + /// + /// 区/县 + /// 必填：否 + /// 示例值：6863333516579440141 + /// + [JsonPropertyName("district_id_v2")] + public string? DistrictIdV2 { get; set; } } /// @@ -1326,6 +1382,14 @@ public record EmailForUpdate [JsonPropertyName("email_usage")] public string EmailUsage { get; set; } = string.Empty; } + + /// + /// 主要联系人,若有多个联系人，只能有一个联系人的「is_primary」为true + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("is_primary")] + public bool? IsPrimary { get; set; } } /// @@ -1462,6 +1526,22 @@ public record AddressForUpdate /// [JsonPropertyName("is_public")] public bool IsPublic { get; set; } + + /// + /// 城市 + /// 必填：否 + /// 示例值：6863333254578046471 + /// + [JsonPropertyName("city_id_v2")] + public string? CityIdV2 { get; set; } + + /// + /// 区/县 + /// 必填：否 + /// 示例值：6863333516579440141 + /// + [JsonPropertyName("district_id_v2")] + public string? DistrictIdV2 { get; set; } } /// @@ -1538,6 +1618,162 @@ public record ObjectFieldData /// [JsonPropertyName("hukou_location")] public string? HukouLocation { get; set; } + + /// + /// 性别，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： + /// - object_api_name：dependent + /// - custom_api_name：gender + /// 必填：否 + /// 示例值：male + /// + [JsonPropertyName("gender_id")] + public string? GenderId { get; set; } + + /// + /// 生日 + /// 必填：否 + /// 示例值：2011-99-99 + /// + [JsonPropertyName("date_of_birth")] + public string? DateOfBirth { get; set; } + + /// + /// 参加工作日期 + /// 必填：否 + /// 示例值：2100-09-09 + /// + [JsonPropertyName("date_entered_workforce")] + public string? DateEnteredWorkforce { get; set; } + + /// + /// 预计毕业日期 + /// 必填：否 + /// 示例值：2023-01-10 + /// + [JsonPropertyName("expected_graduate_date")] + public string? ExpectedGraduateDate { get; set; } + + /// + /// 公民身份 + /// 必填：否 + /// 示例值：[6862995757234914824] + /// + [JsonPropertyName("citizenship_status_id_list")] + public string[]? CitizenshipStatusIdList { get; set; } + + /// + /// 工作履历 + /// 必填：否 + /// + [JsonPropertyName("work_experience")] + public WorkExperienceForUpdate[]? WorkExperiences { get; set; } + + /// + /// 工作履历 + /// + public record WorkExperienceForUpdate + { + /// + /// 公司名称 + /// 必填：否 + /// 示例值：猎豹 + /// + [JsonPropertyName("company_name")] + public string? CompanyName { get; set; } + + /// + /// 开始时间 + /// 必填：否 + /// 示例值：2015-02-01 + /// + [JsonPropertyName("start_time")] + public string? StartTime { get; set; } + + /// + /// 结束时间 + /// 必填：否 + /// 示例值：2017-02-01 + /// + [JsonPropertyName("end_time")] + public string? EndTime { get; set; } + + /// + /// 岗位 + /// 必填：否 + /// 示例值：产品经理 + /// + [JsonPropertyName("job_title")] + public string? JobTitle { get; set; } + + /// + /// 工作描述 + /// 必填：否 + /// 示例值：app + /// + [JsonPropertyName("description")] + public string? Description { get; set; } + + /// + /// 部门 + /// 必填：否 + /// 示例值：部门名称 + /// + [JsonPropertyName("department")] + public string? Department { get; set; } + } + + /// + /// 教育经历 + /// 必填：否 + /// + [JsonPropertyName("education_info")] + public EducationInfoForUpdate[]? EducationInfos { get; set; } + + /// + /// 教育经历 + /// + public record EducationInfoForUpdate + { + /// + /// 学校名称 + /// 必填：否 + /// 示例值：长安大学 + /// + [JsonPropertyName("school_name")] + public string? SchoolName { get; set; } + + /// + /// 学历，枚举值可通过文档[枚举常量介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)学历（level_of_education）枚举定义获得 + /// 必填：否 + /// 示例值：phd + /// + [JsonPropertyName("education")] + public string? Education { get; set; } + + /// + /// 开始时间 + /// 必填：否 + /// 示例值：2017-04-01 + /// + [JsonPropertyName("start_time")] + public string? StartTime { get; set; } + + /// + /// 结束时间 + /// 必填：否 + /// 示例值：2018-04-01 + /// + [JsonPropertyName("end_time")] + public string? EndTime { get; set; } + + /// + /// 专业 + /// 必填：否 + /// 示例值：医学影像技术 + /// + [JsonPropertyName("field_of_study")] + public string? FieldOfStudy { get; set; } + } } /// @@ -1923,6 +2159,14 @@ public record ObjectFieldData [JsonPropertyName("employee_type_id")] public string? EmployeeTypeId { get; set; } + /// + /// 人员子类型 + /// 必填：否 + /// 示例值：xxx + /// + [JsonPropertyName("employee_subtype_id")] + public string? EmployeeSubtypeId { get; set; } + /// /// 直属上级，可以通过[批量查询员工信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)接口获取 /// 必填：否 @@ -1931,6 +2175,15 @@ public record ObjectFieldData [JsonPropertyName("direct_leader_id")] public string? DirectLeaderId { get; set; } + /// + /// 虚线上级，可以通过[搜索员工信息](https://open.feishu.cn/document/server-docs/corehr-v1/employee/search)接口获取详情 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：xxx + /// + [JsonPropertyName("dotted_line_manager_id")] + public string? DottedLineManagerId { get; set; } + /// /// 部门 ID，可以通过[批量查询部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get)接口获取 /// 必填：否 @@ -1970,6 +2223,200 @@ public record ObjectFieldData /// [JsonPropertyName("working_hours_type")] public string? WorkingHoursType { get; set; } + + /// + /// 司龄起算日期 + /// 必填：否 + /// 示例值：2022-10-08 + /// + [JsonPropertyName("seniority_date")] + public string? SeniorityDate { get; set; } + + /// + /// 司龄调整信息 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// + [JsonPropertyName("seniority_adjust_information_list")] + public PrehireSeniorityAdjustInformationUpdate[]? SeniorityAdjustInformationLists { get; set; } + + /// + /// 司龄调整信息 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// + public record PrehireSeniorityAdjustInformationUpdate + { + /// + /// 调整值 + /// - 精确度：两位小数 + /// - 单位：年 + /// - 自动计算逻辑：如果这个值为空，司龄调整的开始日期和结束日期均不为空，会自动计算出调整值 + /// 必填：否 + /// 示例值：0.5 + /// 最大值：100 + /// 最小值：0 + /// + [JsonPropertyName("seniority_adjustment")] + public float? SeniorityAdjustment { get; set; } + + /// + /// 调整类型 + /// - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name：seniority_adjust_information + /// - custom_api_name：seniority_adjustment_type + /// 必填：是 + /// 示例值：增加 + /// 可选值： + /// decrease：减少 + /// increase：增加 + /// + /// + [JsonPropertyName("seniority_adjustment_type")] + public string SeniorityAdjustmentType { get; set; } = string.Empty; + + /// + /// 司龄调整原因 + /// 必填：否 + /// 示例值：工厂停产需要减去半年工龄 + /// + [JsonPropertyName("reasons_for_seniority_adjustment")] + public string? ReasonsForSeniorityAdjustment { get; set; } + + /// + /// 开始日期 + /// - 格式： yyyy-mm-dd + /// 必填：否 + /// 示例值：2024-05-19 + /// + [JsonPropertyName("start_date")] + public string? StartDate { get; set; } + + /// + /// 结束日期 + /// - 格式： yyyy-mm-dd + /// 必填：否 + /// 示例值：2024-11-18 + /// + [JsonPropertyName("end_date")] + public string? EndDate { get; set; } + } + + /// + /// 试用期内通知期（主动离职) + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：xxx + /// + [JsonPropertyName("notice_period_probation_voluntary")] + public NoticePeriodDetail? NoticePeriodProbationVoluntary { get; set; } + + /// + /// 试用期内通知期（主动离职) + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// + public record NoticePeriodDetail + { + /// + /// ID + /// 必填：否 + /// 示例值：4698019107896524633 + /// + [JsonPropertyName("wk_id")] + public string? WkId { get; set; } + + /// + /// 数值 + /// 必填：否 + /// 示例值：1 + /// 最大值：65535 + /// 最小值：1 + /// + [JsonPropertyName("value")] + public int? Value { get; set; } + + /// + /// 单位 + /// 必填：否 + /// 示例值：月 + /// + [JsonPropertyName("value_unit")] + public string? ValueUnit { get; set; } + } + + /// + /// 试用期内通知期（被动离职） + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：xxx + /// + [JsonPropertyName("notice_period_probation_involuntary")] + public NoticePeriodDetail? NoticePeriodProbationInvoluntary { get; set; } + + /// + /// 转正后通知期（主动离职） + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：xxx + /// + [JsonPropertyName("notice_period_positive_voluntary")] + public NoticePeriodDetail? NoticePeriodPositiveVoluntary { get; set; } + + /// + /// 转正后通知期（被动离职） + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：xxx + /// + [JsonPropertyName("notice_period_positive_involuntary")] + public NoticePeriodDetail? NoticePeriodPositiveInvoluntary { get; set; } + + /// + /// 是否外部人员 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("condition_worker")] + public bool? ConditionWorker { get; set; } + + /// + /// 需要公司办理签证 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("company_sponsored_visa")] + public bool? CompanySponsoredVisa { get; set; } + + /// + /// 周工作时长（单位：小时） + /// 必填：否 + /// 示例值：8.5 + /// + [JsonPropertyName("weekly_working_hours_v2")] + public float? WeeklyWorkingHoursV2 { get; set; } + + /// + /// 工位 + /// 必填：否 + /// 示例值：5-1-2 + /// + [JsonPropertyName("work_station")] + public string? WorkStation { get; set; } + + /// + /// 任职公司，可以通过[批量查询公司](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)接口查询 + /// 必填：否 + /// 示例值：6738317738688661772 + /// + [JsonPropertyName("service_company")] + public string? ServiceCompany { get; set; } + + /// + /// 是否包含竞业条款 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("non_compete_covenant")] + public bool? NonCompeteCovenant { get; set; } } /// diff --git a/src/Corehr/PostCorehrV2ContractsSearchResponseDto.cs b/src/Corehr/PostCorehrV2ContractsSearchResponseDto.cs index 5bb3df6b..3bf44304 100644 --- a/src/Corehr/PostCorehrV2ContractsSearchResponseDto.cs +++ b/src/Corehr/PostCorehrV2ContractsSearchResponseDto.cs @@ -132,7 +132,7 @@ public record I18n public string? FirstPartyCompanyId { get; set; } /// - /// 合同签约员工ID，详细信息可通过接口文档[【批量查询员工信息接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)接口查询获得 + /// 个人信息 ID，详细信息可通过接口文档[【批量查询员工信息接口】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)接口查询获得 /// 必填：否 /// 示例值：7088589447189022252 /// diff --git a/src/Corehr/PostCorehrV2OffboardingsSubmitV2BodyDto.cs b/src/Corehr/PostCorehrV2OffboardingsSubmitV2BodyDto.cs index 617a6cbd..4df9eb46 100644 --- a/src/Corehr/PostCorehrV2OffboardingsSubmitV2BodyDto.cs +++ b/src/Corehr/PostCorehrV2OffboardingsSubmitV2BodyDto.cs @@ -47,6 +47,7 @@ public record PostCorehrV2OffboardingsSubmitV2BodyDto /// /// 离职日期，不允许为空，填写时需要符合YYYY-MM-DD的日期格式。 + /// 注意：按员工离职当天的工作地点时区24点生效。假设员工离职日期为2024-12-01，如果员工在中国大陆，则生效时间为东八区的2024-12-01 23:59:59。如果员工在华盛顿，则生效时间为东八区的2024-12-02 12:59:59，对应西五区的2024-12-01 23:59:59。 /// 必填：是 /// 示例值：2022-05-18 /// diff --git a/src/Corehr/PostCorehrV2PreHiresBodyDto.cs b/src/Corehr/PostCorehrV2PreHiresBodyDto.cs index a018ee14..21005e7f 100644 --- a/src/Corehr/PostCorehrV2PreHiresBodyDto.cs +++ b/src/Corehr/PostCorehrV2PreHiresBodyDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-07-28 +// Last Modified On : 2025-01-17 // ************************************************************************ // // MIT @@ -124,6 +124,14 @@ public record PostCorehrV2PreHiresBodyDtoBasicInfoName /// [JsonPropertyName("custom_western_name")] public string? CustomWesternName { get; set; } + + /// + /// 别名 + /// 必填：否 + /// 示例值：别名 + /// + [JsonPropertyName("additional_name")] + public string? AdditionalName { get; set; } } /// @@ -336,8 +344,23 @@ public record NameSuffix /// [JsonPropertyName("custom_western_name")] public string? CustomWesternName { get; set; } + + /// + /// 别名 + /// 必填：否 + /// 示例值：别名 + /// + [JsonPropertyName("additional_name")] + public string? AdditionalName { get; set; } } + /// + /// 别名 + /// 必填：否 + /// + [JsonPropertyName("additional_name")] + public NameSuffix? AdditionalName { get; set; } + /// /// 纳税身份信息 /// 必填：否 @@ -500,6 +523,22 @@ public record AddressForUpdate /// [JsonPropertyName("is_public")] public bool IsPublic { get; set; } + + /// + /// 城市，可以通过接口[查询城市信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-city/search)获取详情 + /// 必填：否 + /// 示例值：6863333254578046471 + /// + [JsonPropertyName("city_id_v2")] + public string? CityIdV2 { get; set; } + + /// + /// 区/县，可以通过接口[查询区/县信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-district/search)获取详情 + /// 必填：否 + /// 示例值：6863333516579440141 + /// + [JsonPropertyName("district_id_v2")] + public string? DistrictIdV2 { get; set; } } /// @@ -808,7 +847,7 @@ public record AddressForUpdate public string CountryRegionId { get; set; } = string.Empty; /// - /// 主要行政区，可以通过[查询省份/行政区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)接口获取 + /// 主要行政区，可以通过接口[查询省份/行政区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)获取 /// 必填：否 /// 示例值：6863326815667095047 /// @@ -921,6 +960,22 @@ public record AddressForUpdate /// [JsonPropertyName("is_public")] public bool IsPublic { get; set; } + + /// + /// 城市，可以通过接口[查询城市信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-city/search)获取详情 + /// 必填：否 + /// 示例值：6863333254578046471 + /// + [JsonPropertyName("city_id_v2")] + public string? CityIdV2 { get; set; } + + /// + /// 区/县，可以通过接口[查询区/县信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-district/search)获取详情 + /// 必填：否 + /// 示例值：6863333516579440141 + /// + [JsonPropertyName("district_id_v2")] + public string? DistrictIdV2 { get; set; } } } @@ -1348,6 +1403,22 @@ public record AddressForUpdate /// [JsonPropertyName("is_public")] public bool IsPublic { get; set; } + + /// + /// 城市，可以通过接口[查询城市信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-city/search)获取详情 + /// 必填：否 + /// 示例值：6863333254578046471 + /// + [JsonPropertyName("city_id_v2")] + public string? CityIdV2 { get; set; } + + /// + /// 区/县，可以通过接口[查询区/县信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-district/search)获取详情 + /// 必填：否 + /// 示例值：6863333516579440141 + /// + [JsonPropertyName("district_id_v2")] + public string? DistrictIdV2 { get; set; } } /// @@ -1396,6 +1467,14 @@ public record EmailForUpdate [JsonPropertyName("email_usage")] public string EmailUsage { get; set; } = string.Empty; } + + /// + /// 主要联系人，若有多个联系人，只能有一个联系人的「is_primary」为true + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("is_primary")] + public bool? IsPrimary { get; set; } } /// @@ -1532,6 +1611,22 @@ public record AddressForUpdate /// [JsonPropertyName("is_public")] public bool IsPublic { get; set; } + + /// + /// 城市，可以通过接口[查询城市信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-city/search)获取详情 + /// 必填：否 + /// 示例值：6863333254578046471 + /// + [JsonPropertyName("city_id_v2")] + public string? CityIdV2 { get; set; } + + /// + /// 区/县，可以通过接口[查询区/县信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-district/search)获取详情 + /// 必填：否 + /// 示例值：6863333516579440141 + /// + [JsonPropertyName("district_id_v2")] + public string? DistrictIdV2 { get; set; } } /// @@ -1608,6 +1703,14 @@ public record ObjectFieldData [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; } + + /// + /// 预计毕业日期 + /// 必填：否 + /// 示例值：2023-01-10 + /// + [JsonPropertyName("expected_graduate_date")] + public string? ExpectedGraduateDate { get; set; } } /// @@ -1654,6 +1757,15 @@ public record PostCorehrV2PreHiresBodyDtoOfferInfo [JsonPropertyName("direct_leader_id")] public string? DirectLeaderId { get; set; } + /// + /// 虚线上级ID，可以通过[批量查询员工信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)接口获取 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：7032210902531327521 + /// + [JsonPropertyName("dotted_line_manager_id")] + public string? DottedLineManagerId { get; set; } + /// /// 职务 ID，可以通过[批量查询职务](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/job/list)接口获取 /// 必填：否 @@ -1786,6 +1898,14 @@ public record PostCorehrV2PreHiresBodyDtoOfferInfo [JsonPropertyName("employee_type_id")] public string? EmployeeTypeId { get; set; } + /// + /// 人员子类型id + /// 必填：否 + /// 示例值：6977973225846343171 + /// + [JsonPropertyName("employee_subtype_id")] + public string? EmployeeSubtypeId { get; set; } + /// /// 雇佣类型， 枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： /// - object_api_name：pre_hire @@ -1927,7 +2047,7 @@ public record ObjectFieldData } /// - /// 任职公司 + /// 任职公司，可以通过[批量查询公司](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/company/list)接口获取 /// 必填：否 /// 示例值：6738317738688661772 /// @@ -2035,6 +2155,184 @@ public record ObjectFieldData /// [JsonPropertyName("check_in_method")] public string? CheckInMethod { get; set; } + + /// + /// 司龄起算日期 + /// 必填：否 + /// 示例值：2024-08-01 + /// + [JsonPropertyName("seniority_date")] + public string? SeniorityDate { get; set; } + + /// + /// 司龄调整信息 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// + [JsonPropertyName("seniority_adjust_information_list")] + public PrehireSeniorityAdjustInformation[]? SeniorityAdjustInformationLists { get; set; } + + /// + /// 司龄调整信息 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// + public record PrehireSeniorityAdjustInformation + { + /// + /// 调整值 + /// - 精确度：两位小数 + /// - 单位：年 + /// - 自动计算逻辑：如果这个值为空，司龄调整的开始日期和结束日期均不为空，会自动计算出调整值 + /// 必填：否 + /// 示例值：0.5 + /// 最大值：100 + /// 最小值：0 + /// + [JsonPropertyName("seniority_adjustment")] + public float? SeniorityAdjustment { get; set; } + + /// + /// 调整类型 + /// - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name：seniority_adjust_information + /// - custom_api_name：seniority_adjustment_type + /// 必填：是 + /// 示例值：增加 + /// 可选值： + /// decrease：减少 + /// increase：增加 + /// + /// + [JsonPropertyName("seniority_adjustment_type")] + public string SeniorityAdjustmentType { get; set; } = string.Empty; + + /// + /// 司龄调整原因 + /// 必填：否 + /// 示例值：工厂停产需要减去半年工龄 + /// + [JsonPropertyName("reasons_for_seniority_adjustment")] + public string? ReasonsForSeniorityAdjustment { get; set; } + + /// + /// 开始日期 + /// - 格式： yyyy-mm-dd + /// 必填：否 + /// 示例值：2024-05-19 + /// + [JsonPropertyName("start_date")] + public string? StartDate { get; set; } + + /// + /// 结束日期 + /// - 格式： yyyy-mm-dd + /// 必填：否 + /// 示例值：2024-11-18 + /// + [JsonPropertyName("end_date")] + public string? EndDate { get; set; } + } + + /// + /// 试用期内通知期（主动离职) + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：xxx + /// + [JsonPropertyName("notice_period_probation_voluntary")] + public NoticePeriodDetail? NoticePeriodProbationVoluntary { get; set; } + + /// + /// 试用期内通知期（主动离职) + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// + public record NoticePeriodDetail + { + /// + /// ID + /// 必填：否 + /// 示例值：4698019107896524633 + /// + [JsonPropertyName("wk_id")] + public string? WkId { get; set; } + + /// + /// 数值 + /// 必填：否 + /// 示例值：1 + /// 最大值：65535 + /// 最小值：1 + /// + [JsonPropertyName("value")] + public int? Value { get; set; } + + /// + /// 单位 + /// 必填：否 + /// 示例值：月 + /// + [JsonPropertyName("value_unit")] + public string? ValueUnit { get; set; } + } + + /// + /// 试用期内通知期（被动离职） + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：xxx + /// + [JsonPropertyName("notice_period_probation_involuntary")] + public NoticePeriodDetail? NoticePeriodProbationInvoluntary { get; set; } + + /// + /// 转正后通知期（主动离职） + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：xxx + /// + [JsonPropertyName("notice_period_positive_voluntary")] + public NoticePeriodDetail? NoticePeriodPositiveVoluntary { get; set; } + + /// + /// 转正后通知期（被动离职） + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：xxx + /// + [JsonPropertyName("notice_period_positive_involuntary")] + public NoticePeriodDetail? NoticePeriodPositiveInvoluntary { get; set; } + + /// + /// 是否外部人员 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("condition_worker")] + public bool? ConditionWorker { get; set; } + + /// + /// 是否包含竞业条款 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("non_compete_covenant")] + public bool? NonCompeteCovenant { get; set; } + + /// + /// 需要公司办理签证 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("company_sponsored_visa")] + public bool? CompanySponsoredVisa { get; set; } + + /// + /// 工位 + /// 必填：否 + /// 示例值：5-1-2 + /// + [JsonPropertyName("work_station")] + public string? WorkStation { get; set; } } /// @@ -2090,6 +2388,35 @@ public record EducationInfo /// [JsonPropertyName("field_of_study")] public string? FieldOfStudy { get; set; } + + /// + /// 自定义字段 + /// 必填：否 + /// + [JsonPropertyName("custom_fields")] + public ObjectFieldData[]? CustomFields { get; set; } + + /// + /// 自定义字段 + /// + public record ObjectFieldData + { + /// + /// 字段名 + /// 必填：是 + /// 示例值：name + /// + [JsonPropertyName("field_name")] + public string FieldName { get; set; } = string.Empty; + + /// + /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, [\"id1\",\"id2\], 2006-01-02 15:04:05]) + /// 必填：是 + /// 示例值：Sandy + /// + [JsonPropertyName("value")] + public string Value { get; set; } = string.Empty; + } } /// @@ -2151,6 +2478,35 @@ public record WorkExperience /// [JsonPropertyName("department")] public string? Department { get; set; } + + /// + /// 自定义字段 + /// 必填：否 + /// + [JsonPropertyName("custom_fields")] + public ObjectFieldData[]? CustomFields { get; set; } + + /// + /// 自定义字段 + /// + public record ObjectFieldData + { + /// + /// 字段名 + /// 必填：是 + /// 示例值：name + /// + [JsonPropertyName("field_name")] + public string FieldName { get; set; } = string.Empty; + + /// + /// 字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, [\"id1\",\"id2\], 2006-01-02 15:04:05]) + /// 必填：是 + /// 示例值：Sandy + /// + [JsonPropertyName("value")] + public string Value { get; set; } = string.Empty; + } } /// @@ -2163,6 +2519,8 @@ public record WorkExperience /// /// 外部业务唯一编码，用于支持幂等创建 + /// - 外部接入方需要保证id的唯一，相同id最多唯一对应一个待入职数据 + /// - 如果id对应的待入职数据已经存在，执行创建操作则直接返回待入职id，且不会更新本次传入的数据到待入职 /// 必填：否 /// 示例值：7140946969586010376 /// diff --git a/src/Corehr/PostCorehrV2PreHiresQueryResponseDto.cs b/src/Corehr/PostCorehrV2PreHiresQueryResponseDto.cs index 9abe9a55..8e8bb3b4 100644 --- a/src/Corehr/PostCorehrV2PreHiresQueryResponseDto.cs +++ b/src/Corehr/PostCorehrV2PreHiresQueryResponseDto.cs @@ -4,7 +4,7 @@ // Created : 2024-07-18 // // Last Modified By : yxr -// Last Modified On : 2024-07-18 +// Last Modified On : 2025-01-17 // ************************************************************************ // // MIT @@ -197,6 +197,14 @@ public record I18n [JsonPropertyName("local_primary_2")] public string? LocalPrimary2 { get; set; } + /// + /// 别名 + /// 必填：否 + /// 示例值：别名 + /// + [JsonPropertyName("additional_name")] + public string? AdditionalName { get; set; } + /// /// 补充姓名类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： /// - custom_api_name：additional_name_type @@ -270,6 +278,14 @@ public record I18n [JsonPropertyName("secondary")] public string? Secondary { get; set; } + /// + /// 婚后姓氏 + /// 必填：否 + /// 示例值：王 + /// + [JsonPropertyName("tertiary")] + public string? Tertiary { get; set; } + /// /// 尊称，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： /// - custom_api_name：social @@ -280,14 +296,6 @@ public record I18n [JsonPropertyName("social")] public Enum? Social { get; set; } - /// - /// 婚后姓氏 - /// 必填：否 - /// 示例值：王 - /// - [JsonPropertyName("tertiary")] - public string? Tertiary { get; set; } - /// /// 头衔，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： /// - custom_api_name：title @@ -397,6 +405,14 @@ public record I18n [JsonPropertyName("date_of_birth")] public string? DateOfBirth { get; set; } + /// + /// 国籍，可以通过[查询国籍信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)接口获取 + /// 必填：否 + /// 示例值：6862995757234914821 + /// + [JsonPropertyName("nationality_id_v2")] + public string? NationalityIdV2 { get; set; } + /// /// 民族，枚举值可通过文档[枚举常量介绍](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)民族（race）枚举定义获得 /// 必填：否 @@ -572,6 +588,22 @@ public record Address [JsonPropertyName("region_id")] public string? RegionId { get; set; } + /// + /// 城市，可以通过接口[查询城市信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-city/search)获取详情 + /// 必填：否 + /// 示例值：6863333254578046471 + /// + [JsonPropertyName("city_id_v2")] + public string? CityIdV2 { get; set; } + + /// + /// 区/县，可以通过接口[查询区/县信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-district/search)获取详情 + /// 必填：否 + /// 示例值：6863333516579440141 + /// + [JsonPropertyName("district_id_v2")] + public string? DistrictIdV2 { get; set; } + /// /// 地址行 1 /// 必填：否 @@ -1452,10 +1484,42 @@ public record I18n [JsonPropertyName("bank_account_type")] public Enum? BankAccountType { get; set; } + /// + /// 分配方式，枚举值可通过文档【飞书人事枚举常量】分配方式（Payment Type）枚举定义部分获得 + /// 必填：否 + /// 示例值：balance + /// + [JsonPropertyName("payment_type")] + public Enum? PaymentType { get; set; } + + /// + /// 分配比例 + /// 必填：否 + /// 示例值：70.21 + /// + [JsonPropertyName("payment_rate")] + public string? PaymentRate { get; set; } + + /// + /// 分配金额 + /// 必填：否 + /// 示例值：5000 + /// + [JsonPropertyName("payment_amount")] + public string? PaymentAmount { get; set; } + + /// + /// 分配优先级 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("priority")] + public int? Priority { get; set; } + /// /// 货币id /// 必填：否 - /// 示例值：12QueryCountryRegionSubdivisionDataReq + /// 示例值：12 /// [JsonPropertyName("currency_id")] public string? CurrencyId { get; set; } @@ -1690,6 +1754,14 @@ public record CustomName /// public record Dependent { + /// + /// ID + /// 必填：否 + /// 示例值：123 + /// + [JsonPropertyName("id")] + public string? Id { get; set; } + /// /// 姓名 /// 必填：否 @@ -1792,6 +1864,14 @@ public record I18n [JsonPropertyName("local_primary_2")] public string? LocalPrimary2 { get; set; } + /// + /// 别名 + /// 必填：否 + /// 示例值：别名 + /// + [JsonPropertyName("additional_name")] + public string? AdditionalName { get; set; } + /// /// 补充姓名类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： /// - custom_api_name：additional_name_type @@ -1865,6 +1945,14 @@ public record I18n [JsonPropertyName("secondary")] public string? Secondary { get; set; } + /// + /// 婚后姓氏 + /// 必填：否 + /// 示例值：王 + /// + [JsonPropertyName("tertiary")] + public string? Tertiary { get; set; } + /// /// 尊称，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： /// - custom_api_name：social @@ -1875,14 +1963,6 @@ public record I18n [JsonPropertyName("social")] public Enum? Social { get; set; } - /// - /// 婚后姓氏 - /// 必填：否 - /// 示例值：王 - /// - [JsonPropertyName("tertiary")] - public string? Tertiary { get; set; } - /// /// 头衔，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： /// - custom_api_name：title @@ -2763,6 +2843,14 @@ public record File /// public record EmergencyContact { + /// + /// ID + /// 必填：否 + /// 示例值：123 + /// + [JsonPropertyName("id")] + public string? Id { get; set; } + /// /// 姓名 /// 必填：否 @@ -2865,6 +2953,14 @@ public record I18n [JsonPropertyName("local_primary_2")] public string? LocalPrimary2 { get; set; } + /// + /// 别名 + /// 必填：否 + /// 示例值：别名 + /// + [JsonPropertyName("additional_name")] + public string? AdditionalName { get; set; } + /// /// 补充姓名类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： /// - custom_api_name：additional_name_type @@ -2938,6 +3034,14 @@ public record I18n [JsonPropertyName("secondary")] public string? Secondary { get; set; } + /// + /// 婚后姓氏 + /// 必填：否 + /// 示例值：王 + /// + [JsonPropertyName("tertiary")] + public string? Tertiary { get; set; } + /// /// 尊称，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： /// - custom_api_name：social @@ -2948,14 +3052,6 @@ public record I18n [JsonPropertyName("social")] public Enum? Social { get; set; } - /// - /// 婚后姓氏 - /// 必填：否 - /// 示例值：王 - /// - [JsonPropertyName("tertiary")] - public string? Tertiary { get; set; } - /// /// 头衔，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： /// - custom_api_name：title @@ -3258,6 +3354,14 @@ public record CustomName [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; } + + /// + /// 主要联系人,若有多个联系人，只能有一个联系人的「is_primary」为true + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("is_primary")] + public bool? IsPrimary { get; set; } } /// @@ -4000,6 +4104,15 @@ public record I18n [JsonPropertyName("direct_leader_id")] public string? DirectLeaderId { get; set; } + /// + /// 虚线上级雇佣 ID ， 可以通过【搜索员工信息】接口获取 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：7032210902531327521 + /// + [JsonPropertyName("dotted_line_manager_id")] + public string? DottedLineManagerId { get; set; } + /// /// 职务 ID ,可以通过[查询职务](https://open.feishu.cn/document/server-docs/corehr-v1/job-management/job/get)接口获取详情 /// 必填：否 @@ -4048,6 +4161,14 @@ public record I18n [JsonPropertyName("employee_type_id")] public string? EmployeeTypeId { get; set; } + /// + /// 人员子类型 ID + /// 必填：否 + /// 示例值：6977973225846343171 + /// + [JsonPropertyName("employee_subtype_id")] + public string? EmployeeSubtypeId { get; set; } + /// /// 雇佣类型， 枚举值可查询[获取字段详情](https://open.feishu.cn/document/server-docs/corehr-v1/basic-infomation/custom_field/get_by_param)接口获取，按如下参数查询即可： /// - object_api_name = pre_hire @@ -4511,6 +4632,14 @@ public record CustomName [JsonPropertyName("suspected_rehiring")] public bool? SuspectedRehiring { get; set; } + /// + /// 是否外部人员 + /// 必填：否 + /// 示例值：false + /// + [JsonPropertyName("condition_worker")] + public bool? ConditionWorker { get; set; } + /// /// 自定义字段 /// 必填：否 @@ -4755,6 +4884,404 @@ public record I18n /// [JsonPropertyName("updated_by")] public string? UpdatedBy { get; set; } + + /// + /// 司龄起算日期 + /// 必填：否 + /// 示例值：2023-01-10 + /// + [JsonPropertyName("seniority_date")] + public string? SeniorityDate { get; set; } + + /// + /// 背调订单ID + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：123 + /// + [JsonPropertyName("background_check_order_id")] + public string? BackgroundCheckOrderId { get; set; } + + /// + /// 背调名称 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：xxx + /// + [JsonPropertyName("background_check_order_name")] + public string? BackgroundCheckOrderName { get; set; } + + /// + /// 背调套餐 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：xxx + /// + [JsonPropertyName("background_check_order_package_name")] + public string? BackgroundCheckOrderPackageName { get; set; } + + /// + /// 背调结果 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：通过 + /// + [JsonPropertyName("background_check_order_result")] + public string? BackgroundCheckOrderResult { get; set; } + + /// + /// 背调供应商 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：xxx + /// + [JsonPropertyName("background_check_order_supplier_name")] + public string? BackgroundCheckOrderSupplierName { get; set; } + + /// + /// 背调账号名称 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：xxx + /// + [JsonPropertyName("background_check_order_account_name")] + public string? BackgroundCheckOrderAccountName { get; set; } + + /// + /// 背调开始时间 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：2023-01-10 10:29 + /// + [JsonPropertyName("background_check_order_start_time")] + public string? BackgroundCheckOrderStartTime { get; set; } + + /// + /// 背调完成时间 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：2023-01-10 10:29 + /// + [JsonPropertyName("background_check_order_complete_time")] + public string? BackgroundCheckOrderCompleteTime { get; set; } + + /// + /// 背调状态，枚举值可查询[获取字段详情](https://open.feishu.cn/document/server-docs/corehr-v1/basic-infomation/custom_field/get_by_param)接口获取，按如下参数查询即可： + /// - object_api_name = pre_hire + /// - custom_api_name = background_check_order_status + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// + [JsonPropertyName("background_check_order_status")] + public Enum? BackgroundCheckOrderStatus { get; set; } + + /// + /// 司龄调整信息 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// + [JsonPropertyName("seniority_adjust_information_list")] + public PrehireSeniorityAdjustInformationQuery[]? SeniorityAdjustInformationLists { get; set; } + + /// + /// 司龄调整信息 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// + public record PrehireSeniorityAdjustInformationQuery + { + /// + /// 调整值 + /// - 精确度：两位小数 + /// - 单位：年 + /// 必填：否 + /// 示例值：0.5 + /// 最大值：100 + /// 最小值：0 + /// + [JsonPropertyName("seniority_adjustment")] + public float? SeniorityAdjustment { get; set; } + + /// + /// 调整类型 + /// - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name：seniority_adjust_information + /// - custom_api_name：seniority_adjustment_type + /// 必填：否 + /// 示例值：增加 + /// + [JsonPropertyName("seniority_adjustment_type")] + public Enum? SeniorityAdjustmentType { get; set; } + + /// + /// 调整类型 + /// - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name：seniority_adjust_information + /// - custom_api_name：seniority_adjustment_type + /// + public record Enum + { + /// + /// 枚举值 + /// 必填：是 + /// 示例值：phone_type + /// + [JsonPropertyName("enum_name")] + public string EnumName { get; set; } = string.Empty; + + /// + /// 枚举多语展示 + /// 必填：否 + /// + [JsonPropertyName("display")] + public I18n[]? Displies { get; set; } + + /// + /// 枚举多语展示 + /// + public record I18n + { + /// + /// 语言编码（IETF BCP 47） + /// 必填：是 + /// 示例值：zh-CN + /// + [JsonPropertyName("lang")] + public string Lang { get; set; } = string.Empty; + + /// + /// 文本内容 + /// 必填：是 + /// 示例值：中文示例 + /// + [JsonPropertyName("value")] + public string Value { get; set; } = string.Empty; + } + } + + /// + /// 司龄调整原因 + /// 必填：否 + /// 示例值：工厂停产需要减去半年工龄 + /// + [JsonPropertyName("reasons_for_seniority_adjustment")] + public string? ReasonsForSeniorityAdjustment { get; set; } + + /// + /// 开始日期 + /// 必填：否 + /// 示例值：2024-05-19 + /// + [JsonPropertyName("start_date")] + public string? StartDate { get; set; } + + /// + /// 结束日期 + /// 必填：否 + /// 示例值：2024-11-18 + /// + [JsonPropertyName("end_date")] + public string? EndDate { get; set; } + + /// + /// 自定义字段 + /// 必填：否 + /// + [JsonPropertyName("custom_fields")] + public CustomFieldData[]? CustomFields { get; set; } + + /// + /// 自定义字段 + /// + public record CustomFieldData + { + /// + /// 自定义字段 apiname，即自定义字段的唯一标识 + /// 必填：是 + /// 示例值：name + /// + [JsonPropertyName("custom_api_name")] + public string CustomApiName { get; set; } = string.Empty; + + /// + /// 自定义字段名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public CustomName? Name { get; set; } + + /// + /// 自定义字段名称 + /// + public record CustomName + { + /// + /// 中文 + /// 必填：否 + /// 示例值：自定义姓名 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：Custom Name + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 自定义字段类型 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("type")] + public int? Type { get; set; } + + /// + /// 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"） + /// 必填：是 + /// 示例值：\"231\" + /// + [JsonPropertyName("value")] + public string Value { get; set; } = string.Empty; + } + } + + /// + /// 转正后通知期（主动离职） + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// + [JsonPropertyName("notice_period_positive_voluntary")] + public NoticePeriodDetail? NoticePeriodPositiveVoluntary { get; set; } + + /// + /// 转正后通知期（主动离职） + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// + public record NoticePeriodDetail + { + /// + /// ID + /// 必填：否 + /// 示例值：4698019107896524633 + /// + [JsonPropertyName("wk_id")] + public string? WkId { get; set; } + + /// + /// 数值 + /// 必填：否 + /// 示例值：1 + /// 最大值：65535 + /// 最小值：1 + /// + [JsonPropertyName("value")] + public int? Value { get; set; } + + /// + /// 单位 + /// 必填：否 + /// 示例值：月 + /// + [JsonPropertyName("value_unit")] + public string? ValueUnit { get; set; } + + /// + /// 名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 名称 + /// + public record I18n + { + /// + /// 语言编码（IETF BCP 47） + /// 必填：是 + /// 示例值：zh-CN + /// + [JsonPropertyName("lang")] + public string Lang { get; set; } = string.Empty; + + /// + /// 文本内容 + /// 必填：是 + /// 示例值：中文示例 + /// + [JsonPropertyName("value")] + public string Value { get; set; } = string.Empty; + } + } + + /// + /// 试用期内通知期（被动离职） + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// + [JsonPropertyName("notice_period_probation_involuntary")] + public NoticePeriodDetail? NoticePeriodProbationInvoluntary { get; set; } + + /// + /// 转正后通知期（被动离职） + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// + [JsonPropertyName("notice_period_positive_involuntary")] + public NoticePeriodDetail? NoticePeriodPositiveInvoluntary { get; set; } + + /// + /// 试用期内通知期（主动离职) + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// + [JsonPropertyName("notice_period_probation_voluntary")] + public NoticePeriodDetail? NoticePeriodProbationVoluntary { get; set; } + + /// + /// 工时制度是否被手动修改 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("working_hours_type_manual_updated")] + public bool? WorkingHoursTypeManualUpdated { get; set; } + + /// + /// 入职任务是否逾期 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("is_over_due")] + public bool? IsOverDue { get; set; } + + /// + /// 入职任务是否完成，暂不推荐使用 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("task_completed")] + public bool? TaskCompleted { get; set; } + + /// + /// 预计毕业日期 + /// 必填：否 + /// 示例值：2023-01-10 + /// + [JsonPropertyName("expected_graduate_date")] + public string? ExpectedGraduateDate { get; set; } + + /// + /// 任职公司 ID , 详细信息可通过[查询单个公司](https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/company/get)接口获得 + /// 必填：否 + /// 示例值：6738317738688661772 + /// + [JsonPropertyName("service_company")] + public string? ServiceCompany { get; set; } } /// @@ -4873,7 +5400,7 @@ public record OnboardingTask public string? TaskName { get; set; } /// - /// 任务名称 + /// 任务状态 /// 必填：否 /// 示例值：task_1 /// 可选值： diff --git a/src/Corehr/PostCorehrV2PreHiresSearchBodyDto.cs b/src/Corehr/PostCorehrV2PreHiresSearchBodyDto.cs index 46e259e9..ef94fefd 100644 --- a/src/Corehr/PostCorehrV2PreHiresSearchBodyDto.cs +++ b/src/Corehr/PostCorehrV2PreHiresSearchBodyDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-09-24 +// Last Modified On : 2025-01-17 // ************************************************************************ // // MIT @@ -126,6 +126,14 @@ public record PostCorehrV2PreHiresSearchBodyDto [JsonPropertyName("employee_type_ids")] public string[]? EmployeeTypeIds { get; set; } + /// + /// 人员子类型 ID 列表 + /// 必填：否 + /// 最大长度：100 + /// + [JsonPropertyName("employee_subtype_ids")] + public string[]? EmployeeSubtypeIds { get; set; } + /// /// 序列 ID 列表，可以通过[批量查询序列](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/job_family/list)接口获取 /// 必填：否 diff --git a/src/Corehr/PostCorehrV2PreHiresSearchResponseDto.cs b/src/Corehr/PostCorehrV2PreHiresSearchResponseDto.cs index 4a3b8236..6b0cf6dc 100644 --- a/src/Corehr/PostCorehrV2PreHiresSearchResponseDto.cs +++ b/src/Corehr/PostCorehrV2PreHiresSearchResponseDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-09-24 +// Last Modified On : 2025-01-17 // ************************************************************************ // // MIT @@ -197,6 +197,14 @@ public record I18n [JsonPropertyName("local_primary_2")] public string? LocalPrimary2 { get; set; } + /// + /// 别名 + /// 必填：否 + /// 示例值：别名 + /// + [JsonPropertyName("additional_name")] + public string? AdditionalName { get; set; } + /// /// 补充姓名类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： /// - custom_api_name：additional_name_type @@ -270,6 +278,14 @@ public record I18n [JsonPropertyName("secondary")] public string? Secondary { get; set; } + /// + /// 婚后姓氏 + /// 必填：否 + /// 示例值：王 + /// + [JsonPropertyName("tertiary")] + public string? Tertiary { get; set; } + /// /// 尊称，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： /// - custom_api_name：social @@ -280,14 +296,6 @@ public record I18n [JsonPropertyName("social")] public Enum? Social { get; set; } - /// - /// 婚后姓氏 - /// 必填：否 - /// 示例值：王 - /// - [JsonPropertyName("tertiary")] - public string? Tertiary { get; set; } - /// /// 头衔，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： /// - custom_api_name：title @@ -398,7 +406,7 @@ public record I18n public string? DateOfBirth { get; set; } /// - /// 国籍 ID，可通过【查询国籍信息】接口查询 + /// 国籍，可以通过[查询国籍信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)接口获取 /// 必填：否 /// 示例值：6862995757234914821 /// @@ -577,13 +585,29 @@ public record Address public string CountryRegionId { get; set; } = string.Empty; /// - /// 主要行政区 + /// 主要行政区，可以通过接口[查询省份/主要行政区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)获得 /// 必填：否 /// 示例值：6863326815667095047 /// [JsonPropertyName("region_id")] public string? RegionId { get; set; } + /// + /// 城市，可以通过接口[查询城市信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-city/search)获取详情 + /// 必填：否 + /// 示例值：6863333254578046471 + /// + [JsonPropertyName("city_id_v2")] + public string? CityIdV2 { get; set; } + + /// + /// 区/县，可以通过接口[查询区/县信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-district/search)获取详情 + /// 必填：否 + /// 示例值：6863333516579440141 + /// + [JsonPropertyName("district_id_v2")] + public string? DistrictIdV2 { get; set; } + /// /// 地址行 1 /// 必填：否 @@ -1468,10 +1492,42 @@ public record I18n [JsonPropertyName("bank_account_type")] public Enum? BankAccountType { get; set; } + /// + /// 分配方式，枚举值可通过文档【飞书人事枚举常量】分配方式（Payment Type）枚举定义部分获得 + /// 必填：否 + /// 示例值：balance + /// + [JsonPropertyName("payment_type")] + public Enum? PaymentType { get; set; } + + /// + /// 分配比例 + /// 必填：否 + /// 示例值：70.21 + /// + [JsonPropertyName("payment_rate")] + public string? PaymentRate { get; set; } + + /// + /// 分配金额 + /// 必填：否 + /// 示例值：5000 + /// + [JsonPropertyName("payment_amount")] + public string? PaymentAmount { get; set; } + + /// + /// 分配优先级 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("priority")] + public int? Priority { get; set; } + /// /// 货币id，详细信息可通过[查询货币信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-currency/search)接口查询获得 /// 必填：否 - /// 示例值：12QueryCountryRegionSubdivisionDataReq + /// 示例值：12 /// [JsonPropertyName("currency_id")] public string? CurrencyId { get; set; } @@ -1706,6 +1762,14 @@ public record CustomName /// public record Dependent { + /// + /// 家庭成员数据ID + /// 必填：否 + /// 示例值：123 + /// + [JsonPropertyName("id")] + public string? Id { get; set; } + /// /// 姓名 /// 必填：否 @@ -1808,6 +1872,14 @@ public record I18n [JsonPropertyName("local_primary_2")] public string? LocalPrimary2 { get; set; } + /// + /// 别名 + /// 必填：否 + /// 示例值：别名 + /// + [JsonPropertyName("additional_name")] + public string? AdditionalName { get; set; } + /// /// additional_name_type /// 补充姓名类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： @@ -1882,6 +1954,14 @@ public record I18n [JsonPropertyName("secondary")] public string? Secondary { get; set; } + /// + /// 婚后姓氏 + /// 必填：否 + /// 示例值：王 + /// + [JsonPropertyName("tertiary")] + public string? Tertiary { get; set; } + /// /// 尊称，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： /// - custom_api_name：social @@ -1892,14 +1972,6 @@ public record I18n [JsonPropertyName("social")] public Enum? Social { get; set; } - /// - /// 婚后姓氏 - /// 必填：否 - /// 示例值：王 - /// - [JsonPropertyName("tertiary")] - public string? Tertiary { get; set; } - /// /// 头衔，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： /// - custom_api_name：title @@ -2782,6 +2854,14 @@ public record File /// public record EmergencyContact { + /// + /// 紧急联系人ID + /// 必填：否 + /// 示例值：123 + /// + [JsonPropertyName("id")] + public string? Id { get; set; } + /// /// 姓名 /// 必填：否 @@ -2884,6 +2964,14 @@ public record I18n [JsonPropertyName("local_primary_2")] public string? LocalPrimary2 { get; set; } + /// + /// 别名 + /// 必填：否 + /// 示例值：别名 + /// + [JsonPropertyName("additional_name")] + public string? AdditionalName { get; set; } + /// /// 补充姓名类型，枚举值可查询[获取字段详情](https://open.larkoffice.com/document/server-docs/corehr-v1/basic-infomation/custom_field/get_by_param)接口获取，按如下参数查询即可： /// - custom_api_name：additional_name_type @@ -2957,14 +3045,6 @@ public record I18n [JsonPropertyName("secondary")] public string? Secondary { get; set; } - /// - /// 尊称 - /// 必填：否 - /// 示例值：王大帅 - /// - [JsonPropertyName("social")] - public Enum? Social { get; set; } - /// /// 婚后姓氏 /// 必填：否 @@ -2973,8 +3053,22 @@ public record I18n [JsonPropertyName("tertiary")] public string? Tertiary { get; set; } + /// + /// 尊称 + /// - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name：person_name + /// - custom_api_name：social + /// 必填：否 + /// 示例值：王大帅 + /// + [JsonPropertyName("social")] + public Enum? Social { get; set; } + /// /// 头衔 + /// - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name：person_name + /// - custom_api_name：title /// 必填：否 /// 示例值：王 /// @@ -3273,6 +3367,14 @@ public record CustomName [JsonPropertyName("value")] public string Value { get; set; } = string.Empty; } + + /// + /// 主要联系人,若有多个联系人，只能有一个联系人的「is_primary」为true + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("is_primary")] + public bool? IsPrimary { get; set; } } /// @@ -4013,6 +4115,15 @@ public record I18n [JsonPropertyName("direct_leader_id")] public string? DirectLeaderId { get; set; } + /// + /// 虚线上级雇佣 ID ，可以通过[搜索员工信息](https://open.feishu.cn/document/server-docs/corehr-v1/employee/search)接口获取详情 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：7032210902531327521 + /// + [JsonPropertyName("dotted_line_manager_id")] + public string? DottedLineManagerId { get; set; } + /// /// 职务 ID ,可以通过[查询职务](https://open.feishu.cn/document/server-docs/corehr-v1/job-management/job/get)接口获取详情 /// 必填：否 @@ -4061,6 +4172,14 @@ public record I18n [JsonPropertyName("employee_type_id")] public string? EmployeeTypeId { get; set; } + /// + /// 人员子类型 ID + /// 必填：否 + /// 示例值：6977973225846343171 + /// + [JsonPropertyName("employee_subtype_id")] + public string? EmployeeSubtypeId { get; set; } + /// /// 雇佣类型， 枚举值可查询[获取字段详情](https://open.feishu.cn/document/server-docs/corehr-v1/basic-infomation/custom_field/get_by_param)接口获取，按如下参数查询即可： /// - object_api_name = pre_hire @@ -4196,7 +4315,7 @@ public record Address public string CountryRegionId { get; set; } = string.Empty; /// - /// 主要行政区 + /// 主要行政区，可以通过接口[查询省份/主要行政区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)获取详情 /// 必填：否 /// 示例值：6863326815667095047 /// @@ -4524,6 +4643,14 @@ public record CustomName [JsonPropertyName("suspected_rehiring")] public bool? SuspectedRehiring { get; set; } + /// + /// 是否外部人员 + /// 必填：否 + /// 示例值：false + /// + [JsonPropertyName("condition_worker")] + public bool? ConditionWorker { get; set; } + /// /// 自定义字段 /// 必填：否 @@ -4776,6 +4903,395 @@ public record I18n /// [JsonPropertyName("seniority_date")] public string? SeniorityDate { get; set; } + + /// + /// 背调订单ID + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：123 + /// + [JsonPropertyName("background_check_order_id")] + public string? BackgroundCheckOrderId { get; set; } + + /// + /// 背调名称 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：xxx + /// + [JsonPropertyName("background_check_order_name")] + public string? BackgroundCheckOrderName { get; set; } + + /// + /// 背调套餐 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：xxx + /// + [JsonPropertyName("background_check_order_package_name")] + public string? BackgroundCheckOrderPackageName { get; set; } + + /// + /// 背调结果 + /// 必填：否 + /// 示例值：通过 + /// + [JsonPropertyName("background_check_order_result")] + public string? BackgroundCheckOrderResult { get; set; } + + /// + /// 背调供应商 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：xxx + /// + [JsonPropertyName("background_check_order_supplier_name")] + public string? BackgroundCheckOrderSupplierName { get; set; } + + /// + /// 背调账号名称 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：xxx + /// + [JsonPropertyName("background_check_order_account_name")] + public string? BackgroundCheckOrderAccountName { get; set; } + + /// + /// 背调开始时间 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：2023-01-10 10:29 + /// + [JsonPropertyName("background_check_order_start_time")] + public string? BackgroundCheckOrderStartTime { get; set; } + + /// + /// 背调完成时间 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// 示例值：2023-01-10 10:29 + /// + [JsonPropertyName("background_check_order_complete_time")] + public string? BackgroundCheckOrderCompleteTime { get; set; } + + /// + /// 背调状态，枚举值可查询[获取字段详情](https://open.feishu.cn/document/server-docs/corehr-v1/basic-infomation/custom_field/get_by_param)接口获取，按如下参数查询即可： + /// - object_api_name = pre_hire + /// - custom_api_name = background_check_order_status + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// + [JsonPropertyName("background_check_order_status")] + public Enum? BackgroundCheckOrderStatus { get; set; } + + /// + /// 司龄调整信息 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// + [JsonPropertyName("seniority_adjust_information_list")] + public PrehireSeniorityAdjustInformationQuery[]? SeniorityAdjustInformationLists { get; set; } + + /// + /// 司龄调整信息 + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// + public record PrehireSeniorityAdjustInformationQuery + { + /// + /// 调整值 + /// - 精确度：两位小数 + /// - 单位：年 + /// 必填：否 + /// 示例值：0.5 + /// 最大值：100 + /// 最小值：0 + /// + [JsonPropertyName("seniority_adjustment")] + public float? SeniorityAdjustment { get; set; } + + /// + /// 调整类型 + /// - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name：seniority_adjust_information + /// - custom_api_name：seniority_adjustment_type + /// 必填：否 + /// 示例值：增加 + /// + [JsonPropertyName("seniority_adjustment_type")] + public Enum? SeniorityAdjustmentType { get; set; } + + /// + /// 调整类型 + /// - 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： + /// - object_api_name：seniority_adjust_information + /// - custom_api_name：seniority_adjustment_type + /// + public record Enum + { + /// + /// 枚举值 + /// 必填：是 + /// 示例值：phone_type + /// + [JsonPropertyName("enum_name")] + public string EnumName { get; set; } = string.Empty; + + /// + /// 枚举多语展示 + /// 必填：否 + /// + [JsonPropertyName("display")] + public I18n[]? Displies { get; set; } + + /// + /// 枚举多语展示 + /// + public record I18n + { + /// + /// 语言编码（IETF BCP 47） + /// 必填：是 + /// 示例值：zh-CN + /// + [JsonPropertyName("lang")] + public string Lang { get; set; } = string.Empty; + + /// + /// 文本内容 + /// 必填：是 + /// 示例值：中文示例 + /// + [JsonPropertyName("value")] + public string Value { get; set; } = string.Empty; + } + } + + /// + /// 司龄调整原因 + /// 必填：否 + /// 示例值：工厂停产需要减去半年工龄 + /// + [JsonPropertyName("reasons_for_seniority_adjustment")] + public string? ReasonsForSeniorityAdjustment { get; set; } + + /// + /// 开始日期 + /// 必填：否 + /// 示例值：2024-05-19 + /// + [JsonPropertyName("start_date")] + public string? StartDate { get; set; } + + /// + /// 结束日期 + /// 必填：否 + /// 示例值：2024-11-18 + /// + [JsonPropertyName("end_date")] + public string? EndDate { get; set; } + + /// + /// 自定义字段 + /// 必填：否 + /// + [JsonPropertyName("custom_fields")] + public CustomFieldData[]? CustomFields { get; set; } + + /// + /// 自定义字段 + /// + public record CustomFieldData + { + /// + /// 自定义字段 apiname，即自定义字段的唯一标识 + /// 必填：是 + /// 示例值：name + /// + [JsonPropertyName("custom_api_name")] + public string CustomApiName { get; set; } = string.Empty; + + /// + /// 自定义字段名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public CustomName? Name { get; set; } + + /// + /// 自定义字段名称 + /// + public record CustomName + { + /// + /// 中文 + /// 必填：否 + /// 示例值：自定义姓名 + /// + [JsonPropertyName("zh_cn")] + public string? ZhCn { get; set; } + + /// + /// 英文 + /// 必填：否 + /// 示例值：Custom Name + /// + [JsonPropertyName("en_us")] + public string? EnUs { get; set; } + } + + /// + /// 自定义字段类型 + /// 必填：否 + /// 示例值：1 + /// + [JsonPropertyName("type")] + public int? Type { get; set; } + + /// + /// 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同（如 123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05"） + /// 必填：是 + /// 示例值：\"231\" + /// + [JsonPropertyName("value")] + public string Value { get; set; } = string.Empty; + } + } + + /// + /// 转正后通知期（主动离职） + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// + [JsonPropertyName("notice_period_positive_voluntary")] + public NoticePeriodDetail? NoticePeriodPositiveVoluntary { get; set; } + + /// + /// 转正后通知期（主动离职） + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// + public record NoticePeriodDetail + { + /// + /// ID + /// 必填：否 + /// 示例值：4698019107896524633 + /// + [JsonPropertyName("wk_id")] + public string? WkId { get; set; } + + /// + /// 数值 + /// 必填：否 + /// 示例值：1 + /// 最大值：65535 + /// 最小值：1 + /// + [JsonPropertyName("value")] + public int? Value { get; set; } + + /// + /// 单位 + /// 必填：否 + /// 示例值：月 + /// + [JsonPropertyName("value_unit")] + public string? ValueUnit { get; set; } + + /// + /// 名称 + /// 必填：否 + /// + [JsonPropertyName("name")] + public I18n? Name { get; set; } + + /// + /// 名称 + /// + public record I18n + { + /// + /// 语言编码（IETF BCP 47） + /// 必填：是 + /// 示例值：zh-CN + /// + [JsonPropertyName("lang")] + public string Lang { get; set; } = string.Empty; + + /// + /// 文本内容 + /// 必填：是 + /// 示例值：中文示例 + /// + [JsonPropertyName("value")] + public string Value { get; set; } = string.Empty; + } + } + + /// + /// 试用期内通知期（被动离职） + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// + [JsonPropertyName("notice_period_probation_involuntary")] + public NoticePeriodDetail? NoticePeriodProbationInvoluntary { get; set; } + + /// + /// 转正后通知期（被动离职） + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// + [JsonPropertyName("notice_period_positive_involuntary")] + public NoticePeriodDetail? NoticePeriodPositiveInvoluntary { get; set; } + + /// + /// 试用期内通知期（主动离职) + /// - 功能灰度中，如有需求请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) + /// 必填：否 + /// + [JsonPropertyName("notice_period_probation_voluntary")] + public NoticePeriodDetail? NoticePeriodProbationVoluntary { get; set; } + + /// + /// 工时制度是否被手动修改 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("working_hours_type_manual_updated")] + public bool? WorkingHoursTypeManualUpdated { get; set; } + + /// + /// 入职任务是否逾期 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("is_over_due")] + public bool? IsOverDue { get; set; } + + /// + /// 入职任务是否完成，暂不推荐使用 + /// 必填：否 + /// 示例值：true + /// + [JsonPropertyName("task_completed")] + public bool? TaskCompleted { get; set; } + + /// + /// 预计毕业日期 + /// 必填：否 + /// 示例值：2023-01-10 + /// + [JsonPropertyName("expected_graduate_date")] + public string? ExpectedGraduateDate { get; set; } + + /// + /// 任职公司 ID ,详细信息可通过[查询单个公司](https://open.feishu.cn/document/server-docs/corehr-v1/organization-management/company/get)接口获得 + /// 必填：否 + /// 示例值：6738317738688661772 + /// + [JsonPropertyName("service_company")] + public string? ServiceCompany { get; set; } } /// @@ -4894,7 +5410,7 @@ public record OnboardingTask public string? TaskName { get; set; } /// - /// 任务名称 + /// 任务状态 /// 必填：否 /// 示例值：abc /// 可选值： diff --git a/src/FeishuNetSdk.csproj b/src/FeishuNetSdk.csproj index e8b96de1..70d9eed8 100644 --- a/src/FeishuNetSdk.csproj +++ b/src/FeishuNetSdk.csproj @@ -16,7 +16,7 @@ MIT 适用于飞书开放平台的.Net开发包 LICENSE - 3.2.2 + 3.2.3 diff --git a/src/FeishuPeople/GetCorehrV1LeavesLeaveRequestHistoryResponseDto.cs b/src/FeishuPeople/GetCorehrV1LeavesLeaveRequestHistoryResponseDto.cs index 78d481f7..267c5e45 100644 --- a/src/FeishuPeople/GetCorehrV1LeavesLeaveRequestHistoryResponseDto.cs +++ b/src/FeishuPeople/GetCorehrV1LeavesLeaveRequestHistoryResponseDto.cs @@ -97,6 +97,7 @@ public record I18n /// 假期开始时间，格式可能为： /// - 字符串日期：如 "2022-09-09" /// - 字符串日期加 morning/afternoon：如 "2022-09-09 morning"" + /// - 小时假如需返回精准到小时的时间格式，请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) 开通 /// 必填：是 /// 示例值：2022-07-06 /// @@ -107,6 +108,7 @@ public record I18n /// 假期结束时间，格式可能为： /// - 字符串日期：如 "2022-09-09" /// - 字符串日期加 morning/afternoon：如 "2022-09-09 morning"" + /// - 小时假如需返回精准到小时的时间格式，请联系[技术支持](https://applink.feishu.cn/TLJpeNdW) 开通 /// 必填：是 /// 示例值：2023-01-05 /// diff --git a/src/FeishuPeople/PostCorehrV1ContractsBodyDto.cs b/src/FeishuPeople/PostCorehrV1ContractsBodyDto.cs index 8dd36faf..d1c0479c 100644 --- a/src/FeishuPeople/PostCorehrV1ContractsBodyDto.cs +++ b/src/FeishuPeople/PostCorehrV1ContractsBodyDto.cs @@ -46,14 +46,18 @@ public record PostCorehrV1ContractsBodyDto public string EmploymentId { get; set; } = string.Empty; /// - /// 合同类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)合同类型（contract_type）枚举定义部分获得 + /// 合同类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： + /// - object_api_name：contract + /// - custom_api_name：contract_type /// 必填：是 /// [JsonPropertyName("contract_type")] public Enum ContractType { get; set; } = new(); /// - /// 合同类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)合同类型（contract_type）枚举定义部分获得 + /// 合同类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： + /// - object_api_name：contract + /// - custom_api_name：contract_type /// public record Enum { @@ -83,14 +87,14 @@ public record Enum public string? PersonId { get; set; } /// - /// 自定义字段 + /// 自定义字段，预留字段，暂时不支持 /// 必填：否 /// [JsonPropertyName("custom_fields")] public ObjectFieldData[]? CustomFields { get; set; } /// - /// 自定义字段 + /// 自定义字段，预留字段，暂时不支持 /// public record ObjectFieldData { diff --git a/src/Helpdesk.Spec/PostHelpdeskV1TicketCustomizedFieldsBodyDto.cs b/src/Helpdesk.Spec/PostHelpdeskV1TicketCustomizedFieldsBodyDto.cs index f9d1af99..df5ec76e 100644 --- a/src/Helpdesk.Spec/PostHelpdeskV1TicketCustomizedFieldsBodyDto.cs +++ b/src/Helpdesk.Spec/PostHelpdeskV1TicketCustomizedFieldsBodyDto.cs @@ -4,7 +4,7 @@ // Created : 2024-06-24 // // Last Modified By : yxr -// Last Modified On : 2024-06-24 +// Last Modified On : 2025-01-17 // ************************************************************************ // // MIT @@ -15,8 +15,6 @@ namespace FeishuNetSdk.Helpdesk.Spec; /// /// 创建工单自定义字段 请求体 /// 该接口用于创建自定义字段。 -/// 注意事项： -/// user_access_token 访问，需要操作者是当前服务台的管理员或所有者 /// 接口ID：6955768699895562242 /// 文档地址：https://open.feishu.cn/document/server-docs/helpdesk-v1/ticket-management/ticket_customized_field/create-ticket-customized-field /// JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fhelpdesk-v1%2fticket_customized_field%2fcreate-ticket-customized-field @@ -83,14 +81,6 @@ public record PostHelpdeskV1TicketCustomizedFieldsBodyDto [JsonPropertyName("visible")] public bool Visible { get; set; } - /// - /// 是否可以修改 - /// **示例值**：true - /// 必填：是 - /// - [JsonPropertyName("editable")] - public bool Editable { get; set; } - /// /// 是否必填 /// **示例值**：false diff --git a/src/IFeishuTenantApi.cs b/src/IFeishuTenantApi.cs index 4e79535f..1f758bd1 100644 --- a/src/IFeishuTenantApi.cs +++ b/src/IFeishuTenantApi.cs @@ -4389,8 +4389,10 @@ System.Threading.Tasks.Task GetImV1ImagesByImageKeyAsync( /// ## 前提条件 /// 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)。 /// ## 使用限制 - /// - 仅支持加入公开群。 + /// - 调用该接口仅支持加入公开群。 + /// 公开群是指的群类型，你可以调用[获取群信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/get)接口，在返回结果中查看 `chat_type ` 参数取值是否为 `public`。 /// - 操作内部群时，操作者必须与相应的群组在同一租户内。 + /// 内部群是指的群标签，你可以调用[获取群信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/get)接口，在返回结果中查看 `chat_tag ` 参数取值是否为 `inner `。 /// 权限要求： /// im:chat /// im:chat.members:write_only @@ -6848,7 +6850,7 @@ System.Threading.Tasks.Task PostCalendarV4CalendarsByCalendarIdE /// /// /// 必填：否 - /// 一次请求返回的最大日程参与人数量。 + /// 一次请求返回的最大日程参与人数量。最小值为 10，传入小于 10 的值默认按照 10 计算。 /// 示例值：10 /// 默认值：20 /// @@ -25691,7 +25693,7 @@ System.Threading.Tasks.Task PostContactV3GroupByGroupIdMemberBat [PathQuery] string? user_id_type = "open_id"); /// - /// 【考勤打卡】获取审批通过数据 + /// 【考勤打卡】获取审批数据 /// 接口ID：7108645368100257794 /// 接口文档：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/query /// Authorization：tenant_access_token @@ -37620,7 +37622,6 @@ System.Threading.Tasks.Task DeleteDriveV1FilesByFileTokenDeleteS /// corehr:employment.position:read /// corehr:employment.position:write /// corehr:employment.recruitment_project_id:read - /// corehr:employment.seniority_date:write /// corehr:job_data.work_shift:read /// corehr:person.address:read /// corehr:person.address:write @@ -37678,14 +37679,25 @@ System.Threading.Tasks.Task DeleteDriveV1FilesByFileTokenDeleteS /// corehr:person.work_experience:read /// corehr:person.work_experience:write /// corehr:pre_hire.abnormal_reason_field:read + /// corehr:pre_hire.background_check_order_account_name:read + /// corehr:pre_hire.background_check_order_complete_time:read + /// corehr:pre_hire.background_check_order_id:read + /// corehr:pre_hire.background_check_order_name:read + /// corehr:pre_hire.background_check_order_package_name:read + /// corehr:pre_hire.background_check_order_result:read + /// corehr:pre_hire.background_check_order_start_time:read + /// corehr:pre_hire.background_check_order_status:read + /// corehr:pre_hire.background_check_order_supplier_name:read /// corehr:pre_hire.check_in_data:read /// corehr:pre_hire.company_manual_updated:read /// corehr:pre_hire.company_sponsored_visa:read /// corehr:pre_hire.cost_center:read /// corehr:pre_hire.cost_center:write + /// corehr:pre_hire.dotted_line_manager:read /// corehr:pre_hire.flow_id:read /// corehr:pre_hire.office_address:read /// corehr:pre_hire.onboarding_address:read + /// corehr:pre_hire.seniority_adjust_information:read /// corehr:pre_hire.suspected_rehiring:read /// corehr:pre_hire.working_calendar:read /// @@ -43886,6 +43898,8 @@ System.Threading.Tasks.Task PostHireV1ApplicationsByApplicationI /// corehr:person.martyr_family:write /// corehr:person.national_id:read /// corehr:person.national_id:write + /// corehr:person.nationality:read + /// corehr:person.nationality:write /// corehr:person.native_region:read /// corehr:person.native_region:write /// corehr:person.passport_number:read @@ -43904,14 +43918,25 @@ System.Threading.Tasks.Task PostHireV1ApplicationsByApplicationI /// corehr:person.work_experience:read /// corehr:person.work_experience:write /// corehr:pre_hire.abnormal_reason_field:read + /// corehr:pre_hire.background_check_order_account_name:read + /// corehr:pre_hire.background_check_order_complete_time:read + /// corehr:pre_hire.background_check_order_id:read + /// corehr:pre_hire.background_check_order_name:read + /// corehr:pre_hire.background_check_order_package_name:read + /// corehr:pre_hire.background_check_order_result:read + /// corehr:pre_hire.background_check_order_start_time:read + /// corehr:pre_hire.background_check_order_status:read + /// corehr:pre_hire.background_check_order_supplier_name:read /// corehr:pre_hire.check_in_data:read /// corehr:pre_hire.company_manual_updated:read /// corehr:pre_hire.company_sponsored_visa:read /// corehr:pre_hire.cost_center:read /// corehr:pre_hire.cost_center:write + /// corehr:pre_hire.dotted_line_manager:read /// corehr:pre_hire.flow_id:read /// corehr:pre_hire.office_address:read /// corehr:pre_hire.onboarding_address:read + /// corehr:pre_hire.seniority_adjust_information:read /// corehr:pre_hire.suspected_rehiring:read /// corehr:pre_hire.working_calendar:read /// diff --git a/src/IFeishuUserApi.cs b/src/IFeishuUserApi.cs index 1767d7ab..e426eac0 100644 --- a/src/IFeishuUserApi.cs +++ b/src/IFeishuUserApi.cs @@ -2501,8 +2501,10 @@ System.Threading.Tasks.Task PostDocV2ByDocTokenBatchUpdateAsync( /// ## 前提条件 /// 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)。 /// ## 使用限制 - /// - 仅支持加入公开群。 + /// - 调用该接口仅支持加入公开群。 + /// 公开群是指的群类型，你可以调用[获取群信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/get)接口，在返回结果中查看 `chat_type ` 参数取值是否为 `public`。 /// - 操作内部群时，操作者必须与相应的群组在同一租户内。 + /// 内部群是指的群标签，你可以调用[获取群信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/get)接口，在返回结果中查看 `chat_tag ` 参数取值是否为 `inner `。 /// 权限要求： /// im:chat /// im:chat.members:write_only @@ -4213,7 +4215,7 @@ System.Threading.Tasks.Task PostCalendarV4CalendarsByCalendarIdE /// /// /// 必填：否 - /// 一次请求返回的最大日程参与人数量。 + /// 一次请求返回的最大日程参与人数量。最小值为 10，传入小于 10 的值默认按照 10 计算。 /// 示例值：10 /// 默认值：20 /// diff --git a/src/Im/GetImV1BatchMessagesByBatchMessageIdGetProgressResponseDto.cs b/src/Im/GetImV1BatchMessagesByBatchMessageIdGetProgressResponseDto.cs index 4ea7bcff..782d462d 100644 --- a/src/Im/GetImV1BatchMessagesByBatchMessageIdGetProgressResponseDto.cs +++ b/src/Im/GetImV1BatchMessagesByBatchMessageIdGetProgressResponseDto.cs @@ -39,7 +39,7 @@ public record GetImV1BatchMessagesByBatchMessageIdGetProgressResponseDtoBatchMes /// /// 批量发送消息请求中，有效的用户数量。 /// **注意**： - /// - 包含当前机器人不可见但有效的用户。不可见是指用户不在机器人的通讯录权限范围内，详情了解[配置应用数据权限](https://open.feishu.cn/document/home/introduction-to-scope-and-authorization/configure-app-data-permissions)。 + /// - 不在当前机器人的通讯录权限数据范围内但有效的用户，也会被统计在内。了解通讯录数据权限范围参见[配置应用数据权限](https://open.feishu.cn/document/home/introduction-to-scope-and-authorization/configure-app-data-permissions)。 /// - `valid_user_ids_count` 值为 0 有两种情况： /// - 批量发送消息接口为异步调用，任务还没有开始被调度便查询当前接口则取值为 0。建议你等待片刻再调用该接口。 /// - 批量发送消息时传入的所有 department_ids、open_ids、user_ids、union_ids 均未包含有效的用户。