获取员工到勤情况

本文档介绍如何获取员工考勤打卡信息。

接入流程简介

本文介绍了创建一个企业内部应用，使用考勤事件和考勤组管理提供的API，实现获取员工到勤情况等。

步骤一：登录开发者后台，点击应用开发-企业内部开发，创建企业内部应用。

步骤二：单击基础信息 > 应用信息，获取应用AppKey和AppSecret。

步骤三：添加接口调用权限。单击“考勤”，申请考勤接口对应的权限。

步骤四：获取应用访问凭证获取企业内部应用的access_token。调用接口时，通过accessToken鉴权调用者身份。

步骤五：相关调用流程：

调用考勤服务端API-批量获取考勤组详情接口，获取企业考勤组内的排班上下班时间。

获取员工考勤打卡情况，需要注册企业考勤事件回调，参考文档配置事件订阅，并订阅考勤事件。

成功注册企业考勤事件回调后，企业内员工上班执行打卡即可实时产生回调。

根据实时推送的打卡信息userId、groupId、checkTime值跟获取的考勤组内排班打卡时间对比即可得到该员工打卡是正常打卡还是迟到打卡。

步骤一：创建企业内部应用

说明

如果已有企业内部应用，可直接使用已有应用，可忽略此步骤。

登录开发者后台，创建企业内部应用。

应用类型：选择H5微应用。

开发方式：选择企业自主开发。

步骤二：获取AppKey和AppSecret

获取应用AppKey和AppSecret信息。

步骤三：添加接口权限

添加接口调用权限。单击“考勤”，申请考勤接口权限。

步骤四：获取应用访问凭证accessToken

重要

服务端API差异详情参见新旧版规范服务端API区别。

服务端API接口SDK下载，详情参见服务端SDK下载。

新版服务端API接口SDK下载，详情参见新版服务端SDK下载。

以下接口均使用服务端API接口，SDK下载详情参见服务端SDK下载。

根据步骤二中的AppKey和AppSecret，获取应用访问凭证获取企业内部应用的access_token。

public void getAccessToken() throws ApiException {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/gettoken");
        OapiGettokenRequest req = new OapiGettokenRequest();
        req.setAppkey("dingxxxxxxxxxhgn");
        req.setAppsecret("9G_xxxxxxxxxxxxxxx1JDf0Qq3nexxxxxxxxGIO");
        req.setHttpMethod("GET");
        OapiGettokenResponse rsp = client.execute(req);
        System.out.println(rsp.getBody());
    }

步骤五：相关调用流程

调用考勤服务端API-批量获取考勤组详情接口，获取企业考勤组内的排班上下班时间。

public void batchAttendanceGroupInfo() throws ApiException {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/getsimplegroups");
        OapiAttendanceGetsimplegroupsRequest req = new OapiAttendanceGetsimplegroupsRequest();
        req.setOffset(0L);
        req.setSize(10L);
        OapiAttendanceGetsimplegroupsResponse rsp = client.execute(req, "access_token");
        System.out.println(rsp.getBody());
    }

获取员工考勤打卡情况，需要注册企业考勤事件回调，参考文档配置事件订阅，并订阅考勤事件。

成功注册企业考勤事件回调后，企业内员工上班执行打卡即可实时产生回调，接收到的回调信息如下。

      {
            "DataList":[
            {
                    //打卡员工的userId值
                    "userId":"0126xxxx",
                    //员工执行打卡时间，单位毫秒
                    "checkTime":1570791880000,
                    //执行打卡时的地址
                    "address":"中国科学院工程热物理研究所（浙江海外高层次人才创新园7幢东）",
                    //企业corpId
                    "corpId":"dingxxxx",
                    //该员工所在的考勤组ID
                    "groupId":"4C63xxxx",
                    //打卡地址对应的纬度
                    "latitude":30.285230848524307,
                    //打卡地址对应的经度
                    "longitude":120.01713514539931,
                    //打卡业务ID
                    "bizId":"FF62xxxx",
                    //定位方法
                    "locationMethod":"MAP",
            }
    ],
            "EventType":"attendance_check_record"
        }

根据实时推送的打卡信息userId、groupId、checkTime值跟获取的考勤组内排班打卡时间对比即可得到该员工打卡是正常打卡还是迟到打卡。

获取员工到勤情况

接入流程简介#

步骤一：创建企业内部应用#

步骤二：获取AppKey和AppSecret#

步骤三：添加接口权限#