通知审批状态更新

对于只使用飞书考勤系统而未使用飞书审批系统的企业，可以通过该接口更新写入飞书考勤系统中的三方系统审批状态，例如请假、加班、外出、出差、补卡等审批，状态包括通过、不通过、撤销等。

Tip: 发起状态的审批才可以被更新为通过、不通过，已经通过的审批才可以被更新为撤销。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/attendance/v1/approval_infos/process
HTTP Method	POST
接口频率限制	50 次/秒
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	attendance:task 写入打卡数据

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

请求体

名称	类型	必填	描述
approval_id	string	是	审批实例 ID，获取方式：1）获取审批通过数据 2）写入审批结果 3）通知补卡审批发起（补卡情况下） 示例值："6737202939523236113"
approval_type	string	是	审批类型 - leave：请假 - out：外出 - overtime：加班 - trip：出差 - remedy：补卡 示例值："remedy"
status	int	是	审批状态 - 1：不通过 - 2：通过 - 4：撤销 注意 - 请假、外出、加班、出差只支持传撤销 - 补卡支持传不通过、通过和撤销 示例值：4

请求体示例

{
    "approval_id": "6737202939523236113",
    "approval_type": "remedy",
    "status": 4
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ approval_info	approval_info	审批信息
└ approval_id	string	审批实例 ID
└ approval_type	string	审批类型 可选值有： - leave: 请假 - overtime: 加班 - trip: 出差 - out: 外出 - remedy: 补卡
└ status	int	审批状态 可选值有： - 0: 待审批 - 1: 未通过 - 2: 已通过 - 3: 已取消 - 4: 已撤回

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "approval_info": {
            "approval_id": "6737202939523236113",
            "approval_type": "remedy",
            "status": 0
        }
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
400	1220001	param is invalid	入参校验失败，请根据具体返回的信息检查入参。例如“employee_type invalid”代表人员类型异常。如仍无法解决可联系 技术支持
400	1220002	tenant_id is empty	请检查入参中的 tenant_access_token是否正确
400	1220004	param is invalid	请参考实际返回的错误信息排查问题。例如“user_id does not exist or does not have permission”代表入参传入的用户id不存在或者没有权限。如仍无法解决可联系 技术支持
400	1220005	没有权限	请前往考勤管理后台检查数据权限范围
400	1220600	通用错误信息	通用错误信息包含多条，详细的错误信息以及处理建议可参见 错误信息
500	1225000	param is invalid	请参考实际返回的错误信息排查问题。例如“internal server error”代表内部服务异常。如仍无法解决可联系 技术支持
500	1226500	历史错误码，不再使用	-
500	1227500	param is invalid	班次服务异常错误码，请参考实际返回的错误信息排查问题。例如“[BatchGetLarkIDByOpenID] cannot find user larkID”代表没有找到对应lark uid。如仍无法解决可联系 技术支持