部门分类批量同步接口
说明
该接口用于批量新增或更新部门分类。
接口限制
1. 10次/秒;
2. 单次导入限制为200条数据;
接口说明
- 接口支持批量导入多个部门分类
- 单条失败模式。即传入的每条数据互不影响。某条失败，不会影响其他数据执行
- 一个部门分类限制最多包含500个部门，如本次导入将导致该部门分类下的部门超限，则本次有关该部门分类的导入将失败
- 该接口部门分类编码作为唯一标识。如果编码不存在，将新增一条记录；如果存在，将更新
接口地址
/api/openapi/org/department/group/batch
请求类型
POST
请求参数
参数说明
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| name | String(80) | 否 | 部门分类名称 若该参数当前有值，传""视为清除原数据。 不填时视为维持原数据 |
| nameEn | String(80) | 否 | 部门分类英文名称 若该参数当前有值，传""视为清除原数据。 不填时视为维持原数据 |
| businessCode | String(80) | 是 | 部门分类编码 |
| groupName | String(80) | 否 | 部门分组名称 如名称存在则将部门分类挂到该分组下，名称不存在则新增分组 |
| description | String(80) | 否 | 描述 若该参数当前有值，传""视为清除原数据。 不填时视为维持原数据 |
| includeChildDept | String(16) | 否 | 所选部门是否作用到子部门 填写是或者否 新增时不填默认是 更新时 传""视为清除原数据。 不填时视为维持原数据 |
| departmentBusinessCodes | List<String> | 否 | 关联的部门编码 不填时视为维持原数据 填写空数组时视为清除原数据 |
参数样例
[
{
"name": "name1",
"businessCode": "OPAPI1",
"groupName": "分组1",
"description": "描述1",
"departmentBusinessCodes": []
}
]
响应参数
参数样例
- 正常响应参数示例
{
"code": "ACK",
"message": "",
"data": null,
"errorCode": null,
"success": true
}
- 错误返回示例
当有数据发生错误时，code返回NACK，data里会包含错误对象，此接口错误数据的key为部门分类编码
{
"code": "NACK",
"message": "",
"data": {
"errorData": [
{
"key": "OPAPI2",
"errorCode": "30005",
"errorMessage": "部门分类名称已存在",
"errorIndex": 0
}
]
},
"errorCode": null,
"success": false
}
修改记录
2025-10-23 新增