部门管理
部门管理
- 同一父部门下的部门名称不能重复
- 部门编号不能重复
新增部门信息
接口URL
/adddeptinfo
请求参数定义
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| Version | 版本号 | Y | String | 10 | 3.0 | 固定为3.0。 |
| MsgID | 唯一标识 | Y | String | 128 | 1000120150511190411000001 | 企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN |
| CorpCode | 操作企业账号 | Y | String | 50 | 企业账号 | |
| TenantUserId | 操作人帐号 | Y | String | 200 | HW_000001 | 1、如果是系统维护，写"sysadmin" 2、如果是普通员工维护，写员工租户用户id |
| Dept | 部门信息 | Y | DeptAdd | 如果按照部门层级展示，则需要按照部门从上到下调用接口 |
DeptAdd
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| DeptNum | 部门编号 | Y | String | 50 | 1234 | 部门标识字段，开发者可用该字段来唯一标识一个部门，与差旅系统部门做映射。 格式为英文字母、数字、下划线和中划线 |
| DeptName | 部门名称 | Y | String | 200 | 市场部 | 同一父部门下的部门名称不能重复 |
| DeptDescription | 部门描述 | N | String | 300 | 市场部 | |
| UpperDeptNum | 上级部门编号 | N | String | 50 | 5678 | 为空表示为一级部门 |
响应参数定义
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| ResultCode | 返回码 | Y | String | 0 | 0表示成功，其他值为失败。 | |
| Description | 描述 | Y | String | Success | 描述信息，出错时为错误信息即错误原因。 |
样例
请求
{
"Version": "3.0",
"MsgID": "0008120220929071248283828",
"CorpCode": "0008",
"TenantUserId": "sysadmin",
"Dept": {
"DeptNum": "1",
"DeptName": "产品与解决方案",
"DeptDescription": "产品与解决方案"
}
}
返回
{
"ResultCode": "0",
"Description": "成功"
}
修改部门信息
接口URL
/modideptinfo
请求参数定义
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| Version | 版本号 | Y | String | 10 | 3.0 | 固定为3.0。 |
| MsgID | 唯一标识 | Y | String | 128 | 1000120150511190411000001 | 企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN |
| CorpCode | 操作企业账号 | Y | String | 50 | 企业账号 | |
| TenantUserId | 操作人帐号 | Y | String | 200 | HW_000001 | 1、如果是系统维护，写"sysadmin" 2、如果是普通员工维护，写员工租户用户id |
| Dept | 部门信息 | Y | DeptModify |
DeptModify
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| DeptNum | 部门编号 | Y | String | 50 | 1234 | 部门标识字段，开发者可用该字段来唯一标识一个部门，与差旅系统部门做映射。 格式为英文字母、数字、下划线和中划线 |
| DeptName | 部门名称 | N | String | 200 | 市场部 | 同一父部门下的部门名称不能重复 |
| DeptDescription | 部门描述 | N | String | 300 | 市场部 | |
| UpperDeptNum | 上级部门编号 | N | String | 50 | 5678 | 为空表示为一级部门。 若当前部门不是一级部门，需要正确传值。 上级部门必须存在。 |
响应参数定义
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| ResultCode | 返回码 | Y | String | 0 | 0表示成功，其他值为失败。 | |
| Description | 描述 | Y | String | Success | 描述信息，出错时为错误信息即错误原因。 |
样例
请求
{
"Version": "3.0",
"MsgID": "0008120220929071248283828",
"CorpCode": "0008",
"TenantUserId": "sysadmin",
"Dept": {
"DeptNum": "1",
"DeptName": "产品与解决方案",
"DeptDescription": "产品与解决方案"
}
}
返回
{
"ResultCode": "0",
"Description": "成功"
}
删除部门信息
接口URL
/deldeptinfo
请求参数定义
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| Version | 版本号 | Y | String | 10 | 3.0 | 固定为3.0。 |
| MsgID | 唯一标识 | Y | String | 128 | 1000120150511190411000001 | 企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN |
| CorpCode | 操作企业账号 | Y | String | 50 | 企业账号 | |
| TenantUserId | 操作人帐号 | Y | String | 200 | HW_000001 | 1、如果是系统维护，写"sysadmin" 2、如果是普通员工维护，写员工租户用户id |
| DeptNum | 部门编号 | Y | String | 50 | 1234 | 部门标识字段 |
响应参数定义
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| ResultCode | 返回码 | Y | String | 0 | 0表示成功，其他值为失败。 | |
| Description | 描述 | Y | String | Success | 描述信息，出错时为错误信息即错误原因。 |
样例
请求
{
"Version": "3.0",
"MsgID": "0008120220929071248283828",
"CorpCode": "0008",
"TenantUserId": "sysadmin",
"DeptNum": "1"
}
返回
{
"ResultCode": "0",
"Description": "成功"
}