添加待入职员工
接口说明: 创建一个新的待入职员工,相当于薪人薪事页面中创建一名待入职员工。
请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/employee/createpending
请求Header:
key | value |
---|---|
access_token | 获取的access_token的实际值 |
Query参数:
key | value |
---|---|
sign | 签名值 |
Body参数:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
name | String | Y | 员工名字 |
mobile | String | N | 手机号,当手机号为唯一标识时必填 |
String | N | 邮箱,当邮箱为唯一标识时必填 | |
entryDate | String | Y | 入职时间,格式:yyyy-MM-dd |
hireType | Integer | Y | 雇佣类型 0:正式,1:非正式 |
regularDate | String | N | 转正日期,格式:yyyy-MM-dd |
workCity | Integer | N | 工作城市,城市列表接口中的区域编码 |
laborType | Integer | N | 当hireType=1的时候必填。10-实习,11-劳务,12-顾问,13-返聘,14-外包,15-兼职 |
departmentId | String | N | 部门ID |
jobId | String | N | 岗位ID,对应的是岗位信息接口中的jobId |
sendEmail | Integer | N | 是否给员工发送完善个人信息的邮件 0:不发送,1:发送。默认为0不发送 |
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
返回结果:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 错误码 |
errmsg | String | Y | 错误信息 |
data | EmpToBeHiredCreateResponse | Y | 响应结果 |
EmpToBeHiredCreateResponse
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
employeeId | String | Y | 员工ID |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/employee/createpending?sign=26dAzTk%2BzeMz%2Bx45d8SRniM1PTk%3D
请求Body示例:
{
"name": "张四",
"mobile": "19400232249",
"email": "xrxs@xrxs.com",
"entryDate": "2021-11-24",
"laborType": 10,
"hireType": 0,
"regularDate": "2022-01-24",
"workCity": 1,
"departmentId": "8652b404594144f98cc602ad90744422",//部门id
"jobId": "ae8f392242684f54b3547496379a7a44",//岗位id
"timestamp": 1606185958409
}
SDK请求示例(java):
EmpToBeHiredCreateRequest request = new EmpToBeHiredCreateRequest(access_token);
request.setName("张四");
request.setMobile("19400232249");
request.setEmail("xrxs@xrxs.com");
request.setEntryDate("2021-11-24");
request.setRegularDate("2022-08-10");
request.setWorkCity(1);
request.setHireType(SimpleHireTypeEnum.OFFICIAL);
request.setLaborType(LaborTypeEnum.PRACTICE);
request.setDepartmentId("8652b404594144f98cc602ad90744422");
request.setJobId("ae8f392242684f54b3547496379a7a44");
OpenapiResponse<EmpToBeHiredCreateResponse> employeeId = XrxsEmployeeService.createEntryPendingEmployee(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"employeeId": "3cfd59661b0642659f12eb8c75ad0f18"//员工id
}
}