查询部门列表


查询部门列表

基本信息

请求方式:POST

请求地址:/napi/enterprise/department/list

Body参数

参数名参数说明必填参数类型长度值举例备注
msgId消息idYString1281000120150511190411000001企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN
corpCode企业编码NString501000不传默认查询租户级数据
pageIndex页码YInt1
pageSize每页条数YInt20建议20,上限50
duration最近更新时间范围NDuration不填默认查询最近一天

Duration

参数名参数说明必填参数类型长度值举例备注
endTime结束时间YString20240606110101yyyyMMddHHmmss格式
startTime开始时间YString20240605110101yyyyMMddHHmmss格式

响应参数定义

参数名参数说明必填参数类型长度值举例备注
resultCode返回码YString00表示成功,其他值为失败。
description描述YString操作成功描述信息,出错时为错误信息即错误原因。
data响应数据YDepartmentPage

DepartmentPage

参数名参数说明必填参数类型长度值举例备注
pageIndex页码YInt1
pageSize每页条数YInt20
totalSize总数YLong100
departmentList部门列表YList<Department>

Department

参数名参数说明必填参数类型长度值举例备注
departmentNo部门编号YString50A1234
nameCn中文名称YString200市场部
nameEn英文名称NString200Marketing Dept.
parentNo上级部门编号NString50
corpCode企业编码YString50
leaderList主管列表NList<DepartmentLeader>

DepartmentLeader

参数名参数说明必填参数类型长度值举例备注
tenantUserId租户用户idYString200440285
name姓名YString100张三

样例

请求

{
  "duration": {
    "startTime": "20240613135700",
    "endTime": "20240613174346"
  },
  "pageIndex": 1,
  "pageSize": 20,
  "msgId": "0008120240617143030100010",
  "corpCode": "0008"
}

返回

{
  "resultCode": "0",
  "description": "操作成功",
  "data": {
    "pageIndex": 1,
    "pageSize": 20,
    "totalSize": 1,
    "departmentList": [
      {
        "departmentNo": "A1234",
        "nameCn": "市场部",
        "nameEn": "Marketing Dept.",
        "parentNo": "A123",
        "corpCode": "0008",
        "leaderList": [
          {
            "tenantUserId": "d00xxxxxx",
            "name": "张三"
          }
        ]
      }
    ]
  }
}

错误码

错误码错误描述
840000050重复请求
840001021企业不存在