更新员工基础信息

最后更新于:2020-07-09 20:28:26

可通过本接口可更新员工基础信息。  

更新员工基础信息子集下的信息,可更新字段包含除以下之外的所有子集字段:

1 特殊字段:“手机号”、“年龄”、“司龄”、“员工状态”、“证件号”、“工号”

2 异动相关字段:“入职日期”、“转正日期”、“试用期状态”、“部门”、“职位”、“职级”、“职务”、“工作地点”、“合同公司”、“离职日期”、“最后工作日”、“离职类型”、“离职原因”

接口调用请求说明

https请求方式:PUT

https://openapi.ihr360.com/openapi/thirdparty/api/v1/staffs/{staffId}

请求参数说明

调用前,在请求头信息中必须包含以下2项 Content-Type:application/json;charset=UTF-8 Authorization: Bearer access_token; 例如,获取到的有效凭证为8f87b9b1-9f66-4b32-9269-0d41a0face00,则头信息中数据应为: Content-Type:application/json;charset=UTF-8 Authorization: Bearer 8f87b9b1-9f66-4b32-9269-0d41a0face00。

请求参数属性描述

参数 类型 是否必须 说明
access_token String 调用接口凭证
staffId String 员工id
staffInfoFieldMap map 请求体(更新字段和更新值)

 

staffInfoFieldMap 的key由获取员工基本信息元数据定义接口返回数据的columnName组成。

请求数据样例

body:
{
"staffName": "接口",
"idCardType": "MTPFHKAMR",
"contractType": "LABOR_CONTRACT",
"staffType": "EXPATRIATE",
"initialWorkYears": "3",
"isUseLunar": "false",
"workPlace": "上海",
"country": "CN",
"workEmail": "***@123456.com",
"workPhone": "158****5059",
"emergencyContactMobile": "177",
"emergencyContactName": "徐",
"spouseName": "xudd",
"childName": "bb",
"weChatNo": "weixin",
"email": "***@123456.com",
"staffRemark": "一条备注",
"hukouAddress": "福建厦门",
"nickName": "miko",
"firstName": "饭",
"lastName": "冰冰",
"legalName": "范冰冰",
"nationality": "HAN",
"hukouType": "TOWN",
"birthday": "2000-02-02",
"marryStatus": "MARRIED",
"highestEducation": "DOCTOR",
"bloodType": "A",
"qqNo": "982099427",
"probationEndDate": "2020-09-10",
"probationLength": "3",
"contractBeginDate": "2019-01-01",
"contractEndDate": "2020-12-12",
"livingAddress": "上海宝山",
"nativePlace": "福建",
"politicalStatus": "PARTYMEMBER"
}

返回说明

正常情况下,"i人事"会返回如下JSON数据给第三方:

返回数据说明

属性 类型 说明
code Int 返回代码,成功是为1
message String 返回消息,成功时为OK
errorResult Boolean 错误结果,成功为false
data Boolean 返回数据,成功时为true

错误时,"i人事"会返回错误码等信息,JSON数据包示例如下:

返回数据样例

成功:

{ "data": true, "code": 1, "message": "OK", "errorResult": false }

失败:

{ "code": -1, "message": "字段:contractType:数据格式错误!", "errorResult": true }