通知补卡审批发起

POST

/open-apis/attendance/v1/user_task_remedys

自建应用

对于只使用飞书考勤系统而未使用飞书审批系统的企业，可以通过该接口，将在三方审批系统中发起的补卡审批数据，写入到飞书考勤系统中。

错误码

HTTP状态码	错误码	描述	排查建议
400	1220001	参数错误	请检查参数是否符合要求
400	1220002	租户不存在	请检查 tenant_access_token 是否正确
400	1220004	用户不存在或没有权限	请检查用户 ID 是否正确
400	1220005	没有权限	请前往考勤管理后台检查数据权限范围
500	1225000	系统错误	详见错误信息
500	1225001	写入部分成功	详见错误信息
400	1226501	没有异常考勤	当天没有异常考勤，无需补卡
400	1226502	不允许补卡	考勤组设置不允许补卡
400	1226503	补卡日期限制	考勤组设置只允许补过去多少天的卡，超出可补卡日期
400	1226504	超出补卡次数	当前周期的补卡次数已用完

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://open.feishu.cn/open-apis/attendance/v1/user_task_remedys?employee_type=employee_id' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "user_id": "abd754f7",
    "remedy_date": 20210701,
    "punch_no": 0,
    "work_type": 1,
    "remedy_time": "2021-07-01 08:00",
    "status": 2,
    "reason": "忘记打卡",
    "time": "1611476284",
    "time_zone": "Asia/Shanghai",
    "create_time": "1611476284",
    "update_time": "1611476284"
}'

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "user_remedy": {
      "user_id": "abd754f7",
      "remedy_date": 20210701,
      "punch_no": 0,
      "work_type": 1,
      "approval_id": "6737202939523236113",
      "remedy_time": "2021-07-01 08:00",
      "status": 2,
      "reason": "忘记打卡",
      "time": "1611476284",
      "time_zone": "Asia/Shanghai",
      "create_time": "1611476284",
      "update_time": "1611476284"
    }
  }
}

请求参数

Query 参数

employee_type

必需

请求体和响应体中的 user_id 的员工工号类型示例值："employee_id" 可选值有： employee_id：员工 employee ID，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的用户 ID employee_no：员工工号，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的工号

示例值:

employee_id

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

user_id

string

必需

用户 ID 示例值："abd754f7"

remedy_date

integer

必需

补卡日期示例值：20210701

punch_no

integer

必需

第几次上下班，0：第 1 次上下班，1：第 2 次上下班，2：第 3 次上下班，自由班制填 0 示例值：0

work_type

integer

必需

上班 / 下班，1：上班，2：下班，自由班制填 0 示例值：1

approval_id

string

必需

审批 ID 示例值："6737202939523236113"

remedy_time

string

必需

补卡时间，时间格式为 yyyy-MM-dd HH:mm 示例值："2021-07-01 08:00"

status

integer

必需

补卡状态示例值：2 可选值有： 0：审批中 2：已通过 3：已取消 4：通过后撤回

reason

string

必需

补卡原因示例值："忘记打卡"

time

string

必需

补卡时间，精确到秒的时间戳示例值："1611476284"

time_zone

string

必需

补卡时考勤组时区示例值："Asia/Shanghai"

create_time

string

必需

补卡发起时间，精确到秒的时间戳示例值："1611476284"

update_time

string

必需

补卡状态更新时间，精确到秒的时间戳示例值："1611476284"

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

user_remedy

object

补卡审批信息

必需

修改于 2023-01-28 08:52:34

获取补卡记录

批量查询打卡流水

通知补卡审批发起

错误码#

请求参数

返回响应

错误码