根据员工工号查询岗位信息

接口描述

此接口用于使用工号查询员工的岗位信息

接口权限

本接口需要集团权限

请求URI

/api/openapi/users/posts/by/employeeId

请求方式

GET

请求参数示例

/api/openapi/users/posts/by/employeeId?employeeId=EMP-001

请求参数说明

参数名	类型	是否必填	约束	说明
employeeId	String	是	最大长度 32	员工工号
baseDate	String	否	日期格式：yyyy-MM-dd	基准日 无值：取系统日期时间点有效的岗位 有值：取基准日期时间点有效的岗位

接口返回示例

{
    "employeeId": "EMP-001",
    "fullName": "張三",
    "email": "san.zhang@spendia.jp",
    "onboardDate": "2019-12-27",
    "status": "NORMAL",
    "posts": [
      {
          "companyCode": "JP002",
          "departmentCode": "D1",
          "fromDate": "2022-12-27",
          "toDate": "9999-12-31",
          "staffLevel": "3",
          "job": "1231",
          "approvalLevel": "123",
          "managerEmployeeId": "007",
          "staffType": "01",
          "isPrimary": true,
          "postCustomFields": [
                {
                    "fieldCode": "user-group1",
                    "value": "mail_001"
                },
                {
                    "fieldCode": "secondJob",
                    "value": "456"
                }
           ]
      }, 
      {
          "companyCode": "CMP-002",
          "departmentCode": "DEV2",
          "fromDate": "2023-1-27",
          "endDate": "9999-12-31",
          "staffLevel": "5",
          "job": "12345",
          "approvalLevel": "123",
          "managerEmployeeId": "008",
          "staffType": "02",
          "isPrimary": false,
          "postCustomFields": [
                {
                    "fieldCode": "user-group1",
                    "value": "mail_001"
                },
                {
                    "fieldCode": "secondJob",
                    "value": "456"
                }
           ]
      }
   ]
}

接口返回字段

字段名	类型	规则	说明
employeeId	String	最大32文字	员工工号
fullName	String	最大100文字	员工姓名
email	String	最大128文字	邮箱
onboardDate	Date	日付フォーマット：yyyy-MM-dd	入职日
status	String		NORMAL-在职 LEAVING-待离职 RESIGNED-已离职
posts	Post[]		岗位信息列表

Post

字段名	类型	规则	说明
companyCode	String		员工所属公司
departmentCode	String		员工所属部门
fromDate	Date	日期格式：yyyy-MM-dd	开始日
toDate	Date	日期格式：yyyy-MM-dd	终了日
staffLevel	String		员工级别
job	String		职务
approvalLevel	String		审批级别
managerEmployeeId	String		直属经理
staffType	String		人员类型
isPrimary	Boolean		岗位flag 主岗:true 兼岗:false
postCustomFields	CustomField[]		员工扩展字段列表

CustomField

参数名	类型	约束	说明
fieldCode	String	最大长度 50	自定义字段编码
value	String	最大长度 200	自定义字段值，如果自定义字段设定为必填，则该值不可为空

失败示例

{
    "message": "当前操作需要租户权限",
    "errorCode": "120001"
}

字段说明

字段名称	类型	说明
message	String	返回信息说明
errorCode	String	返回错误码

错误代码

errorCode	message	说明
120001	当前操作需要租户权限
6013009	日期格式为:yyyy-MM-dd
120003	缺少必填项:{0}