---
name: bkit-find-records
description: "Tìm và mở đúng bản ghi trong các danh sách BKIT. Dùng khi người dùng yêu cầu tìm kiếm, tra cứu, mở chi tiết, lọc theo mã/tên/số chứng từ/ngày/trạng thái hoặc khi cần xác định duy nhất một dòng trước thao tác tiếp theo."
---

# Tìm bản ghi BKIT

## Quy trình

1. Xác định phân hệ và khóa nghiệp vụ mạnh nhất: mã danh mục, số chứng từ, số hợp đồng, số tài khoản hoặc ID.
2. Mở route danh sách bằng menu/command palette hoặc route đã biết trên origin hiện tại.
3. Chờ trang và dữ liệu tải xong; dùng ô tìm kiếm trong đúng container danh sách.
4. Tìm khóa chính xác trước. Chỉ mở rộng sang tên, diễn giải, ngày hoặc số tiền khi không có kết quả.
5. Sau khi lọc, đọc lại bảng và khoanh vùng dòng chứa khóa nghiệp vụ.
6. Đối chiếu ít nhất một thuộc tính thứ hai trước khi mở chi tiết.

## Phân trang và trùng kết quả

- Nếu chưa thấy bản ghi, kiểm tra tổng kết quả, bộ lọc đang hoạt động và phân trang trước khi kết luận không tồn tại.
- Không duyệt mọi trang nếu tìm kiếm phía máy chủ có thể dùng được.
- Nếu có nhiều kết quả giống nhau, nêu mã, tên, ngày hoặc trạng thái để người dùng chọn; không tự chọn dòng đầu.
- Sau sắp xếp hoặc đổi trang, xác định lại dòng từ nội dung.

## Khi dùng cho bước thay đổi

Tìm kiếm chỉ hoàn tất khi đã xác minh đúng bản ghi. Trước khi chuyển sang sửa/xóa, ghi lại các thuộc tính nhận diện và đọc lại DOM để tránh thao tác trên hàng stale.

## Kết quả

Báo số kết quả, khóa đã tìm và bản ghi đã mở. Nếu không tìm thấy, nêu route và bộ lọc đã dùng.
