查询父部门列表
基本信息
请求方式:POST
请求地址:/napi/enterprise/department/parent/list
Body参数
参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
---|
msgId | 消息id | Y | String | 128 | 1000120150511190411000001 | 企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN |
corpCode | 企业编码 | Y | String | 50 | 1000 | |
type | 查询类型 | Y | Enum | | department | 查询部门:department,查询员工归属部门:member |
departmentNo | 部门编号 | N | String | 50 | A1234 | type为department时必填 |
tenantUserId | 租户用户id | N | String | 200 | d00xxxxxx | type为member时必填 |
响应参数定义
参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
---|
resultCode | 返回码 | Y | String | | 0 | 0表示成功,其他值为失败。 |
description | 描述 | Y | String | | 操作成功 | 描述信息,出错时为错误信息即错误原因。 |
data | 响应数据 | Y | DepartmentParent | | | type为member时有多个父级部门列表; type为department时只有一个父部门列表 |
DepartmentParent
DepartmentParentList
参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
---|
parentList | 父部门列表 | Y | List<Department> | | | 自顶向下 |
Department
参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
---|
departmentNo | 部门编号 | Y | String | 50 | A1234 | |
nameCn | 中文名称 | Y | String | 200 | 市场部 | |
nameEn | 英文名称 | N | String | 200 | Marketing Dept. | |
样例
请求
{
"msgId": "0008120240617143030100010",
"corpCode": "0008",
"type": "department",
"departmentNo": "A1234",
"tenantUserId": null
}
返回
{
"resultCode": "0",
"description": "操作成功",
"data": {
"resultList": [
{
"parentList": [
{
"departmentNo": "A123",
"nameCn": "一级部门",
"nameEn": "level_1_department"
},
{
"departmentNo": "A1234",
"nameCn": "市场部",
"nameEn": "Marketing Dept."
}
]
}
]
}
}
错误码
错误码 | 错误描述 |
---|
840000050 | 重复请求 |
840001001 | 用户不存在 |
840001021 | 企业不存在 |
840001045 | 部门信息不存在 |