钉钉开发文档

企业考勤排班详情

更新时间: 2019-7-12

在钉钉考勤应用中,设置考勤组规则后,会生成每天的排班信息,包括工作日、周末、节假日等。如果企业想查询某天的排班情况,可使用此接口查询某天的考勤排班全量信息。
注:固定班制只能查到未来15天的排班信息。

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

名称 类型 是否必须 示例值 描述
workDate Date 必须 2016-03-09 11:11:11 排班时间,只取年月日部分
offset Number 可选 0 偏移位置,从0开始,后续传offset+size的值。当返回结果中的has_more为false时,表示没有多余的数据了。
size Number 可选 200 分页大小,最大200,默认值:200

SDK请求示例(JAVA)

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/listschedule");
OapiAttendanceListscheduleRequest request = new OapiAttendanceListscheduleRequest();
request.setWorkDate(new Date());
request.setOffset(0L);
request.setSize(100L);
OapiAttendanceListscheduleResponse execute = client.execute(request,accessToken);

返回结果

{
    "result":{
        "schedules":[
            {
                    "plan_id":1,
                    "check_type":"OnDuty",
                    "approve_id":1,
                    "userid":"0001",
                    "class_id":1,
                    "class_setting_id":1,
                    "plan_check_time":"2017-04-11 11:11:11",
                    "group_id":1
            }
        ],
        "has_more":false
    },
    "errmsg":"ok",
    "errcode":0
}
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
result
└ schedules 排班列表
└└ plan_id 排班id
└└ check_type 打卡类型,OnDuty表示上班打卡,OffDuty表示下班打卡
└└ approve_id 审批id,结果集中没有的话表示没有审批单
└└ userid userId
└└ class_id 考勤班次id
└└ class_setting_id 班次配置id,结果集中没有的话表示使用全局班次配置
└└ plan_check_time 打卡时间
└└ group_id 考勤组id
└ has_more 分页用,表示是否还有下一页
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!