接口文档：查询员工兼岗信息

scope: ptj:info2

body参数

名称	类型	是否必填	描述
corpId	String	是	企业Id
empId	String	是	员工ID
ptjStartDate	String	否	兼岗开始日期（格式：yyyy-MM-dd），用于筛选当前生效的兼岗信息
ptjEndDate	String	否	兼岗结束日期（格式：yyyy-MM-dd），用于筛选当前生效的兼岗信息
ptjDepartment	String	否	兼岗部门ID，用于筛选指定部门下的兼岗记录

查询逻辑说明：
如果同时传入 ptjStartDate 和 ptjEndDate：查询在该时间范围内生效的兼岗信息
如果只传入 ptjStartDate：查询开始日期早于该日期的兼岗信息
如果只传入 ptjEndDate：查询结束日期晚于该日期的兼岗信息
如果传入 ptjDepartment：仅返回指定部门下的兼岗记录

返回参数

名称	类型	描述
success	Boolean	接口是否响应成功
errorCode	String	错误码（成功时为null）
errorMsg	String	错误提示原因（成功时为null）
data	Array of Object	兼岗信息列表

data 兼岗记录字段说明

字段名	类型	描述
ptjId	String	兼岗记录ID（MongoDB ObjectId）
empId	String	员工ID
corpId	String	企业ID
procInsId	String	审批流程实例ID（可为null，无审批时不返回该字段）
ptjStartDate	String	兼岗开始日期（格式：yyyy-MM-dd）
ptjEndDate	String	兼岗结束日期（格式：yyyy-MM-dd，可为null表示无结束日期）
ptjType	Array of Object	兼岗类型（选项数组）
ptjDepartment	Array of Object	兼岗部门（选项数组）
ptjJobTitle	Array of Object	兼岗职位（选项数组，可为null）
ptjJobLevel	Array of Object	兼岗职级（选项数组，可为null）
ptjReason	String	兼岗原因（可为null）
field_xxx	Array of Object / String	自定义字段

选项对象结构

ptjType、ptjDepartment 等选项数组中每个元素的结构：

字段名	类型	描述
label	String	选项显示名称
value	String	选项值（用于数据存储和接口传参）
order	Integer	排序号（可为null）
status	String	选项状态（normal-正常，stop-停用）

枚举值说明

ptjType 兼岗类型

value	label
ptjOutJob	外派
ptjPartTimeJob	兼职
ptjSecondment	借调
selection_xxx	自定义兼岗类型（企业自定义）

说明：系统预置了外派、兼职、借调三种类型，企业也可以自定义兼岗类型，自定义类型的 value 以 selection_ 开头。

返回示例

{
    "data": [
        {
            "empId": "emp_ea405cf6aabb4078ba734e2db2b8b671",
            "procInsId": "c95ecd56-bfbe-11f0-b00a-00163e5cbd75",
            "ptjId": "69147696e4b0235f3139851e",
            "corpId": "ding4c7c311a701851ac35c2f4657eb6378f",
            "ptjStartDate": "2025-11-02",
            "ptjType": [
                {
                    "label": "劳务派遣",
                    "value": "selection_846039af0a9545c3b517393e07878cf8",
                    "order": 3,
                    "status": "normal"
                }
            ],
            "ptjDepartment": [
                {
                    "label": "绿萝3",
                    "value": "org_56925dca5abb4fd18707f434ee680a67",
                    "order": null,
                    "status": "normal"
                }
            ]
        },
        {
            "empId": "emp_ea405cf6aabb4078ba734e2db2b8b671",
            "ptjId": "6915c342e4b03df5fcfa937d",
            "corpId": "ding4c7c311a701851ac35c2f4657eb6378f",
            "ptjStartDate": "2025-11-13",
            "ptjType": [
                {
                    "label": "外派",
                    "value": "ptjOutJob",
                    "order": 1,
                    "status": "normal"
                }
            ],
            "ptjDepartment": [
                {
                    "label": "三月合同无权限验证新增数33",
                    "value": "org_7ea947e6ae7444e4a5ebbb6d5c9ea3e6",
                    "order": null,
                    "status": "normal"
                }
            ]
        }
    ],
    "success": true,
    "errorCode": null,
    "errorMsg": null
}

注意事项

返回数据为数组：一个员工可以有多条兼岗记录，接口返回该员工的所有兼岗信息列表

审批流程：procInsId 字段表示该兼岗记录关联的审批流程实例ID，如果兼岗未经过审批流程，则该字段不返回

自定义字段：企业可配置自定义兼岗字段，字段名格式为 field_{fieldId}

数据过滤：返回的数据不包含 gmtCreate、gmtModified、delete 等系统字段

空数组：当员工没有兼岗信息时，返回空数组 []

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json

示例

{
    "empId": "string",
    "corpId": "string",
    "ptjEndDate": "string",
    "ptjStartDate": "string",
    "ptjDepartment": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

查询员工兼岗信息

接口文档：查询员工兼岗信息#

body参数#

返回参数#

data 兼岗记录字段说明#

选项对象结构#

枚举值说明#

ptjType 兼岗类型#

返回示例#

注意事项#