考勤补卡操作流程

本文档介绍提交补卡申请，并将信息同步到钉钉考勤。考勤补卡审批通过后，该员工的缺卡状态修改为补卡通过。

说明

本文档以企业内部应用实现为例，第三方企业应用实现流程与本文档流程一致。

预期效果

接入流程简介

本文介绍了创建一个企业内部应用，使用提供的假勤审批中考勤补卡等API，实现把企业自有考勤系统提交的补卡信息同步到钉钉考勤中，修改钉钉考勤的缺卡为补卡。

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

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

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

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

步骤五：调用考勤相关API：

员工在自有考勤系统提交补卡申请时，根据员工选择的补卡日期调用服务端API-查询成员排班信息接口，获取对应日期该员工的排班打卡时间点。

员工使用自有假勤系统发起补卡审批单，审批结果不同，触发的操作不同。

（1）如果审批通过，调用服务端API-通知补卡通过接口，提交的补卡信息会同步到钉钉考勤应用，考勤状态从缺卡修改为补卡通过。

说明

本步骤不会在钉钉中产生补卡审批单。

（2）如果员工撤销了补卡申请，可以调用服务端API-通知审批撤销接口，撤销已同步到钉钉的补卡审申请，考勤状态恢复到修改之前的打卡状态。

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

说明

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

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

应用类型：选择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

员工在自有考勤系统提交补卡申请时，根据员工选择的补卡日期调用服务端API-查询成员排班信息接口，获取对应日期该员工的排班打卡时间点。

 public void scheduleInfo() throws ApiException {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/schedule/listbyday");
        OapiAttendanceScheduleListbydayRequest req = new OapiAttendanceScheduleListbydayRequest();
        req.setOpUserId("ma******75");
        req.setUserId("014*********041");
        req.setDateTime(166*******00L);
        OapiAttendanceScheduleListbydayResponse rsp = client.execute(req, "access_token");
        System.out.println(rsp.getBody());
    }

员工使用自有假勤系统发起补卡审批单，审批结果不同，触发的操作不同。

（1）如果审批通过，调用服务端API-通知补卡通过接口，提交的补卡信息会同步到钉钉考勤应用，考勤状态从缺卡修改为补卡通过。

 public void approveCheck() throws ApiException {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/approve/check");
        OapiAttendanceApproveCheckRequest req = new OapiAttendanceApproveCheckRequest();
        req.setUserid("ma****75");
        req.setWorkDate("2022-10-10 09:00:00");
        req.setPunchId(1006170802L);
        req.setPunchCheckTime("2022-10-10 09:00:00");
        req.setUserCheckTime("2022-10-10 08:00:00");
        req.setApproveId("dingTalk10001");
        req.setJumpUrl("https://www.dingtalk.com");
        req.setTagName("补卡");
        OapiAttendanceApproveCheckResponse rsp = client.execute(req, "access_token");
        System.out.println(rsp.getBody());
    }

说明

本步骤不会在钉钉中产生补卡审批单。

（2）如果员工撤销了补卡申请，可以调用服务端API-通知审批撤销接口，撤销已同步到钉钉的补卡审申请，考勤状态恢复到修改之前的打卡状态。

public void approveCancel() throws ApiException {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/approve/cancel");
        OapiAttendanceApproveCancelRequest req = new OapiAttendanceApproveCancelRequest();
        req.setUserid("ma****75");
        req.setApproveId("dingTalk10001");
        OapiAttendanceApproveCancelResponse rsp = client.execute(req, "access_token");
        System.out.println(rsp.getBody());
    }

考勤补卡操作流程

预期效果#

接入流程简介#

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

步骤二：获取AppKey和AppSecret#

步骤三：添加接口权限#

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