创建或修改考勤组
POST
/open-apis/attendance/v1/groups
错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 400 | 1220001 | 参数错误 | 请检查参数是否符合要求 |
| 400 | 1220002 | 租户不存在 | 请检查 tenant_access_token 是否正确 |
| 400 | 1220003 | employee_type 不存在 | employee_type，employee_id：员工的 employeeId，employee_no：员工工号 |
| 400 | 1220004 | 用户不存在或没有权限 | 请检查用户 ID 是否正确 |
| 400 | 1220005 | 没有权限 | 请前往考勤管理后台检查数据权限范围 |
| 500 | 1225000 | 系统错误 | 详见错误信息 |
| 400 | 1227500 | 组织架构服务系统错误 | 详见错误信息 |
| 400 | 1227000 | 管理服务系统错误 | 详见错误信息 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.feishu.cn/open-apis/attendance/v1/groups?employee_type=employee_id&dept_type=od-fcb45c28a45311afd441b8869541ece8' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
"group": {
"group_id": "6919358128597097404",
"group_name": "开心考勤",
"time_zone": "Asia/Shanghai",
"bind_dept_ids": [
"a6a64f94gg768492"
],
"except_dept_ids": [
"f864f94dg73459845"
],
"bind_user_ids": [
"52aa1fa1"
],
"except_user_ids": [
"4fasdtc2"
],
"group_leader_ids": [
"52aa1fa1"
],
"sub_group_leader_ids": [
"4fasdtc2"
],
"allow_out_punch": true,
"out_punch_need_approval": true,
"out_punch_need_remark": true,
"out_punch_need_photo": true,
"out_punch_allowed_hide_addr": true,
"allow_pc_punch": true,
"allow_remedy": true,
"remedy_limit": true,
"remedy_limit_count": 3,
"remedy_date_limit": true,
"remedy_date_num": 3,
"allow_remedy_type_lack": true,
"allow_remedy_type_late": true,
"allow_remedy_type_early": true,
"allow_remedy_type_normal": true,
"show_cumulative_time": true,
"show_over_time": true,
"hide_staff_punch_time": true,
"face_punch": true,
"face_punch_cfg": 1,
"face_downgrade": true,
"replace_basic_pic": true,
"machines": [
{
"machine_sn": "FS0701",
"machine_name": "创实 9 楼"
}
],
"gps_range": 300,
"locations": [
{
"location_name": "浙江省杭州市余杭区五常街道木桥头西溪八方城",
"location_type": 1,
"latitude": 30.28994,
"longitude": 120.04509,
"ssid": "TP-Link-af12ca",
"bssid": "08:00:20:0A:8C:6D",
"map_type": 1,
"address": "北京市海淀区中航广场",
"ip": "122.224.123.146",
"feature": "中国电信",
"gps_range": 300
}
],
"group_type": 0,
"punch_day_shift_ids": [
"6919668824125513935"
],
"free_punch_cfg": {
"free_start_time": "7:00",
"free_end_time": "18:00",
"punch_day": 1111100,
"work_day_no_punch_as_lack": true
},
"calendar_id": 1,
"need_punch_special_days": [
{
"punch_day": 20190101,
"shift_id": "6919668827865513935"
}
],
"no_need_punch_special_days": [
{
"punch_day": 20190101,
"shift_id": "6919668827865513935"
}
],
"work_day_no_punch_as_lack": true,
"effect_now": true,
"remedy_period_type": 0,
"remedy_period_custom_date": 1,
"punch_type": 1,
"rest_clockIn_need_approval": true,
"clockIn_need_photo": true
},
"operator_id": "dd31248a"
}'响应示例响应示例
{
"code": 0,
"msg": "success",
"data": {
"group": {
"group_id": "6919358128597097404",
"group_name": "开心考勤",
"time_zone": "Asia/Shanghai",
"bind_dept_ids": [
"a6a64f94gg768492"
],
"except_dept_ids": [
"f864f94dg73459845"
],
"bind_user_ids": [
"52aa1fa1"
],
"except_user_ids": [
"4fasdtc2"
],
"group_leader_ids": [
"52aa1fa1"
],
"sub_group_leader_ids": [
"4fasdtc2"
],
"allow_out_punch": true,
"out_punch_need_approval": true,
"out_punch_need_remark": true,
"out_punch_need_photo": true,
"out_punch_allowed_hide_addr": true,
"allow_pc_punch": true,
"allow_remedy": true,
"remedy_limit": true,
"remedy_limit_count": 3,
"remedy_date_limit": true,
"remedy_date_num": 3,
"allow_remedy_type_lack": true,
"allow_remedy_type_late": true,
"allow_remedy_type_early": true,
"allow_remedy_type_normal": true,
"show_cumulative_time": true,
"show_over_time": true,
"hide_staff_punch_time": true,
"face_punch": true,
"face_punch_cfg": 1,
"face_downgrade": true,
"replace_basic_pic": true,
"machines": [
{
"machine_sn": "FS0701",
"machine_name": "创实 9 楼"
}
],
"gps_range": 300,
"locations": [
{
"location_id": "6921213751454744578",
"location_name": "浙江省杭州市余杭区五常街道木桥头西溪八方城",
"location_type": 1,
"latitude": 30.28994,
"longitude": 120.04509,
"ssid": "TP-Link-af12ca",
"bssid": "08:00:20:0A:8C:6D",
"map_type": 1,
"address": "北京市海淀区中航广场",
"ip": "122.224.123.146",
"feature": "中国电信",
"gps_range": 300
}
],
"group_type": 0,
"punch_day_shift_ids": [
"6919668824125513935"
],
"free_punch_cfg": {
"free_start_time": "7:00",
"free_end_time": "18:00",
"punch_day": 1111100,
"work_day_no_punch_as_lack": true
},
"calendar_id": 1,
"need_punch_special_days": [
{
"punch_day": 20190101,
"shift_id": "6919668827865513935"
}
],
"no_need_punch_special_days": [
{
"punch_day": 20190101,
"shift_id": "6919668827865513935"
}
],
"work_day_no_punch_as_lack": true,
"effect_now": true,
"remedy_period_type": 0,
"remedy_period_custom_date": 1,
"punch_type": 1,
"rest_clockIn_need_approval": true,
"clockIn_need_photo": true
}
}
}请求参数
Query 参数
Header 参数
Body 参数application/json
返回响应
扫码加入交流群修改于 2023-01-28 08:21:17