获取员工详情信息
接口说明: 根据员工id获取员工的详细信息。可以通过此接口获取员工的基本信息，账号信息，通讯信息
自定义信息，岗位信息等字段信息。
特殊说明:字段是文件组或图片组类型的情况下，值是文件对象列表转成的json字符串。
fileName:文件名。
fileKey:文件key,可以通过文件下载接口下载文件。
fileUrl:文件下载地址。
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/employee/detail
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 参数类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| employeeId | String | Y | 员工id |
| status | Integer | N | 员工状态，默认为0。0:在职员工、1:离职员工、2:待入职、8:删除 |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 0成功，其他失败 |
| errmsg | String | Y | 结果描述 |
| data | EmployeeDetail | Y | 员工信息 |
EmployeeDetail
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| employeeId | String | Y | 员工ID |
| entryDate | String | Y | 入职时间，格式:yyyy-MM-dd |
| hireType | Integer | Y | 聘用类型,0-正式,10-实习,11-劳务,12-顾问,13-返聘,14-外包,15-兼职 |
| mobile | String | Y | 手机号 |
| String | Y | 工作邮箱 | |
| name | String | Y | 员工名字 |
| status | Integer | Y | 员工状态，0:在职员工、1:离职员工、2:待入职、8:删除 |
| addtime | Integer | Y | 添加时间 |
| modtime | Integer | Y | 更新时间 |
| dismissionType | Integer | N | 离职类型，0:主动离职,1:被动离职,2:退休,3:协商解除,999:其他 |
| dismissionReason | String | N | 离职原因 |
| dismissionDate | String | N | 离职日期，格式:yyyy-MM-dd |
| secondment | Integer | N | 是否派入 0:否 1:是 eg：员工是A公司的，派到B公司兼职。A公司就是派出，B公司是派入 |
| seconded | Integer | N | 是否派出 0:否 1:是 |
| fields | Map<String,String> | Y | 员工字段信息 |
特殊说明:员工字段信息里面的“护照号”更名为“证件号”
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/employee/detail?sign=X5O4br3gDtG1wMwSnWCkWe%2BXIgQ%3D
请求Body示例:
{
"employeeId": "3cfd59661b0642659f12eb8c75ad0f18",
"status": 0,
"timestamp": 1606199386843
}
SDK请求示例(java):
EmployeeInfoRequest request = new EmployeeInfoRequest(access_token);
request.setEmployeeId("3cfd59661b0642659f12eb8c75ad0f18");
request.setStatus(EmpStatusEnum.ON_JOB);
OpenapiResponse<EmployeeDetail> employee = XrxsEmployeeService.getDetailEmployee(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"employeeId": "04577f3277f841248f17d36e2561f642",
"name": "方旭",
"mobile": "19002393231",
"entryDate": "2019-11-12",
"hireType": 0,
"email": "fangyu@xrxs.com",
"status": 0,
"addtime":1606100590,
"modtime":1606308521,
"dismissionType": 0,
"dismissionReason": "",
"dismissionDate": "",
"secondment":1,//派入
"seconded":1,//派出
"fields": {
"部门": "a54e4cbb3c114fd8b8c0e7d85ee024e7",//部门id
"岗位": "ffe93f52aaf54cd285118667ee2f0d19",//岗位id
"工号": "137764",
"职级": "P100",
"HRBP": "3cfd59661b0642659f12eb8c75ad0f18",//hrbp的员工id
"汇报对象": "3cfd59661b0642659f12eb8c75ad0f18",//汇报对象的员工id
"个人邮箱": "2424399527@qq.com",
"联系手机": "19400131686",
"自我介绍": "自我感觉良好",
"所属国籍": "241",//对应国籍列表信息中的国籍id
"纳税城市": "北京市北京市",
"工作地点": "北京市北京市",
"开户行": "武汉支行",
"直属下属数量": "0",
"司龄": "1.03年",
"试用期截止日": "2020-11-24",
"首次参加工作时间": "2019-11-02",
"有无违法违纪行为": "无",
"居住证截止日期": "2029-12-22",
"银行卡号": "2424399527242439952",
"籍贯": "北京市北京市",
"国家/地区": "中国大陆",
"子女状态": "无",
"招聘渠道": "智联招聘",
"户籍所在地": "北京市北京市",
"婚姻状况": "未婚",
"证件号": "",
"最高学历": "请选择",
"身份证号": "429006202011245416",
"年龄": "1",
"QQ": "2424399527",
"上家公司": "",
"社保电脑号": "2424399527",
"工作城市": "北京市北京市",
"生日": "1124",
"入党时间": "2020-11-24",
"生活照": "md+znJl772zqCBfkOOMBk2IxY2U5YmZiMmYzNWUxYzYyNDYxNTA4N2VhZjMyNWIxNmRiNzlmNzBhZmU4MDJMOZMrKYJG89c5E+sS8e0bugnMQcbCBnGlnzo7GUEVa+7nXT0OFe1xBD/YoqHMRa8==",//对应上传文件返回的文件key
"工龄": "1.34年",
"主动离职主因": "",
"公积金账号": "2424399527",
"自定义选项": "自定义选项",
"转正评价": "",
"通讯地址": "北京省北京市",
"管理形式": "总部",
"被动离职原因": "",
"其他招聘渠道": "暂时没有",
"员工照片": "",
"调整工龄(天)": "100",
"社招/校招": "社招",
"存档机构": "中国政府",
"属相": "鼠",
"民族": "汉",
"自我评价": "",
"转正日期": "2020-11-25",
"办理离职时间": "",
"血型": "O型",
"调整司龄(天)": "0",
"主动离职次因": "",
"星座": "射手座",
"转正状态": "已转正",
"居住证城市": "北京市北京市",
"居住证办理日期": "2019-11-30",
"身份证照": "0BRItoygRfQEyb1Wlwt8YmI1YzZkY2ZkZTAxNjUwYzI4Yjc4MTY5YTE1NDBjZGHwlD3dDeyYLi9+xhL+qXwRPL1F1PBKwyCsRzMez7u5IAMdVqO7xF7O9QwSHRkynnxiagTN/QXMqCWjOSA73td6oLL8nG5A6WKqpEHkw==",//对应上传文件返回的文件key
"现居住地": "北京省北京市",
"英文名": "",
"性别": "男",
"成本中心": "c03b7ef4fced4e64a256327a740b39fc",//成本中心id
"子女有无商业保险": "无",
"证照类型": "中国护照",
"出生日期": "2019-09-14",
"政治面貌": "党员",
"出生国家": "241",
"微信": "19400131686",
"有无重大病史": "无",
"推荐企业/人": "xrxs",
"虚拟部门Id":"c961159ebd244a57a41236cf77a1f3cf,e9025aaa3d214f73bf8691943c8c68f3",
"虚拟部门":"虚拟部门测试、ren",
"自定义字段1": "这是自定义的信息",
"测试文件组":"[{\"fileName\":\"1.png\",\"fileKey\":\"cH830por/GAVkC1xiXpv0zllNGY2NzdmYmRmMzk1YjliMmFjMGYyYjMyMmNlMDhhMjVkOGNlYmQ3ZjFjMzIzMjNjMWMwMjllNWI5OWJiODLwUvYJv5wIpjRCPAbzTIYTpfJIOVLv2MBLBPNa4EyCEIWbP6Nn19LuIyCTHx0IgD4vPYFALzM5P9/cAQ0eaK/12iC10PCOp0K+NU5OHhwN6qYPdMReyfKg2MlO7U7iy6gJvqQQZroZqqDPfikGT+65uTEJSR2FPlc1tjARws5mRQ==\",\"fileUrl\":\"https://f.xinrenxinshi.com/site/download?ptoken=efc4bce763b1142ec97944f4086bb9555e83f562461beaeeb72c4130aef100000.png\"}]"
}
}
}