概述 - 钉钉 API

本文介绍了考勤打卡开放接口的能力以及如何接入考勤相关接口。

什么是考勤

考勤打卡是钉钉的官方应用，致力于为企业提供软硬一体的员工考勤管理的解决方案，随时随地了解团队状态，出勤人员一目了然；**智能统计考勤数据，**一键下载，无需人工核算，更多介绍请参见钉钉使用手册-考勤。

具备以下特点：

打卡方式丰富，覆盖多种考勤场景：支持GPS定位，WiFi定位，蓝牙定位，考勤机打卡等软硬一体的打卡方式。

内外勤统一管理，数据统计更便捷：支持外勤打卡，对于临时外出，外地出差的员工考勤也能有效管理。

假勤审批关联，算工资一张表搞定：请假，加班，外出，出差审批自动汇总计算，避免多张报表反复校验。

如何开通考勤

考勤是钉钉默认安装的官方应用。员工可以在钉钉工作台打开应用并使用。

手机端：钉钉手机客户端-工作台

电脑端：钉钉电脑客户端-工作台

考勤接口能力

考勤提供了丰富的接口开放能力，开发者通过API接口可以实现考勤和企业业务系统打通。

考勤组管理

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
创建考勤组	调用本接口创建考勤组。	-	创建考勤组
更新考勤组	调用本接口根据考勤组id更新考勤组信息。	-	更新考勤组
删除考勤组	调用本接口批量删除考勤组。	-	删除考勤组
搜素考勤组摘要	调用本接口按考勤组名称模糊搜索，获取考勤组摘要信息。	-	搜索考勤组摘要
获取考勤组详情	调用本接口根据考勤组ID获取考勤组详情。	-	获取考勤组详情
根据groupkey查询考勤组信息	调用本接口根据考勤组id查询考勤组信息。	-	根据groupKey查询考勤组信息
groupKey转换为groupId	调用本接口将考勤组的groupKey转换为groupId。	-	groupKey转换为groupId
groupId转换为groupKey	调用本接口将考勤组的groupId转换为groupKey。	-	groupId转换为groupKey
批量获取考勤组摘要	调用本接口分页获取企业内所有考勤组摘要信息。	-	批量获取考勤组摘要
批量获取考勤组详情	调用本接口查询所有的考勤组详情信息。	-	批量获取考勤组详情
获取用户考勤组	调用本接口获取员工的考勤组信息。	-	获取用户考勤组
批量新增参与考勤人员	调用本接口在指定的考勤组下批量新增考勤组成员。	-	批量新增参与考勤人员
更新参与考勤人员	调用本接口更新考勤组成员，支持新增或删除人员、部门、无需考勤人员。	-	更新参与考勤人员
获取参与考勤人员	调用本接口通过操作人的userid和考勤组id获取当前考勤组下的成员信息。	-	获取参与考勤人员
获取参与考勤人员的userid	调用本接口分页获取某个考勤组下的所有员工的userId。	-	获取参与考勤人员的userid
批量删除参与考勤人员	调用本接口批量删除指定考勤组下的考勤组成员。	-	批量删除参与考勤人员
查询参与考勤人员列表	调用本接口查询指定考勤组下的员工列表。	-	查询参与考勤人员列表
校验用户是否在当前考勤组	调用本接口校验某个部门或者员工是否属于某个考勤组，返回值为属于这个考勤组的部门ID或者员工ID。	-	校验用户是否在当前考勤组
批量新增Wi-Fi信息	调用本接口为指定考勤组批量新增wifi信息。	-	批量新增Wi-Fi信息
批量查询Wi-Fi信息	调用本接口批量查询指定考勤组下的wifi列表信息。	-	批量查询Wi-Fi信息
批量移除Wi-Fi信息	调用本接口批量移除指定考勤组的wifi信息。	-	批量移除Wi-Fi信息
批量新增地点	调用本接口在指定考勤组下批量新增position。	-	批量新增地点
批量查询地点	调用本接口批量查询指定考勤组下的position列表信息。	-	批量查询地点
批量删除地点	调用本接口在指定考勤组下批量删除position。	-	批量删除地点
查询考勤写操作权限	用于查询企业员工在考勤组内的操作权限。	查询考勤写操作权限	-

考勤打卡

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
获取打卡结果	调用本接口返回企业内员工的实际打卡结果。	-	获取打卡结果
获取打卡详情	调用本接口返回企业内员工的实际打卡详情。	-	获取打卡详情

考勤班次

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
创建班次	调用本接口创建钉钉考勤班次。	-	创建班次
删除班次	调用本接口根据班次ID删除考勤班次。	-	删除班次
按名称搜索班次	调用本接口根据名称模糊搜索班次，返回班次名称和ID信息。	-	按名称搜索班次
获取班次摘要信息	调用本接口查询所有的班次信息。	-	获取班次摘要信息
获取班次详情	调用本接口根据班次ID查询班次的详细信息。	-	获取班次详情
查询历史班次	调用本接口根据班次ID和version查询历史班次信息。	-	查询历史班次
修改打卡时段设置	调用本接口修改考勤班次卡点的设置信息。	-	修改打卡时段设置

考勤排班

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
查询成员排班信息	调用本接口查询某人在某工作日的排班信息。	-	查询成员排班信息
批量查询人员排班信息	调用本接口批量查询员工在工作日内的排班信息。	-	批量查询人员排班信息
排班制考勤组排班	调用此接口给排班制考勤组成员进行排班。	-	排班制考勤组排班
查询排班打卡结果	调用本接口查询排班的打卡结果，打卡结果包含打卡时间、迟到、早退、内勤及外勤等信息。	-	查询排班打卡结果
查询企业考勤排班详情	调用本接口查询某天的考勤排班信息。	-	查询企业考勤排班详情
批量查询成员排班概要信息	调用本接口查询用户在某个时间段内的排班概要信息。	-	批量查询成员排班概要信息

考勤规则

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
分页获取加班规则列表	调用本接口分页获取考勤打卡中设置的加班规则列表。	分页获取加班规则列表	-
分页获取补卡规则列表	调用本接口分页获取考勤打卡中设置的补卡规则列表。	分页获取补卡规则列表	-
批量获取加班规则设置	调用本接口用于根据多个加班规则ID，批量获取加班规则设置详情。	批量获取加班规则设置	-

考勤统计

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
查询是否启用智能统计报表	调用本接口判断企业是否开启了考勤智能报表，如果企业未启用智能报表，无法调用统计报表其他的接口。	-	查询是否启用智能统计报表
获取用户考勤数据	调用本接口获取指定用户当天的考勤数据，包括打卡流水记录、打卡结果和审批列表等。	-	获取用户考勤数据
获取报表假期数据	调用本接口根据假期名称和用户ID获取钉钉智能考勤报表的假期数据。	-	获取报表假期数据
获取考勤报表列定义	调用本接口获取企业智能考勤报表中的列信息。	-	获取考勤报表列定义
获取考勤报表列值	调用本接口用于获取钉钉智能考勤报表的列值数据。	-	获取考勤报表列值
查询用户某段时间内是否处于封账状态	调用本接口查询员工一段时间内是否处于封账状态，如果处于封账状态，不能发起审批、排班、换班等操作。	查询用户某段时间内是否处于封账状态	-

考勤机管理

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
查询员工智能考勤机列表	调用本接口查询员工智能考勤机列表。	-	查询员工智能考勤机列表
根据设备ID获取员工信息	调用本接口根据考勤机设备ID查询这台考勤机设备上的员工信息。	根据设备ID获取员工信息	-
查询考勤机信息	调用本接口根据考勤机设备ID查询这台考勤机的相关信息。	查询考勤机信息	-
变更智能考勤机员工	调用本接口变更智能考勤机员工。	变更智能考勤机员工	-

假期审批

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
通知审批通过	调用本接口通知审批通过，支持加班、请假、外出和出差类型。	-	通知审批通过
通知审批撤销	调用本接口通知审批撤销，支持加班、请假、外出、出差和补卡类型。	-	通知审批撤销
通知补卡通过	调用本接口通知考勤补卡通过。	-	通知补卡通过
通知换班通过	通过本接口换班审批通过后，通知考勤执行换班动作，可以和自己换班，也可以和别人换班。	-	通知换班通过
预计算时长	调用本接口根据考勤系统的排班情况，预计算员工加班、出差及请假的时长信息。	-	预计算时长
计算请假时长	调用本接口获取自动根据排班规则统计出每个员工的请假时长。	-	计算请假时长
查询请假状态	调用本接口查询指定企业下指定用户在指定时间段内的请假状态。	-	查询请假状态

假期管理

API	说明	新版规范（新版服务端API）	旧版规范（服务端API）
添加假期规则	调用本接口新建一个假期规则。	添加假期规则	添加假期规则
更新假期规则	调用本接口更新指定假期的相关规则。	更新假期规则	更新假期规则
删除假期规则	调用本接口删除指定的假期规则。	-	删除假期规则
查询假期规则列表	调用本接口查询企业内的假期规则列表。	-	查询假期规则列表
初始化假期余额	调用本接口批量初始化假期余额。	-	初始化假期余额
查询假期余额	调用本接口根据企业或员工分页获取假期余额信息，每次返回50条数据。	-	查询假期余额
批量更新假期余额	调用本接口批量更新假期余额信息。	-	批量更新假期余额
批量查询员工假期余额变更记录	调用本接口根据员工分页获取假期余额记录信息。	-	批量查询员工假期余额变更记录