根据员工UserID集合获取指定条件的任职记录相关信息

POST

/TenantBaseExternal/api/v5/Employee/GetServiceInfoByIds

接口限制：100次/秒/企业 3000次/分钟/企业

适用场景：查询已知员工UserID的指定条件的任职记录相关信息

警告信息：1.ID列表元素个数需小于等于300
2.该接口支持元数据字段入参、出参控制

tips：1.该处为员工UserID，示例：["388551","388552"]
2.支持查询已删除的数据
3.支持根据Option参数快速查询，0：条件查询-使用参数中的其他条件进行查询、1：直接获取最新主职任职记录，其他条件自动忽略、2：直接获取当前生效的主职任职记录，其他条件自动忽略
4.默认查询条件：未删除、审批生效、主职
5.默认查询列：无
6.默认排序条件：UserID
7.累计工龄（WorkYearTotal）、累计集团工龄（WorkYearGroupTotal）、累计司龄（WorkYearCompanyTotal）非实时数据，而是每天定时任务刷新，故存在延迟情况

错误码示例

{
"data": null,
"code": "417",
"message": "Value cannot be null.\r\nParameter name: Argument name: Ids is null"
}

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://openapi.italent.cn/TenantBaseExternal/api/v5/Employee/GetServiceInfoByIds' \
--header 'Content-Type: application/json' \
--data-raw '{
    "option": "None",
    "empStatus":[
        1
    ],
    "employType" : null,
    "serviceType" : null,
    "approvalStatus":[
        4
    ],
    "oIds":[
        101501220
    ],
    "columns":["UserID","PObjectDataID","OIdDepartment"],//查询列
    "isWithDeleted" : false,
    "enableTranslate": true,//开启数据源自动翻译功能
}'

响应示例

{
  "data": [
    {
      "userID": 0,
      "pObjectDataID": "string",
      "oIdDepartment": 0,
      "startDate": "2019-08-24T14:15:22Z",
      "stopDate": "2019-08-24T14:15:22Z",
      "jobNumber": "string",
      "entryDate": "2019-08-24T14:15:22Z",
      "lastWorkDate": "2019-08-24T14:15:22Z",
      "regularizationDate": "2019-08-24T14:15:22Z",
      "probation": 0,
      "order": 0,
      "employType": 0,
      "serviceType": 0,
      "serviceStatus": 0,
      "approvalStatus": 0,
      "employmentSource": "string",
      "employmentForm": "string",
      "isCharge": "string",
      "oIdJobPost": "string",
      "oIdJobSequence": "string",
      "oIdJobPosition": "string",
      "oIdJobLevel": "string",
      "oidJobGrade": "string",
      "place": "string",
      "employeeStatus": "string",
      "employmentType": "string",
      "employmentChangeID": "string",
      "changedStatus": "string",
      "pOIdEmpAdmin": 0,
      "pOIdEmpReserve2": 0,
      "businessTypeOID": "string",
      "changeTypeOID": "string",
      "workYearBefore": 0,
      "workYearGroupBefore": 0,
      "workYearCompanyBefore": 0,
      "workYearTotal": 0,
      "workYearGroupTotal": 0,
      "workYearCompanyTotal": 0,
      "oIdOrganization": 0,
      "whereabouts": "string",
      "blackStaffDesc": "string",
      "blackListAddReason": "string",
      "transitionTypeOID": "string",
      "changeReason": "string",
      "probationResult": "string",
      "probationActualStopDate": "2019-08-24T14:15:22Z",
      "probationStartDate": "2019-08-24T14:15:22Z",
      "probationStopDate": "2019-08-24T14:15:22Z",
      "isHaveProbation": "string",
      "remarks": "string",
      "addOrNotBlackList": true,
      "businessModifiedBy": 0,
      "businessModifiedTime": "2019-08-24T14:15:22Z",
      "objectId": "string",
      "customProperties": {
        "property1": {},
        "property2": {}
      },
      "translateProperties": {
        "property1": "string",
        "property2": "string"
      },
      "createdBy": 0,
      "createdTime": "2019-08-24T14:15:22Z",
      "modifiedBy": 0,
      "modifiedTime": "2019-08-24T14:15:22Z",
      "stdIsDeleted": true
    }
  ],
  "code": "string",
  "message": "string"
}

请求参数

Body 参数application/json

option

string

可选

empStatus

array[string]

可选

人员状态，默认空，表示所有。示例：[2,3]，表示试用、正式。查看可用选项

employType

array[string]

可选

雇佣关系：默认内部员工，空表示查询全部。示例：[0,2]，表示内部员工、实习生。查看可用选项

serviceType

array[string]

可选

任职类型：默认主职，空表示查询全部。示例：[0]，表示主职。查看可用选项

approvalStatus

array[string]

可选

任职审批状态，默认审批生效，空表示查询全部。示例：[4]，表示审批生效。查看可用选项

oIds

array[integer <int32>]

可选

业务OId集合，示例：[116347665,116347666,116347667]。正整数，必填，元素个数小于等于300个

isWithDeleted

boolean

可选

是否包括已删除数据，默认否，示例：true/false

columns

array[string]

可选

查询字段列表，默认为null(获取全部信息)，非必填。注意：该参数仅表示是否查询该列的值，不控制响应模型的字段。例：["Name","OId","Code","Status"]

enableTranslate

boolean

可选

是否开启动态翻译，默认否，示例：true/false。开启后，自动翻译数据源等字典类型字段，结果在响应参数的TranslateProperties中，key为对应字段加Text后缀，值为翻译后文本

示例

返回响应

🟢200响应结果

application/json

Body

data

array [object {61}]

可选

userID

integer <int32>

可选

任职记录父对象员工信息业务实体UserID，示例：115515434

pObjectDataID

string

可选

父对象数据员工实体主键GUID，示例：8f84b89e-5d25-487f-98f8-78cff524434c

oIdDepartment

integer <int32> | null

可选

任职部门（如技术部），对应于组织单元业务实体关联的部门OId，示例：1019505

startDate

string <date-time> | null

可选

任职记录的生效时间，用于任职记录的时间轴，示例：2020-1-12

stopDate

string <date-time> | null

可选

任职记录的失效时间，用于任职记录的时间轴，示例：2020-12-31

jobNumber

string

可选

工号，示例：s00000365

entryDate

string <date-time> | null

可选

入职操作时，任职记录的入职日期，用于任职记录的时间轴，示例：2020-1-12

lastWorkDate

string <date-time> | null

可选

离职操作时，任职记录的最后工作日的日期，用于任职记录的时间轴，示例：2020-1-12

regularizationDate

string <date-time> | null

可选

试用期转正操作时，任职记录的转正日期，示例：2020-1-12

probation

integer <int32> | null

可选

试用期（月），0表示无试用期，示例：3

order

integer <int32> | null

可选

排序号，用于同一个员工多条任职记录排序，示例：10

employType

integer <int32> | null

可选

雇佣关系，查看可用选项

serviceType

integer <int32> | null

可选

任职类型，查看可用选项

serviceStatus

integer <int32> | null

可选

任职状态，查看可用选项

approvalStatus

integer <int32> | null

可选

审批状态，示例值：1（审批中），查看可用选项

employmentSource

string

可选

人员来源实体对象（实体编码：TenantBase.EmploymentSource）业务数据GUID，示例：e48c6360-7022-4338-ba9b-b3e5ec6518cd

employmentForm

string

可选

用工形式实体对象（实体编码：TenantBase.EmploymentForm）业务数据GUID，示例：e48c6360-7022-4338-ba9b-b3e5ec6518cd

isCharge

string

可选

是否部门负责人，"0"-否、"1"-是

oIdJobPost

string

可选

职务实体（实体编码：TenantBase.JobPost）OId字段的值，示例：62797

oIdJobSequence

string

可选

职务序列实体（实体编码：TenantBase.JobSequence）OId字段的值，示例：1459

oIdJobPosition

string

可选

职位实体（实体编码：TenantBase.JobPosition）OId字段的值，示例：a29c442e-b101-4cba-bd7c-6411c0b672a4

oIdJobLevel

string

可选

职级实体（实体编码：TenantBase.JobLevel）OId字段的值，示例：365f0d60-fa19-46a5-aee1-4240954b0ef5

oidJobGrade

string

可选

职等（实体编码：TenantBase.JobGrade）OId字段的值，必须为空或GUID，示例：8785dd30-7b2d-4fce-8fd3-df0e4be79f46

place

string

可选

工作地点，查看可用选项

employeeStatus

string

可选

人员状态，查看可用选项

employmentType

string

可选

人员类别实体对象（实体编码：TenantBase.EmploymentType）业务数据GUID，示例：e48c6360-7022-4338-ba9b-b3e5ec6518cd

employmentChangeID

string

可选

任职变更记录实体（实体编码：TenantBase.EmploymentChange）业务主键GUID，示例：365f0d60-fa19-46a5-aee1-4240954b0ef5

changedStatus

string

可选

变动后状态，查看可用选项

pOIdEmpAdmin

integer <int32> | null

可选

直线经理UserID，示例：116107372

pOIdEmpReserve2

integer <int32> | null

可选

虚线经理UserID，示例：116107372

businessTypeOID

string

可选

变动业务类型OID，查看可用选项

changeTypeOID

string

可选

变动类型ID，查看可用选项

workYearBefore

number <float> | null

可选

入职前累计工龄（年），示例：2.1

workYearGroupBefore

number <float> | null

可选

入职前集团工龄（年），示例：1.5

workYearCompanyBefore

number <float> | null

可选

入职前司龄（年），示例：1.5

workYearTotal

number <float> | null

可选

累计工龄（年），示例：1.5

workYearGroupTotal

number <float> | null

可选

累计集团工龄（年），示例：1.5

workYearCompanyTotal

number <float> | null

可选

累计司龄，示例：1.5

oIdOrganization

integer <int32> | null

可选

任职机构（如子公司），对应于组织单元业务实体关联的机构OId，示例：1019505

whereabouts

string

可选

离职后去向，查看可用选项

blackStaffDesc

string

加黑说明，如：违纪

可选

blackListAddReason

string

可选

加黑原因，查看可用选项

transitionTypeOID

string

可选

异动类型ID，查看可用选项

changeReason

string

可选

变动原因，查看可用选项

probationResult

string

可选

试用结果，查看可用选项

probationActualStopDate

string <date-time> | null

可选

试用期实际结束日期，示例：2020-1-12

probationStartDate

string <date-time> | null

可选

试用开始日期，示例：2020-1-12

probationStopDate

string <date-time> | null

可选

预计试用结束日期，示例：2020-1-12

isHaveProbation

string

可选

是否有试用期，示例：true

remarks

string

可选

备注如：xxx的A部门任职

addOrNotBlackList

boolean | null

可选

是否加入黑名单，布尔类型，示例：true

businessModifiedBy

integer <int32>

可选

业务修改人：只查询。系统更新数据时，该字段值不会修改。

businessModifiedTime

string <date-time>

可选

业务修改时间：只查询。系统更新数据时，该字段值不会修改。

objectId

string

可选

业务对象实体主键GUID

customProperties

object

可选

租户级别自定义字段Key（字段编码）-Value（字段值）字典，示例：key=exthtxybeizhua_127666_1123139652,value="自定义字段"

translateProperties

object

可选

动态翻译字段集合，用于数据源字段翻译功能，省去调用方调用翻译接口。翻译后字段名默认为翻译前字段名追加后缀Text，示例：[{"OIdJobPositionText","示例职位"}]

createdBy

integer <int32>

可选

创建人员工UserID，示例：115515434

createdTime

string <date-time>

可选

创建时间，示例：2021-01-01 14:00:00

modifiedBy

integer <int32>

可选

修改人员工UserID，示例：115515434。系统更新数据时，该字段值会修改。

modifiedTime

string <date-time>

可选

修改时间，示例：2021-01-01 14:00:00。系统更新数据时，该字段值会修改。

stdIsDeleted

boolean

可选

是否删除，示例：false

code

string

可选

响应码（正常情况必须200）或异常错误编码（异常情况）：200-OK，417-参数异常、业务不合法，500-内部服务器异常。示例："200"

message

string

结果消息

可选

发起离职交接流程

根据时间窗滚动查询变动的员工与单条任职信息

根据员工UserID集合获取指定条件的任职记录相关信息

错误码示例#

请求参数

返回响应

错误码示例