第三方应用开发 服务端API 打卡 获取打卡日报数据
获取打卡日报数据
最后更新:2023/12/18
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取打卡日报数据
最后更新:2023/12/18

企业可通过具有调用权限的应用,获取应用可见范围内指定员工指定日期内的打卡日报统计数据。

请求方式: POST(HTTPS)

请求地址: https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckin_daydata?access_token=ACCESS_TOKEN

请求示例

{
    "starttime": 1599062400,
    "endtime": 1599062400,
    "useridlist": [
        "ZhangSan"
    ]
}

参数说明:

参数必须类型说明
access_tokenstring调用接口凭证,获取方式参考:文档-获取access_token
starttimeuint32获取日报的开始时间。0点Unix时间戳
endtimeuint32获取日报的结束时间。0点Unix时间戳
useridliststring[]获取日报的userid列表。
单个userid不少于1字节,不多于64字节
可填充个数:1 ~ 100

调用频率:
接口调用频率限制为100次/分钟。

权限说明:
调用的应用需要满足如下的权限:

应用类型权限要求
自建应用配置到「打卡 - 可调用接口的应用」中
代开发应用具有「打卡」权限
第三方应用具有「打卡」权限

注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情

返回结果:

{
    "errcode":0,
    "errmsg":"ok",
    "datas":[
        {
            "base_info":{
                "date":1599062400,
                "record_type":1,
                "name":"张三",
                "name_ex":"Three Zhang",
                "departs_name":"有家企业/realempty;有家企业;有家企业/部门A4",
                "acctid":"ZhangSan",
                "rule_info":{
                    "groupid":10,
                    "groupname":"规则测试",
                    "scheduleid":0,
                    "schedulename":"",
                    "checkintime":[
                        {
                            "work_sec":38760,
                            "off_work_sec":38880
                        }
                    ]
                },
                "day_type":0
            },
            "summary_info":{
                "checkin_count":2,
                "regular_work_sec":31,
                "standard_work_sec":120,
                "earliest_time":38827,
                "lastest_time":38858
            },
            "holiday_infos":[
                {
                    "sp_description":{
                        "data":[
                            {
                                "lang":"zh_CN",
                                "text":"09/03 10:00~09/03 10:01"
                            }
                        ]
                    },
                    "sp_number":"202009030002",
                    "sp_title":{
                        "data":[
                            {
                                "lang":"zh_CN",
                                "text":"请假0.1小时"
                            }
                        ]
                    }
                },
                {
                    "sp_description":{
                        "data":[
                            {
                                "lang":"zh_CN",
                                "text":"08/25 14:37~09/10 14:37"
                            }
                        ]
                    },
                    "sp_number":"202008270004",
                    "sp_title":{
                        "data":[
                            {
                                "lang":"zh_CN",
                                "text":"加班17.0小时"
                            }
                        ]
                    }
                }
            ],
            "exception_infos":[
                {
                    "count":1,
                    "duration":60,
                    "exception":1
                },
                {
                    "count":1,
                    "duration":60,
                    "exception":2
                }
            ],
            "ot_info":{
                "ot_status":1,
                "ot_duration":3600,
                "exception_duration":[],
				"workday_over_as_money": 54000
            },
            "sp_items":[
                {
                    "count":1,
                    "duration":360,
                    "time_type":0,
                    "type":1,
                    "vacation_id":2,
					"name":"年假",
                },
                {
                    "count":0,
                    "duration":0,
                    "time_type":0,
                    "type":100,
                    "vacation_id":0
					"name":"外勤次数"
                }
            ]
        }
    ]
}

参数说明:

参数类型说明
errcodeint32返回码
errmsgstring错误码描述
datasobj[]日报数据列表
datas.base_infoobj基础信息
datas.base_info.dateuint32日报日期
datas.base_info.record_typeuint32记录类型:1-固定上下班;2-外出(此报表中不会出现外出打卡数据);3-按班次上下班;4-自由签到;5-加班;7-无规则
datas.base_info.namestring打卡人员姓名
datas.base_info.name_exstring打卡人员别名
datas.base_info.departs_namestring打卡人员所在部门,会显示所有所在部门
datas.base_info.acctidstring打卡人员账号,即userid
datas.base_info.rule_infoobj打卡人员所属规则信息
datas.base_info.rule_info.groupidint32所属规则的id
datas.base_info.rule_info.groupnamestring打卡规则名
datas.base_info.rule_info.scheduleidint32当日所属班次id,仅按班次上下班才有值,显示在打卡日报-班次列
datas.base_info.rule_info.schedulenamestring当日所属班次名称,仅按班次上下班才有值,显示在打卡日报-班次列
datas.base_info.rule_info.checkintimeobj[]当日打卡时间,仅固定上下班规则有值,显示在打卡日报-班次列
datas.base_info.rule_info.checkintime.work_secuint32上班时间,为距离0点的时间差
datas.base_info.rule_info.checkintime.off_work_secuint32下班时间,为距离0点的时间差
datas.base_info.day_typeuint32日报类型:0-工作日日报;1-休息日日报
datas.summary_infoobj汇总信息
datas.summary_info.checkin_countint32当日打卡次数
datas.summary_info.regular_work_secint32当日实际工作时长,单位:秒
datas.summary_info.standard_work_secint32当日标准工作时长,单位:秒
datas.summary_info.earliest_timeint32当日最早打卡时间
datas.summary_info.lastest_timeint32当日最晚打卡时间
datas.holiday_infosobj[]假勤相关信息
datas.holiday_infos.sp_numberstring假勤申请id,即当日关联的假勤审批单id
datas.holiday_infos.sp_titleobj假勤信息摘要-标题信息
datas.holiday_infos.sp_title.dataobj[]多种语言描述,目前只有中文一种
datas.holiday_infos.sp_title.data.textstring假勤信息摘要-标题文本
datas.holiday_infos.sp_title.data.langstring语言类型:"zh_CN"
datas.holiday_infos.sp_descriptionobj假勤信息摘要-描述信息
datas.holiday_infos.sp_description.dataobj[]多种语言描述,目前只有中文一种
datas.holiday_infos.sp_description.data.textstring假勤信息摘要-描述文本
datas.holiday_infos.sp_description.data.langstring语言类型:"zh_CN"
datas.exception_infosobj[]校准状态信息
datas.exception_infos.exceptionuint32校准状态类型:1-迟到;2-早退;3-缺卡;4-旷工;5-地点异常;6-设备异常
datas.exception_infos.countint32当日此异常的次数
datas.exception_infos.durationint32当日此异常的时长(迟到/早退/旷工才有值)
datas.ot_infoobj加班信息
datas.ot_info.ot_statusuint32状态:0-无加班;1-正常;2-缺时长
datas.ot_info.ot_durationuint32加班时长
datas.ot_info.exception_durationuint32[]ot_status为2下,加班不足的时长
datas.ot_info.workday_over_as_vacationint32工作日加班记为调休,单位秒
datas.ot_info.workday_over_as_moneyint32工作日加班记为加班费,单位秒
datas.ot_info.restday_over_as_vacationint32休息日加班记为调休,单位秒
datas.ot_info.restday_over_as_moneyint32休息日加班记为加班费,单位秒
datas.ot_info.holiday_over_as_vacationint32节假日加班记为调休,单位秒
datas.ot_info.holiday_over_as_moneyint32节假日加班记为加班费,单位秒
datas.sp_itemsobj[]假勤统计信息
datas.sp_items.typeuint32类型:1-请假;2-补卡;3-出差;4-外出;100-外勤
datas.sp_items.vacation_iduint32具体请假类型,当type为1请假时,具体的请假类型id,可通过审批相关接口获取假期详情
datas.sp_items.countuint32当日假勤次数
datas.sp_items.durationuint32当日假勤时长秒数,时长单位为天直接除以86400即为天数,单位为小时直接除以3600即为小时数
datas.sp_items.time_typeuint32时长单位:0-按天 1-按小时
datas.sp_items.namestring统计项名称
上一篇
获取打卡记录数据
下一篇
获取打卡月报数据