---
name: bkit-export-accounting-documents
description: "Lọc và xuất danh sách chứng từ kế toán BKIT sang XLSX hoặc ODS, đồng thời xác minh lượt tải. Dùng khi người dùng yêu cầu tải Excel, xuất bảng chứng từ, lấy danh sách chứng từ theo từ khóa hoặc định dạng XLSX/ODS."
---

# Xuất danh sách chứng từ kế toán

## Phạm vi

- Mở `/dashboard/accounting-document` trên origin hiện tại.
- Xuất đúng tập dữ liệu đang hiển thị sau khi áp dụng bộ lọc của người dùng.
- Ưu tiên nút có ID `#accounting-document-export-xlsx-btn` hoặc `#accounting-document-export-ods-btn`; nếu giao diện thay đổi, dùng tên truy cập “Xuất XLSX/ODS”.

## Quy trình

1. Kiểm tra đúng đơn vị, tổ chức và năm tài chính.
2. Áp dụng từ khóa, khoảng ngày, loại chứng từ hoặc trạng thái theo yêu cầu.
3. Chờ bộ tải biến mất và xác minh một vài hàng đại diện phù hợp với bộ lọc.
4. Nếu người dùng không chỉ định định dạng, dùng XLSX.
5. Chụp trạng thái danh sách tải xuống hiện tại, bấm đúng nút xuất một lần và chờ một mục tải mới hoặc thông báo thành công.
6. Xác minh tên file, phần mở rộng và trạng thái hoàn tất. Không bấm lặp khi tải đang chạy.

## Quy tắc an toàn

- Không xuất toàn bộ dữ liệu nếu người dùng đã yêu cầu phạm vi hẹp nhưng bộ lọc chưa áp dụng được.
- Không giả định file đã tải chỉ vì nút đã được bấm.
- Nếu trình duyệt chặn tải hoặc phiên hết hạn, báo lỗi và giữ nguyên bộ lọc để người dùng tiếp tục.
- Không mở, gửi hoặc tải file sang dịch vụ khác nếu chưa được yêu cầu.

## Báo cáo kết quả

Nêu định dạng, phạm vi lọc, tên file và trạng thái tải. Nếu không thể xác định thư mục tải xuống, vẫn xác minh bằng danh sách tải của trình duyệt.
