> 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/quan-tri-and-cau-hinh/reports.md).

# Báo cáo thống kê

Hệ thống Báo cáo của Mon POS cung cấp cho các nhà quản lý và chủ cửa hàng những công cụ phân tích doanh thu bán hàng, lợi nhuận gộp, xuất nhập tồn kho và công nợ một cách trực quan, đồng thời hỗ trợ xuất dữ liệu ra file PDF và Excel chuẩn hóa tiếng Việt.

***

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

Phân hệ **Báo cáo & Thống kê** hỗ trợ các báo cáo cốt lõi sau:

* **Báo cáo Doanh thu & Lợi nhuận**: Thống kê doanh số bán ra theo ngày, giá vốn hàng bán, chi phí hao hụt và tính toán lợi nhuận gộp thực tế của cửa hàng.
* **Báo cáo Bán hàng chi tiết**: Thống kê số lượng bán ra của từng mặt hàng, nhóm hàng để tìm ra sản phẩm bán chạy nhất.
* **Báo cáo Xuất Nhập Tồn kho**: Theo dõi biến động hàng hóa trong kho, lượng tồn đầu kỳ, nhập trong kỳ, xuất trong kỳ và tồn cuối kỳ của từng sản phẩm.
* **Báo cáo Công nợ đối tác**: Tổng hợp nợ phải thu của khách hàng và nợ phải trả cho nhà cung cấp.

***

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

### A. Sidebar bộ lọc báo cáo (ReportFiltersSidebar)

Nằm ở phía bên trái màn hình, giúp cấu hình các tiêu chí báo cáo:

* **Loại báo cáo**: Chọn một trong các biểu mẫu báo cáo có sẵn.
* **Thời gian báo cáo**: Lọc theo ngày cụ thể hoặc khoảng thời gian tùy chọn.
* **Chọn chi nhánh kho**: Lọc dữ liệu báo cáo của một kho hàng cụ thể hoặc tổng hợp tất cả các kho.
* **Tìm kiếm theo Sản phẩm / Nhóm hàng**: Lọc báo cáo giới hạn cho một vài sản phẩm/nhóm hàng mong muốn.

### B. Bảng hiển thị dữ liệu báo cáo (ReportSheetViewer)

* Hiển thị bảng số liệu chi tiết tương thích cấu trúc trang tính Excel.
* Hỗ trợ tính toán dòng tổng cộng ở cuối bảng dữ liệu một cách tự động.
* Tích hợp thanh công cụ xuất dữ liệu:
  * **Xuất file Excel (.xlsx)**: Xuất file bảng tính Excel định dạng chuẩn.
  * **Xuất file PDF / In báo cáo**: Định cấu hình trang in và xuất báo cáo dạng tài liệu PDF.

***

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

### Các bước xuất báo cáo doanh thu cuối tháng:

1. Vào **Báo cáo** trên thanh Menu chính.
2. Tại thanh Sidebar bên trái:
   * Chọn biểu mẫu **Báo cáo Doanh thu & Lợi nhuận**.
   * Chọn khoảng thời gian là **Tháng này** hoặc tùy chỉnh từ ngày mùng 1 đầu tháng đến ngày hiện tại.
   * Chọn **Tất cả các kho** (hoặc chọn 1 kho chi nhánh cụ thể).
3. Bấm nút **Tải dữ liệu báo cáo**.
4. Rà soát bảng số liệu hiển thị ở khung bên phải:
   * Cột **Doanh thu**: Tổng doanh số hóa đơn đã xuất.
   * Cột **Giá vốn**: Chi phí gốc để nhập số lượng hàng đã bán đó.
   * Cột **Lợi nhuận gộp**: Doanh thu trừ đi giá vốn.
5. Để xuất bản báo cáo gửi cho cổ đông hoặc lưu trữ:
   * Bấm nút **Xuất Excel (Export to Excel)** để tải về file bảng tính.
   * Hoặc bấm nút **Tải PDF (Export to PDF)** để lưu file tài liệu.

***

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

> \[!IMPORTANT] **Quy tắc làm việc với Excel không lỗi Font chữ (UTF-8 BOM)**:
>
> * Mon POS sử dụng công nghệ xuất dữ liệu Excel chuẩn hóa kèm mã hóa UTF-8 BOM và thư viện `ExcelJS`.
> * Bạn có thể mở trực tiếp file Excel xuất ra trên mọi phiên bản Microsoft Excel (bao gồm cả Excel đời cũ 2010, 2013) mà **không bao giờ bị lỗi font tiếng Việt** có dấu như các phần mềm POS thông thường.

> \[!WARNING] **Quy tắc tính toán lợi nhuận gộp khi có hàng hủy**:
>
> * Doanh thu bán hàng thực tế trên báo cáo sẽ tự động khấu trừ đi giá trị các đơn hàng bị hủy (`INV - CANCELLED`).
> * Các chi phí từ phiếu **Xuất hủy kho** do hàng hỏng/hết hạn đã phê duyệt sẽ được hệ thống tính toán và trừ trực tiếp vào kết quả Lợi nhuận thuần của cửa hàng trên báo cáo tài chính tổng hợp.


---

# 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/quan-tri-and-cau-hinh/reports.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.