API开放平台

TIP

# 考勤相关接口

# 获取考勤记录数据接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/attDetail/v1/getAttUserDetail/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "startDate": "2016-11-01",
    "endDate": "2016-11-31"
}
说明： 本示例仅供参考。

参数说明：

参数 类型 必填 说明
empId VARCHAR(32) 否 员工ID
empSourceCode VARCHAR(32) 否 三方系统员工唯一标识，若与员工ID同时存在，则以员工ID优先
startDate VARCHAR(10) 是 开始日期。格式：yyyy-MM-dd
endDate VARCHAR(10) 是 结束日期。格式：yyyy-MM-dd
page int 否 当前第几页数据，不指定则默认为1
size int 否 当前页面记录条数

响应示例：

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "maxFrequnce": 3,  
               "data": 
               [
                    {
                        "deptId": "5451675706331206298",     
                        "deptName": "成功运维测试",           
                        "deptCode": "",                       
                        "deptSourceCode": "",                 
                        "empCode": "zhouhaifeng",             
                        "empId": "4614317478245645296",      
                        "empName": "周海丰",                   
                        "empSourceCode": "",                  
                        "groupName": "",                      
                        "positionName": "总经理",             
                        "registerDate": "2016-12-06 00:00",   
                        "sex": "M",                           
                        "absentDay": "1.00",                  
                        "absentTimes": "540",                 
                        "workTimes": "0",                     
                        "firstOffLcError": "",     
                        "firstOffLcOffset": "",     
                        "firstOffLieLocate": "",    
                        "firstOffLocateType": "",  
                        "firstOffLocationA": "",    
                        "firstOffNearstPoint": "",  
                        "firstOffPictures": "",     
                        "firstOffRemarks": "",      
                        "firstOffRgTime": "",      
                        "firstOffRqTime": "",       
                        "firstOffStatus": "",       
                        "firstOffTimeOffset": "",   
                        "firstOffRepunchStatus": "1",   
                        "firstOnLcError": "",       
                        "firstOnLcOffset": "",      
                        "firstOnLieLocate": "",    
                        "firstOnLocateType": "",     
                        "firstOnLocationA": "",    
                        "firstOnNearstPoint": "",  
                        "firstOnPictures": "",     
                        "firstOnRemarks": "",       
                        "firstOnRgTime": "",        
                        "firstOnRqTime": "",        
                        "firstOnStatus": "",        
                        "firstOnTimeOffset": "",   
                        "firstOnRepunchStatus": "",   
                        "id": 0,
                        "secondOffLcError": "",     
                        "secondOffLcOffset": "",    
                        "secondOffLieLocate": "",   
                        "secondOffLocateType": "",  
                        "secondOffLocationA": "",   
                        "secondOffNearstPoint": "", 
                        "secondOffPictures": "",    
                        "secondOffRemarks": "",     
                        "secondOffRgTime": "",      
                        "secondOffRqTime": "",      
                        "secondOffStatus": "",      
                        "secondOffTimeOffset": "",  
                        "secondOffRepunchStatus": "1",  
                        "secondOnLcError": "",      
                        "secondOnLcOffset": "",     
                        "secondOnLieLocate": "",    
                        "secondOnLocateType": "",   
                        "secondOnLocationA": "",    
                        "secondOnNearstPoint": "",  
                        "secondOnPictures": "",     
                        "secondOnRemarks": "",     
                        "secondOnRgTime": "",       
                        "secondOnRqTime": "",     
                        "secondOnStatus": "",      
                        "secondOnTimeOffset": "",   
                        "secondOnRepunchStatus": "",   
                        "thirdOffLcError": "",      
                        "thirdOffLcOffset": "",     
                        "thirdOffLieLocate": "",    
                        "thirdOffLocateType": "",   
                        "thirdOffLocationA": "",   
                        "thirdOffNearstPoint": "",  
                        "thirdOffPictures": "",     
                        "thirdOffRemarks": "",      
                        "thirdOffRgTime": "",       
                        "thirdOffRqTime": "",       
                        "thirdOffStatus": "",      
                        "thirdOffTimeOffset": "",
                        "thirdOffRepunchStatus": "",
                        "thirdOnLcError": "",       
                        "thirdOnLcOffset": "",      
                        "thirdOnLieLocate": "",     
                        "thirdOnLocateType": "",    
                        "thirdOnLocationA": "",     
                        "thirdOnNearstPoint": "",  
                        "thirdOnPictures": "",      
                        "thirdOnRemarks": "",       
                        "thirdOnRgTime": "",        
                        "thirdOnRqTime": "",        
                        "thirdOnStatus": "",        
                        "thirdOnTimeOffset": "",     
                        "thirdOnRepunchStatus": ""     
                    }
               ]
    }
]

参数说明：

参数 类型 说明
maxFrequnce 考勤组数量
data 考勤组详细信息列表
data.deptId 部门ID
data.deptName 部门名称
data.deptCode 部门编码
data.deptSourceCode 部门来源编码
data.empCode 员工账号
data.empId 员工ID
data.empName 员工名称
data.empSourceCode 员工来源编码
data.groupName 考勤组名称
data.positionName 职位
data.registerDate 考勤日期
data.sex 性别
data.absentDay 当天的旷工天数
data.absentTimes 缺勤时长
data.workTimes 工作总时长
以下字段为第一组签退信息
data.firstOffLcError 考勤一下班是否脱岗。0：正常，1：脱岗
data.firstOffLcOffset 考勤一下班位置偏差
data.firstOffLieLocate 考勤一下班定位是不是虚假模拟位置。0：非虚假模拟位置，1：虚假模拟位置
data.firstOffLocateType 考勤一下班定位类型。1：GPS，2：基站定位
data.firstOffLocationA 考勤一下班地标信息
data.firstOffNearstPoint 考勤一下班最近考勤点
data.firstOffPictures 考勤一下班照片路径
data.firstOffRemarks 考勤一下班备注
data.firstOffRgTime 考勤一下班时间
data.firstOffRqTime 考勤一要求下班时间
data.firstOffStatus 考勤一下班状态。0：正常，1：早退，2：异常
data.firstOffTimeOffset 考勤一下班时间偏差
data.firstOffRepunchStatus 考勤一下班是否补卡。1：补卡，其他为非补卡
以下字段为第一组签到信息
data.firstOnLcError 考勤一上班是否脱岗。0：正常，1：脱岗
data.firstOnLcOffset 考勤一上班位置偏差
data.firstOnLieLocate 考勤一上班定位是不是虚假模拟位置。0：非虚假模拟位置，1：虚假模拟位置
data.firstOnLocateType 考勤一上班定位类型。1：GPS，2：基站定位
data.firstOnLocationA 考勤一上班地标信息
data.firstOnNearstPoint 考勤一上班最近考勤点
data.firstOnPictures 考勤一上班照片路径
data.firstOnRemarks 考勤一上班备注
data.firstOnRgTime 考勤一上班时间
data.firstOnRqTime 考勤一要求上班时间
data.firstOnStatus 考勤一上班状态。0：正常，1：迟到，2：异常
data.firstOnTimeOffset 考勤一上班时间偏差
data.firstOnRepunchStatus 考勤一上班是否补卡。1：补卡，其他为非补卡
data.id id
以下字段为第二组签退信息
data.secondOffLcError 考勤一下班是否脱岗。0：正常，1：脱岗
data.secondOffLcOffset 考勤一下班位置偏差
data.secondOffLieLocate 考勤一下班定位是不是虚假模拟位置。0：非虚假模拟位置，1：虚假模拟位置
data.secondOffLocateType 考勤一下班定位类型。1：GPS，2：基站定位
data.secondOffLocationA 考勤一下班地标信息
data.secondOffNearstPoint 考勤一下班最近考勤点
data.secondOffPictures 考勤一下班照片路径
data.secondOffRemarks 考勤一下班备注
data.secondOffRgTime 考勤一下班时间
data.secondOffRqTime 考勤一要求下班时间
data.secondOffStatus 考勤一下班状态。0：正常，1：早退，2：异常
data.secondOffTimeOffset 考勤一下班时间偏差
data.secondOffRepunchStatus 考勤一下班是否补卡。1：补卡，其他为非补卡
以下字段为第二组签到信息
data.secondOnLcError 考勤一上班是否脱岗。0：正常，1：脱岗
data.secondOnLcOffset 考勤一上班位置偏差
data.secondOnLieLocate 考勤一上班定位是不是虚假模拟位置。0：非虚假模拟位置，1：虚假模拟位置
data.secondOnLocateType 考勤一上班定位类型。1：GPS，2：基站定位
data.secondOnLocationA 考勤一上班地标信息
data.secondOnNearstPoint 考勤一上班最近考勤点
data.secondOnPictures 考勤一上班照片路径
data.secondOnRemarks 考勤一上班备注
data.secondOnRgTime 考勤一上班时间
data.secondOnRqTime 考勤一要求上班时间
data.secondOnStatus 考勤一上班状态。0：正常，1：迟到，2：异常
data.secondOnTimeOffset 考勤一上班时间偏差
data.secondOnRepunchStatus 考勤一上班是否补卡。1：补卡，其他为非补卡
以下字段为第三组签退信息
data.thirdOffLcError 考勤一下班是否脱岗。0：正常，1：脱岗
data.thirdOffLcOffset 考勤一下班位置偏差
data.thirdOffLieLocate 考勤一下班定位是不是虚假模拟位置。0：非虚假模拟位置，1：虚假模拟位置
data.thirdOffLocateType 考勤一下班定位类型。1：GPS，2：基站定位
data.thirdOffLocationA 考勤一下班地标信息
data.thirdOffNearstPoint 考勤一下班最近考勤点
data.thirdOffPictures 考勤一下班照片路径
data.thirdOffRemarks 考勤一下班备注
data.thirdOffRgTime 考勤一下班时间
data.thirdOffRqTime 考勤一要求下班时间
data.thirdOffStatus 考勤一下班状态。0：正常，1：早退，2：异常
data.thirdOffTimeOffset 考勤一下班时间偏差
data.thirdOffRepunchStatus 考勤一下班是否补卡。1：补卡，其他为非补卡
以下字段为第三组签到信息
data.thirdOnLcError 考勤一上班是否脱岗。0:正常;1:脱岗
data.thirdOnLcOffset 考勤一上班位置偏差
data.thirdOnLieLocate 考勤一上班定位是不是虚假模拟位置。0：非虚假模拟位置，1：虚假模拟位置
data.thirdOnLocateType 考勤一上班定位类型。1:GPS，2:基站定位
data.thirdOnLocationA 考勤一上班地标信息
data.thirdOnNearstPoint 考勤一上班最近考勤点
data.thirdOnPictures 考勤一上班照片路径
data.thirdOnRemarks 考勤一上班备注
data.thirdOnRgTime 考勤一上班时间
data.thirdOnRqTime 考勤一要求上班时间
data.thirdOnStatus 考勤一上班状态。0：正常，1：迟到，2：异常
data.thirdOnTimeOffset 考勤一上班时间偏差
data.thirdOnRepunchStatus 考勤一上班是否补卡。1：补卡，其他为非补卡

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

请求方式： 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 否 当前第几页数据，不指定则默认为1
size int 否 当前页面记录条数

响应示例：

{
    "return_code": "0", 
    "return_msg": null,
    "msg_id": null,
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
     {
        "deptName": "部门三",              
        "userId": "6642001518209655480",   
        "empName": "",                     
        "sex": "M",                       
        "userName": "flow_05",             
        "group": "默认考勤组",             
        "code": "flow_05",                
        "attendance": 
        [
            {       
                "checkin": 
                [ 
                    {
                        "attdLieLocate": "0",                   
                        "attdAddress": "安徽省铜陵市铜陵县X008",  
                        "attdLcError": "1",                     
                        "attdStatus": "2",                       
                        "attdTime": "2016-12-05 19:21:00"        
                    },
                    {
                        "attdTime": "",                         
                        "attdAddress": ""                        
                    },
                    {
                        "attdTime": "",                         
                        "attdAddress": ""                        
                    }
                ],
                "attDate": "2016-12-05",                         
                "workTime": " 1.00",                             
                "remarks": "出差",                              
                "checkout": 
                [
                    {
                        "attdLieLocate": "0",                    
                        "attdAddress": "安徽省铜陵市铜陵县X008",   
                        "attdLcError": "1",                      
                        "attdStatus": "2",                       
                        "attdTime": "2016-12-05 20:21:00"        
                    },
                    {
                        "attdTime": "",                          
                        "attdAddress": ""                       
                    },
                    {
                        "attdTime": "",                          
                        "attdAddress": ""                       
                    }
                ]
            }
        ]
     }
]

参数说明：

参数 类型 说明
deptName 部门名称
userId 员工编码
empName 职位名称
sex 性别。M：男，F：女
userName 姓名
group 考勤组名称
code 工号
以下字段为签到数据(根据maxFrequnce改变数量，最多三组)
attendance.checkin.attdLieLocate 定位是否虚假模拟位置。0：非虚假模拟位置，1：虚假模拟位置
attendance.checkin.attdAddress 打卡位置
attendance.checkin.attdLcError 是否脱岗。0：正常，1：脱岗
attendance.checkin.attdStatus 考勤状态。0：正常，1：迟到，2：异常
attendance.checkin.attdTime 考勤时间
attendance.attDate 考勤日期
attendance.workTime 工作时长，默认值为0.00
attendance.remarks 备注信息
以下字段为签退数据(根据maxFrequnce改变数量，最多三组)
attendance.checkout.attdLieLocate 定位是否虚假模拟位置。0：非虚假模拟位置，1：虚假模拟位置
attendance.checkout.attdAddress 打卡位置
attendance.checkout.attdLcError 是否脱岗。0：正常，1：脱岗
attendance.checkout.attdStatus 考勤状态。0：正常，1：迟到，2：异常
attendance.checkout.attdTime 考勤时间

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

请求方式： 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) 否 部门唯一标识

响应示例：

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

异常示例：

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

数据DATA示例:

[
    {
        "list": 
        [
            {
                "id": "8724265247178874064",          
                "code": "fy111",                       
                "name": "helius",                      
                "sex": "M",                            
                "dept_name": "Test_0000001",         
                "emp_name": null,                      
                "dept_id": "6304139210062816860",      
                "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":"病假"
            }
        ]
    }
]

参数说明：

参数 类型 说明
list.id 人员Id
list.code 人员编码
list.name 人员工号
list.sex 人员性别
list.dept_name 部门名称
list.emp_name 职务名称
list.dept_id 部门Id
list.mobile 手机
list.work_days_cnt 工作天数
list.work_norm_att_days_cnt 工作日正常天数
list.work_error_att_days_cnt 工作日异常天数
list.att_days_cnt 打卡天数
list.t_4859144426888459735 产假天数
list.t_5524488419267919397 调休天数
list.t_8246516321884997223 护理假天数
list.t_7183994520973342772 婚假天数
list.t_5290242889096590359 年休假天数
list.t_6257132206537336058 丧假天数
list.money_leave_types 带薪休假天数合计
list.t_9103959133677454524 病假天数
list.t_4702852879741096507 事假天数
list.no_money_leave_types 扣薪假天数合计
list.leave_days 请假总天数
list.late_att_count 迟到次数
list.early_att_count 早退次数
list.kg_att_days 旷工累计天数
list.absent_times 缺勤时长
list.offjob_times 脱岗次数
list.work_times 工作时长
list.tr_days_cnt 出差天数
list.tgr_hour 外出时长
list.work_day_overtime_hour 工作日加班时长
list.no_work_day_overtime_hour 节假日加班时长
list.overtime_hour 加班合计时长
list.overtime_times 加班次数
listMoneyLeaveTypes.id 带薪休假id
listMoneyLeaveTypes.name 带薪休假名称

# 获取考勤请假信息接口

请求方式： 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": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "id": "5865180152216568336",
        "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",
		"count_date": "1"
    }
]

参数说明：

参数 类型 说明
id String 唯一标识id
end_date String 请假结束时间。格式：yyyy-MM-dd HH:mm:ss
reason String 请假事由
verify_opinion String 审批意见
user_id String 用户id
leave_type String 请假类型，请假类型设置表中ID
mission_status String 审批状态。0：待审批，1：审批通过，2：打回
verify_id String 审批人id
pictures String 照片
copy_to_id String 抄送人
start_date String 请假开始时间。格式：yyyy-MM-dd HH:mm:ss
count_date String 请假天数
verify_time String 审批时间。格式：yyyy-MM-dd HH:mm:ss
status String 状态。1：正常，0：已删除
cancel_type String 取消类型。1：销假，2：撤销
ori_leave_id String 取消记录对应的原请假记录id

# 获取考勤出差记录查询

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/attendanceBas/v2/getAttendanceTravel/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "startDate":"2020-11-04",
    "endDate":"2020-12-24"
}
说明： 本示例仅供参考。

参数说明：

参数 类型 必填 名称
startDate VARCHAR(10) 是 开始日期。格式：yyyy-MM-dd
endDate VARCHAR(10) 是 结束日期。格式：yyyy-MM-dd
userId int8 否 用户ID
mobile VARCHAR(32) 否 手机号
page int 否 分页页码，默认为1
size int 否 分页大小

响应示例：

[
    {
        "end_date": "2020-12-25",
        "reason": "出差",
        "create_time": "2020-12-23 13:44",
        "key_id": "7724449665169889485",
        "mission_status": "1",
        "user_name": "韩煜",
        "emp_name": null,
        "dept_name": "研发部",
        "estimate_departure": "南京",
        "verify_time": "2020-12-23 13:47",
        "pictures": null,
        "vehicle": "火车",
        "verify_opinion": "通过11111",
        "user_id": "4880066687204640177",
        "travel_recs": [
            {
                "location_a": "江苏省南京市建邺区雨润大街嘉陵江东街(地铁站)",
                "travel_id": "7724449665169889485",
                "location_city": "南京市",
                "rec_pictures": null,
                "remark": "出发",
                "rec_id": "8000017996136410476",
                "travel_time": "2020-12-23 13:46",
                "travel_type": 0,
                "location_c": "31.979647,118.727493"
            },
            {
                "location_a": "江苏省南京市建邺区创智路紫金科技创业特别社区先导区北区",
                "travel_id": "7724449665169889485",
                "location_city": "南京市",
                "rec_pictures": "attendance/202012/20201223135248331_45813751_CAMERA_11001009262.jpeg",
                "remark": "离开1221346646",
                "rec_id": "8089239242532763217",
                "travel_time": "2020-12-23 13:52",
                "travel_type": 3,
                "location_c": "31.982264,118.734962"
            },
            {
                "location_a": "江苏省南京市建邺区创智路紫金科技创业特别社区先导区北区",
                "travel_id": "7724449665169889485",
                "location_city": "南京市",
                "rec_pictures": "attendance/202012/20201223140445264_45813751_CAMERA_11002005250.jpeg,attendance/202012/20201223140439071_45813751_CAMERA_11001005253.jpeg",
                "remark": "归来55555",
                "rec_id": "4936015121513116771",
                "travel_time": "2020-12-23 14:04",
                "travel_type": 1,
                "location_c": "31.982304,118.734947"
            },
            {
                "location_a": "江苏省南京市建邺区创智路紫金科技创业特别社区先导区北区",
                "travel_id": "7724449665169889485",
                "location_city": "南京市",
                "rec_pictures": null,
                "remark": "抵达上海",
                "rec_id": "7162963534242629060",
                "travel_time": "2020-12-23 13:46",
                "travel_type": 2,
                "location_c": "31.98221,118.734734"
            }
        ],
        "estimate_destination": "上海",
        "dept_id": "6810772645593098378",
        "start_date": "2020-12-24"
    }
]

参数说明：

参数 类型 说明
dept_name VARCHAR(100) 部门名称
dept_id VARCHAR(32) 部门ID
user_name VARCHAR(100) 员工姓名
user_id VARCHAR(32) 员工ID
emp_name VARCHAR(100) 员工职位
create_time VARCHAR(32) 申请时间
mission_status VARCHAR(1) 审批状态。0：待审批，1：已通过，2：已打回（取最后一次)
verify_time VARCHAR(32) 审批日期。取最后一次
verify_opinion VARCHAR(100) 审批意见。取最后一次
estimate_departure VARCHAR(100) 始发地
estimate_destination VARCHAR(100) 目的地
start_date VARCHAR(32) 开始日期
end_date VARCHAR(32) 结束日期
vehicle VARCHAR(32) 交通工具
reason VARCHAR(400) 出差事由
pictures VARCHAR(100) 出差申请照片
travel_recs List 状态上报信息列表
travel_recs.travel_type int 状态上报类型。0：出发登记，1：出差归来，2：抵达目的地，3：离开目的地
travel_recs.travel_time VARCHAR(32) 状态上报时间
travel_recs.location_city VARCHAR(32) 状态上报城市
travel_recs.location_a VARCHAR(400) 状态上报位置
travel_recs.rec_pictures VARCHAR(4000) 状态上报照片
travel_recs.remark VARCHAR(4000) 状态上报文字说明

# 获取考勤点数据接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/attendanceBas/v2/getAttendanceLocation/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "id":"7057198646832627267"
}
说明： 本示例仅供参考。

参数说明：

参数 类型 必填 名称
id int8 否 考勤点ID，对应获取考勤记录数据接口中的data.firstOffNearstPoint

响应示例：

[
    {
		"location_a":"南京市建邺区烽火科技大厦",
		"deviation":10,
		"id":7057198646832627267,
		"lc_name":"烽火"
	}
]

参数说明：

参数 类型 说明
id VARCHAR(32) 考勤点ID，对应获取考勤记录数据接口中的data.firstOffNearstPoint
lc_name VARCHAR(100) 考勤点名称
location_a VARCHAR(100) 考勤地址
deviation VARCHAR(100) 有效范围

# 获取考勤出差记录查询v3

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/attendanceBasV3/v3/getAttendanceTravel/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "startDate":"2020-11-04",
    "endDate":"2020-12-24"
}
说明： 本示例仅供参考。

参数说明：

参数 类型 必填 名称
startDate VARCHAR(10) 是 开始日期。格式：yyyy-MM-dd
endDate VARCHAR(10) 是 结束日期。格式：yyyy-MM-dd
userId int8 否 用户ID
mobile VARCHAR(32) 否 手机号
page int 否 分页页码，默认为1
size int 否 分页大小

响应示例：

[
    {
        "end_date": "2020-12-25",
        "reason": "出差",
        "create_time": "2020-12-23 13:44",
        "key_id": "7724449665169889485",
        "mission_status": "1",
        "user_name": "韩煜",
        "emp_name": null,
        "dept_name": "研发部",
        "estimate_departure": "南京",
        "verify_time": "2020-12-23 13:47",
        "pictures": null,
        "vehicle": "火车",
        "verify_opinion": "通过11111",
        "user_id": "4880066687204640177",
        "travel_recs": [
            {
                "location_a": "江苏省南京市建邺区雨润大街嘉陵江东街(地铁站)",
                "travel_id": "7724449665169889485",
                "location_city": "南京市",
                "rec_pictures": null,
                "remark": "出发",
                "rec_id": "8000017996136410476",
                "travel_time": "2020-12-23 13:46",
                "travel_type": 0,
                "location_c": "31.979647,118.727493"
            },
            {
                "location_a": "江苏省南京市建邺区创智路紫金科技创业特别社区先导区北区",
                "travel_id": "7724449665169889485",
                "location_city": "南京市",
                "rec_pictures": "attendance/202012/20201223135248331_45813751_CAMERA_11001009262.jpeg",
                "remark": "离开1221346646",
                "rec_id": "8089239242532763217",
                "travel_time": "2020-12-23 13:52",
                "travel_type": 3,
                "location_c": "31.982264,118.734962"
            },
            {
                "location_a": "江苏省南京市建邺区创智路紫金科技创业特别社区先导区北区",
                "travel_id": "7724449665169889485",
                "location_city": "南京市",
                "rec_pictures": "attendance/202012/20201223140445264_45813751_CAMERA_11002005250.jpeg,attendance/202012/20201223140439071_45813751_CAMERA_11001005253.jpeg",
                "remark": "归来55555",
                "rec_id": "4936015121513116771",
                "travel_time": "2020-12-23 14:04",
                "travel_type": 1,
                "location_c": "31.982304,118.734947"
            },
            {
                "location_a": "江苏省南京市建邺区创智路紫金科技创业特别社区先导区北区",
                "travel_id": "7724449665169889485",
                "location_city": "南京市",
                "rec_pictures": null,
                "remark": "抵达上海",
                "rec_id": "7162963534242629060",
                "travel_time": "2020-12-23 13:46",
                "travel_type": 2,
                "location_c": "31.98221,118.734734"
            }
        ],
        "estimate_destination": "上海",
        "dept_id": "6810772645593098378",
        "start_date": "2020-12-24"
    }
]

参数说明：

参数 类型 说明
dept_name VARCHAR(100) 部门名称
dept_id VARCHAR(32) 部门ID
user_name VARCHAR(100) 员工姓名
user_id VARCHAR(32) 员工ID
emp_name VARCHAR(100) 员工职位
create_time VARCHAR(32) 申请时间
mission_status VARCHAR(1) 审批状态。0：待审批，1：已通过，2：已打回（取最后一次)
verify_time VARCHAR(32) 审批日期。取最后一次
verify_opinion VARCHAR(100) 审批意见。取最后一次
estimate_departure VARCHAR(100) 始发地
estimate_destination VARCHAR(100) 目的地
start_date VARCHAR(32) 开始日期
end_date VARCHAR(32) 结束日期
vehicle VARCHAR(32) 交通工具
reason VARCHAR(400) 出差事由
pictures VARCHAR(100) 出差申请照片
travel_recs List 状态上报信息列表
travel_recs.travel_type int 状态上报类型。0：出发登记，1：出差归来，2：抵达目的地，3：离开目的地
travel_recs.travel_time VARCHAR(32) 状态上报时间
travel_recs.location_city VARCHAR(32) 状态上报城市
travel_recs.location_a VARCHAR(400) 状态上报位置
travel_recs.rec_pictures VARCHAR(4000) 状态上报照片
travel_recs.remark VARCHAR(4000) 状态上报文字说明

# 获取考勤点数据接口v3

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/attendanceBasV3/v3/getAttendanceLocation/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "id":"7057198646832627267"
}
说明： 本示例仅供参考。

参数说明：

参数 类型 必填 名称
id int8 否 考勤点ID，对应获取考勤记录数据接口中的data.firstOffNearstPoint

响应示例：

[
    {
		"location_a":"南京市建邺区烽火科技大厦",
		"deviation":10,
		"id":7057198646832627267,
		"lc_name":"烽火"
	}
]

参数说明：

参数 类型 说明
id VARCHAR(32) 考勤点ID，对应获取考勤记录数据接口中的data.firstOffNearstPoint
lc_name VARCHAR(100) 考勤点名称
location_a VARCHAR(100) 考勤地址
deviation VARCHAR(100) 有效范围

# 获取排班考勤打卡记录数据接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/attSchedule/v1/getScheduleAttRecord/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "empId":"7057198646832627267",
    "startDate":"2022-09-29",
    "endDate":"2022-10-29",
    "page":1,
    "rows":100
}
说明： 本示例仅供参考。

参数说明：

参数 类型 必填 名称
empId int8 否 用户ID
startDate VARCHAR(10) 是 开始日期。格式：yyyy-MM-dd
endDate VARCHAR(10) 是 结束日期。格式：yyyy-MM-dd
page int 否 分页页码，默认为1
rows int 否 分页大小，默认500

响应示例：

[
    {
		"empId ": 8311871721884814228,
		"firstOffRemarks ": "江宁",
		"firstOnRgTime ": "2022-09-28 19:32",
		"firstOnRemarks ": "奥体 ",
		"onCustId ": 4807356373745385238,
		"offCustId ": 8487348048636316669,
		"groupId ": 7962514806751241243,
		"firstOnLocationC ": "31.982777,118.735146",
		"firstOffRgTime ": "2022-09-28 19:32 ",
		"firstOffLocationC ": "31.982777,118.735146 ",
		"firstOnLocationA ": "江苏省南京市建邺区沙洲街道白龙江东街紫金(建邺)科技创业特别社区先导区附近",
		"firstOffLocationA ": "江苏省南京市建邺区沙洲街道白龙江东街紫金(建邺)科技创业特别社区先导区附近",
		"firstOnPictures ": "attendance/202209/20220928193205853_8855e5a2_CAMERA_21001001245",
		"scheduleId ": 7769495223482158158,
		"firstOffPictures ": "attendance/202209/20220928193219958_8855e5a2_CAMERA_21001001244"
	}
]

参数说明：

参数 类型 必填 名称
empId int8 否 员工id
groupId int8 排班组id
scheduleId int8 班次id
onCustId int8 上班打卡门店id
offCustId int8 下班打卡门店id
firstOnRgTime VARCHAR 考勤上班时间
firstOnLocationC VARCHAR 考勤上班位置（坐标）
firstOnLocationA VARCHAR 考勤上班位置（地址）
firstOnRemarks VARCHAR 考勤上班备注
firstOffRgTime VARCHAR 考勤下班时间
firstOffLocationC VARCHAR 考勤下班位置（坐标）
firstOffLocationA VARCHAR 考勤下班位置（地址）
firstOffRemarks VARCHAR 考勤下班备注
firstOnPictures VARCHAR 考勤上班照片路径
firstOffPictures VARCHAR 考勤下班照片路径

# 获取排班考勤组数据接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/attSchedule/v1/getScheduleAttGroup/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "groupId":"7057198646832627267"
}
说明： 本示例仅供参考。

参数说明：

参数 类型 必填 名称
groupId int8 否 考勤组ID

响应示例：

[
    {
		"leaveEarlyHalfdayAbsentTime ": 90,
		"groupName ": "092801 ",
		"isLocationPoint ": "1 ",
		"leaveEarlyAlldayAbsentTime ": 180,
		"isFaceRecognition ": "2 ",
		"changeSchedule ": "1 ",
		"lateHalfdayAbsentTime ": 90,
		"isFreedom ": "1 ",
		"isPhoto ": 2,
		"lateAlldayAbsentTime ": 180,
		"isLocationDeviation ": 500,
		"isOtherStore ": "1 "
	}
]

参数说明：

参数 类型 必填 名称
groupName int8 否 考勤组名称
isPhoto int8 打卡时是否拍照
lateHalfdayAbsentTime int8 迟到时间算旷工半天
lateAlldayAbsentTime int8 迟到时间算旷工一天
leaveEarlyHalfdayAbsentTime int8 早退时间算旷工半天
leaveEarlyAlldayAbsentTime VARCHAR 早退时间算旷工一天
isLocationPoint VARCHAR 将员工所属门店位置作为考勤点
isLocationDeviation VARCHAR 有效范围
isFreedom VARCHAR 自排班
isFaceRecognition VARCHAR 打卡提交时是否进行人脸校验
changeSchedule VARCHAR 允许成员修改排班
isOtherStore VARCHAR 允许成员在另一门店签退

# 获取排班考勤班次数据接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/attSchedule/v1/getScheduleAttTime/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "timeId":"7057198646832627267"
}
说明： 本示例仅供参考。

参数说明：

参数 类型 必填 名称
timeId int8 否 班次ID

响应示例：

[
	{
		"isStartNextday ": "0",
		"color ": "#54A9F4",
		"name ": "晚班1",
		"earliestTime ": 120,
		"startTime ": "20:29",
		"isEndNextday ": "0",
		"endTime ": "22:00",
		"latestTime ": 120
	}
]

参数说明：

参数 类型 必填 名称
name VARCHAR 否 班次名称
color VARCHAR 班次颜色
startTime VARCHAR 班次开始时间
endTime VARCHAR 班次结束时间
earliestTime VARCHAR 允许最早签到时间
latestTime VARCHAR 允许最晚签到时间
isStartNextday VARCHAR 开始时间是否隔天
isEndNextday VARCHAR 结束时间是否隔天

← 自定义表单接口 →