钉钉开发文档

企业考勤组详情

更新时间: 2019-5-17

在钉钉考勤应用中,考勤组是一类具有相同的班次、考勤位置等考勤规则的人或部门的组合,企业可根据实际业务设置多个考勤组。如果企业想获取企业的考勤组与企业业务系统对接,可使用此接口查询所有的考勤组详情信息。

请求方式:POST(HTTPS)
请求地址https://oapi.dingtalk.com/topapi/attendance/getsimplegroups?access_token=ACCESS_TOKEN
参数说明:

名称 类型 是否必须 示例值 描述
offset Number 可选 0 偏移位置,从0、1、2...依次递增,默认值:0
size Number 可选 10 分页大小,最大10,默认值:10

SDK请求示例(JAVA)

DefaultDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/getsimplegroups");
OapiAttendanceGetsimplegroupsRequest request = new OapiAttendanceGetsimplegroupsRequest();
OapiAttendanceGetsimplegroupsResponse execute = client.execute(request,accessToken);

返回结果

{
    "errcode":0,
    "errmsg":"ok",
    "result":{
        "has_more":true,
        "groups":[
            {
                    "group_id":20015047,
                    "is_default":false,
                    "group_name":"固定排班",
                    "selected_class":[
                        {
                                "setting":{
                                    "class_setting_id":1,
                                    "rest_begin_time":{
                                        "check_time":"2017-04-11 11:11:11"
                                    },
                                    "permit_late_minutes":10,
                                    "work_time_minutes":-1,
                                    "rest_end_time":{
                                        "check_time":"2017-04-11 11:11:11"
                                    },
                                    "absenteeism_late_minutes":30,
                                    "serious_late_minutes":20,
                                    "is_off_duty_free_check":"Y"
                                },
                                "class_id":20008010,
                                "sections":[
                                    {
                                            "times":[
                                                {
                                                        "check_time":"2017-04-11 11:11:11",
                                                        "check_type":"OnDuty",
                                                        "across":0
                                                }
                                            ]
                                    }
                                ],
                                "class_name":"A"
                        }
                    ],
                    "type":"FIXED",
                    "member_count":1,
                    "default_class_id":111,
                    "work_day_list":"1",
                    "classes_list":"周一、二 班次A:09:00-18:00, 周六、周日 休息",
                    "manager_list":"1,2",
                    "dept_name_list":"部门1,部门2"

            }
        ]
    }
}
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
result
└ has_more 分页用,表示是否还有下一页
└ groups 考勤组列表
└└ group_id 考勤组id
└└ is_default 是否默认考勤组
└ └group_name 考勤组名称
└ └selected_class 考勤组对应的考勤班次列表
└└└ setting 考勤组班次配置
└ └└└class_setting_id 考勤组班次id
└ └└└rest_begin_time 休息开始时间,只有一个时间段的班次有
└└└└└ check_time 开始时间
└└└└ permit_late_minutes 允许迟到时长,单位分钟
└└└└work_time_minutes 工作时长,单位分钟,-1表示关闭该功能
└└└└rest_end_time 休息结束时间,只有一个时间段的班次有
└└└└└ check_time 结束时间
└└└└ absenteeism_late_minutes 旷工迟到时长,单位分钟
└└└└ serious_late_minutes 严重迟到时长,单位分钟
└└└└ is_off_duty_free_check Y表示下班不强制打卡,N表示下班强制打卡
└└└└ class_id 考勤班次id
└└└└ sections 班次打卡时间段
└└└└└ times 时间段列表
└└└└└check_time 打卡时间
└└└└└ check_type 打卡类型枚举(Onduty和OffDuty)
└└└└└ across 打卡时间跨度
└└└└ class_name 考勤班次名称
└ type 考勤类型,FIXED为固定排班,TURN为轮班排班,NONE为无班次
└ member_count 成员人数
└ default_class_id 默认班次id
└ work_day_list 固定班次的工作日班次
└ classes_list 一周的班次时间展示列表
└ manager_list 考勤组负责人
└ dept_name_list 关联的部门
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!