开放接口API说明-考勤相关接口

获取考勤记录数据接口

请求地址: https://openapi.waiqin365.com/api/attDetail/v1/getAttUserDetail/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体:

{
    "startDate": "2016-11-01",
    "endDate": "2016-11-31"
}

请求信息

参数 类型 必填 说明
startDate VARCHAR(10) 开始日期,格式:“yyyy-MM-dd”
endDate VARCHAR(10) 结束日期,格式:“yyyy-MM-dd”
page int 分页-页数
size int 分页-每页记录条数

返回结果:

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": "成功",
    "response_data": {
        "maxFrequnce": 3,   // 考勤组数量
        "data": [
            {
                "deptId": "5451675706331206298",      // 部门ID
                "deptName": "成功运维测试",            // 部门名称
                "deptCode": "",                       // 部门编码
                "deptSourceCode": "",                 // 部门来源编码
                "empCode": "zhouhaifeng",             // 员工账号
                "empId": "4614317478245645296",       // 员工ID
                "empName": "周海丰",                   // 员工名称
                "empSourceCode": "",                  // 员工来源编码
                "groupName": "",                      // 考勤组名称
                "positionName": "总经理",              // 职位
                "registerDate": "2016-12-06 00:00",   // 考勤日期
                "sex": "M",                           // 性别
                "absentDay": "1.00",                  // 当天的旷工天数
                "absentTimes": "540",                 // 缺勤时长
                "workTimes": "0",                     // 工作总时长
                // 第一组签退信息
                "firstOffLcError": "",      // 考勤一下班是否脱岗 0:正常;1:脱岗
                "firstOffLcOffset": "",     // 考勤一下班位置偏差
                "firstOffLieLocate": "",    // 考勤一下班定位是不是虚假模拟位置 0:非虚假模拟位置,1:虚假模拟位置
                "firstOffLocateType": "",   // 考勤一下班定位类型 1:GPS;2:基站定位
                "firstOffLocationA": "",    // 考勤一下班地标信息
                "firstOffNearstPoint": "",  // 考勤一下班最近考勤点
                "firstOffPictures": "",     // 考勤一下班照片路径
                "firstOffRemarks": "",      // 考勤一下班备注
                "firstOffRgTime": "",       // 考勤一下班时间
                "firstOffRqTime": "",       // 考勤一要求下班时间
                "firstOffStatus": "",       // 考勤一下班状态 0:正常;1:早退;2:异常
                "firstOffTimeOffset": "",   // 考勤一下班时间偏差
                // 第一组签到信息
                "firstOnLcError": "",       // 考勤一上班是否脱岗 0:正常;1:脱岗
                "firstOnLcOffset": "",      // 考勤一上班位置偏差
                "firstOnLieLocate": "",     // 考勤一上班定位是不是虚假模拟位置 0:非虚假模拟位置,1:虚假模拟位置
                "firstOnLocateType": "",    // 考勤一上班定位类型 1:GPS;2:基站定位
                "firstOnLocationA": "",     // 考勤一上班地标信息
                "firstOnNearstPoint": "",   // 考勤一上班最近考勤点
                "firstOnPictures": "",      // 考勤一上班照片路径
                "firstOnRemarks": "",       // 考勤一上班备注
                "firstOnRgTime": "",        // 考勤一上班时间
                "firstOnRqTime": "",        // 考勤一要求上班时间
                "firstOnStatus": "",        // 考勤一上班状态 0:正常;1:迟到;2:异常
                "firstOnTimeOffset": "",    // 考勤一上班时间偏差
                "id": 0,// 
                // 第二组签退信息
                "secondOffLcError": "",     // 考勤一下班是否脱岗 0:正常;1:脱岗
                "secondOffLcOffset": "",    // 考勤一下班位置偏差
                "secondOffLieLocate": "",   // 考勤一下班定位是不是虚假模拟位置 0:非虚假模拟位置,1:虚假模拟位置
                "secondOffLocateType": "",  // 考勤一下班定位类型 1:GPS;2:基站定位
                "secondOffLocationA": "",   // 考勤一下班地标信息
                "secondOffNearstPoint": "", // 考勤一下班最近考勤点
                "secondOffPictures": "",    // 考勤一下班照片路径
                "secondOffRemarks": "",     // 考勤一下班备注
                "secondOffRgTime": "",      // 考勤一下班时间
                "secondOffRqTime": "",      // 考勤一要求下班时间
                "secondOffStatus": "",      // 考勤一下班状态 0:正常;1:早退;2:异常
                "secondOffTimeOffset": "",  // 考勤一下班时间偏差
                // 第二组签到信息
                "secondOnLcError": "",      // 考勤一上班是否脱岗 0:正常;1:脱岗
                "secondOnLcOffset": "",     // 考勤一上班位置偏差
                "secondOnLieLocate": "",    // 考勤一上班定位是不是虚假模拟位置 0:非虚假模拟位置,1:虚假模拟位置
                "secondOnLocateType": "",   // 考勤一上班定位类型 1:GPS;2:基站定位
                "secondOnLocationA": "",    // 考勤一上班地标信息
                "secondOnNearstPoint": "",  // 考勤一上班最近考勤点
                "secondOnPictures": "",     // 考勤一上班照片路径
                "secondOnRemarks": "",      // 考勤一上班备注
                "secondOnRgTime": "",       // 考勤一上班时间
                "secondOnRqTime": "",       // 考勤一要求上班时间
                "secondOnStatus": "",       // 考勤一上班状态 0:正常;1:迟到;2:异常
                "secondOnTimeOffset": "",   // 考勤一上班时间偏差
                // 第三组签退信息
                "thirdOffLcError": "",      // 考勤一下班是否脱岗 0:正常;1:脱岗
                "thirdOffLcOffset": "",     // 考勤一下班位置偏差
                "thirdOffLieLocate": "",    // 考勤一下班定位是不是虚假模拟位置 0:非虚假模拟位置,1:虚假模拟位置
                "thirdOffLocateType": "",   // 考勤一下班定位类型 1:GPS;2:基站定位
                "thirdOffLocationA": "",    // 考勤一下班地标信息
                "thirdOffNearstPoint": "",  // 考勤一下班最近考勤点
                "thirdOffPictures": "",     // 考勤一下班照片路径
                "thirdOffRemarks": "",      // 考勤一下班备注
                "thirdOffRgTime": "",       // 考勤一下班时间
                "thirdOffRqTime": "",       // 考勤一要求下班时间
                "thirdOffStatus": "",       // 考勤一下班状态 0:正常;1:早退;2:异常
                "thirdOffTimeOffset": "",   // 考勤一下班时间偏差
                // 第三组签到信息
                "thirdOnLcError": "",       // 考勤一上班是否脱岗 0:正常;1:脱岗
                "thirdOnLcOffset": "",      // 考勤一上班位置偏差
                "thirdOnLieLocate": "",     // 考勤一上班定位是不是虚假模拟位置 0:非虚假模拟位置,1:虚假模拟位置
                "thirdOnLocateType": "",    // 考勤一上班定位类型 1:GPS;2:基站定位
                "thirdOnLocationA": "",     // 考勤一上班地标信息
                "thirdOnNearstPoint": "",   // 考勤一上班最近考勤点
                "thirdOnPictures": "",      // 考勤一上班照片路径
                "thirdOnRemarks": "",       // 考勤一上班备注
                "thirdOnRgTime": "",        // 考勤一上班时间
                "thirdOnRqTime": "",        // 考勤一要求上班时间
                "thirdOnStatus": "",        // 考勤一上班状态 0:正常;1:迟到;2:异常
                "thirdOnTimeOffset": ""     // 考勤一上班时间偏差
            }
        ]
    }
}

响应信息

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他参照附件错误码
return_msg String 响应说明
response_data String 数据格式参照示例

获取考勤明细统计数据接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/attStatistics/v1/getUserStatistic/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体:

{
    "startDate": "2016-11-01",
    "endDate": "2016-11-31"
}

请求信息

参数 类型 必填 说明
startDate VARCHAR(10) 开始日期,格式:“yyyy-MM-dd”
endDate VARCHAR(10) 结束日期,格式:“yyyy-MM-dd”
page int 分页-页数
size int 分页-每页记录条数

返回结果:

{"msg_id": "X000001","return_code": 0,"return_msg": "成功","response_data": {"maxFrequnce": 3,   // 考勤组数量"data": [{"deptName": "部门三",               // 部门名称"userId": "6642001518209655480",   // 员工编码"empName": "",                     // 职位名称"sex": "M",                        //  性别 M:男 F:女"userName": "flow_05",             // 姓名"group": "默认考勤组",              // 考勤组名称"code": "flow_05",                 // 工号// 考勤数据"attendance": [{// 签到数据(根据maxFrequnce改变数量,最多三组)"checkin": [{"attdLieLocate": "0",                    // 定位是否虚假模拟位置 0:非虚假模拟位置,1:虚假模拟位置"attdAddress": "安徽省铜陵市铜陵县X008",   // 打卡位置"attdLcError": "1",                      // 是否脱岗 0:正常;1:脱岗"attdStatus": "2",                       // 考勤状态 0:正常;1:迟到;2:异常"attdTime": "2016-12-05 19:21:00"        // 考勤时间},{"attdTime": "",                          // 考勤时间"attdAddress": ""                        // 打卡位置},{"attdTime": "",                          // 考勤时间"attdAddress": ""                        // 打卡位置}],"attDate": "2016-12-05",                         // 考勤日期"workTime": " 1.00",                             // 工作时长(默认0.00)"remarks": "出差",                               // 备注信息// 签退数据(根据maxFrequnce改变数量,最多三组)"checkout": [{"attdLieLocate": "0",                    // 定位是否虚假模拟位置 0:非虚假模拟位置,1:虚假模拟位置"attdAddress": "安徽省铜陵市铜陵县X008",   // 打卡位置"attdLcError": "1",                      // 是否脱岗 0:正常;1:脱岗"attdStatus": "2",                       // 考勤状态 0:正常;1:迟到;2:异常"attdTime": "2016-12-05 20:21:00"        // 考勤时间},{"attdTime": "",                          // 考勤时间"attdAddress": ""                        // 打卡位置},{"attdTime": "",                          // 考勤时间"attdAddress": ""                        // 打卡位置}]}]}]}
}

响应信息

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他参照附件错误码
return_msg String 响应说明
response_data String 数据格式参照示例

获取考勤人员统计数据接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/userStatistics/v1/getUserStatistics/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体:

{
	"startDate":"2016-07-20",
	"endDate":"2016-07-22",
	"empIds":"1200235510200010120",
	"empPositions":"8760235510200015420",
	"attGroupIds":"8760235510200015420",
	"deptId":"8760235510200015420"	
}

请求信息

参数 类型 必填 说明
startDate VARCHAR(10) 开始日期,格式:yyyy-MM-dd
endDate VARCHAR(10) 结束日期,格式:yyyy-MM-dd
page int 分页-页数,从1开始
rows int 分页-每页记录条数,默认1000
empIds VARCHAR(32) 人员唯一标识
empPositions VARCHAR(32) 人员职位唯一标识
attGroupIds VARCHAR(32) 考勤组唯一标识
deptId VARCHAR(32) 部门唯一标识

返回结果:

{
    "msg_id":"ACT00001",
    "return_code":"0",
    "return_msg":"成功",
    "response_data":{
        "list": [
            {
                "id": "8724265247178874064",           //人员Id
                "code": "fy111",                       //人员编码
                "name": "helius",                      //人员工号
                "sex": "M",                            //人员性别
                "dept_name": "Test___0000001",         //部门名称
                "emp_name": null,                      //职务名称
                "dept_id": "6304139210062816860",      //部门Id
                "mobile": "15645645824",               //手机
                "work_days_cnt": "15",                 //工作天数
                "work_norm_att_days_cnt": "0",         //工作日正常天数
                "work_error_att_days_cnt": "15",       //工作日异常天数
                "att_days_cnt": 0,                     //打卡天数
                "t_4859144426888459735": "0",          //产假天数
                "t_5524488419267919397": "0",          //调休天数
                "t_8246516321884997223": "0",          //护理假天数
                "t_7183994520973342772": "0",          //婚假天数
                "t_5290242889096590359": "0",          //年休假天数
                "t_6257132206537336058": "0",          //丧假天数
                "money_leave_types": "0",              //带薪休假天数合计
                "t_9103959133677454524": "0",          //病假天数
                "t_4702852879741096507": "0",          //事假天数
                "no_money_leave_types": "0",           //扣薪假天数合计
                "leave_days": "0",                     //请假总天数
                "late_att_count": "0",                 //迟到次数
                "early_att_count": "0",                //早退次数
                "kg_att_days": "14.00",                //旷工累计天数
                "absent_times": "126.00",              //缺勤时长
                "offjob_times": 0,                     //脱岗次数
                "work_times": "0.00",                  //工作时长
                "tr_days_cnt": "0",                    //出差天数
                "tgr_hour": "0.00",                    //外出时长
                "work_day_overtime_hour": "0.00",      //工作日加班时长
                "no_work_day_overtime_hour": "0.00",   //节假日加班时长
                "overtime_hour": "0.00",               //加班合计时长
                "overtime_times": 0                    //加班次数
            }
        ],
        "listMoneyLeaveTypes": [
            {
                "id":"8246516321884997223",
                "name":"护理假"
            }
        ],
        "listNoMoneyLeaveTypes": [
            {
                "id":"9103959133677454524",
                "name":"病假"
            }
        ]
    }
}

异常结果:

{
	"msg_id":"ACT00001",
	"return_code": 1,
	"return_msg":"获取考勤人员统计失败。"
}

响应信息

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他参照附件错误码
return_msg String 响应说明
response_data String 数据格式参照示例

获取考勤请假信息接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/attendanceBas/v2/getAttendanceLeave/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体示例:

{
	"startDate":"2020-05-06",
	"endDate":"2020-05-08",
    "userId":"5776957927670915807",
    "deptId":"7640023445358369498",
    "cancelFlag":true
}

请求参数说明

参数 类型 必填 说明
startDate VARCHAR(10) 请假开始日期,格式:yyyy-MM-dd
endDate VARCHAR(10) 请假结束日期,格式:yyyy-MM-dd
userId int 用户id
deptId int 部门id
positionId int 职位id
jobId int 岗位id
mobile VARCHAR(32) 手机号
leaveType int 请假类型id
cancelFlag Boolean 是否销假

响应包体示例:

{
	"return_code": "0",
	"return_msg": null,
	"msg_id": "tUM87N843333",
	"response_data": "[{
		"end_date": "2020-05-07 17:30:00",
		"reason": "啊啊啊",
		"verify_opinion": "",
		"user_id": "5776957927670915807",
		"leave_type": "调休",
		"mission_status": 0,
		"verify_id": "",
		"verify_time": "",
		"pictures": "user_defined/202005/20200507170453304_46188923_CAMERA_21001002276.jpg",
		"copy_to_id": "5776957927670915807",
		"start_date": "2020-05-07 08:30:00"
	}]"
}

响应参数说明

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他参照附件错误码
return_msg String 响应说明
response_data.end_date String 请假结束时间
response_data.reason String 请假事由
response_data.verify_opinion String 审批意见
response_data.user_id String 用户id
response_data.leave_type String 请假类型
response_data.mission_status String 审批状态
response_data.verify_id String 审批人id
response_data.pictures String 照片
response_data.copy_to_id String 抄送人
response_data.start_date String 请假结束时间
response_data.verify_time String 审批时间