部门更新
接口说明: 更新部门信息(只支持单线程更新)
请求方式: POST （HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/department/update
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 参数类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| departmentId | String | Y | 部门ID |
| name | String | N | 部门名称 |
| parentId | String | N | 上级部门ID |
| code | String | N | 部门编码 |
| type | Integer | N | 部门类型，默认0，固定部门类型有 0-部门,1-事业部,2-事业群,3-组,4-中心,5-子公司 其他部门自定义类型 详见部门类型列表接口中的departType字段 |
| adminId | String | N | 部门负责人ID。如果存在部门负责人，需传对应的负责人ID；不传值，会置空负责人ID |
| hrbpId | String | N | hrbp的员工id |
| city | String | N | 所属城市 |
| remark | String | N | 备注 |
| fields | Map<String,String> | N | 部门自定义字段，参考部门列表接口中的fields字段 |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
部门更新注意事项:
- 对于文本类型的部门自定义字段，key为字段名称，value为调整后的值且长度不能超过设置字段长度;
- 对于数值类型的部门自定义字段，key为字段名称，value为调整后的值，必须是数字;
- 对于日期类型的部门自定义字段。key为字段名称，value的值的格式为 "yyyy-MM-dd";
- 对于选项类型的部门自定义字段。key为字段名称，value的值为选项类型的datasource中的选项。例如:datasource为{A,B,C}，则value只能为A或B或C;
- 对于地区(精确到县级地区)类型的部门自定义字段。key为字段名称，value的值为城市列表接口中type为4(即区域类型为区级)的区域编码。
- 对于地区(精确到地级市)类型的部门自定义字段。key为字段名称，value的值为城市列表接口中type为3(即区域类型为城市)的区域编码。
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 0成功，其他失败 |
| errmsg | String | Y | 结果描述 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/department/update?sign=BqCoQtiHaDxnYhfeDi87%2BiR7CXc%3D
请求Body示例:
{
"code":"测试更新部门",
"city":"湖北省武汉市",
"departmentId":"66cb5a71fbd24afb831b1ed14ed0a36b",
"name":"测试更新部门",
"remark":"openapi测试部门修改的备注",
"type":0,
"fields":{
"数值":"111221.000",
"单行文本":"我是单行文本1",
"地区精确到地级市":"171"
},
"timestamp":1625827438929
}
SDK请求示例(java):
DepartmentUpdateRequest request = new DepartmentUpdateRequest(access_token());
request.setDepartmentId("66cb5a71fbd24afb831b1ed14ed0a36b");
request.setName("测试更新部门");
request.setCode("测试更新部门");
request.setType(DepartTypeEnum.DEPARTMENT);
request.setAdminId("");
request.setCity("湖北省武汉市");
request.setRemark("openapi测试部门修改的备注");
HashMap<String, String> fields = new HashMap<>();
fields.put("数值", "111221.000");
fields.put("单行文本", "我是单行文本1");
fields.put("地区精确到地级市", "171");
request.setFields(fields);
XrxsDepartmentService.updateDepartment(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": null
}