Lấy danh sách lô chứng từ import

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

---

Mục đích

Hàm lấy danh sách các lô chứng từ đã import trên hệ thống của người dùng

• Request URL: /api/batch-imports
• HTTP method: GET
• Authorize: Bearer token
• Parameter: Không yêu cầu, tuy nhiên có thể thêm các tùy chọn bên dưới để thực hiện lọc hoặc tìm kiếm danh sách lô chứng từ.

Key	Type	Description
search	string	Thông tin tìm kiếm theo tên lô chứng từ
page	int	Số trang cần lấy dữ liệu (Mặc định hệ thống đang là 1)
pagesize	int	Số record dữ liệu mà hệ thống sẽ trả về sau mỗi request (Mặc định hệ thống đang là 10 record)

Mẫu request

Query param:
    page: 1
    pageSize: 10
    search: LÔ IMPORT 001
    Request: /api/batch-imports?page=1&pageSize=10&search=LÔ IMPORT 001

Mẫu response body

{
    "data": {
        "items": [
            {
                "id": 1231,
                "createdDate": "2022-12-02T15:04:28.7095771",
                "uploadedByUserId": 2320,
                "numberOfRecords": 1,
                "name": "LÔ IMPORT 001",
                "department": {
                    "id": 29,
                    "name": "Công ty Công nghệ thông tin VNPT",
                    "code": "VNPT-IT",
                    "isShared": false
                },
                "documentType": {
                    "id": 46,
                    "code": "CKDS",
                    "name": "Chiết khấu doanh số",
                    "description": "Chứng từ chiết khấu DOANH SỐ ",
                    "documentCount": 0,
                    "enableVnptSeal": false,
                    "requireVerifiedUserSigning": false,
                    "children": []
                },
                "status": {
                    "value": 2,
                    "description": "Completed"
                },
                "documents": [],
                "errors": [],
                "importType": {
                    "value": 1,
                    "description": "Documents created from templates"
                }
            }
        ],
        "totalCount": 1,
        "pageCount": 1,
        "page": 1,
        "pageSize": 10,
        "hasNextPage": true,
        "hasPreviousPage": false
    },
    "success": true,
    "code": 0,
    "messages": []
}

Response Parameter

Key	Type	Description
data	object	Đối tượng chứa thông tin phân trang và danh sách dữ liệu trả về (xem bên dưới)
success	boolean	Trạng thái xử lý của yêu cầu (true: Thành công, false: Thất bại)
code	int	Mã trạng thái phản hồi từ hệ thống
messages	Array[string]	Danh sách thông báo phản hồi từ hệ thống

---

Chi tiết đối tượng data:

Key	Type	Description
items	Array[object]	Danh sách các lô chứng từ import (xem chi tiết bên dưới)
totalCount	int	Tổng số bản ghi tìm thấy
pageCount	int	Tổng số trang
page	int	Trang hiện tại
pageSize	int	Số lượng bản ghi trên một trang
hasNextPage	boolean	Có trang tiếp theo hay không (true: Có, false: Không)
hasPreviousPage	boolean	Có trang trước đó hay không (true: Có, false: Không)

---

Chi tiết các thuộc tính trong items:

Key	Type	Description
id	int	ID của lô import
createdDate	string	Thời gian tạo lô import (định dạng ISO 8601)
uploadedByUserId	int	ID người dùng thực hiện upload
numberOfRecords	int	Số lượng bản ghi/chứng từ trong lô
name	string	Tên lô import
department	object	Thông tin bộ phận/phòng ban (xem bên dưới)
documentType	object	Thông tin loại chứng từ (xem bên dưới)
status	object	Trạng thái xử lý của lô import (2: Completed)
documents	Array[object]	Danh sách chi tiết các chứng từ trong lô
errors	Array[object]	Danh sách lỗi gặp phải trong quá trình import (nếu có)
importType	object	Hình thức import (1: Documents created from templates)

---

Chi tiết đối tượng department:

Key	Type	Description
id	int	ID bộ phận/phòng ban
name	string	Tên bộ phận/phòng ban
code	string	Mã bộ phận/phòng ban
isShared	boolean	Chia sẽ quyền truy cập chứng từ cho tất cả những người trong bộ phận (true/false)

---

Chi tiết đối tượng documentType:

Key	Type	Description
id	int	ID loại chứng từ
code	string	Mã loại chứng từ
name	string	Tên loại chứng từ
description	string	Mô tả loại chứng từ
documentCount	int	Số lượng chứng từ thuộc loại này
enableVnptSeal	boolean	Chứng thực thông điệp VNPT SEAL (true: Bật, false: Tắt)
requireVerifiedUserSigning	boolean	Yêu cầu người ký đã xác thực danh tính (true/false)