删除打卡流水

删除员工从开放平台导入的打卡记录。删除后会重新计算打卡记录对应考勤任务结果。

Tip: 当返回结果fail_record_ids不为空时，msg字段返回对应失败原因，格式为：

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/attendance/v1/user_flows/batch_del
HTTP Method	POST
接口频率限制	10 次/秒
支持的应用类型	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"

请求体

名称	类型	必填	描述
`record_ids`	`string\[\]`	是	打卡流水记录 ID，获取方式：1）批量查询打卡流水记录 2）获取打卡结果 3）导入打卡流水记录示例值：["6709359313699356941"] 数据校验规则： - 长度范围：`1` ～ `10`

请求体示例

json

{
    "record_ids": [
        "6709359313699356941"
    ]
}

响应

响应体

名称	类型	描述
`code`	`int`	错误码，非 0 表示失败
`msg`	`string`	错误描述
`data`	`\-`	-
└ `success_record_ids`	`string\[\]`	删除成功的流水记录ID列表
└ `fail_record_ids`	`string\[\]`	删除失败的流水记录ID列表

响应体示例

json

{
    "code": 0,
    "msg": "success",
    "data": {
        "success_record_ids": [
            "6709359313699356941"
        ],
        "fail_record_ids": [
            "6709359313699356941"
        ]
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
400	1220001	param is invalid	请参考实际返回的错误信息排查问题。例如“internal server error”代表内部服务异常。如仍无法解决可联系技术支持
400	1220002	tenant_id is empty	检查租户 ID
400	1220003	user_id type is not employee_id or employee_no	无效的用户 ID
400	1220006	enterprise tenant app has no privilege	按照错误信息指引，开启应用权限
500	1225000	system error	系统错误，可重试解决或咨询技术支持
500	1227000	management service error	系统错误，可重试解决或咨询技术支持

删除打卡流水 ​

请求 ​

请求头 ​

请求体 ​

请求体示例 ​

响应 ​

响应体 ​

响应体示例 ​

错误码 ​

删除打卡流水

请求

请求头

请求体

请求体示例

响应

响应体

响应体示例

错误码