接口文档：查询单个员工任职信息

scope: employee:workInfo:select

body参数

名称	类型	是否必填	描述
corpId	String	是	企业Id
empId	String	否	员工ID（empId 和 jobDataId 至少填一个）
effectDate	String	否	生效日期（格式：yyyy-MM-dd，未传则使用当前日期）
jobDataId	String	否	任职信息记录ID（empId 和 jobDataId 至少填一个）

说明：empId 和 jobDataId 可以二选一传入。如果传入 jobDataId，则直接查询指定的任职记录；如果传入 empId，则查询该员工在指定生效日期的任职信息。

返回参数

名称	类型	描述
success	Boolean	接口是否响应成功
errorCode	String	错误码（成功时为null）
errorMsg	String	错误提示原因（成功时为null）
data	Object	返回结果

data 数据结构

名称	类型	描述
jobDataId	String	任职信息记录ID
empId	String	员工ID
effectDate	String	生效日期（格式：yyyy-MM-dd）
operate	Array of Object	所属操作（选项数组）
operateType	Array of Object	操作类型（选项数组）
workInfo	Object	任职信息
workStatusInfo	Object	任职状态信息
quitInfo	Object	离职信息（在职员工为空对象）

workInfo 任职信息字段

字段名	类型	描述
mainDepartment	Array of Object	主部门（选项数组）
jobTitle	Array of Object	职位（选项数组）
jobLevel	Array of Object	职级（选项数组）
jobDuty	Array of Object	职务（选项数组）
jobSequence	Array of Object	职序（选项数组）
jobGrade	Array of Object	职等（选项数组）
manager	Array of Object	直属上级（选项数组）
orgManager	Array of Object	组织负责人（选项数组）
costCenter	Array of Object	成本中心（选项数组）
workLocation	String	工作地点
field_xxx	Array of Object / String	自定义字段（下拉类型为选项数组，其他类型为字符串）

workStatusInfo 任职状态字段

字段名	类型	描述
employeeStatus	Array of Object	员工状态（选项数组）
employeeType	Array of Object	员工类型（选项数组）
onBoardingDate	String	入职日期（格式：yyyy-MM-dd）
probationDate	String	转正日期（格式：yyyy-MM-dd）
probationPeriod	String	试用期（月）
companySeniorityAge	String	司龄（年）
ifHasProbationPeriod	Array of Object	是否有试用期（选项数组）
wasConverted	Array of Object	是否已转正（选项数组）
field_xxx	Array of Object / String	自定义字段

quitInfo 离职信息字段

说明：仅离职员工返回以下字段，在职员工返回空对象 {}

字段名	类型	描述
lastDayOfWork	String	最后工作日（格式：yyyy-MM-dd）
offBoardingType	Array of Object	离职类型（选项数组）
reasonForOffBoarding	Array of Object	离职原因（选项数组）
remarksForOffBoarding	String	离职备注

选项对象结构

operate、operateType、mainDepartment 等选项数组中每个元素的结构：

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

枚举值说明

operate 所属操作

value	label
onboarding	入职
offboarding	离职
jobchange	调动
other	其他调整

operateType 操作类型

value	label
firstOnBoarding	首次入职
reOnBoarding	再入职
activeOffBoarding	主动离职
passiveOffBoarding	被动离职
employeeTypeChange	员工类型变更
specialChange	特殊调整
promotion	晋升
demotion	降级
transfer	调动

employeeStatus 员工状态

value	label
probation	试用
formal	正式
quitted	离职

employeeType 员工类型

value	label
regular	全职
part_time	兼职
internship	实习
dispatching	劳务派遣
restart	退休返聘
epiboly	劳务外包

offBoardingType 离职类型

value	label
activeOffBoarding	主动离职
passiveOffBoarding	被动离职

ifHasProbationPeriod 是否有试用期

value	label
true	是
false	否

wasConverted 是否已转正

value	label
true	是
false	否

返回示例

{
    "data": {
        "jobDataId": "6435355f6709906d3475a9fa",
        "empId": "emp_7f65fc44f7e64d6195fa09bac4c33b66",
        "effectDate": "2023-03-03",
        "operate": [
            {
                "label": "入职",
                "value": "onboarding",
                "order": null,
                "status": null
            }
        ],
        "operateType": [
            {
                "label": "首次入职",
                "value": "firstOnBoarding",
                "order": null,
                "status": null
            }
        ],
        "workInfo": {
            "workLocation": "33",
            "manager": [
                {
                    "label": "未知",
                    "value": "emp_4bc9a5e1bd334eb6bf075e4bc8a991d6",
                    "order": null,
                    "status": null
                }
            ],
            "field_65caf3bb733c4a65af78fd78172d9725": [
                {
                    "label": "北京市",
                    "value": "11",
                    "order": null,
                    "status": null
                },
                {
                    "label": "北京市",
                    "value": "1101",
                    "order": null,
                    "status": null
                },
                {
                    "label": "东城区",
                    "value": "110101",
                    "order": null,
                    "status": null
                }
            ],
            "orgManager": [],
            "costCenter": [
                {
                    "label": "test123",
                    "value": "cost_center_de0d575811694740ac860778702dd797",
                    "order": null,
                    "status": "normal"
                }
            ],
            "jobTitle": [],
            "mainDepartment": [
                {
                    "label": "测试111",
                    "value": "813553628",
                    "order": null,
                    "status": "normal"
                }
            ],
            "jobLevel": []
        },
        "workStatusInfo": {
            "employeeType": [
                {
                    "label": "实习",
                    "value": "internship",
                    "order": 1,
                    "status": "normal"
                }
            ],
            "companySeniorityAge": "1",
            "onBoardingDate": "2023-03-03",
            "probationDate": "2023-09-01",
            "employeeStatus": [
                {
                    "label": "试用",
                    "value": "probation",
                    "order": 0,
                    "status": "normal"
                }
            ]
        },
        "quitInfo": {}
    },
    "success": true,
    "errorCode": null,
    "errorMsg": null
}

注意事项

自定义字段：workInfo 和 workStatusInfo 中以 field_ 开头的字段为企业自定义字段，字段名格式为 field_{fieldId}

级联选项：部分自定义字段（如地区选择）返回的是级联选项数组，包含多级选项（如省/市/区）

空数组：当某个选项字段没有值时，返回空数组 []

离职信息：quitInfo 仅在员工已离职时包含数据，在职员工返回空对象 {}

application/json

Bodyapplication/json

示例

{
  "data": {
    "jobDataId": "",
    "empId": "",
    "effectDate": "",
    "operate": [
      {
        "label": "",
        "value": "",
        "order": 0,
        "status": ""
      }
    ],
    "operateType": [
      {
        "label": "",
        "value": "",
        "order": 0,
        "status": ""
      }
    ],
    "workInfo": {
      "": {}
    },
    "workStatusInfo": {
      "": {}
    },
    "quitInfo": {
      "": {}
    }
  },
  "success": false,
  "errorCode": "",
  "errorMsg": ""
}

查询单个工作信息

接口文档：查询单个员工任职信息

body参数

返回参数

data 数据结构

workInfo 任职信息字段

workStatusInfo 任职状态字段

quitInfo 离职信息字段

选项对象结构

枚举值说明

operate 所属操作

operateType 操作类型

employeeStatus 员工状态

employeeType 员工类型

offBoardingType 离职类型

ifHasProbationPeriod 是否有试用期

wasConverted 是否已转正

返回示例

注意事项

请求参数

请求示例代码

返回响应

查询单个工作信息

接口文档：查询单个员工任职信息#

body参数#

返回参数#

data 数据结构#

workInfo 任职信息字段#

workStatusInfo 任职状态字段#

quitInfo 离职信息字段#

选项对象结构#

枚举值说明#

operate 所属操作#

operateType 操作类型#

employeeStatus 员工状态#

employeeType 员工类型#

offBoardingType 离职类型#

ifHasProbationPeriod 是否有试用期#

wasConverted 是否已转正#

返回示例#

注意事项#

请求参数

请求示例代码

返回响应

接口文档：查询单个员工任职信息

body参数

返回参数

data 数据结构

workInfo 任职信息字段

workStatusInfo 任职状态字段

quitInfo 离职信息字段

选项对象结构

枚举值说明

operate 所属操作

operateType 操作类型

employeeStatus 员工状态

employeeType 员工类型

offBoardingType 离职类型

ifHasProbationPeriod 是否有试用期

wasConverted 是否已转正

返回示例

注意事项