直接退休正式员工

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

适用场景：1.主要用于直接退休正式员工
2.退休无申请功能
3.外部人员、已离职人员不支持退休

警告信息：1.为防止并发请求导致重复数据，请求参数相同时，3秒内仅能请求一次，否则进行错误提示
2.该操作不支持修改生效日期（ServiceInfoFields.StartDate）

tips：1.必填项：最后工作日（lastWorkDate）、退休类型（ServiceInfoFields.ChangeTypeOID）、退休后管理部门（ServiceInfoFields.OIdDepartment）
2.人员UserId标识（OId）或外部ID标识（OriginalId，第三方系统唯一标识ID（非北森系统））必须有且仅有一个有值
3.XXX外部ID标识（XXXOriginalId字段，如HRBPOriginalId），表示可以使用第三方系统唯一标识ID（非北森系统），而不用使用北森内部的ID标识。系统中会自动根据已有的外部ID和内部ID字段映射关系，进行转换处理。前提是系统中已通过新增操作关联该外部ID，否则报错。

错误码示例

{
"code": "417",
"message": "testlhz133存在未生效的退休记录（生效日期：2021-07-02），无法执行当前操作！请在生效日期后发起新的业务，或联系系统管理员处理"
}

curl --location --request POST 'https://openapi.italent.cn/TenantBaseExternal/api/v5/Employee/Retired' \ --header 'Content-Type: application/json' \ --data-raw '{ "userId" : 101501410, "employmentRecord" : { "lastWorkDate" : "2021-07-01", "changeTypeOID" : "17", "oIdDepartment" : 4624803, "isCharge": "0", "oIdOrganization": 900127666, "poIdEmpAdmin": 101178784, "poIdEmpReserve2": 101500687, "employmentSource": "d5c77d41-a8f4-4dae-9bca-d1f4cdb60520", "employmentForm": "db4e33b9-d83c-4a58-86ab-083e3b488d95", "employmentType": "05773898-47aa-4dee-85dc-0cfc85f6237b", "oIdJobPost": "2022", "oIdJobSequence": "371", "oIdJobPosition": "64c9a5b2-2c31-4f90-a547-990f3be1a513", "oIdJobLevel": "b410ef25-af77-4a4c-84e4-e6ca61ccc96d", "oidJobGrade": "8a82cd49-91fb-41ce-a2b4-e433714a8141", "place": "1108", "jobNumber": "bs8898", "probationStopDate": "2021-10-07T00:00:00", "objectId": "d9c97d1e-b69e-459d-836f-9223e3b7f907", "customProperties": { "extbeizhua_127666_398499608": "这是一个备注字段" } } } //外部id调用示例 { "originalId" : "8785dd30-7b2d-4fce-8fd3-df0e4be79f46", "employmentRecord" : { "lastWorkDate" : "2021-07-01", "changeTypeOID" : "17", "oIdDepartment" : 4624803, "isCharge": "0", "oIdOrganization": 900127666, "poIdEmpAdmin": 101178784, "poIdEmpReserve2": 101500687, "employmentSource": "d5c77d41-a8f4-4dae-9bca-d1f4cdb60520", "employmentForm": "db4e33b9-d83c-4a58-86ab-083e3b488d95", "employmentType": "05773898-47aa-4dee-85dc-0cfc85f6237b", "oIdJobPost": "2022", "oIdJobSequence": "371", "oIdJobPosition": "64c9a5b2-2c31-4f90-a547-990f3be1a513", "oIdJobLevel": "b410ef25-af77-4a4c-84e4-e6ca61ccc96d", "oidJobGrade": "8a82cd49-91fb-41ce-a2b4-e433714a8141", "place": "1108", "jobNumber": "bs8898", "probationStopDate": "2021-10-07T00:00:00", "objectId": "d9c97d1e-b69e-459d-836f-9223e3b7f907", "customProperties": { "extbeizhua_127666_398499608": "这是一个备注字段" } } }'

直接退休正式员工

错误码示例#

请求参数

返回响应

错误码示例