> 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-ly-san-pham-and-kho/inventory.md).

# Quản lý Kho hàng

Hệ thống quản lý kho hàng của Mon POS hỗ trợ mô hình đa chi nhánh kho, truy vết lịch sử biến động thẻ kho chi tiết từng giây và quản lý việc xuất hủy hàng hỏng/hết hạn một cách chặt chẽ.

***

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

Chức năng **Quản lý Kho hàng & Xuất hủy** bao gồm các nghiệp vụ:

* **Quản lý đa kho**: Hỗ trợ thêm mới và kiểm soát số lượng sản phẩm tại nhiều địa điểm kho khác nhau.
* **Thẻ kho (Lịch sử giao dịch kho)**: Tự động ghi nhận mọi hành động Nhập (IN), Xuất (OUT), Điều chỉnh (ADJUST), Kiểm kê (CHECK) của từng sản phẩm kèm nhân viên thực hiện và lý do cụ thể.
* **Cảnh báo định mức**: Hiển thị danh sách hàng hóa sắp hết để chủ cửa hàng chủ động nhập thêm.
* **Xuất hủy hàng hóa**: Hạch toán các mặt hàng bị vỡ, hỏng, lỗi sản xuất hoặc hết hạn sử dụng để làm cơ sở tính toán chính xác chi phí thiệt hại.

***

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

### A. Quản lý Kho hàng (InventoryPage)

* **Thanh Sidebar danh sách kho**: Hiển thị danh sách các kho hiện có (Kho trung tâm, Kho bán lẻ, Kho chi nhánh...). Cho phép thêm mới hoặc sửa thông tin kho.
* **Bảng danh sách hàng hóa trong kho**:
  * Hiển thị số lượng tồn kho chi tiết của từng sản phẩm và từng biến thể tại kho đang chọn.
  * Hỗ trợ tìm kiếm nhanh và lọc sản phẩm.
  * Nút **Phân bổ sản phẩm vào kho**: Cho phép đưa một sản phẩm mới khai báo vào kho hiện tại với số lượng khởi tạo ban đầu.

### B. Phiếu xuất hủy kho (WasteListPage & WasteFormPage)

* **Trang danh sách phiếu hủy (WasteListPage)**: Thống kê toàn bộ các đợt xuất hủy trong quá khứ kèm lý do, tổng giá trị thiệt hại và trạng thái phiếu (Nháp hoặc Đã duyệt).
* **Màn hình lập phiếu hủy mới (WasteFormPage)**:
  * **Chọn kho xuất hủy**: Kho thực hiện rút hàng ra để hủy.
  * **Danh sách hàng hủy**: Chọn sản phẩm, số lượng hủy và lý do hủy cụ thể (Ẩm mốc, Vỡ hỏng, Hết hạn sử dụng...).
  * **Tổng tiền hủy**: Tự động tính toán tổng thiệt hại dựa trên giá vốn nhập hàng của sản phẩm.

***

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

### Chức năng 1: Thêm mới kho hàng

1. Vào **Sản phẩm** $\rightarrow$ **Kho hàng**.
2. Trên bảng Sidebar bên trái, bấm nút **Thêm kho mới** (hoặc biểu tượng tương ứng).
3. Nhập Tên kho (ví dụ: `Kho phụ Quận 3`) và địa chỉ của kho hàng.
4. Bấm **Lưu lại**.

### Chức năng 2: Phân bổ hàng hóa vào kho mới

1. Chọn kho cần phân bổ trên Sidebar bên trái.
2. Bấm nút **Thêm sản phẩm vào kho** ở thanh công cụ phía trên bảng.
3. Chọn sản phẩm từ danh sách và nhập số lượng tồn ban đầu (nếu có).
4. Bấm **Xác nhận**. Hệ thống sẽ tự động tạo một giao dịch điều chỉnh (`ADJUST`) để cộng tồn kho cho sản phẩm đó.

### Chức năng 3: Lập phiếu xuất hủy hàng hỏng/hết hạn

1. Vào **Sản phẩm** $\rightarrow$ **Xuất hủy kho** $\rightarrow$ Chọn **Tạo phiếu hủy**.
2. Chọn kho hàng có sản phẩm cần hủy. Nhập ghi chú chung cho đợt hủy này.
3. Bấm **Thêm hàng hóa**, chọn các sản phẩm bị hỏng, nhập số lượng thực tế cần xuất hủy và chọn Lý do hủy tương ứng.
4. Bấm **Lưu nháp** nếu cần kiểm tra lại, hoặc bấm **Phê duyệt** để hoàn tất.

***

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

> \[!WARNING] **Quy tắc duyệt phiếu hủy**:
>
> * Khi phiếu hủy ở trạng thái **Nháp (Draft)**, số lượng tồn kho của sản phẩm vẫn được giữ nguyên. Bạn có thể tự do thêm, bớt hoặc xóa phiếu hủy này.
> * Một khi đã bấm **Phê duyệt (Approved)**, hệ thống sẽ ngay lập tức trừ tồn kho thực tế của sản phẩm tại kho đã chọn, đồng thời tự động ghi nhận một giao dịch thẻ kho loại `OUT` và không cho phép chỉnh sửa hay xóa phiếu hủy này nữa.

> \[!IMPORTANT] **Giá trị hạch toán thiệt hại**:
>
> * Chi phí xuất hủy được tính toán dựa trên **Giá vốn** tại thời điểm xuất hủy chứ không dựa trên giá bán lẻ/giá sỉ.
> * Giá trị thiệt hại từ các phiếu xuất hủy đã phê duyệt sẽ tự động được trừ vào doanh số khi tính toán Báo cáo Lợi nhuận gộp cuối tháng.


---

# 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-ly-san-pham-and-kho/inventory.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.