企业自有假勤审批同步到钉钉

本文档介绍企业使用自有OA审批系统如何同步到钉钉的OA审批。

说明

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

接入流程简介

本文介绍了创建一个企业内部应用，使用假勤审批提供的API，实现企业将自有假勤系统的审批单，同步到钉钉。

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

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

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

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

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

说明

该功能支持企业自研系统的加班、出差和请假信息与钉钉同步。

调用服务端API-预计算时长接口，实现根据考勤系统的排班情况，预计算员工加班、出差及请假的时长信息。

在企业自有审批系统提交了假勤申请，审批通过后通过该接口通知钉钉考勤，调用服务端API-通知审批通过接口，实现钉钉考勤同步通过。保存自定义审批单IDapprove_id。

在企业自有审批系统提交了撤销假勤申请，根据自定义审批单IDapprove_id，调用服务端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-预计算时长接口，实现根据考勤系统的排班情况，预计算员工加班、出差及请假的时长信息。

说明

该步骤不可跳过，自有系统内的审批单信息同步到钉钉。

例如，小明在10月15日的排班是8小时，10月16日的排班是4小时，如果正常上班，小明在10月15日、16日这2天的工作时间是12小时。

小明在企业自有系统内提交请假审批单时，以下各情况，可提交的请假时长不同：

情况一，选择请假开始时间是10月15日，结束时间是10月15日；调用预计算时长接口，获取的可提交请假时长最大是8小时。

情况二，选择请假开始时间是10月15日，结束时间是10月16日，调用预计算时长接口，获取的可提交请假时长最大是12小时。

public void durationCalculate() throws ApiException {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/approve/duration/calculate");
        OapiAttendanceApproveDurationCalculateRequest req = new OapiAttendanceApproveDurationCalculateRequest();
        req.setUserid("01472825524039877041");
        req.setBizType(2L);
        req.setFromTime("2022-10-13 09:00");
        req.setToTime("2022-10-13 18:00");
        req.setDurationUnit("hour");
        req.setCalculateModel(1L);
        OapiAttendanceApproveDurationCalculateResponse rsp = client.execute(req,"access_token");
        System.out.println(rsp.getBody());
    }

在企业自有审批系统提交了假勤申请，审批通过后通过该接口通知钉钉考勤，调用服务端API-通知审批通过接口，实现钉钉考勤同步通过，保存自定义审批单IDapprove_id。

说明

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

 public void approveFinish() throws ApiException {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/approve/finish");
        OapiAttendanceApproveFinishRequest req = new OapiAttendanceApproveFinishRequest();
        req.setUserid("01472825524039877041");
   			//本示例使用外出
        req.setBizType(2L);
        req.setFromTime("2022-10-13 09:00");
        req.setToTime("2022-10-13 19:00");
        req.setDurationUnit("hour");
        req.setCalculateModel(1L);
        req.setTagName("外出");
        req.setApproveId("dingTalk");
        req.setJumpUrl("https://xxx.xxx");
        OapiAttendanceApproveFinishResponse rsp = client.execute(req, "access_token");
        System.out.println(rsp.getBody());
    }

在企业自有审批系统提交了撤销假勤申请，根据自定义审批单IDapprove_id，调用服务端API-通知审批撤销接口，实现钉钉考勤同步撤销。

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

企业自有假勤审批同步到钉钉

接入流程简介#

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

步骤二：获取AppKey和AppSecret#

步骤三：添加接口权限#