> For the complete documentation index, see [llms.txt](https://docs.monpos.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.monpos.vn/tai-chinh-and-doi-tac/debts.md).

# Công nợ Khách hàng

Hệ thống quản lý công nợ của Mon POS giúp chủ cửa hàng theo dõi chi tiết từng khoản nợ phải thu của khách hàng, lịch sử biến động công nợ và thực hiện quy trình thu hồi nợ nhanh chóng, chính xác.

***

## 1. Giới thiệu tổng quan

Việc quản lý công nợ tốt là yếu tố sống còn để đảm bảo dòng tiền lành mạnh cho cửa hàng. Tính năng **Quản lý Công nợ** hỗ trợ:

* **Tự động ghi nhận nợ**: Khi thực hiện thanh toán hóa đơn tại quầy POS, nếu khách trả thiếu tiền, số tiền thiếu sẽ tự động được ghi nhận thành công nợ của khách hàng đó.
* **Theo dõi nợ chi tiết theo đối tác**: Hiển thị danh sách khách hàng kèm số dư công nợ hiện tại (phải thu).
* **Lịch sử biến động công nợ**: Lưu trữ đầy đủ lịch sử các đợt phát sinh nợ (khi mua hàng) và các đợt trả nợ (khi khách thanh toán).
* **Thanh toán nợ linh hoạt**: Khách hàng có thể trả nợ nhiều lần bằng tiền mặt hoặc chuyển khoản, hệ thống tự động cấn trừ nợ gối đầu và đồng bộ ngay sang Sổ quỹ.

***

## 2. Giao diện và các chức năng chính

Trang quản lý công nợ gồm 2 bảng chính:

### A. Thẻ thông tin công nợ (DebtSummaryCards)

* **Tổng nợ phải thu**: Tổng số tiền mà tất cả khách hàng đang nợ cửa hàng.
* **Số khách hàng đang nợ**: Số lượng đối tác hiện có số dư nợ lớn hơn 0.

### B. Bảng Công nợ Đối tác (PartnerDebtsTable)

* Liệt kê danh sách khách hàng kèm số điện thoại, tổng chi tiêu và số dư nợ hiện tại.
* Nút **Thanh toán nợ (Thu nợ)**: Lập nhanh phiếu thu tiền nợ của khách hàng.
* Nút **Điều chỉnh nợ**: Tăng hoặc giảm số dư nợ của khách hàng thủ công trong các trường hợp đặc biệt (ví dụ: làm tròn nợ, giảm trừ nợ khuyến mại).

### C. Bảng Lịch sử Công nợ (HistoryDebtsTable)

* Thống kê chi tiết toàn bộ các giao dịch tăng nợ (khi mua hóa đơn nợ) và giảm nợ (khi lập phiếu thu nợ) của tất cả khách hàng theo thời gian thực.
* Cho phép lọc lịch sử công nợ của một khách hàng cụ thể để in bảng đối soát công nợ gửi khách hàng.

***

## 3. Quy trình thao tác chi tiết

### Chức năng 1: Ghi nhận công nợ khi bán hàng (tại màn hình POS)

1. Trong quá trình thanh toán, chọn thông tin **Khách hàng** ở cột bên phải.
2. Nhập số tiền khách thực trả vào ô **Khách đưa** (số tiền này nhỏ hơn Tổng tiền hóa đơn).
3. Bấm **Thanh toán**. Hệ thống sẽ tự động ghi nhận số tiền chênh lệch thiếu vào công nợ của khách hàng này.

### Chức năng 2: Thu hồi nợ (Khách trả nợ)

1. Vào **Thu chi** $\rightarrow$ **Quản lý công nợ** (hoặc truy cập trực tiếp hồ sơ khách hàng tại trang Khách hàng).
2. Tìm khách hàng cần trả nợ trong danh sách, bấm nút **Thu nợ** (hoặc biểu tượng ví/tiền).
3. Nhập các thông tin:
   * **Số tiền thu nợ**: Số tiền khách thực tế trả (có thể trả một phần hoặc toàn bộ số nợ).
   * **Hình thức thanh toán**: Tiền mặt hoặc Ngân hàng chuyển khoản.
   * **Ghi chú**: Nội dung thu nợ (ví dụ: Khách thanh toán nợ hóa đơn tuần trước).
4. Bấm **Lưu lại**. Hệ thống sẽ:
   * Giảm số dư công nợ của khách hàng tương ứng với số tiền đã thu.
   * Tự động sinh một phiếu thu trên Sổ quỹ để cộng tiền vào quỹ của cửa hàng.
   * Ghi nhận một giao dịch giảm nợ loại `PAYMENT` trong lịch sử công nợ.

### Chức năng 3: Điều chỉnh số dư công nợ thủ công

1. Tại bảng công nợ khách hàng, tìm khách hàng cần điều chỉnh, chọn nút **Điều chỉnh nợ**.
2. Nhập số dư nợ mới mong muốn sau khi điều chỉnh.
3. Nhập lý do điều chỉnh nợ (ví dụ: Chủ cửa hàng đồng ý bớt lẻ 50,000đ nợ).
4. Bấm **Xác nhận**. Hệ thống tự động cập nhật số dư nợ mới mà không sinh giao dịch tiền tệ trên Sổ quỹ (chỉ ghi nhận thay đổi số dư nợ).

***

## 4. Các lưu ý quan trọng & Quy tắc nghiệp vụ

> \[!IMPORTANT] **Quy tắc xóa nợ**:
>
> * Số dư nợ của khách hàng không thể tự động bị xóa trừ khi: khách hàng thực hiện trả nợ (lập phiếu thu nợ) hoặc người quản lý thực hiện điều chỉnh nợ thủ công về 0.
> * Khi xóa một hóa đơn gốc có ghi nợ, hệ thống sẽ tự động hoàn tác (xóa) khoản nợ đã phát sinh từ hóa đơn đó để đảm bảo tính chính xác của sổ sách.

> \[!WARNING] **Giới hạn bán nợ cho khách lẻ**:
>
> * Hệ thống **chặn hoàn toàn** việc bán nợ cho "Khách lẻ" (khách không đăng ký thông tin). Thu ngân bắt buộc phải thu đủ tiền trước khi xuất hóa đơn cho khách lẻ.
> * Nếu muốn ghi nợ, thu ngân bắt buộc phải tạo hồ sơ khách hàng có tên và số điện thoại rõ ràng để theo dõi công nợ.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.monpos.vn/tai-chinh-and-doi-tac/debts.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.