单个/批量查询员工信息

支持按多种条件单查或批量查询当前企业下的员工信息,返回员工基础信息及在企业下的部门、成本中心、状态、时间戳等聚合信息。

该接口适用于使用绿色公务APP叫车、免登企业H5叫车接入方进行员工信息查询/对账。

请求地址: /v2/common/batchQueryEmpList

服务协议: HTTP/POST

Content-Type: application/x-www-form-urlencoded

请求参数:

参数名称 类型 必选 说明
client_id string Y 申请的client_id
timestamp long Y 时间戳
sign string Y 签名
extUserIds string N 员工唯一ID 列表(批量),英文逗号分隔,最多 100 个
outEmpIds string N 员工工号列表(批量),英文逗号分隔,最多 100 个
phones string N 手机号列表(批量),英文逗号分隔,最多 100 个
extUserId string N 员工唯一ID(单查,精确匹配)
phone string N 手机号(单查,精确匹配)
empName string N 员工姓名(单查,精确匹配)
includeDeleted boolean N 是否含已删除员工,默认 false

命中优先级:extUserIds > outEmpIds > phones > extUserId > phone > empName。 命中即按该条件查询,忽略其他条件;全部为空时降级返回前 100 条。

响应data参数:

接口直接返回员工列表 List<UpmsEmpListItem>,单条结构如下:

参数名称 类型 必有 说明
extUserId string N 员工唯一ID(第三方用户ID,每企业唯一)
name string Y 员工姓名
outEmpId string N 员工工号
mobile string N 手机号
deptName string N 部门名称:在职员工取当前部门;已离职/已删除员工取离职时所在部门
costCenter string N 所属成本中心名称,多个以英文逗号拼接
status int Y 状态:1-正常,0-已离职或已删除
createTime long Y 创建时间(毫秒时间戳)
updateTime long Y 最后更新时间(毫秒时间戳)
deleteTime long N 删除时间(毫秒时间戳):软删时优先取离职时间,无则回退更新时间;未软删则为 null

结果示例:

{
  "code": 200,
  "message": "成功",
  "data": [
    {
      "extUserId": "EX10001",
      "name": "张三",
      "outEmpId": "E001",
      "mobile": "13800000001",
      "deptName": "研发,架构组",
      "costCenter": "CC-A,CC-B",
      "status": 1,
      "createTime": 1700000000000,
      "updateTime": 1700000001000,
      "deleteTime": null
    },
    {
      "extUserId": "EX10002",
      "name": "李四",
      "outEmpId": "E002",
      "mobile": "13800000002",
      "deptName": "财务部",
      "costCenter": "CC-C",
      "status": 0,
      "createTime": 1700000002000,
      "updateTime": 1700000003000,
      "deleteTime": 1700000003000
    }
  ]
}