> For the complete documentation index, see [llms.txt](https://docs.enspire.online/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enspire.online/sales/programs/lo-hang.md).

# Lô hàng

#### 1. Giới thiệu và cách truy cập

Trang Lô hàng dùng để quản lý các lô key sản phẩm (Enspire Plus) được xuất ra để bán buôn, bán lẻ, dùng thử hoặc làm giải thưởng. Mỗi lô hàng chứa một hoặc nhiều key kích hoạt, được gắn với một trường học hoặc một hình thức phân phối cụ thể.

Để truy cập trang này, tại thanh menu bên trái, chọn mục **Bán hàng**, sau đó chọn **Lô hàng**.

#### 2. Ý nghĩa các thẻ thống kê

Ở đầu trang có 3 thẻ thống kê tổng quan:

* **Tổng lô**: tổng số lô hàng đã được tạo trong hệ thống.
* **Tổng key**: tổng số lượng key đã được xuất ra từ tất cả các lô hàng.
* **Key đã kích hoạt**: tổng số key đã được người dùng (học sinh/trường) kích hoạt sử dụng trên tổng số key đã xuất.

  <figure><img src="/files/T7NTvu35UxA3BLC9Ohue" alt=""><figcaption></figcaption></figure>

#### 3. Bộ lọc và bảng danh sách

<figure><img src="/files/KK6VF06s5M1k4U5CZ3SQ" alt=""><figcaption></figcaption></figure>

Khu vực **Bộ lọc** cho phép tìm kiếm và thu hẹp danh sách lô hàng theo nhiều tiêu chí:

* Ô tìm kiếm theo tên trường, tên lô hoặc mã lô.
* Lọc theo **Loại lô**: Bán buôn, Bán lẻ, Dùng thử, Giải thưởng.
* Lọc theo **Trạng thái** lô: Đang hoạt động, Đã đóng.
* Lọc theo **Trường** (chọn từ danh sách các trường đã có trong hệ thống).
* Lọc theo **Thanh toán**: Đã thanh toán, Chưa thanh toán.
* Lọc theo **Trạng thái key**: Đã tạo key, Chưa tạo key.
* Lọc theo khoảng thời gian (Từ ngày – Đến ngày).

Bảng danh sách lô hàng hiển thị các cột: STT, Mã lô, Tên lô, Loại lô, Sản phẩm, Trường (nếu là bán buôn), Thời hạn (ngày) sử dụng của key, Key xuất (số lượng key đã được xuất), Đã kích hoạt (số lượng và phần trăm key đã kích hoạt), và Hành động.

Ngoài ra có nút **Xuất Excel** ở góc trên bên phải để xuất toàn bộ danh sách lô hàng hiện tại ra file Excel.

<figure><img src="/files/Bmk6nYNYAimKoc0WlMG2" alt=""><figcaption></figcaption></figure>

#### 4. Ý nghĩa các nhãn trạng thái

* **Loại lô**: Bán buôn (lô cấp cho một trường cụ thể), Bán lẻ (bán trực tiếp cho cá nhân qua sales hoặc app/FPT), Dùng thử (key thử miễn phí, có thời hạn ngắn), Giải thưởng (key tặng làm quà/giải thưởng).
* **Trạng thái lô** (hiển thị trên trang chi tiết): Đang hoạt động (lô còn hiệu lực, có thể tiếp tục sử dụng/xuất key), Đã đóng (lô đã bị khóa, không thể xuất thêm key).
* **Trạng thái thanh toán**: Đã thanh toán, Chưa thanh toán — theo dõi lô hàng bán buôn/bán lẻ đã được trường hoặc khách thanh toán hay chưa.
* **Trạng thái từng key** (trong bảng đối soát key ở trang chi tiết): Key đang hoạt động, Key đã hết hạn, Key chưa kích hoạt.

#### 5. Các bước tạo lô hàng mới

1. Tại trang Lô hàng, nhấn nút **+ Tạo lô hàng** ở góc phải khu vực bộ lọc.

<figure><img src="/files/FlcDZaI0ZaK2YZyHAhhD" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Ii11UcEoVN96SP0LRpUN" alt=""><figcaption></figcaption></figure>

1. Trong mục **Thông tin lô key**, nhập **Tên lô key** và chọn **Sản phẩm** (hiện chỉ có Enspire Plus – 500.000đ).
2. Chọn **Loại lô**. Tùy loại lô chọn, các trường bên dưới sẽ thay đổi:

<figure><img src="/files/I8K0uE18BKuggTvlgRBc" alt=""><figcaption></figcaption></figure>

* Nếu chọn **Bán buôn**: nhập **Thời hạn (ngày)** sử dụng của key, sau đó điền tiếp mục **Thông tin trường và người nhận** gồm chọn **Trường** (tìm theo tên hoặc mã trường trong danh sách có sẵn), **Thông tin người nhận**, **SĐT**, **Email**.
* Nếu chọn **Bán lẻ**: nhập Thời hạn (ngày), sau đó chọn **Kiểu bán lẻ** là "Qua sales" hoặc "App/FPT" (không cần chọn trường/người nhận).
* Nếu chọn **Dùng thử** hoặc **Giải thưởng**: chỉ cần nhập Thời hạn (ngày), không cần thông tin trường hay người nhận.

3. Ở mục **Thời gian hiệu lực**, chọn **Ngày bắt đầu** và **Ngày kết thúc** áp dụng cho lô hàng (không bắt buộc).

<figure><img src="/files/y1TxOuNcTsjLduqFmTzZ" alt=""><figcaption></figcaption></figure>

3. Kiểm tra lại thông tin rồi nhấn **Tạo lô hàng** để lưu, hoặc nhấn **Hủy** để đóng lại mà không lưu.

#### 6. Các bước sửa lô hàng

1. Tại dòng lô hàng muốn sửa, nhấn vào icon **bút chì (Sửa)** trong cột Hành động.
2. Trong cửa sổ **Sửa lô hàng**, có thể chỉnh sửa Tên lô key, Sản phẩm, Loại lô, Thời hạn (ngày), Ngày bắt đầu/Ngày kết thúc. Mã lô được hệ thống tạo tự động và không thể chỉnh sửa.
3. Nhấn **Lưu thay đổi** để cập nhật, hoặc **Hủy** để đóng lại mà không lưu.

<figure><img src="/files/KWRwrThVemP7agSCtUZv" alt=""><figcaption></figcaption></figure>

#### 7. Đóng lô hàng

<figure><img src="/files/O4Pkobjng6EOtLubXXAW" alt=""><figcaption></figcaption></figure>

Tại cột Hành động, icon hình tròn màu đỏ (gạch chéo) chính là nút **Đóng lô**, dùng để khóa một lô hàng lại (chuyển trạng thái từ "Đang hoạt động" sang "Đã đóng"), khi đó lô sẽ không thể xuất thêm key mới. Đây là hành động cần cân nhắc kỹ vì ảnh hưởng đến khả năng sử dụng của lô hàng, nên trước khi thực hiện cần xác nhận chắc chắn trong hộp thoại cảnh báo hiện ra.

#### 8. Xem chi tiết lô hàng và đối soát key

<figure><img src="/files/EQb8hRpIw3rM2F5lUc8a" alt=""><figcaption></figcaption></figure>

1. Nhấn vào **Tên lô** trong bảng danh sách để mở trang chi tiết lô hàng.
2. Trang chi tiết hiển thị **Tổng quan key** (biểu đồ phần trăm key đã kích hoạt trên tổng số key của lô) và **Thông tin bán hàng** đầy đủ (Mã lô, Tên lô, Loại lô, Sản phẩm, Giá, Thời hạn, Trường, Thông tin người nhận, SĐT, Email, Ngày tạo lô, Ngày xuất key, Người xuất key, Trạng thái tiền).
3. Phần **Đối soát key** ở cuối trang cho phép tra cứu từng key cụ thể thuộc lô hàng này, gồm: tìm kiếm theo key/người nhận/email, lọc theo trạng thái key (Tất cả key, Key đang hoạt động, Key đã hết hạn, Key chưa kích hoạt), lọc theo khoảng ngày, và nút **Xuất Excel** để xuất danh sách key ra file. Bảng hiển thị các cột: Key, Trạng thái, Tên học sinh, Tên trường, Email, Ngày kích hoạt, Ngày hết hạ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.enspire.online/sales/programs/lo-hang.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.