常见问题

缺卡、不在考勤班次范围内的打卡（无效打卡）与旷工记录何时生成？

答：记录生成时间如下：

• 无效打卡：实时生成。

  • 旷工记录：旷工记录是计算出来的状态，如果一整天都缺卡则为旷工。

  • 缺卡场景：例如某企业正常工作日班次是09-18点。

• 若未设置打卡时段：

  • 上班考勤结果生成：会按中线生成缺卡，即:（9+18）/ 2 =13.5，即13时30分。

  • 下班考勤结果生成：

    • 次日为工作日时：按两个卡点的中线计算[遵循前8后12规则]，即（18 + 9） /2=13.5，即凌晨01：30。

    • 次日为休息日时：系统会扩大最晚打卡时间，[遵循前8后12规则]，会在12小时后生成考勤结果。

• 设置打卡时段：依据设置的最晚打卡时间生成考勤结果。

获取打卡结果，接口返回为空

答：调用获取打卡结果接口返回的信息为空的可能原因包括但不限于以下情况：

• 参数userId值有误，请确认当前企业下是否有该userid。

• isI18n(判断海外企业)参数有误。如果是国内企业，isI18n参数必须传false。

• 检查checkDateFrom，若用户打卡时间点是09:00，调用接口时参数传10:00，获取不到信息。

• userIdList参数的格式不正确。多个userid需用英文逗号隔开。

上传打卡记录接口返回成功，OA后台查看未生效

答：调用上传打卡记录接口返回成功，但在企业OA后台考勤信息统计中未查到，请检查接口参数user_check_time值是否为13位毫秒单位时间戳。

获取考勤报表列值，返回的应出勤天数为0

答：应出勤天数字段，目前只支持获取距今15天内的值。

调用获取考勤报表列值接口报错{errcode:850015,errmsg:系统异常，请稍后重试}

答：调用获取考勤报表列值接口报上述错误时，请依次确认以下情况：

• 检查参数column_id_list的格式，String类型，多个id用","分割(示例："id1,id2,id3")。

• 检查参数column_id_list内的值，是否来自获取考勤报表列定义接口返回的报表列ID值，而非expression_id字段。

调用获取打卡结果接口，返回空{"errcode":0,"hasMore":false,"errmsg":"ok","recordresult":[]}

答：调用获取打卡结果时，接口返回的信息为空，请依次确认以下情况：

• 检查接口参数userId值是否正确，使用获取打卡接口接口的accessToken值调用查询用户详情接口，如果接口返回“userId不存在”，说明userId值不正确。

• 检查isI18n参数，如果是国内企业，isI18n参数必须传false，如果传了true获取不到考勤信息。

• 检查userIdList参数的格式是否正确。

调用获取打卡详情接口，返回空{"errcode":0,"errmsg":"ok","recordresult":[]}

答：调用获取打卡详情时，接口返回的信息为空，请依次确认以下情况：

• 检查接口参数userId值是否正确，使用获取打卡接口接口的accessToken值调用查询用户详情接口，如果接口返回“userId不存在”，说明userId值不正确。

• 检查checkDateFrom参数，如果用户打卡时间点是09:00，调用接口时参数传10:00，获取不到信息。

• 检查isI18n参数，如果是国内企业，isI18n参数必须传false，如果传了true获取不到考勤信息。

• 检查userIdList参数的格式是否正确。

调用获取考勤报表列值接口，返回系统异常{errcode:850015,errmsg:系统异常，请稍后重试,request_id:woae9xpid4xi}

答：调用获取考勤报表列值时，接口返回系统异常，请依次确认以下情况：

• 检查参数column_id_list的格式，String类型，多个id用","分割。示例："id1,ide2,id3"

• 检查参数column_id_list内的值，是否来自获取考勤报表列定义接口返回的id值，非expression_id字段

调用获取考勤报表列值接口，应出勤天数字段value有0的情况

答：调用获取考勤报表列值时，接口返回的信息中应出勤天数值为0的情况，如下所示：

解决方案：应出勤天数字段，目前只支持获取距今15天内的值。

调用获取用户考勤数据接口，返回信息为空

答：调用获取用户考勤数据时，接口返回的信息为空，如下所示：

解决方案：检查接口参数userId值是否正确，使用获取打卡接口接口的accessToken值调用查询用户详情接口，如果接口返回“userId不存在”，说明userId值不正确。