---
name: bkit-manage-cash-receipts
description: "Lập và quản lý phiếu thu tiền mặt trong BKIT, gồm tìm, xem, tạo, sửa, xóa, hạch toán và dòng định khoản. Dùng khi người dùng nhắc phiếu thu, thu tiền mặt, số chứng từ, người nộp, lý do thu, Nợ/Có hoặc tài khoản 111."
---

# Quản lý phiếu thu tiền mặt

## Phạm vi

- Danh sách: `/dashboard/cash-receipt`; tạo: `/dashboard/cash-receipt/new`; sửa/xem dùng ID bản ghi.
- Điểm neo: `#cash-receipt-search-box`, `#cash-receipt-add-btn`, `#cash-receipt-datagrid`, `#cash-receipt-form`, `#cash-receipt-save-btn`.
- Trường nhận diện: `#accountingDocumentNumber`, `#accountingDocumentDate`, `#accountingEntryDate`, `#partnerId`, `#journalMemo`, `#currencyCode`, `#exchangeRate`, `#totalAmount`, `#isPosted`.

## Quy trình

1. Xác nhận đúng đơn vị và năm tài chính; kiểm tra kỳ kế toán có cho phép ghi sổ.
2. Tìm theo số chứng từ chính xác. Chỉ dùng ngày, đối tượng và số tiền để phân biệt thêm.
3. Khi tạo, nhập ngày chứng từ, ngày hạch toán, đối tượng, lý do, tiền tệ và tỷ giá theo dữ liệu được cung cấp.
4. Điền từng dòng hạch toán; xác minh tài khoản Nợ/Có, số tiền và diễn giải trước khi thêm dòng tiếp theo.
5. Kiểm tra tổng nguyên tệ, tổng quy đổi và trạng thái ghi sổ. Không tự bật `isPosted`.
6. Lưu, chờ phản hồi mạng/UI kết thúc rồi tìm lại số chứng từ để xác minh.

## Quy tắc an toàn

- Không tự sinh số chứng từ nếu quy tắc đánh số chưa rõ.
- Không tự chọn đối tượng, nhân viên, tài khoản hoặc tỷ giá khi có nhiều kết quả.
- Không lưu khi định khoản không cân, tổng tiền không khớp hoặc ngày hạch toán ngoài kỳ.
- Trước xóa hoặc bỏ ghi sổ, yêu cầu xác nhận bằng số chứng từ, ngày và số tiền.
- Không dùng vị trí dòng trong bảng làm danh tính phiếu.

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

Nêu số chứng từ, ngày, đối tượng, tổng tiền, tiền tệ và trạng thái ghi sổ. Nếu chỉ tạo nháp, nói rõ chưa ghi sổ.
