流转入职任务

配置入职流程后，可通过本接口流转进行中的任务

Tip: 该接口会按照应用拥有的「待入职人员」的权限范围返回数据，请提前在「开发者后台 - 权限管理 - 数据权限-飞书人事(企业版)数据权限范围」中申请「待入职人员」权限范围

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/corehr/v2/pre_hires/:pre_hire_id/transit_task
HTTP Method	POST
接口频率限制	1000 次/分钟、50 次/秒
支持的应用类型	custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	corehr:pre_hire:transit_tasks 入职任务流转

请求头

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

路径参数

名称	类型	描述
pre_hire_id	string	待入职ID，可从待入职列表接口获取 示例值："7345005664477775407"

请求体

名称	类型	必填	描述
task_id	string	是	任务标识码。 - 对于系统内置的任务，标识码与任务名称的对应关系如下所示： > 其中 创建账户SSO 为隐藏的任务节点，在 个人信息 前自动执行。 - 1：职位信息 - 2：个人信息 - 3：创建账户SSO - 4：签到 - 9：签署入职文件 - 对于自定义的任务节点（如：3095697a-065f-4627-a47c-46fe958a6754），名称的获取方式如下所示： 1. 通过 pre_hire_id 调用搜索待入职人员信息接口或查询待入职 2. 查询字段 fields 中添加 onboarding_info.onboarding_task_list 查询后返回的 onboarding_task_list 结构体中包含标识码和任务名字的对应关系，示例如下所示： json `{ "onboarding_task_list": [ { "task_code": "3095697a-065f-4627-a47c-46fe958a6754", "task_name": "修改入职日期", "task_status": "uninitialized" }`, `{ "task_code": "d37b9d7c-232d-4a55-98fa-541318234ede", "task_name": "工签补充任务", "task_status": "uninitialized" }` ] } 示例值："1"

请求体示例

{
    "task_id": "1"
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ success	boolean	是否成功流转任务

响应体示例

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

错误码

HTTP状态码	错误码	描述	排查建议
400	1161093	Transit task failed	任务流转失败，请联系管理员
400	1161094	Invalid workflow operation	当前步骤不允许执行
400	1161095	The task was not found, unable to operate	没有找到需要流转的任务
400	1161096	Task status error, unable to operate	任务状态不是进行中，不允许流转
400	1161097	Permission denied, please contact the administrator	无权限，请联系管理员
400	1161098	Form required field is lack, please check the form config	任务表单配置的必填字段没有填写，需要填写之后再流转