接口文档：获取企业员工列表

scope: employee:list

body参数

名称	类型	是否必填	描述
corpId	String	是	企业Id
orgIds	Array of String	是	部门ID列表（数量范围：1~20个）
employeeStatus	String	否	员工状态（在职：working，离职quitted）
page	Integer	否	当前是第几页（从1开始，默认值：1）
pageSize	Integer	否	每页的数据量（默认值：30，最大值：100）
effectDate	String	否	生效日期（格式：yyyy-MM-dd，未传则使用当前日期）

返回参数

名称	类型	描述
code	int	接口是否响应成功（200->成功）
msg	String	错误提示原因
data	Object	返回结果

data 数据结构解释

名称	类型	描述
list	Array of Object	员工数据列表
page	Integer	当前是第几页（从1开始）
pageSize	Integer	每页的数据量
total	Long	总数据量

list 员工对象字段说明

说明：员工字段分为系统字段（固定字段）和自定义字段（以 field_emp_ 开头）。下拉选择类型字段会同时返回显示值和带 _source 后缀的选项详情。

一、基础信息字段

字段名	类型	描述
id	String	记录唯一标识
empId	String	员工ID
corpId	String	企业ID
name	String	姓名
idName	String	证件姓名
idNumber	String	证件号码
age	String	年龄
personalEmail	String	个人邮箱
nativeRegion	String	籍贯
currentResidentialAddress	String	现居住地址
providentFundAccount	String	公积金账号

二、任职信息字段

字段名	类型	描述
mainDepartment	String	主部门名称
mainDepartment_source	Array	主部门选项详情
jobTitle	String	职位名称
jobTitle_source	Array	职位选项详情
jobLevel	String	职级名称
jobLevel_source	Array	职级选项详情
manager	String	直属上级姓名
manager_source	Array	直属上级选项详情
orgManager	String	组织负责人姓名
orgManager_source	Array	组织负责人选项详情
mobileNumber	String	手机号码
employeeNumber	String	工号

三、任职状态字段

字段名	类型	描述
employeeStatus	String	员工状态（显示值）
employeeStatus_source	Array	员工状态选项详情
employeeType	String	员工类型（显示值）
employeeType_source	Array	员工类型选项详情

四、个人信息字段

字段名	类型	描述
gender	String	性别（显示值）
gender_source	Array	性别选项详情
idType	String	证件类型（显示值）
idType_source	Array	证件类型选项详情
maritalStatus	String	婚姻状况（显示值）
maritalStatus_source	Array	婚姻状况选项详情
ethnicity	String	民族（显示值）
ethnicity_source	Array	民族选项详情
politicalStatus	String	政治面貌（显示值）
politicalStatus_source	Array	政治面貌选项详情
hukouType	String	户籍类型（显示值）
hukouType_source	Array	户籍类型选项详情
hukouLocation	String	户籍地址（显示值，如"甘肃省/兰州市"）
hukouLocation_source	Array	户籍地址选项详情（省市级联）
contractCompany	String	合同公司（显示值）
contractCompany_source	Array	合同公司选项详情

五、日期字段

字段名	类型	描述
dateOfBirth	String	出生日期（格式：yyyy-MM-dd）
onBoardingDate	String	入职日期（格式：yyyy-MM-dd）
probationDate	String	转正日期（格式：yyyy-MM-dd）
dateEnteredWorkforce	String	首次参加工作时间（格式：yyyy-MM-dd）
validPeriodOfId	String	证件有效期（格式：yyyy-MM-dd）
lastDayOfWork	String	最后工作日（离职员工，格式：yyyy-MM-dd）
effectDate	String	生效日期（格式：yyyy-MM-dd HH:mm:ss）
invalidDate	String	失效日期（格式：yyyy-MM-dd HH:mm:ss）
gmtCreate	String	创建时间（格式：yyyy-MM-dd HH:mm:ss）
gmtModified	String	修改时间（格式：yyyy-MM-dd HH:mm:ss）

六、工龄字段

字段名	类型	描述
workSeniorityAge	String	工龄（年）
companySeniorityAge	String	司龄（年）

七、操作记录字段

字段名	类型	描述
operate	String	所属操作
operateType	String	操作类型
effectVersion	Integer	生效版本号
delete	String	删除状态

八、离职相关字段（离职员工特有）

字段名	类型	描述
offBoardingType	String	离职类型（显示值）
offBoardingType_source	Array	离职类型选项详情
reasonForOffBoarding	String	离职原因（显示值）
reasonForOffBoarding_source	Array	离职原因选项详情

九、文件字段

字段名	类型	描述
portraitSidePhotoOfId	Array	身份证人像面照片
backSidePhotoOfId	Array	身份证国徽面照片
offBoardingPaperwork	Array	离职材料/其他附件

十、审批信息字段

字段名	类型	描述
approvalInfos	Array	审批信息列表

十一、自定义字段

字段名模式	类型	描述
field_emp_stri_xxx	String	自定义字符串字段（根据企业配置动态返回）
field_emp_date_xxx	String	自定义日期字段
field_emp_numb_xxx	Number	自定义数字字段
field_emp_sele_xxx	String	自定义下拉字段（显示值）
field_emp_sele_xxx_source	Array	自定义下拉字段选项详情

枚举值说明

employeeStatus 员工状态

value	label
probation	试用
formal	正式
working	在职
quitted	离职

employeeType 员工类型

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

gender 性别

value	label
male	男
female	女

idType 证件类型

value	label
identity_card	居民身份证
hk_and_macao_id	港澳居民往来内地通行证
taiwan_id	台湾居民往来大陆通行证
passport	护照
others	其他

maritalStatus 婚姻状况

value	label
spinsterhood	未婚
married	已婚
divorced	离异
bereft	丧偶
separation	分居

politicalStatus 政治面貌

value	label
masses	群众
league_member	团员
communist	党员
other	其他

operate 所属操作

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

operateType 操作类型

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

delete 删除状态

value	label
normal	正常
(UUID)	已删除

_source 选项详情结构

带 _source 后缀的字段返回选项的详细信息：

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

文件对象结构

文件类型字段（如 portraitSidePhotoOfId）返回数组，每个元素结构：

字段名	类型	描述
empId	String	员工ID
corpId	String	企业ID
fileName	String	文件名
ossKey	String	OSS存储路径
key	String	相对路径
size	Number	文件大小（字节）
time	String	上传时间（格式：yyyy_MM_dd_HH_mm_ss_SSS）

审批信息结构

approvalInfos 字段返回数组，每个元素结构：

字段名	类型	描述
empFormTempleType	String	审批表单类型（如 JOB_CHANGE）
processInstanceId	String	审批流程实例ID
approvalStatus	String	审批状态（PASSED-已通过，REJECTED-已拒绝，RUNNING-进行中）

application/json

Bodyapplication/json

示例

{
    "data": {
        "list": [
            {
                "empId": "xxx",
                "gmtModified": "xxx",
                "mobileNumber": "xxx",
                "employeeType_source": [
                    {
                        "label": "xxx",
                        "value": "xxx",
                        "order": 0,
                        "status": "normal",
                        "markValue": null
                    }
                ],
                "idNumber": "xxx",
                "delete": "normal",
                "employeeStatus": "xxx",
                "idType_source": [
                    {
                        "label": "xxx",
                        "value": "xxx",
                        "order": 4,
                        "status": "normal",
                        "markValue": null
                    }
                ],
                "onBoardingDate": "xxx",
                "id": "xxx",
                "department": "xxx",
                "effectDate": "xxx",
                "employeeStatus_source": [
                    {
                        "label": "xxx",
                        "value": "xxx",
                        "order": 1,
                        "status": "normal",
                        "markValue": null
                    }
                ],
                "idType": "xxx",
                "corpId": "xxx",
                "operateType": "xxx",
                "gmtCreate": "xxx",
                "invalidDate": "xxx",
                "operate": "xxx",
                "employeeType": "xxx",
                "syncDingTalk": "xxx",
                "companySeniorityAge": "xxx",
                "mainDepartment_source": [
                    {
                        "label": "xxx",
                        "value": "xxx",
                        "order": null,
                        "status": null,
                        "markValue": null
                    }
                ],
                "effectVersion": "xxx",
                "name": "xxx",
                "department_source": [
                    {
                        "label": "xxx",
                        "value": "xxx",
                        "order": null,
                        "status": null,
                        "markValue": null
                    }
                ],
                "mainDepartment": "xxx"
            }
        ],
        "total": 0,
        "page": 0,
        "pageSize": 0,
        "notDataPermission": false
    },
    "success": false,
    "errorCode": "",
    "errorMsg": ""
}

获取企业员工列表

接口文档：获取企业员工列表

body参数

返回参数

data 数据结构解释

list 员工对象字段说明

一、基础信息字段

二、任职信息字段

三、任职状态字段

四、个人信息字段

五、日期字段

六、工龄字段

七、操作记录字段

八、离职相关字段（离职员工特有）

九、文件字段

十、审批信息字段

十一、自定义字段

枚举值说明

employeeStatus 员工状态

employeeType 员工类型

gender 性别

idType 证件类型

maritalStatus 婚姻状况

politicalStatus 政治面貌

operate 所属操作

operateType 操作类型

delete 删除状态

_source 选项详情结构

文件对象结构

审批信息结构

请求参数

请求示例代码

返回响应

获取企业员工列表

接口文档：获取企业员工列表#

body参数#

返回参数#

data 数据结构解释#

list 员工对象字段说明#

一、基础信息字段#

二、任职信息字段#

三、任职状态字段#

四、个人信息字段#

五、日期字段#

六、工龄字段#

七、操作记录字段#

八、离职相关字段（离职员工特有）#

九、文件字段#

十、审批信息字段#

十一、自定义字段#

枚举值说明#

employeeStatus 员工状态#

employeeType 员工类型#

gender 性别#

idType 证件类型#

maritalStatus 婚姻状况#

politicalStatus 政治面貌#

operate 所属操作#

operateType 操作类型#

delete 删除状态#

_source 选项详情结构#

文件对象结构#

审批信息结构#

请求参数

请求示例代码

返回响应

接口文档：获取企业员工列表

body参数

返回参数

data 数据结构解释

list 员工对象字段说明

一、基础信息字段

二、任职信息字段

三、任职状态字段

四、个人信息字段

五、日期字段

六、工龄字段

七、操作记录字段

八、离职相关字段（离职员工特有）

九、文件字段

十、审批信息字段

十一、自定义字段

枚举值说明

employeeStatus 员工状态

employeeType 员工类型

gender 性别

idType 证件类型

maritalStatus 婚姻状况

politicalStatus 政治面貌

operate 所属操作

operateType 操作类型

delete 删除状态

_source 选项详情结构

文件对象结构

审批信息结构