# 通知补卡审批发起
对于只使用飞书考勤系统而未使用飞书审批系统的企业，可以通过该接口，将在三方审批系统中发起的补卡审批数据，写入到飞书考勤系统中，状态为审批中。写入后可以由[通知审批状态更新](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/approval_info/process) 进行状态更新
## 请求
基本 |
---|---
HTTP URL | https://open.feishu.cn/open-apis/attendance/v1/user_task_remedys
HTTP Method | POST
接口频率限制 | [50 次/秒](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
支持的应用类型 | Custom App、Store App
权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 写入打卡数据(attendance:task)
### 请求头
名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`
**值格式**："Bearer `access_token`"
**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"
[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"
### 查询参数
名称 | 类型 | 必填 | 描述
---|---|---|---
employee_type | string | 是 | 响应体中的 user_id 的员工ID类型。如果没有后台管理权限，可使用[通过手机号或邮箱获取用户 ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/batch_get_id)
**示例值**：employee_id
**可选值有**：
- employee_id：员工 employee ID，即[飞书管理后台](https://example.feishu.cn/admin/contacts/departmentanduser) > 组织架构 > 成员与部门 > 成员详情中的用户 ID
- employee_no：员工工号，即[飞书管理后台](https://example.feishu.cn/admin/contacts/departmentanduser) > 组织架构 > 成员与部门 > 成员详情中的工号
### 请求体
名称 | 类型 | 必填 | 描述
---|---|---|---
user_id | string | 是 | 用户 ID，对应employee_type
**示例值**："abd754f7"
remedy_date | int | 是 | 补卡日期，日期格式yyyyMMdd
**示例值**：20210701
punch_no | int | 是 | 第几次上下班，0：第 1 次上下班，1：第 2 次上下班，2：第 3 次上下班，自由班制填 0
**示例值**：0
work_type | int | 是 | 上班 / 下班，1：上班，2：下班，自由班制填 0
**示例值**：1
remedy_time | string | 是 | 补卡时间，时间格式为 yyyy-MM-dd HH:mm
**示例值**："2021-07-01 08:00"
reason | string | 是 | 补卡原因
**示例值**："忘记打卡"
time | string | 否 | 字段已失效
**示例值**："-"
### 请求体示例
```json
{
"user_id": "abd754f7",
"remedy_date": 20210701,
"punch_no": 0,
"work_type": 1,
"remedy_time": "2021-07-01 08:00",
"reason": "忘记打卡",
"time": "-"
}
```
## 响应
### 响应体
名称 | 类型 | 描述
---|---|---
code | int | 错误码，非 0 表示失败
msg | string | 错误描述
data | \- | \-
user_remedy | user_task_remedy | 补卡审批信息
user_id | string | 用户 ID，对应employee_type
remedy_date | int | 补卡日期，日期格式yyyyMMdd
punch_no | int | 第几次上下班，0：第 1 次上下班，1：第 2 次上下班，2：第 3 次上下班，自由班制填 0
work_type | int | 上班 / 下班，1：上班，2：下班，自由班制填 0
approval_id | string | 审批 ID，可用于[通知审批状态更新](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/approval_info/process)
remedy_time | string | 补卡时间，时间格式为 yyyy-MM-dd HH:mm
status | int | 无效字段，默认数据全部返回的类型为审批中，需要调用[通知审批状态更新](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/approval_info/process)
**可选值有**：
- 0：审批中
- 1：未通过
- 2：已通过
- 3：已取消
- 4：通过后撤回
reason | string | 补卡原因
time | string | 无效字段
time_zone | string | 无效字段
create_time | string | 无效字段
update_time | string | 无效字段
### 响应体示例
```json
{
"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": "-",
"time_zone": "-",
"create_time": "-",
"update_time": "-"
}
}
}
```
### 错误码
HTTP状态码 | 错误码 | 描述 | 排查建议
---|---|---|---
400 | 1220001 | param is invalis | 入参校验失败，请根据具体返回的信息检查入参。例如“employee_type invalid”代表人员类型异常。如仍无法解决可联系 [技术支持](https://applink.feishu.cn/TLJpeNdW)
400 | 1220002 | tenant_id is empty | 请检查入参中的 tenant_access_token是否正确
400 | 1220004 | param is invalis | 请参考实际返回的错误信息排查问题。例如“user_id is not exist or does not have permission”代表入参传入的用户id不存在或者没有权限。如仍无法解决可联系 [技术支持](https://applink.feishu.cn/TLJpeNdW)
400 | 1220005 | 没有权限 | 请前往[考勤管理后台](https://oa.feishu.cn/attendance/manage/member/list)检查数据权限范围
400 | 1220600 | 通用错误信息 | 通用错误信息包含多条，详细的错误信息以及处理建议可参见[错误信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/attendance-development-guidelines)。
500 | 1225000 | param is invalis | 请参考实际返回的错误信息排查问题。例如“internal server error”代表内部服务异常。如仍无法解决可联系 [技术支持](https://applink.feishu.cn/TLJpeNdW)
500 | 1225001 | param is invalis | 请参考实际返回的错误信息排查问题。返回错误格式为导入的审批数据，格式为：{"TripErrorRecords":"","OvertimeWorkErrorRecords":"","LeaveErrorRecords":"","OutErrorRecords":""}。如仍无法解决可联系 [技术支持](https://applink.feishu.cn/TLJpeNdW)
400 | 1226501 | no need remedy | 当天没有异常考勤，无需补卡
400 | 1226502 | not allowed remedy | 考勤组设置不允许补卡
400 | 1226503 | approval time beyond the time range | 考勤组设置只允许补过去多少天的卡，超出可补卡日期
400 | 1226504 | no remedy time left | 超出补卡次数，当前周期的补卡次数已用完