添加员工
接口说明: 创建一个员工，相当于在薪人薪事入职一名新员工。
目前员工的字段信息支持单行文本、多行文本、日期、选项、城市字段类型。 城市字段类型要求字段的值必须是二级城市的fullName，参考城市列表接口。 职级字段要求字段的值必须是系统中存在的职级名称，参考职级列表接口。 例如:
{
"工作城市":"河北省石家庄市",
"职级":"M0-1"
}
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/employee/create
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 参数类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| name | String | Y | 员工名字 |
| mobile | String | N | 手机号，根据公司设置的唯一标识选择必填项，手机号与邮箱两个必填一个，如果是国外手机号则传参的格式为 +区号-号码,类似+49-2341123 |
| String | N | 工作邮箱，根据公司设置的唯一标识选择必填项，手机号与邮箱两个必填一个 | |
| entryDate | String | Y | 入职时间,格式2017-03-02 |
| hireType | Integer | Y | 聘用类型，0-正式,10-实习,11-劳务,12-顾问,13-返聘,14-外包,15-兼职 |
| fields | Map<String,String> | Y | 员工字段信息。参考员工详情接口中的fields字段 |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 错误码 |
| errmsg | String | Y | 错误信息 |
| data | EmployeeCreateResponse | Y | 返回结果 |
EmployeeCreateResponse
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| employeeId | String | Y | 员工ID |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/employee/create?sign=X5O4br3gDtG1wMwSnWCkWe%2BXIgQ%3D
请求Body示例:
{
"name": "张三",
"mobile": "19400232249",
"email": "abc@qq.com",
"fields": {
"属相": "牛",
"婚姻状况": "已婚",
"民族": "汉族",
"性别": "男"
},
"entryDate": "2020-11-24",
"hireType": 0,
"timestamp": 1606185561809
}
SDK请求示例(java):
EmployeeCreateRequest request = new EmployeeCreateRequest(access_token);
request.setName("张三");
request.setMobile("19400232249");
request.setEmail("abc@qq.com");
request.setEntryDate("2020-11-24");
request.setHireType(HireTypeEnum.OFFICIAL);
Map<String, String> fields = new HashMap<>();
fields.put("性别", "男");
fields.put("民族", "汉族");
fields.put("婚姻状况", "已婚");
fields.put("属相", "牛");
request.setFields(fields);
OpenapiResponse<EmployeeCreateResponse> employeeId = XrxsEmployeeService.createEmployee(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"employeeId": "1fee8a031bfd467483c15995eaa18553"//员工id
}
}