转交审批任务

对于单个审批任务进行转交操作。转交后审批流程流转给被转交人。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/corehr/v2/processes/:process_id/transfer
HTTP Method	PUT
接口频率限制	20 次/分钟
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	corehr:process.instance:write 通过/拒绝审批任务
字段权限要求	> Tip: 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请 contact:user.employee_id:readonly 获取用户 user ID

请求头

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

路径参数

名称	类型	描述
process_id	string	流程实例id，是一个流程的唯一标识。 可通过查询流程实例列表接口返回的 process_ids 字段获取 示例值："7410664363763172908"

查询参数

名称	类型	必填	描述
user_id_type	string	否	用户 ID 类型 示例值：open_id 可选值有： - open_id: 标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。了解更多：如何获取 Open ID - union_id: 标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多：如何获取 Union ID？ - user_id: 标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。了解更多：如何获取 User ID？ - people_corehr_id: 以飞书人事的 ID 来识别用户 默认值：open_id 当值为 user_id，字段权限要求： contact:user.employee_id:readonly 获取用户 user ID

请求体

名称	类型	必填	描述
operator	string	否	操作人，按user_id_type类型传递；如果system_user为true，则此字段可以不填 示例值："7184703091806602796"
to_user_id	string	是	被转交人，按user_id_type类型传递 示例值："7184703091806602796"
approver_ids	string\[\]	是	待转交审批任务id列表 同一个审批节点如果有多个审批人，不同审批人的 approver_id 不同。 可通过 获取单个流程详情接口获取流程中各审批任务的 approver_id。 示例值：["7424452160928106028"] 数据校验规则： - 长度范围：1 ～ 20
remark	string	否	备注 示例值："备注"
system_user	boolean	否	是否以系统身份操作，如果为fasle，则operator必填 示例值：true 默认值：false

请求体示例

{
    "operator": "7184703091806602796",
    "to_user_id": "7184703091806602796",
    "approver_ids": [
        "7424452160928106028"
    ],
    "remark": "备注",
    "system_user": true
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {}
}

错误码

HTTP状态码	错误码	描述	排查建议
500	1160500	系统异常	请咨询技术支持协助排查。
400	1160234	节点不支持转交	只有表单和审批节点可以转交
400	1160101	参数非法	参数错误，请操作接口字段说明自查
400	1160221	流程状态非法	进行中的流程才能转交
400	1161103	任务处理中	任务处理中，请稍后再试
400	1161003	无权限	请确认是否已申请权限
400	1160245	被转交人已是当前节点处理人	同一个节点下，审批人不能重复
400	1160117	员工不存在	请检查，用户id是否正确
500	1160025	对不起，系统出现问题，请稍后重试	如重试后仍失败，请咨询技术支持协助排查。