待入职员工入职
接口说明:待入职员工通过此接口操作入职成为在职员工,非必传字段不传会被设置为系统默认值
请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/employee/entrypending
请求Header:
key | value |
---|---|
access_token | 获取的access_token的实际值 |
Query参数:
key | value |
---|---|
sign | 签名值 |
Body参数:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
employeeId | String | Y | 员工ID |
name | String | Y | 员工姓名 |
mobile | String | N | 员工手机号,根据公司设置的唯一标识选择必填项,手机号与邮箱两个必填一个 |
String | N | 工作邮箱,根据公司设置的唯一标识选择必填项,手机号与邮箱两个必填一个 | |
entryDate | String | Y | 入职日期,格式:yyyy-MM-dd |
hireType | Integer | Y | 雇佣类型 0:正式,1:非正式 |
laborType | Integer | N | 当hireType=1的时候必填。10-实习,11-劳务,12-顾问,13-返聘,14-外包,15-兼职 |
regularDate | String | N | 转正日期 |
jobNumber | String | N | 工号 |
departmentId | String | N | 部门ID |
gender | Integer | N | 性别,1:男,2:女 |
jobId | String | N | 岗位ID,对应的是岗位信息接口中的jobId |
subjection | Integer | N | 管理形式,0:总部,1:分城市 |
highestDegree | Integer | N | 最高学历,1:初中,2:高中,3:中专,4:大专,5:本科,6:硕士,7:博士,8:其他,9:小学,10:中职,11:中技 |
返回结果:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 结果编码,0成功,其他失败 |
errmsg | String | Y | 错误描述 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/employee/entrypending?sign=BqCoQtiHaDxnYhfeDi87%2BiR7CXc%3D
请求Body示例:
{
"employeeId": "3cfd59661b0642659f12eb8c75ad0f18",
"name": "张四",
"mobile": "19400232259",
"laborType": 11,
"gender": 1,
"highestDegree": 1,
"entryDate": "2022-11-24",
"hireType": 0,
"departmentId": "a54e4cbb3c114fd8b8c0e7d85ee024e7",
"subjection": 0,
"regularDate": "2022-12-24",
"timestamp": 1606187065709
}
SDK请求示例(java):
EmployeeEmployedRequest request = new EmployeeEmployedRequest(access_token);
request.setEmployeeId("3cfd59661b0642659f12eb8c75ad0f18");
request.setName("张四");
request.setMobile("19400232259");
request.setEntryDate("2022-11-24");
request.setHireType(SimpleHireTypeEnum.OFFICIAL);
request.setLaborType(LaborTypeEnum.LABOUR);
request.setRegularDate("2022-12-24");
request.setDepartmentId("a54e4cbb3c114fd8b8c0e7d85ee024e7");
request.setGender(1);
request.setSubjection(0);
request.setHighestDegree(1);
OpenapiResponse<Void> response = XrxsEmployeeService.employed(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": null
}