Xóa bộ phận

Ngày cập nhật: 01 tháng 10, 2026
Người cập nhật: VNPT eContract's team

---

Mục đích

Hàm thực hiện xóa một hoặc nhiều bộ phận theo mã bộ phận.

• Request URL: /api/departments/bulk-delete
• HTTP method: DELETE
• HTTP content-type: application/json
• Authorize: Bearer token
• Parameter:

Key	Type	Bắt buộc	Mô tả
codes	Array[string]	Có	Danh sách mã bộ phận cần xóa.

cẩn thận

Không thể xóa bộ phận vẫn còn người dùng. Cần xóa người dùng khỏi bộ phận trước khi thực hiện xóa bộ phận.

Mẫu request

{
    "codes": ["NHANSU"]
}

Mẫu response body thành công

{
    "data": [
        {
            "id": 12012,
            "name": "Phòng Nhân sự",
            "code": "NHANSU",
            "userCount": 0,
            "sharingAccessPermission": false,
            "users": [],
            "requireApproval": false
        }
    ],
    "success": true,
    "code": 0,
    "messages": [
        "Deleted 1 departments successfully"
    ]
}

Mẫu response body không thành công

Bộ phận vẫn còn người dùng:

{
    "success": false,
    "code": 0,
    "messages": [
        "Can not delete department had user, department codes: IT"
    ]
}

Không tìm thấy mã bộ phận:

{
    "success": false,
    "code": 0,
    "messages": [
        "Department not found, department codes: UNKNOWN"
    ]
}

Mô tả Response Body

Key	Type	Mô tả
success	boolean	Trạng thái phản hồi của yêu cầu (true: Thành công, false: Thất bại).
code	int	Mã phản hồi từ hệ thống.
messages	array	Danh sách thông báo kết quả xóa hoặc lỗi từ hệ thống.
data	array	Danh sách bộ phận đã xóa. Trường này không được trả về khi yêu cầu thất bại.