更新员工
接口说明: 更新员工信息接口，目前仅支持更新在职、待入职员工信息
本接口仅支持数据更新，入职、转正式等操作还请到薪人薪事平台进行操作员工的字段信息目前支持单行文本，多行文本，日期，选项，城市、单个图片、单个文件类型，文件组的字段更新。
更新员工虚拟部门得更新虚拟部门字段，而不是虚拟部门id字段，且必须传id，中间分隔符是,
更新员工的文件组类型字段，值必须是file对象的数组转成的json字符串
file对象:
fileName:文件名。
fileKey:文件key,可以通过文件下载接口下载文件。
fileUrl:不用传
城市类型字段更新时要求字段的值必须是二级城市的fullName，参考城市列表接口。
职级字段要求字段的值必须是系统中存在的职级名称，参考职级列表接口。
例如:
{
"工作城市":"河北省石家庄市",
"职级":"M0-1"
}
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/employee/update
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| employeeId | String | Y | 员工ID |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
| name | String | N | 员工名字 |
| mobile | String | N | 手机号 |
| String | N | 工作邮箱 | |
| entryDate | String | N | 入职时间,格式2017-03-02 |
| hireType | Integer | N | 聘用类型,0-正式,10-实习,11-劳务,12-顾问,13-返聘,14-外包,15-兼职 |
| fields | Map<String,String> | N | 员工字段信息，参考员工详情接口中的fields字段 |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 0成功，其他失败 |
| errmsg | String | Y | 结果描述 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/employee/update?sign=X5O4br3gDtG1wMwSnWCkWe%2BXIgQ%3D
请求Body示例:
{
"entryDate": "2020-11-24",
"hireType": 0,
"name": "张四",
"mobile": "19400232259",
"employeeId": "3cfd59661b0642659f12eb8c75ad0f18",
"fields": {
"联系手机": "19244004400",
"纳税城市": "河北省石家庄市",//二级城市的fullName
"工作地点": "河北省石家庄市",//二级城市的fullName
"直属下属数量": "520",
"开户行": "北京天安门支行",
"司龄": "18",
"首次参加工作时间": "1999-12-22",
"有无违法违纪行为": "无",
"居住证截止日期": "2020-11-11",
"籍贯": "河北省石家庄市",//二级城市的fullName
"性别": "女",
"属相": "请选择",
"婚姻状况": "已婚",
"民族": "汉族",
"虚拟部门": "a508dd1c9c2f466ca72bff2dee9b3f9f,1fbb57bf778241fb8273035bb4070cbb",
"测试文件组":"[{\"fileName\":\"1.png\",\"fileKey\":\"cH830por/GAVkC1xiXpv0zllNGY2NzdmYmRmMzk1YjliMmFjMGYyYjMyMmNlMDhhMjVkOGNlYmQ3ZjFjMzIzMjNjMWMwMjllNWI5OWJiODLwUvYJv5wIpjRCPAbzTIYTpfJIOVLv2MBLBPNa4EyCEIWbP6Nn19LuIyCTHx0IgD4vPYFALzM5P9/cAQ0eaK/12iC10PCOp0K+NU5OHhwN6qYPdMReyfKg2MlO7U7iy6gJvqQQZroZqqDPfikGT+65uTEJSR2FPlc1tjARws5mRQ==\"}]"
},
"timestamp": 1606200248573
}
SDK请求示例(java):
EmployeeUpdateRequest request = new EmployeeUpdateRequest(access_token);
request.setEmployeeId("3cfd59661b0642659f12eb8c75ad0f18");
request.setName("张四");
request.setMobile("19400232259");
request.setEntryDate("2020-11-24");
request.setHireType(HireTypeEnum.OFFICIAL);
Map<String, String> map = new HashMap<>();
map.put("性别", "女");
map.put("民族", "汉族");
map.put("婚姻状况", "已婚");
map.put("属相", "请选择");
map.put("联系手机", "19244004400");
map.put("纳税城市", "河北省石家庄市");
map.put("工作地点", "河北省石家庄市");
map.put("直属下属数量", "520");
map.put("开户行", "北京天安门支行");
map.put("司龄", "18");
map.put("首次参加工作时间", "1999-12-22");
map.put("有无违法违纪行为", "无");
map.put("居住证截止日期", "2020-11-11");
map.put("籍贯", "河北省石家庄市");
map.put("虚拟部门","a508dd1c9c2f466ca72bff2dee9b3f9f,1fbb57bf778241fb8273035bb4070cbb");
map.put("测试文件组","[{\"fileName\":\"1.png\",\"fileKey\":\"cH830por/GAVkC1xiXpv0zllNGY2NzdmYmRmMzk1YjliMmFjMGYyYjMyMmNlMDhhMjVkOGNlYmQ3ZjFjMzIzMjNjMWMwMjllNWI5OWJiODLwUvYJv5wIpjRCPAbzTIYTpfJIOVLv2MBLBPNa4EyCEIWbP6Nn19LuIyCTHx0IgD4vPYFALzM5P9/cAQ0eaK/12iC10PCOp0K+NU5OHhwN6qYPdMReyfKg2MlO7U7iy6gJvqQQZroZqqDPfikGT+65uTEJSR2FPlc1tjARws5mRQ==\"}]");
request.setFields(map);
OpenapiResponse<Void> response = XrxsEmployeeService.updateEmployee(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": null
}