# 流转入职任务
配置入职流程后，可通过本接口流转进行中的任务
**注意事项**：该接口会按照应用拥有的「待入职人员」的权限范围返回数据，请提前在「开发者后台 - 权限管理 - 数据权限-飞书人事(企业版)数据权限范围」中申请「待入职人员」权限范围
## 请求
基本 |
---|---
HTTP URL | https://open.feishu.cn/open-apis/corehr/v2/pre_hires/:pre_hire_id/transit_task
HTTP Method | POST
接口频率限制 | [1000 次/分钟、50 次/秒](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
支持的应用类型 | Custom App
权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 入职任务流转(corehr:pre_hire:transit_tasks)
### 请求头
名称 | 类型 | 必填 | 描述
---|---|---|---
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"
### 路径参数
名称 | 类型 | 描述
---|---|---
pre_hire_id | string | 待入职ID，可从[待入职列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/pre_hire/search)接口获取
**示例值**："7345005664477775407"
### 请求体
名称 | 类型 | 必填 | 描述
---|---|---|---
task_id | string | 是 | 任务标识码。
- 对于系统内置的任务，标识码与任务名称的对应关系如下所示：
> 其中 **创建账户SSO** 为隐藏的任务节点，在 **个人信息** 前自动执行。
- 1：职位信息
- 2：个人信息
- 3：创建账户SSO
- 4：签到
- 9：签署入职文件
- 对于自定义的任务节点（如：3095697a-065f-4627-a47c-46fe958a6754），名称的获取方式如下所示：
1. 通过 `pre_hire_id` 调用[搜索待入职人员信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/pre_hire/search)接口或[查询待入职](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/pre_hire/query)
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"
### 请求体示例
```json
{
"task_id": "1"
}
```
## 响应
### 响应体
名称 | 类型 | 描述
---|---|---
code | int | 错误码，非 0 表示失败
msg | string | 错误描述
data | \- | \-
success | boolean | 是否成功流转任务
### 响应体示例
```json
{
"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 | 任务表单配置的必填字段没有填写，需要填写之后再流转