@satorijs/adapter-lark 3.8.5 → 3.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (126) hide show
  1. package/lib/bot.d.ts +1 -1
  2. package/lib/content.d.ts +433 -0
  3. package/lib/http.d.ts +1 -1
  4. package/lib/index.cjs +2796 -1713
  5. package/lib/index.cjs.map +6 -0
  6. package/lib/index.d.ts +4 -2
  7. package/lib/internal.d.ts +38 -0
  8. package/lib/message.d.ts +2 -0
  9. package/lib/types/acs.d.ts +177 -0
  10. package/lib/types/admin.d.ts +270 -0
  11. package/lib/types/aily.d.ts +221 -0
  12. package/lib/types/apaas.d.ts +499 -0
  13. package/lib/types/application.d.ts +406 -0
  14. package/lib/types/approval.d.ts +779 -0
  15. package/lib/types/attendance.d.ts +957 -0
  16. package/lib/types/auth.d.ts +86 -0
  17. package/lib/types/authen.d.ts +191 -0
  18. package/lib/types/baike.d.ts +239 -0
  19. package/lib/types/bitable.d.ts +691 -0
  20. package/lib/types/board.d.ts +19 -0
  21. package/lib/types/calendar.d.ts +653 -0
  22. package/lib/types/cardkit.d.ts +139 -0
  23. package/lib/types/compensation.d.ts +54 -0
  24. package/lib/types/contact.d.ts +1137 -0
  25. package/lib/types/corehr.d.ts +4383 -0
  26. package/lib/types/docs.d.ts +23 -0
  27. package/lib/types/document_ai.d.ts +257 -0
  28. package/lib/types/docx.d.ts +380 -0
  29. package/lib/types/drive.d.ts +1045 -0
  30. package/lib/types/ehr.d.ts +32 -0
  31. package/lib/types/event.d.ts +9 -18
  32. package/lib/types/guild.d.ts +59 -0
  33. package/lib/types/helpdesk.d.ts +738 -0
  34. package/lib/types/hire.d.ts +3150 -0
  35. package/lib/types/human_authentication.d.ts +27 -0
  36. package/lib/types/im.d.ts +1300 -0
  37. package/lib/types/index.d.ts +16432 -34
  38. package/lib/types/lingo.d.ts +254 -0
  39. package/lib/types/mail.d.ts +680 -0
  40. package/lib/types/mdm.d.ts +42 -0
  41. package/lib/types/message/asset.d.ts +40 -0
  42. package/lib/types/minutes.d.ts +31 -0
  43. package/lib/types/moments.d.ts +18 -0
  44. package/lib/types/okr.d.ts +205 -0
  45. package/lib/types/optical_char_recognition.d.ts +17 -0
  46. package/lib/types/passport.d.ts +45 -0
  47. package/lib/types/payroll.d.ts +50 -0
  48. package/lib/types/performance.d.ts +413 -0
  49. package/lib/types/personal_settings.d.ts +87 -0
  50. package/lib/types/report.d.ts +57 -0
  51. package/lib/types/search.d.ts +216 -0
  52. package/lib/types/security_and_compliance.d.ts +24 -0
  53. package/lib/types/sheets.d.ts +326 -0
  54. package/lib/types/speech_to_text.d.ts +39 -0
  55. package/lib/types/task.d.ts +1153 -0
  56. package/lib/types/tenant.d.ts +23 -0
  57. package/lib/types/translation.d.ts +37 -0
  58. package/lib/types/user.d.ts +78 -0
  59. package/lib/types/utils.d.ts +9 -0
  60. package/lib/types/vc.d.ts +948 -0
  61. package/lib/types/verification.d.ts +14 -0
  62. package/lib/types/wiki.d.ts +240 -0
  63. package/lib/types/workplace.d.ts +43 -0
  64. package/lib/utils.d.ts +143 -7
  65. package/package.json +6 -4
  66. package/src/bot.ts +19 -3
  67. package/src/{types/message/content.ts → content.ts} +1 -0
  68. package/src/http.ts +1 -3
  69. package/src/index.ts +4 -2
  70. package/src/internal.ts +144 -0
  71. package/src/message.ts +24 -11
  72. package/src/types/acs.ts +236 -0
  73. package/src/types/admin.ts +328 -0
  74. package/src/types/aily.ts +288 -0
  75. package/src/types/apaas.ts +646 -0
  76. package/src/types/application.ts +520 -0
  77. package/src/types/approval.ts +924 -0
  78. package/src/types/attendance.ts +1153 -0
  79. package/src/types/auth.ts +114 -0
  80. package/src/types/authen.ts +220 -0
  81. package/src/types/baike.ts +306 -0
  82. package/src/types/bitable.ts +879 -0
  83. package/src/types/board.ts +31 -0
  84. package/src/types/calendar.ts +817 -0
  85. package/src/types/cardkit.ts +182 -0
  86. package/src/types/compensation.ts +79 -0
  87. package/src/types/contact.ts +1411 -0
  88. package/src/types/corehr.ts +5288 -0
  89. package/src/types/docs.ts +33 -0
  90. package/src/types/document_ai.ts +352 -0
  91. package/src/types/docx.ts +471 -0
  92. package/src/types/drive.ts +1312 -0
  93. package/src/types/ehr.ts +43 -0
  94. package/src/types/event.ts +15 -21
  95. package/src/types/helpdesk.ts +916 -0
  96. package/src/types/hire.ts +3918 -0
  97. package/src/types/human_authentication.ts +38 -0
  98. package/src/types/im.ts +1605 -0
  99. package/src/types/index.ts +17754 -39
  100. package/src/types/lingo.ts +321 -0
  101. package/src/types/mail.ts +851 -0
  102. package/src/types/mdm.ts +57 -0
  103. package/src/types/minutes.ts +46 -0
  104. package/src/types/moments.ts +28 -0
  105. package/src/types/okr.ts +261 -0
  106. package/src/types/optical_char_recognition.ts +27 -0
  107. package/src/types/passport.ts +61 -0
  108. package/src/types/payroll.ts +69 -0
  109. package/src/types/performance.ts +524 -0
  110. package/src/types/personal_settings.ts +116 -0
  111. package/src/types/report.ts +77 -0
  112. package/src/types/search.ts +268 -0
  113. package/src/types/security_and_compliance.ts +33 -0
  114. package/src/types/sheets.ts +425 -0
  115. package/src/types/speech_to_text.ts +54 -0
  116. package/src/types/task.ts +1464 -0
  117. package/src/types/tenant.ts +36 -0
  118. package/src/types/translation.ts +52 -0
  119. package/src/types/vc.ts +1197 -0
  120. package/src/types/verification.ts +23 -0
  121. package/src/types/wiki.ts +313 -0
  122. package/src/types/workplace.ts +59 -0
  123. package/src/utils.ts +160 -8
  124. package/src/types/api.ts +0 -30835
  125. package/src/types/internal.ts +0 -84
  126. package/src/types/message/index.ts +0 -97
@@ -0,0 +1,1153 @@
1
+ import { ApprovalInfo, ArchiveField, ArchiveReportData, ArchiveReportMeta, File, FlexibleRule, FreePunchCfg, Group, GroupMeta, LangText, LateOffLateOnRule, LateOffLateOnSetting, LeaveAccrualRecord, LeaveEmployExpireRecord, LeaveNeedPunchCfg, Location, Machine, MemberStatusChange, OvertimeClockCfg, OvertimeRule, PunchMember, PunchSpecialDateShift, PunchTimeRule, RestRule, RestTimeFlexibleConfig, Shift, ShiftAttendanceTimeConfig, ShiftMiddleTimeRule, UserAllowedRemedy, UserApproval, UserBase, UserDailyShift, UserFlow, UserSetting, UserStatsData, UserStatsField, UserStatsView, UserTask, UserTaskRemedy, UserTmpDailyShift } from '.'
2
+ import { Internal, Pagination } from '../internal'
3
+
4
+ declare module '../internal' {
5
+ interface Internal {
6
+ /**
7
+ * 创建班次
8
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/create
9
+ */
10
+ createAttendanceShift(body: CreateAttendanceShiftRequest, query?: CreateAttendanceShiftQuery): Promise<CreateAttendanceShiftResponse>
11
+ /**
12
+ * 删除班次
13
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/delete
14
+ */
15
+ deleteAttendanceShift(shift_id: string): Promise<void>
16
+ /**
17
+ * 按 ID 查询班次
18
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/get
19
+ */
20
+ getAttendanceShift(shift_id: string): Promise<GetAttendanceShiftResponse>
21
+ /**
22
+ * 按名称查询班次
23
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/query
24
+ */
25
+ queryAttendanceShift(query?: QueryAttendanceShiftQuery): Promise<QueryAttendanceShiftResponse>
26
+ /**
27
+ * 查询所有班次
28
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/shift/list
29
+ */
30
+ listAttendanceShift(query?: Pagination): Paginated<Shift, 'shift_list'>
31
+ /**
32
+ * 创建或修改排班表
33
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_daily_shift/batch_create
34
+ */
35
+ batchCreateAttendanceUserDailyShift(body: BatchCreateAttendanceUserDailyShiftRequest, query?: BatchCreateAttendanceUserDailyShiftQuery): Promise<BatchCreateAttendanceUserDailyShiftResponse>
36
+ /**
37
+ * 查询排班表
38
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_daily_shift/query
39
+ */
40
+ queryAttendanceUserDailyShift(body: QueryAttendanceUserDailyShiftRequest, query?: QueryAttendanceUserDailyShiftQuery): Promise<QueryAttendanceUserDailyShiftResponse>
41
+ /**
42
+ * 创建或修改临时排班
43
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_daily_shift/batch_create_temp
44
+ */
45
+ batchCreateTempAttendanceUserDailyShift(body: BatchCreateTempAttendanceUserDailyShiftRequest, query?: BatchCreateTempAttendanceUserDailyShiftQuery): Promise<BatchCreateTempAttendanceUserDailyShiftResponse>
46
+ /**
47
+ * 查询考勤组下所有成员
48
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/list_user
49
+ */
50
+ listUserAttendanceGroup(group_id: string, query?: ListUserAttendanceGroupQuery): Paginated<UserBase, 'users'>
51
+ /**
52
+ * 创建或修改考勤组
53
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/create
54
+ */
55
+ createAttendanceGroup(body: CreateAttendanceGroupRequest, query?: CreateAttendanceGroupQuery): Promise<CreateAttendanceGroupResponse>
56
+ /**
57
+ * 删除考勤组
58
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/delete
59
+ */
60
+ deleteAttendanceGroup(group_id: string): Promise<void>
61
+ /**
62
+ * 按 ID 查询考勤组
63
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/get
64
+ */
65
+ getAttendanceGroup(group_id: string, query?: GetAttendanceGroupQuery): Promise<GetAttendanceGroupResponse>
66
+ /**
67
+ * 按名称查询考勤组
68
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/search
69
+ */
70
+ searchAttendanceGroup(body: SearchAttendanceGroupRequest): Promise<SearchAttendanceGroupResponse>
71
+ /**
72
+ * 查询所有考勤组
73
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/group/list
74
+ */
75
+ listAttendanceGroup(query?: Pagination): Paginated<GroupMeta, 'group_list'>
76
+ /**
77
+ * 修改用户人脸识别信息
78
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_setting/modify
79
+ */
80
+ modifyAttendanceUserSetting(body: ModifyAttendanceUserSettingRequest, query?: ModifyAttendanceUserSettingQuery): Promise<ModifyAttendanceUserSettingResponse>
81
+ /**
82
+ * 批量查询用户人脸识别信息
83
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_setting/query
84
+ */
85
+ queryAttendanceUserSetting(body: QueryAttendanceUserSettingRequest, query?: QueryAttendanceUserSettingQuery): Promise<QueryAttendanceUserSettingResponse>
86
+ /**
87
+ * 上传用户人脸识别照片
88
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/file/upload
89
+ */
90
+ uploadAttendanceFile(form: UploadAttendanceFileForm, query?: UploadAttendanceFileQuery): Promise<UploadAttendanceFileResponse>
91
+ /**
92
+ * 下载用户人脸识别照片
93
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/file/download
94
+ */
95
+ downloadAttendanceFile(file_id: string): Promise<ArrayBuffer>
96
+ /**
97
+ * 更新统计设置
98
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_view/update
99
+ */
100
+ updateAttendanceUserStatsView(user_stats_view_id: string, body: UpdateAttendanceUserStatsViewRequest, query?: UpdateAttendanceUserStatsViewQuery): Promise<UpdateAttendanceUserStatsViewResponse>
101
+ /**
102
+ * 查询统计表头
103
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_field/query
104
+ */
105
+ queryAttendanceUserStatsField(body: QueryAttendanceUserStatsFieldRequest, query?: QueryAttendanceUserStatsFieldQuery): Promise<QueryAttendanceUserStatsFieldResponse>
106
+ /**
107
+ * 查询统计设置
108
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_view/query
109
+ */
110
+ queryAttendanceUserStatsView(body: QueryAttendanceUserStatsViewRequest, query?: QueryAttendanceUserStatsViewQuery): Promise<QueryAttendanceUserStatsViewResponse>
111
+ /**
112
+ * 查询统计数据
113
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_stats_data/query
114
+ */
115
+ queryAttendanceUserStatsData(body: QueryAttendanceUserStatsDataRequest, query?: QueryAttendanceUserStatsDataQuery): Promise<QueryAttendanceUserStatsDataResponse>
116
+ /**
117
+ * 获取审批通过数据
118
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/query
119
+ */
120
+ queryAttendanceUserApproval(body: QueryAttendanceUserApprovalRequest, query?: QueryAttendanceUserApprovalQuery): Promise<QueryAttendanceUserApprovalResponse>
121
+ /**
122
+ * 写入审批结果
123
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/create
124
+ */
125
+ createAttendanceUserApproval(body: CreateAttendanceUserApprovalRequest, query?: CreateAttendanceUserApprovalQuery): Promise<CreateAttendanceUserApprovalResponse>
126
+ /**
127
+ * 通知审批状态更新
128
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/approval_info/process
129
+ */
130
+ processAttendanceApprovalInfo(body: ProcessAttendanceApprovalInfoRequest): Promise<ProcessAttendanceApprovalInfoResponse>
131
+ /**
132
+ * 通知补卡审批发起
133
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_task_remedy/create
134
+ */
135
+ createAttendanceUserTaskRemedy(body: CreateAttendanceUserTaskRemedyRequest, query?: CreateAttendanceUserTaskRemedyQuery): Promise<CreateAttendanceUserTaskRemedyResponse>
136
+ /**
137
+ * 获取可补卡时间
138
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_task_remedy/query_user_allowed_remedys
139
+ */
140
+ queryUserAllowedRemedysAttendanceUserTaskRemedy(body: QueryUserAllowedRemedysAttendanceUserTaskRemedyRequest, query?: QueryUserAllowedRemedysAttendanceUserTaskRemedyQuery): Promise<QueryUserAllowedRemedysAttendanceUserTaskRemedyResponse>
141
+ /**
142
+ * 获取补卡记录
143
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_task_remedy/query
144
+ */
145
+ queryAttendanceUserTaskRemedy(body: QueryAttendanceUserTaskRemedyRequest, query?: QueryAttendanceUserTaskRemedyQuery): Promise<QueryAttendanceUserTaskRemedyResponse>
146
+ /**
147
+ * 查询归档报表表头
148
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/archive_rule/user_stats_fields_query
149
+ */
150
+ userStatsFieldsQueryAttendanceArchiveRule(body: UserStatsFieldsQueryAttendanceArchiveRuleRequest, query?: UserStatsFieldsQueryAttendanceArchiveRuleQuery): Promise<UserStatsFieldsQueryAttendanceArchiveRuleResponse>
151
+ /**
152
+ * 写入归档报表结果
153
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/archive_rule/upload_report
154
+ */
155
+ uploadReportAttendanceArchiveRule(body: UploadReportAttendanceArchiveRuleRequest, query?: UploadReportAttendanceArchiveRuleQuery): Promise<UploadReportAttendanceArchiveRuleResponse>
156
+ /**
157
+ * 删除归档报表行数据
158
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/archive_rule/del_report
159
+ */
160
+ delReportAttendanceArchiveRule(body: DelReportAttendanceArchiveRuleRequest, query?: DelReportAttendanceArchiveRuleQuery): Promise<void>
161
+ /**
162
+ * 查询所有归档规则
163
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/archive_rule/list
164
+ */
165
+ listAttendanceArchiveRule(query?: Pagination): Paginated<ArchiveReportMeta>
166
+ /**
167
+ * 导入打卡流水
168
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_flow/batch_create
169
+ */
170
+ batchCreateAttendanceUserFlow(body: BatchCreateAttendanceUserFlowRequest, query?: BatchCreateAttendanceUserFlowQuery): Promise<BatchCreateAttendanceUserFlowResponse>
171
+ /**
172
+ * 查询打卡流水
173
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_flow/get
174
+ */
175
+ getAttendanceUserFlow(user_flow_id: string, query?: GetAttendanceUserFlowQuery): Promise<GetAttendanceUserFlowResponse>
176
+ /**
177
+ * 批量查询打卡流水
178
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_flow/query
179
+ */
180
+ queryAttendanceUserFlow(body: QueryAttendanceUserFlowRequest, query?: QueryAttendanceUserFlowQuery): Promise<QueryAttendanceUserFlowResponse>
181
+ /**
182
+ * 查询打卡结果
183
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_task/query
184
+ */
185
+ queryAttendanceUserTask(body: QueryAttendanceUserTaskRequest, query?: QueryAttendanceUserTaskQuery): Promise<QueryAttendanceUserTaskResponse>
186
+ /**
187
+ * 通过过期时间获取发放记录
188
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/leave_employ_expire_record/get
189
+ */
190
+ getAttendanceLeaveEmployExpireRecord(leave_id: string, body: GetAttendanceLeaveEmployExpireRecordRequest, query?: GetAttendanceLeaveEmployExpireRecordQuery): Promise<GetAttendanceLeaveEmployExpireRecordResponse>
191
+ /**
192
+ * 修改发放记录
193
+ * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/leave_accrual_record/patch
194
+ */
195
+ patchAttendanceLeaveAccrualRecord(leave_id: string, body: PatchAttendanceLeaveAccrualRecordRequest, query?: PatchAttendanceLeaveAccrualRecordQuery): Promise<PatchAttendanceLeaveAccrualRecordResponse>
196
+ }
197
+ }
198
+
199
+ export interface CreateAttendanceShiftRequest {
200
+ /** 班次名称 */
201
+ shift_name: string
202
+ /** 打卡次数 */
203
+ punch_times: number
204
+ /** 排班组子负责人id列表 */
205
+ sub_shift_leader_ids?: string[]
206
+ /** 是否弹性打卡 */
207
+ is_flexible?: boolean
208
+ /** 弹性打卡时间,设置【上班最多可晚到】与【下班最多可早走】时间,如果不设置flexible_rule则生效 */
209
+ flexible_minutes?: number
210
+ /** 弹性打卡时间设置 */
211
+ flexible_rule?: FlexibleRule[]
212
+ /** 不需要打下班卡 */
213
+ no_need_off?: boolean
214
+ /** 打卡规则 */
215
+ punch_time_rule: PunchTimeRule[]
216
+ /** 晚走晚到规则 */
217
+ late_off_late_on_rule?: LateOffLateOnRule[]
218
+ /** 休息规则 */
219
+ rest_time_rule?: RestRule[]
220
+ /** 打卡规则 */
221
+ overtime_rule?: OvertimeRule[]
222
+ /** 日期类型,【是否弹性打卡 = ture】时,不可设置为“休息日” 可选值:1:工作日 2:休息日 示例值:(默认值)1 */
223
+ day_type?: number
224
+ /** 班外休息规则 */
225
+ overtime_rest_time_rule?: RestRule[]
226
+ /** 晚到多久记为严重迟到(优先级比原有字段高) */
227
+ late_minutes_as_serious_late?: number
228
+ /** 半天分割规则 */
229
+ shift_middle_time_rule?: ShiftMiddleTimeRule
230
+ /** 应出勤配置 */
231
+ shift_attendance_time_config?: ShiftAttendanceTimeConfig
232
+ /** 晚走次日晚到配置规则 */
233
+ late_off_late_on_setting?: LateOffLateOnSetting
234
+ /** 班次id(更新班次时需要传递) */
235
+ id?: string
236
+ /** 休息弹性设置 */
237
+ rest_time_flexible_configs?: RestTimeFlexibleConfig[]
238
+ }
239
+
240
+ export interface CreateAttendanceShiftQuery {
241
+ /** 用户 ID 的类型 不提供则用户相关字段无效 */
242
+ employee_type?: 'employee_id' | 'employee_no'
243
+ }
244
+
245
+ export interface QueryAttendanceShiftQuery {
246
+ /** 班次名称 */
247
+ shift_name: string
248
+ }
249
+
250
+ export interface BatchCreateAttendanceUserDailyShiftRequest {
251
+ /** 班表信息列表 */
252
+ user_daily_shifts: UserDailyShift[]
253
+ /** 操作人uid,如果您未操作[考勤管理后台“API 接入”流程](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines),则此字段为必填字段 */
254
+ operator_id?: string
255
+ }
256
+
257
+ export interface BatchCreateAttendanceUserDailyShiftQuery {
258
+ /** 请求体和响应体中的 user_id 的员工工号类型 */
259
+ employee_type: 'employee_id' | 'employee_no'
260
+ }
261
+
262
+ export interface QueryAttendanceUserDailyShiftRequest {
263
+ /** employee_no 或 employee_id 列表 */
264
+ user_ids: string[]
265
+ /** 查询的起始工作日 */
266
+ check_date_from: number
267
+ /** 查询的结束工作日 */
268
+ check_date_to: number
269
+ }
270
+
271
+ export interface QueryAttendanceUserDailyShiftQuery {
272
+ /** 请求体中的 user_ids 和响应体中的 user_id 的员工工号类型 */
273
+ employee_type: 'employee_id' | 'employee_no'
274
+ }
275
+
276
+ export interface BatchCreateTempAttendanceUserDailyShiftRequest {
277
+ /** 临时班表信息列表(数量限制50以内) */
278
+ user_tmp_daily_shifts: UserTmpDailyShift[]
279
+ /** 操作人uid */
280
+ operator_id?: string
281
+ }
282
+
283
+ export interface BatchCreateTempAttendanceUserDailyShiftQuery {
284
+ /** 请求体和响应体中的 user_id 的员工工号类型 */
285
+ employee_type: 'employee_id' | 'employee_no'
286
+ }
287
+
288
+ export interface ListUserAttendanceGroupQuery extends Pagination {
289
+ /** 用户 ID 的类型 */
290
+ employee_type: string
291
+ /** 部门 ID 的类型 */
292
+ dept_type: string
293
+ /** 打卡类型 */
294
+ member_clock_type: number
295
+ }
296
+
297
+ export interface CreateAttendanceGroupRequest {
298
+ /** 6921319402260496386 */
299
+ group: Group
300
+ /** 操作人uid,如果您未操作[考勤管理后台“API 接入”流程](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines),则此字段为必填字段 */
301
+ operator_id?: string
302
+ }
303
+
304
+ export interface CreateAttendanceGroupQuery {
305
+ /** 用户 ID 的类型 */
306
+ employee_type: 'employee_id' | 'employee_no'
307
+ /** 部门 ID 的类型 */
308
+ dept_type: 'open_id'
309
+ }
310
+
311
+ export interface GetAttendanceGroupQuery {
312
+ /** 用户 ID 的类型 */
313
+ employee_type: 'employee_id' | 'employee_no'
314
+ /** 部门 ID 的类型 */
315
+ dept_type: 'open_id'
316
+ }
317
+
318
+ export interface SearchAttendanceGroupRequest {
319
+ /** 考勤组名称 */
320
+ group_name: string
321
+ }
322
+
323
+ export interface ModifyAttendanceUserSettingRequest {
324
+ /** 用户设置 */
325
+ user_setting?: UserSetting
326
+ }
327
+
328
+ export interface ModifyAttendanceUserSettingQuery {
329
+ /** 请求体和响应体中的 user_id 的员工工号类型 */
330
+ employee_type: 'employee_id' | 'employee_no'
331
+ }
332
+
333
+ export interface QueryAttendanceUserSettingRequest {
334
+ /** employee_no 或 employee_id 列表 */
335
+ user_ids: string[]
336
+ }
337
+
338
+ export interface QueryAttendanceUserSettingQuery {
339
+ /** 请求体中的 user_ids 和响应体中的 user_id 的员工工号类型 */
340
+ employee_type: 'employee_id' | 'employee_no'
341
+ }
342
+
343
+ export interface UploadAttendanceFileForm {
344
+ /** 文件内容 */
345
+ file?: Blob
346
+ }
347
+
348
+ export interface UploadAttendanceFileQuery {
349
+ /** 带后缀的文件名 */
350
+ file_name: string
351
+ }
352
+
353
+ export interface UpdateAttendanceUserStatsViewRequest {
354
+ /** 统计设置 */
355
+ view: UserStatsView
356
+ }
357
+
358
+ export interface UpdateAttendanceUserStatsViewQuery {
359
+ /** 员工工号类型 */
360
+ employee_type: 'employee_id' | 'employee_no'
361
+ }
362
+
363
+ export interface QueryAttendanceUserStatsFieldRequest {
364
+ /** 语言类型 */
365
+ locale: 'en' | 'ja' | 'zh'
366
+ /** 统计类型 */
367
+ stats_type: 'daily' | 'month'
368
+ /** 开始时间 */
369
+ start_date: number
370
+ /** 结束时间(时间间隔不超过 40 天) */
371
+ end_date: number
372
+ }
373
+
374
+ export interface QueryAttendanceUserStatsFieldQuery {
375
+ /** 响应体中的 user_id 的员工工号类型 */
376
+ employee_type: 'employee_id' | 'employee_no'
377
+ }
378
+
379
+ export interface QueryAttendanceUserStatsViewRequest {
380
+ /** 语言类型 */
381
+ locale: 'en' | 'ja' | 'zh'
382
+ /** 统计类型 */
383
+ stats_type: 'daily' | 'month'
384
+ /** 查询用户id,同【查询统计数据】、【更新统计设置】user_id */
385
+ user_id?: string
386
+ }
387
+
388
+ export interface QueryAttendanceUserStatsViewQuery {
389
+ /** 响应体中的 user_id 的员工工号类型 */
390
+ employee_type: 'employee_id' | 'employee_no'
391
+ }
392
+
393
+ export interface QueryAttendanceUserStatsDataRequest {
394
+ /** 语言类型 */
395
+ locale: 'en' | 'ja' | 'zh'
396
+ /** 统计类型 */
397
+ stats_type: 'daily' | 'month'
398
+ /** 开始时间 */
399
+ start_date: number
400
+ /** 结束时间(时间间隔不超过 40 天) */
401
+ end_date: number
402
+ /** 查询的用户 ID 列表(用户数量不超过 200) */
403
+ user_ids?: string[]
404
+ /** 是否需要历史数据 */
405
+ need_history?: boolean
406
+ /** 只展示当前考勤组 */
407
+ current_group_only?: boolean
408
+ /** 查询用户id,同【更新统计设置】、【查询统计设置】user_id */
409
+ user_id?: string
410
+ }
411
+
412
+ export interface QueryAttendanceUserStatsDataQuery {
413
+ /** 请求体中的 user_ids 和响应体中的 user_id 的员工工号类型 */
414
+ employee_type: 'employee_id' | 'employee_no'
415
+ }
416
+
417
+ export interface QueryAttendanceUserApprovalRequest {
418
+ /** employee_no 或 employee_id 列表 */
419
+ user_ids: string[]
420
+ /** 查询的起始工作日 */
421
+ check_date_from: number
422
+ /** 查询的结束工作日,与 check_date_from 的时间间隔不超过 30 天 */
423
+ check_date_to: number
424
+ /** 查询依据的时间类型(不填默认依据PeriodTime) */
425
+ check_date_type?: 'PeriodTime' | 'CreateTime' | 'UpdateTime'
426
+ /** 查询状态(不填默认查询已通过状态) */
427
+ status?: 0 | 1 | 2 | 3 | 4
428
+ /** 查询的起始时间,精确到秒的时间戳 */
429
+ check_time_from?: string
430
+ /** 查询的结束时间,精确到秒的时间戳 */
431
+ check_time_to?: string
432
+ }
433
+
434
+ export interface QueryAttendanceUserApprovalQuery {
435
+ /** 请求体中的 user_ids 和响应体中的 user_id 的员工工号类型 */
436
+ employee_type: 'employee_id' | 'employee_no' | 'open_id'
437
+ }
438
+
439
+ export interface CreateAttendanceUserApprovalRequest {
440
+ /** 审批信息 */
441
+ user_approval?: UserApproval
442
+ }
443
+
444
+ export interface CreateAttendanceUserApprovalQuery {
445
+ /** 请求体和响应体中的 user_id 的员工工号类型 */
446
+ employee_type: 'employee_id' | 'employee_no' | 'open_id'
447
+ }
448
+
449
+ export interface ProcessAttendanceApprovalInfoRequest {
450
+ /** 审批实例 ID,获取方式:1)[获取审批通过数据](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/query) 2)[写入审批结果](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/create) 3)[通知补卡审批发起(补卡情况下)](/ssl:ttdoc/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_task_remedy/create) */
451
+ approval_id: string
452
+ /** 审批类型,leave:请假,out:外出,overtime:加班,trip:出差,remedy:补卡 */
453
+ approval_type: string
454
+ /** 审批状态,1:不通过,2:通过,4:撤销 */
455
+ status: number
456
+ }
457
+
458
+ export interface CreateAttendanceUserTaskRemedyRequest {
459
+ /** 用户工号 */
460
+ user_id: string
461
+ /** 补卡日期 */
462
+ remedy_date: number
463
+ /** 第几次上下班,可能值0,1,2 */
464
+ punch_no: number
465
+ /** 上班/下班,1是上班,2是下班 */
466
+ work_type: number
467
+ /** 补卡时间 */
468
+ remedy_time: string
469
+ /** 补卡原因 */
470
+ reason: string
471
+ /** 补卡时间戳,精确到秒的时间戳 */
472
+ time?: string
473
+ }
474
+
475
+ export interface CreateAttendanceUserTaskRemedyQuery {
476
+ /** 请求体和响应体中的 user_id 的员工工号类型 */
477
+ employee_type: 'employee_id' | 'employee_no'
478
+ }
479
+
480
+ export interface QueryUserAllowedRemedysAttendanceUserTaskRemedyRequest {
481
+ /** 用户 ID */
482
+ user_id: string
483
+ /** 补卡日期 */
484
+ remedy_date: number
485
+ }
486
+
487
+ export interface QueryUserAllowedRemedysAttendanceUserTaskRemedyQuery {
488
+ /** 请求体和响应体中的 user_id 的员工工号类型 */
489
+ employee_type: 'employee_id' | 'employee_no'
490
+ }
491
+
492
+ export interface QueryAttendanceUserTaskRemedyRequest {
493
+ /** employee_no 或 employee_id 列表 */
494
+ user_ids: string[]
495
+ /** 查询的起始时间,精确到秒的时间戳 */
496
+ check_time_from: string
497
+ /** 查询的结束时间,精确到秒的时间戳 */
498
+ check_time_to: string
499
+ /** 查询依据的时间类型(不填默认依据PeriodTime) */
500
+ check_date_type?: 'PeriodTime' | 'CreateTime' | 'UpdateTime'
501
+ /** 查询状态(不填默认查询已通过状态) */
502
+ status?: 0 | 1 | 2 | 3 | 4
503
+ }
504
+
505
+ export interface QueryAttendanceUserTaskRemedyQuery {
506
+ /** 请求体中的 user_ids 和响应体中的 user_id 的员工工号类型 */
507
+ employee_type: 'employee_id' | 'employee_no'
508
+ }
509
+
510
+ export interface UserStatsFieldsQueryAttendanceArchiveRuleRequest {
511
+ /** 语言类型 */
512
+ locale?: string
513
+ /** 月份 */
514
+ month: string
515
+ /** 归档规则id */
516
+ archive_rule_id: string
517
+ /** 操作者id */
518
+ operator_id: string
519
+ }
520
+
521
+ export interface UserStatsFieldsQueryAttendanceArchiveRuleQuery {
522
+ /** 用户 ID 的类型 */
523
+ employee_type: string
524
+ }
525
+
526
+ export interface UploadReportAttendanceArchiveRuleRequest {
527
+ /** 月份 */
528
+ month: string
529
+ /** 操作者ID */
530
+ operator_id: string
531
+ /** 归档报表内容(不超过50个) */
532
+ archive_report_datas?: ArchiveReportData[]
533
+ /** 归档规则id */
534
+ archive_rule_id: string
535
+ }
536
+
537
+ export interface UploadReportAttendanceArchiveRuleQuery {
538
+ /** 用户 ID 的类型 */
539
+ employee_type: string
540
+ }
541
+
542
+ export interface DelReportAttendanceArchiveRuleRequest {
543
+ /** 月份 */
544
+ month: string
545
+ /** 操作者ID */
546
+ operator_id: string
547
+ /** 归档规则id */
548
+ archive_rule_id: string
549
+ /** 用户id */
550
+ user_ids?: string[]
551
+ }
552
+
553
+ export interface DelReportAttendanceArchiveRuleQuery {
554
+ /** 员工工号类型 */
555
+ employee_type: string
556
+ }
557
+
558
+ export interface BatchCreateAttendanceUserFlowRequest {
559
+ /** 打卡流水记录列表 */
560
+ flow_records: UserFlow[]
561
+ }
562
+
563
+ export interface BatchCreateAttendanceUserFlowQuery {
564
+ /** 请求体和响应体中的 user_id 和 creator_id 的员工工号类型 */
565
+ employee_type: 'employee_id' | 'employee_no'
566
+ }
567
+
568
+ export interface GetAttendanceUserFlowQuery {
569
+ /** 响应体中的 user_id 和 creator_id 的员工工号类型 */
570
+ employee_type: 'employee_id' | 'employee_no'
571
+ }
572
+
573
+ export interface QueryAttendanceUserFlowRequest {
574
+ /** employee_no 或 employee_id 列表,长度不超过 50 */
575
+ user_ids: string[]
576
+ /** 查询的起始时间,时间戳 */
577
+ check_time_from: string
578
+ /** 查询的结束时间,时间戳 */
579
+ check_time_to: string
580
+ }
581
+
582
+ export interface QueryAttendanceUserFlowQuery {
583
+ /** 请求体中的 user_ids 和响应体中的 user_id 的员工工号类型 */
584
+ employee_type: 'employee_id' | 'employee_no'
585
+ /** 由于新入职用户可以复用已离职用户的employee_no/employee_id。如果true,返回employee_no/employee_id对应的所有在职+离职用户数据;如果false,只返回employee_no/employee_id对应的在职或最近一个离职用户数据 */
586
+ include_terminated_user?: boolean
587
+ }
588
+
589
+ export interface QueryAttendanceUserTaskRequest {
590
+ /** employee_no 或 employee_id 列表 */
591
+ user_ids: string[]
592
+ /** 查询的起始工作日 */
593
+ check_date_from: number
594
+ /** 查询的结束工作日 */
595
+ check_date_to: number
596
+ /** 是否需要加班班段打卡结果 */
597
+ need_overtime_result?: boolean
598
+ }
599
+
600
+ export interface QueryAttendanceUserTaskQuery {
601
+ /** 员工工号类型 */
602
+ employee_type: 'employee_id' | 'employee_no'
603
+ /** 是否忽略无效和没有权限的用户。如果 true,则返回有效用户的信息,并告知无效和没有权限的用户信息;如果 false,且 user_ids 中存在无效或没有权限的用户,则返回错误 */
604
+ ignore_invalid_users?: boolean
605
+ /** 由于新入职员工可以复用已离职员工的 employee_no/employee_id,如果 true,则返回 employee_no/employee_id 对应的所有在职 + 离职员工的数据;如果 false,则只返回 employee_no/employee_id 对应的在职或最近一个离职员工的数据 */
606
+ include_terminated_user?: boolean
607
+ }
608
+
609
+ export interface GetAttendanceLeaveEmployExpireRecordRequest {
610
+ /** 员工ID */
611
+ employment_id: string
612
+ /** 假期类型ID */
613
+ leave_type_id: string
614
+ /** 失效最早日期 2023-04-10 格式 */
615
+ start_expiration_date: string
616
+ /** 失效最晚日期 2023-05-10 格式 */
617
+ end_expiration_date: string
618
+ /** 时间偏移,东八区:480 8*60, 如果没有这个参数,默认东八区 */
619
+ time_offset?: number
620
+ }
621
+
622
+ export interface GetAttendanceLeaveEmployExpireRecordQuery {
623
+ /** 用户 ID 类型 */
624
+ user_id_type?: 'open_id' | 'people_corehr_id' | 'union_id' | 'user_id'
625
+ }
626
+
627
+ export interface PatchAttendanceLeaveAccrualRecordRequest {
628
+ /** 授予记录的唯一ID */
629
+ leave_granting_record_id: string
630
+ /** 员工ID */
631
+ employment_id: string
632
+ /** 假期类型ID */
633
+ leave_type_id: string
634
+ /** 修改授予记录原因 */
635
+ reason: LangText[]
636
+ /** 时间偏移,东八区:480 8*60 */
637
+ time_offset?: number
638
+ /** 失效日期,格式"2020-01-01" */
639
+ expiration_date?: string
640
+ /** 修改source 余额 */
641
+ quantity?: string
642
+ /** 是否参与清算 */
643
+ section_type?: number
644
+ }
645
+
646
+ export interface PatchAttendanceLeaveAccrualRecordQuery {
647
+ /** 用户 ID 类型 */
648
+ user_id_type?: 'open_id' | 'people_corehr_id' | 'union_id' | 'user_id'
649
+ }
650
+
651
+ export interface CreateAttendanceShiftResponse {
652
+ /** 班次 */
653
+ shift?: Shift
654
+ }
655
+
656
+ export interface GetAttendanceShiftResponse {
657
+ /** 班次Id */
658
+ shift_id: string
659
+ /** 班次名称 */
660
+ shift_name: string
661
+ /** 打卡次数 */
662
+ punch_times: number
663
+ /** 排班组子负责人id列表 */
664
+ sub_shift_leader_ids?: string[]
665
+ /** 是否弹性打卡 */
666
+ is_flexible?: boolean
667
+ /** 弹性打卡时间,设置【上班最多可晚到】与【下班最多可早走】时间,如果不设置flexible_rule则生效 */
668
+ flexible_minutes?: number
669
+ /** 弹性打卡时间设置 */
670
+ flexible_rule?: FlexibleRule[]
671
+ /** 不需要打下班卡 */
672
+ no_need_off?: boolean
673
+ /** 打卡规则 */
674
+ punch_time_rule: PunchTimeRule[]
675
+ /** 晚走晚到规则 */
676
+ late_off_late_on_rule?: LateOffLateOnRule[]
677
+ /** 休息规则 */
678
+ rest_time_rule?: RestRule[]
679
+ /** 打卡规则 */
680
+ overtime_rule?: OvertimeRule[]
681
+ /** 日期类型,【是否弹性打卡 = ture】时,不可设置为“休息日” 可选值:1:工作日 2:休息日 示例值:(默认值)1 */
682
+ day_type?: number
683
+ /** 班外休息规则 */
684
+ overtime_rest_time_rule?: RestRule[]
685
+ /** 晚到多久记为严重迟到(优先级比原有字段高) */
686
+ late_minutes_as_serious_late?: number
687
+ /** 半天分割规则 */
688
+ shift_middle_time_rule?: ShiftMiddleTimeRule
689
+ /** 应出勤配置 */
690
+ shift_attendance_time_config?: ShiftAttendanceTimeConfig
691
+ /** 晚走次日晚到配置规则 */
692
+ late_off_late_on_setting?: LateOffLateOnSetting
693
+ /** 班次id(更新班次时需要传递) */
694
+ id?: string
695
+ /** 休息弹性设置 */
696
+ rest_time_flexible_configs?: RestTimeFlexibleConfig[]
697
+ }
698
+
699
+ export interface QueryAttendanceShiftResponse {
700
+ /** 班次Id */
701
+ shift_id: string
702
+ /** 班次名称 */
703
+ shift_name: string
704
+ /** 打卡次数 */
705
+ punch_times: number
706
+ /** 排班组子负责人id列表 */
707
+ sub_shift_leader_ids?: string[]
708
+ /** 是否弹性打卡 */
709
+ is_flexible?: boolean
710
+ /** 弹性打卡时间,设置【上班最多可晚到】与【下班最多可早走】时间,如果不设置flexible_rule则生效 */
711
+ flexible_minutes?: number
712
+ /** 弹性打卡时间设置 */
713
+ flexible_rule?: FlexibleRule[]
714
+ /** 不需要打下班卡 */
715
+ no_need_off?: boolean
716
+ /** 打卡规则 */
717
+ punch_time_rule: PunchTimeRule[]
718
+ /** 晚走晚到规则 */
719
+ late_off_late_on_rule?: LateOffLateOnRule[]
720
+ /** 休息规则 */
721
+ rest_time_rule?: RestRule[]
722
+ /** 打卡规则 */
723
+ overtime_rule?: OvertimeRule[]
724
+ /** 日期类型,【是否弹性打卡 = ture】时,不可设置为“休息日” 可选值:1:工作日 2:休息日 示例值:(默认值)1 */
725
+ day_type?: number
726
+ /** 班外休息规则 */
727
+ overtime_rest_time_rule?: RestRule[]
728
+ /** 晚到多久记为严重迟到(优先级比原有字段高) */
729
+ late_minutes_as_serious_late?: number
730
+ /** 半天分割规则 */
731
+ shift_middle_time_rule?: ShiftMiddleTimeRule
732
+ /** 应出勤配置 */
733
+ shift_attendance_time_config?: ShiftAttendanceTimeConfig
734
+ /** 晚走次日晚到配置规则 */
735
+ late_off_late_on_setting?: LateOffLateOnSetting
736
+ /** 班次id(更新班次时需要传递) */
737
+ id?: string
738
+ /** 休息弹性设置 */
739
+ rest_time_flexible_configs?: RestTimeFlexibleConfig[]
740
+ }
741
+
742
+ export interface BatchCreateAttendanceUserDailyShiftResponse {
743
+ /** 班表信息列表 */
744
+ user_daily_shifts?: UserDailyShift[]
745
+ }
746
+
747
+ export interface QueryAttendanceUserDailyShiftResponse {
748
+ /** 班表信息列表 */
749
+ user_daily_shifts?: UserDailyShift[]
750
+ }
751
+
752
+ export interface BatchCreateTempAttendanceUserDailyShiftResponse {
753
+ /** 临时班表信息列表 */
754
+ user_tmp_daily_shifts?: UserTmpDailyShift[]
755
+ }
756
+
757
+ export interface CreateAttendanceGroupResponse {
758
+ group?: Group
759
+ }
760
+
761
+ export interface GetAttendanceGroupResponse {
762
+ /** 考勤组的Id, 需要从获取用户打卡结果信息的接口中获取groupId,修改考勤组时必填 */
763
+ group_id?: string
764
+ /** 考勤组名称 */
765
+ group_name: string
766
+ /** 考勤组时区 */
767
+ time_zone: string
768
+ /** 参加考勤的部门id列表 */
769
+ bind_dept_ids?: string[]
770
+ /** 无需考勤的部门id列表 */
771
+ except_dept_ids?: string[]
772
+ /** 参加考勤的人员id列表 */
773
+ bind_user_ids?: string[]
774
+ /** 参加考勤的人员id列表 */
775
+ except_user_ids?: string[]
776
+ /** 考勤组主负责人id列表 */
777
+ group_leader_ids: string[]
778
+ /** 考勤组子负责人id列表 */
779
+ sub_group_leader_ids?: string[]
780
+ /** 是否允许外勤打卡 */
781
+ allow_out_punch?: boolean
782
+ /** 外勤打卡需审批,先审批后打卡(需要允许外勤打卡才能设置生效) */
783
+ out_punch_need_approval?: boolean
784
+ /** 外勤打卡需审批,先打卡后审批(需要允许外勤打卡才能设置生效) */
785
+ out_punch_need_post_approval?: boolean
786
+ /** 外勤打卡需填写备注(需要允许外勤打卡才能设置生效) */
787
+ out_punch_need_remark?: boolean
788
+ /** 外勤打卡需拍照(需要允许外勤打卡才能设置生效) */
789
+ out_punch_need_photo?: boolean
790
+ /** 外勤打卡允许员工隐藏详细地址(需要允许外勤打卡才能设置生效) */
791
+ out_punch_allowed_hide_addr?: boolean
792
+ /** 外勤打卡允许微调地址(需要允许外勤打卡才能设置生效) */
793
+ out_punch_allowed_adjust_addr?: boolean
794
+ /** 微调范围,默认为 50 米 */
795
+ adjust_range?: number
796
+ /** 是否允许pc打卡 */
797
+ allow_pc_punch?: boolean
798
+ /** 是否允许补卡 */
799
+ allow_remedy?: boolean
800
+ /** 补卡次数是否限制(需要允许补卡才能设置生效) */
801
+ remedy_limit?: boolean
802
+ /** 补卡次数(需要允许补卡才能设置生效) */
803
+ remedy_limit_count?: number
804
+ /** 补卡时间是否限制(需要允许补卡才能设置生效) */
805
+ remedy_date_limit?: boolean
806
+ /** 补卡时间,几天内可以发起补卡(需要允许补卡才能设置生效) */
807
+ remedy_date_num?: number
808
+ /** 允许缺卡补卡(需要允许补卡才能设置生效) */
809
+ allow_remedy_type_lack?: boolean
810
+ /** 允许迟到补卡(需要允许补卡才能设置生效) */
811
+ allow_remedy_type_late?: boolean
812
+ /** 允许早退补卡(需要允许补卡才能设置生效) */
813
+ allow_remedy_type_early?: boolean
814
+ /** 允许正常补卡(需要允许补卡才能设置生效) */
815
+ allow_remedy_type_normal?: boolean
816
+ /** 是否展示累计时长 */
817
+ show_cumulative_time?: boolean
818
+ /** 是否展示加班时长 */
819
+ show_over_time?: boolean
820
+ /** 是否隐藏员工打卡详情 */
821
+ hide_staff_punch_time?: boolean
822
+ /** 是否开启人脸打卡 */
823
+ face_punch?: boolean
824
+ /** 人脸打卡规则, 1:每次打卡均需人脸识别 2:疑似需要 */
825
+ face_punch_cfg?: number
826
+ /** 人脸打卡规则, false:开启活体验证 true:0动作验证,仅在 face_punch_cfg = 1 时有效 */
827
+ face_live_need_action?: boolean
828
+ /** 脸识别失败时允许普通拍照打卡 */
829
+ face_downgrade?: boolean
830
+ /** 是否允许替换基准图片 */
831
+ replace_basic_pic?: boolean
832
+ /** 考勤机信息 */
833
+ machines?: Machine[]
834
+ /** GPS打卡的地址范围 */
835
+ gps_range?: number
836
+ /** GPS打卡的地址信息 */
837
+ locations?: Location[]
838
+ /** 考勤类型 0:固定考勤 2:排班考勤, 3:自由班次 */
839
+ group_type: number
840
+ /** 固定班次必需填 */
841
+ punch_day_shift_ids: string[]
842
+ free_punch_cfg?: FreePunchCfg
843
+ /** 国家日历 id,(0:不根据国家日历休息, 1:中国,2:美国,3:日本,4:印度,5:新加坡),默认 1 */
844
+ calendar_id: number
845
+ /** 强制需要打卡的日期 */
846
+ need_punch_special_days?: PunchSpecialDateShift[]
847
+ /** 强制不需要打卡的日期 */
848
+ no_need_punch_special_days?: PunchSpecialDateShift[]
849
+ /** 自由班次下工作日不打卡是否记为缺卡 */
850
+ work_day_no_punch_as_lack?: boolean
851
+ /** 补卡周期类型 */
852
+ remedy_period_type?: number
853
+ /** 补卡自定义周期起始日期 */
854
+ remedy_period_custom_date?: number
855
+ /** 打卡类型,位运算。1:GPS打卡;2:wifi打卡;4:考勤机打卡;8:IP打卡 */
856
+ punch_type?: number
857
+ /** 生效时间,精确到秒的时间戳 */
858
+ effect_time?: string
859
+ /** 固定班次生效时间,精确到秒的时间戳 */
860
+ fixshift_effect_time?: string
861
+ /** 参加考勤的人员、部门变动生效时间,精确到秒的时间戳 */
862
+ member_effect_time?: string
863
+ /** 休息日打卡需审批 */
864
+ rest_clockIn_need_approval?: boolean
865
+ /** 每次打卡均需拍照 */
866
+ clockIn_need_photo?: boolean
867
+ /** 人员异动打卡设置 */
868
+ member_status_change?: MemberStatusChange
869
+ /** 请假离岗或返岗是否需打卡 */
870
+ leave_need_punch?: boolean
871
+ /** 请假离岗或返岗打卡规则 */
872
+ leave_need_punch_cfg?: LeaveNeedPunchCfg
873
+ /** 外出期间是否需打卡 */
874
+ go_out_need_punch?: number
875
+ /** 外出期间打卡规则 */
876
+ go_out_need_punch_cfg?: LeaveNeedPunchCfg
877
+ /** 出差期间是否需打卡 */
878
+ travel_need_punch?: number
879
+ /** 出差期间打卡规则 */
880
+ travel_need_punch_cfg?: LeaveNeedPunchCfg
881
+ /** 需要打卡的人员配置(新) */
882
+ need_punch_members?: PunchMember[]
883
+ /** 无需打卡的人员配置(新) */
884
+ no_need_punch_members?: PunchMember[]
885
+ /** 是否直接保存可以自动变更的冲突规则 */
886
+ save_auto_changes?: boolean
887
+ /** 人员异动开关(人员组织架构变更后是否允许自动调整到该考勤组) */
888
+ org_change_auto_adjust?: boolean
889
+ /** 默认出勤的部门id列表 */
890
+ bind_default_dept_ids?: string[]
891
+ /** 默认出勤的用户ID列表 */
892
+ bind_default_user_ids?: string[]
893
+ /** 加班打卡规则 */
894
+ overtime_clock_cfg?: OvertimeClockCfg
895
+ /** 节假日id,(如果考勤组使用了自定义节假日,请用此参数传入节假日id) */
896
+ new_calendar_id?: string
897
+ /** 定位不准时是否允许申请打卡 */
898
+ allow_apply_punch?: boolean
899
+ }
900
+
901
+ export interface SearchAttendanceGroupResponse {
902
+ /** 考勤组列表 */
903
+ group_list?: GroupMeta[]
904
+ }
905
+
906
+ export interface ModifyAttendanceUserSettingResponse {
907
+ /** 用户设置 */
908
+ user_setting?: UserSetting
909
+ }
910
+
911
+ export interface QueryAttendanceUserSettingResponse {
912
+ /** 用户设置信息列表 */
913
+ user_settings?: UserSetting[]
914
+ }
915
+
916
+ export interface UploadAttendanceFileResponse {
917
+ file?: File
918
+ }
919
+
920
+ export interface UpdateAttendanceUserStatsViewResponse {
921
+ /** 视图 */
922
+ view?: UserStatsView
923
+ }
924
+
925
+ export interface QueryAttendanceUserStatsFieldResponse {
926
+ user_stats_field?: UserStatsField
927
+ }
928
+
929
+ export interface QueryAttendanceUserStatsViewResponse {
930
+ view?: UserStatsView
931
+ }
932
+
933
+ export interface QueryAttendanceUserStatsDataResponse {
934
+ /** 用户统计数据 */
935
+ user_datas?: UserStatsData[]
936
+ /** 无权限获取的用户列表 */
937
+ invalid_user_list?: string[]
938
+ }
939
+
940
+ export interface QueryAttendanceUserApprovalResponse {
941
+ /** 审批结果列表 */
942
+ user_approvals?: UserApproval[]
943
+ }
944
+
945
+ export interface CreateAttendanceUserApprovalResponse {
946
+ /** 审批信息 */
947
+ user_approval?: UserApproval
948
+ }
949
+
950
+ export interface ProcessAttendanceApprovalInfoResponse {
951
+ /** 审批信息 */
952
+ approval_info?: ApprovalInfo
953
+ }
954
+
955
+ export interface CreateAttendanceUserTaskRemedyResponse {
956
+ /** 补卡审批信息 */
957
+ user_remedy?: UserTaskRemedy
958
+ }
959
+
960
+ export interface QueryUserAllowedRemedysAttendanceUserTaskRemedyResponse {
961
+ /** 用户可补卡时间 */
962
+ user_allowed_remedys?: UserAllowedRemedy[]
963
+ }
964
+
965
+ export interface QueryAttendanceUserTaskRemedyResponse {
966
+ /** 补卡记录列表 */
967
+ user_remedys?: UserTaskRemedy[]
968
+ }
969
+
970
+ export interface UserStatsFieldsQueryAttendanceArchiveRuleResponse {
971
+ /** 统计数据表头 */
972
+ archive_report_fields?: ArchiveField[]
973
+ }
974
+
975
+ export interface UploadReportAttendanceArchiveRuleResponse {
976
+ /** 无效的code */
977
+ invalid_code?: string[]
978
+ /** 无效的member_id */
979
+ invalid_member_id?: string[]
980
+ }
981
+
982
+ export interface BatchCreateAttendanceUserFlowResponse {
983
+ /** 打卡流水记录列表 */
984
+ flow_records?: UserFlow[]
985
+ }
986
+
987
+ export interface GetAttendanceUserFlowResponse {
988
+ /** 用户工号 */
989
+ user_id: string
990
+ /** 记录创建者的工号 */
991
+ creator_id: string
992
+ /** 打卡位置名称信息 */
993
+ location_name: string
994
+ /** 打卡时间,精确到秒的时间戳 */
995
+ check_time: string
996
+ /** 打卡备注 */
997
+ comment: string
998
+ /** 打卡记录ID */
999
+ record_id?: string
1000
+ /** 打卡wifi ssid */
1001
+ ssid?: string
1002
+ /** 打卡wifi MAC地址 */
1003
+ bssid?: string
1004
+ /** 是否为外勤打卡 */
1005
+ is_field?: boolean
1006
+ /** 是否为wifi打卡 */
1007
+ is_wifi?: boolean
1008
+ /** 记录生成方式 */
1009
+ type?: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7
1010
+ /** 打卡照片列表 */
1011
+ photo_urls?: string[]
1012
+ /** 打卡设备ID */
1013
+ device_id?: string
1014
+ /** 打卡结果 */
1015
+ check_result?: 'NoNeedCheck' | 'SystemCheck' | 'Normal' | 'Early' | 'Late' | 'SeriousLate' | 'Lack' | 'Invalid' | 'None' | 'Todo'
1016
+ /** 用户导入的外部打卡记录ID */
1017
+ external_id?: string
1018
+ /** 唯一幂等键 */
1019
+ idempotent_id?: string
1020
+ }
1021
+
1022
+ export interface QueryAttendanceUserFlowResponse {
1023
+ /** 打卡记录列表 */
1024
+ user_flow_results?: UserFlow[]
1025
+ }
1026
+
1027
+ export interface QueryAttendanceUserTaskResponse {
1028
+ /** 打卡任务列表 */
1029
+ user_task_results?: UserTask[]
1030
+ /** 无效用户工号列表 */
1031
+ invalid_user_ids?: string[]
1032
+ /** 没有权限用户工号列表 */
1033
+ unauthorized_user_ids?: string[]
1034
+ }
1035
+
1036
+ export interface GetAttendanceLeaveEmployExpireRecordResponse {
1037
+ /** 员工过期日期的授予记录 */
1038
+ records: LeaveEmployExpireRecord[]
1039
+ }
1040
+
1041
+ export interface PatchAttendanceLeaveAccrualRecordResponse {
1042
+ /** 员工过期日期的授予记录 */
1043
+ record: LeaveAccrualRecord
1044
+ }
1045
+
1046
+ Internal.define({
1047
+ '/attendance/v1/shifts': {
1048
+ POST: 'createAttendanceShift',
1049
+ GET: { name: 'listAttendanceShift', pagination: { argIndex: 0, itemsKey: 'shift_list' } },
1050
+ },
1051
+ '/attendance/v1/shifts/{shift_id}': {
1052
+ DELETE: 'deleteAttendanceShift',
1053
+ GET: 'getAttendanceShift',
1054
+ },
1055
+ '/attendance/v1/shifts/query': {
1056
+ POST: 'queryAttendanceShift',
1057
+ },
1058
+ '/attendance/v1/user_daily_shifts/batch_create': {
1059
+ POST: 'batchCreateAttendanceUserDailyShift',
1060
+ },
1061
+ '/attendance/v1/user_daily_shifts/query': {
1062
+ POST: 'queryAttendanceUserDailyShift',
1063
+ },
1064
+ '/attendance/v1/user_daily_shifts/batch_create_temp': {
1065
+ POST: 'batchCreateTempAttendanceUserDailyShift',
1066
+ },
1067
+ '/attendance/v1/groups/{group_id}/list_user': {
1068
+ GET: { name: 'listUserAttendanceGroup', pagination: { argIndex: 1, itemsKey: 'users' } },
1069
+ },
1070
+ '/attendance/v1/groups': {
1071
+ POST: 'createAttendanceGroup',
1072
+ GET: { name: 'listAttendanceGroup', pagination: { argIndex: 0, itemsKey: 'group_list' } },
1073
+ },
1074
+ '/attendance/v1/groups/{group_id}': {
1075
+ DELETE: 'deleteAttendanceGroup',
1076
+ GET: 'getAttendanceGroup',
1077
+ },
1078
+ '/attendance/v1/groups/search': {
1079
+ POST: 'searchAttendanceGroup',
1080
+ },
1081
+ '/attendance/v1/user_settings/modify': {
1082
+ POST: 'modifyAttendanceUserSetting',
1083
+ },
1084
+ '/attendance/v1/user_settings/query': {
1085
+ GET: 'queryAttendanceUserSetting',
1086
+ },
1087
+ '/attendance/v1/files/upload': {
1088
+ POST: { name: 'uploadAttendanceFile', multipart: true },
1089
+ },
1090
+ '/attendance/v1/files/{file_id}/download': {
1091
+ GET: { name: 'downloadAttendanceFile', type: 'binary' },
1092
+ },
1093
+ '/attendance/v1/user_stats_views/{user_stats_view_id}': {
1094
+ PUT: 'updateAttendanceUserStatsView',
1095
+ },
1096
+ '/attendance/v1/user_stats_fields/query': {
1097
+ POST: 'queryAttendanceUserStatsField',
1098
+ },
1099
+ '/attendance/v1/user_stats_views/query': {
1100
+ POST: 'queryAttendanceUserStatsView',
1101
+ },
1102
+ '/attendance/v1/user_stats_datas/query': {
1103
+ POST: 'queryAttendanceUserStatsData',
1104
+ },
1105
+ '/attendance/v1/user_approvals/query': {
1106
+ POST: 'queryAttendanceUserApproval',
1107
+ },
1108
+ '/attendance/v1/user_approvals': {
1109
+ POST: 'createAttendanceUserApproval',
1110
+ },
1111
+ '/attendance/v1/approval_infos/process': {
1112
+ POST: 'processAttendanceApprovalInfo',
1113
+ },
1114
+ '/attendance/v1/user_task_remedys': {
1115
+ POST: 'createAttendanceUserTaskRemedy',
1116
+ },
1117
+ '/attendance/v1/user_task_remedys/query_user_allowed_remedys': {
1118
+ POST: 'queryUserAllowedRemedysAttendanceUserTaskRemedy',
1119
+ },
1120
+ '/attendance/v1/user_task_remedys/query': {
1121
+ POST: 'queryAttendanceUserTaskRemedy',
1122
+ },
1123
+ '/attendance/v1/archive_rule/user_stats_fields_query': {
1124
+ POST: 'userStatsFieldsQueryAttendanceArchiveRule',
1125
+ },
1126
+ '/attendance/v1/archive_rule/upload_report': {
1127
+ POST: 'uploadReportAttendanceArchiveRule',
1128
+ },
1129
+ '/attendance/v1/archive_rule/del_report': {
1130
+ POST: 'delReportAttendanceArchiveRule',
1131
+ },
1132
+ '/attendance/v1/archive_rule': {
1133
+ GET: { name: 'listAttendanceArchiveRule', pagination: { argIndex: 0 } },
1134
+ },
1135
+ '/attendance/v1/user_flows/batch_create': {
1136
+ POST: 'batchCreateAttendanceUserFlow',
1137
+ },
1138
+ '/attendance/v1/user_flows/{user_flow_id}': {
1139
+ GET: 'getAttendanceUserFlow',
1140
+ },
1141
+ '/attendance/v1/user_flows/query': {
1142
+ POST: 'queryAttendanceUserFlow',
1143
+ },
1144
+ '/attendance/v1/user_tasks/query': {
1145
+ POST: 'queryAttendanceUserTask',
1146
+ },
1147
+ '/attendance/v1/leave_employ_expire_records/{leave_id}': {
1148
+ GET: 'getAttendanceLeaveEmployExpireRecord',
1149
+ },
1150
+ '/attendance/v1/leave_accrual_record/{leave_id}': {
1151
+ PATCH: 'patchAttendanceLeaveAccrualRecord',
1152
+ },
1153
+ })