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

参数名称 参数值
应用编码 attDetail
应用版本 v1
接口名称 获取考勤记录数据接口
接口编码 getAttUserDetail
接口URL https://openapi.waiqin365.com/api/attDetail/v1/getAttUserDetail/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
startDate VARCHAR(10) 开始日期,格式:“yyyy-MM-dd”
endDate VARCHAR(10) 结束日期,格式:“yyyy-MM-dd”
page int 分页-页数
size int 分页-每页记录条数
响应信息 参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他参照附件错误码
return_msg String 响应说明
response_data String 数据格式参照示例

// 请求消息体示例:
{
    "startDate": "2016-11-01",
    "endDate": "2016-11-31"
}

// 响应信息示例:
{
    "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:基站定位
                "firstOffLocation": "",     // 考勤一下班位置
                "firstOffLocationA": "",    // 考勤一下班地标信息
                "firstOffLocationC": "",    // 考勤一下班纠偏位置
                "firstOffNearstPoint": "",  // 考勤一下班最近考勤点
                "firstOffPictures": "",     // 考勤一下班照片路径
                "firstOffRemarks": "",      // 考勤一下班备注
                "firstOffRgTime": "",       // 考勤一下班时间
                "firstOffRqTime": "",       // 考勤一要求下班时间
                "firstOffStatus": "",       // 考勤一下班状态 0:正常;1:早退;2:异常
                "firstOffTimeOffset": "",   // 考勤一下班时间偏差
                // 第一组签到信息
                "firstOnLcError": "",       // 考勤一上班是否脱岗 0:正常;1:脱岗
                "firstOnLcOffset": "",      // 考勤一上班位置偏差
                "firstOnLieLocate": "",     // 考勤一上班定位是不是虚假模拟位置 0:非虚假模拟位置,1:虚假模拟位置
                "firstOnLocateType": "",    // 考勤一上班定位类型 1:GPS;2:基站定位
                "firstOnLocation": "",      // 考勤一上班位置
                "firstOnLocationA": "",     // 考勤一上班地标信息
                "firstOnLocationC": "",     // 考勤一上班纠偏位置
                "firstOnNearstPoint": "",   // 考勤一上班最近考勤点
                "firstOnPictures": "",      // 考勤一上班照片路径
                "firstOnRemarks": "",       // 考勤一上班备注
                "firstOnRgTime": "",        // 考勤一上班时间
                "firstOnRqTime": "",        // 考勤一要求上班时间
                "firstOnStatus": "",        // 考勤一上班状态 0:正常;1:迟到;2:异常
                "firstOnTimeOffset": "",    // 考勤一上班时间偏差
                "id": 0,// 
                // 第二组签退信息
                "secondOffLcError": "",     // 考勤一下班是否脱岗 0:正常;1:脱岗
                "secondOffLcOffset": "",    // 考勤一下班位置偏差
                "secondOffLieLocate": "",   // 考勤一下班定位是不是虚假模拟位置 0:非虚假模拟位置,1:虚假模拟位置
                "secondOffLocateType": "",  // 考勤一下班定位类型 1:GPS;2:基站定位
                "secondOffLocation": "",    // 考勤一下班位置
                "secondOffLocationA": "",   // 考勤一下班地标信息
                "secondOffLocationC": "",   // 考勤一下班纠偏位置
                "secondOffNearstPoint": "", // 考勤一下班最近考勤点
                "secondOffPictures": "",    // 考勤一下班照片路径
                "secondOffRemarks": "",     // 考勤一下班备注
                "secondOffRgTime": "",      // 考勤一下班时间
                "secondOffRqTime": "",      // 考勤一要求下班时间
                "secondOffStatus": "",      // 考勤一下班状态 0:正常;1:早退;2:异常
                "secondOffTimeOffset": "",  // 考勤一下班时间偏差
                // 第二组签到信息
                "secondOnLcError": "",      // 考勤一上班是否脱岗 0:正常;1:脱岗
                "secondOnLcOffset": "",     // 考勤一上班位置偏差
                "secondOnLieLocate": "",    // 考勤一上班定位是不是虚假模拟位置 0:非虚假模拟位置,1:虚假模拟位置
                "secondOnLocateType": "",   // 考勤一上班定位类型 1:GPS;2:基站定位
                "secondOnLocation": "",     // 考勤一上班位置
                "secondOnLocationA": "",    // 考勤一上班地标信息
                "secondOnLocationC": "",    // 考勤一上班纠偏位置
                "secondOnNearstPoint": "",  // 考勤一上班最近考勤点
                "secondOnPictures": "",     // 考勤一上班照片路径
                "secondOnRemarks": "",      // 考勤一上班备注
                "secondOnRgTime": "",       // 考勤一上班时间
                "secondOnRqTime": "",       // 考勤一要求上班时间
                "secondOnStatus": "",       // 考勤一上班状态 0:正常;1:迟到;2:异常
                "secondOnTimeOffset": "",   // 考勤一上班时间偏差
                // 第三组签退信息
                "thirdOffLcError": "",      // 考勤一下班是否脱岗 0:正常;1:脱岗
                "thirdOffLcOffset": "",     // 考勤一下班位置偏差
                "thirdOffLieLocate": "",    // 考勤一下班定位是不是虚假模拟位置 0:非虚假模拟位置,1:虚假模拟位置
                "thirdOffLocateType": "",   // 考勤一下班定位类型 1:GPS;2:基站定位
                "thirdOffLocation": "",     // 考勤一下班位置
                "thirdOffLocationA": "",    // 考勤一下班地标信息
                "thirdOffLocationC": "",    // 考勤一下班纠偏位置
                "thirdOffNearstPoint": "",  // 考勤一下班最近考勤点
                "thirdOffPictures": "",     // 考勤一下班照片路径
                "thirdOffRemarks": "",      // 考勤一下班备注
                "thirdOffRgTime": "",       // 考勤一下班时间
                "thirdOffRqTime": "",       // 考勤一要求下班时间
                "thirdOffStatus": "",       // 考勤一下班状态 0:正常;1:早退;2:异常
                "thirdOffTimeOffset": "",   // 考勤一下班时间偏差
                // 第三组签到信息
                "thirdOnLcError": "",       // 考勤一上班是否脱岗 0:正常;1:脱岗
                "thirdOnLcOffset": "",      // 考勤一上班位置偏差
                "thirdOnLieLocate": "",     // 考勤一上班定位是不是虚假模拟位置 0:非虚假模拟位置,1:虚假模拟位置
                "thirdOnLocateType": "",    // 考勤一上班定位类型 1:GPS;2:基站定位
                "thirdOnLocation": "",      // 考勤一上班位置
                "thirdOnLocationA": "",     // 考勤一上班地标信息
                "thirdOnLocationC": "",     // 考勤一上班纠偏位置
                "thirdOnNearstPoint": "",   // 考勤一上班最近考勤点
                "thirdOnPictures": "",      // 考勤一上班照片路径
                "thirdOnRemarks": "",       // 考勤一上班备注
                "thirdOnRgTime": "",        // 考勤一上班时间
                "thirdOnRqTime": "",        // 考勤一要求上班时间
                "thirdOnStatus": "",        // 考勤一上班状态 0:正常;1:迟到;2:异常
                "thirdOnTimeOffset": ""     // 考勤一上班时间偏差
            }
        ]
    }
}
                  
参数名称 参数值
应用编码 attStatistics
应用版本 v1
接口名称 获取考勤明细统计数据接口
接口编码 getUserStatistic
接口URL https://openapi.waiqin365.com/api/attStatistics/v1/getUserStatistic/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
startDate VARCHAR(10) 开始日期,格式:“yyyy-MM-dd”
endDate VARCHAR(10) 结束日期,格式:“yyyy-MM-dd”
page int 分页-页数
size int 分页-每页记录条数
响应信息 参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他参照附件错误码
return_msg String 响应说明
response_data String 数据格式参照示例

// 请求消息体示例:
{
    "startDate": "2016-11-01",
    "endDate": "2016-11-31"
}

// 响应信息示例:
{
    "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": ""                        // 打卡位置
                            }
                        ]
                    }
                ]
            }
        ]
    }
}
                  
参数名称 参数值
应用编码 userStatistics
应用版本 v1
接口名称 获取考勤人员统计数据接口
接口编码 getUserStatistics
接口URL https://openapi.waiqin365.com/api/userStatistics/v1/getUserStatistics/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
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 String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他参照附件错误码
return_msg String 响应说明
response_data String 数据格式参照示例

// 请求数据体示例:
{
	"startDate":"2016-07-20",
	"endDate":"2016-07-22",
	"empIds":"1200235510200010120",
	"empPositions":"8760235510200015420",
	"attGroupIds":"8760235510200015420",
	"deptId":"8760235510200015420"	
}

// 正常响应信息示例:
{
    "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":"获取考勤人员统计失败。"
}