> For the complete documentation index, see [llms.txt](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/san-pham/danh-sach-san-pham.md).

# Danh sách sản phẩm

<figure><img src="/files/KYytNyxSU8h6NfYFbEhO" alt=""><figcaption><p>Hiển thị danh sách sản phẩm trên Mini App và CMS</p></figcaption></figure>

Màn hình **Danh sách sản phẩm** hỗ trợ quản trị viên:

* Theo dõi toàn bộ sản phẩm đang quản lý.
* Lọc dữ liệu theo nhiều điều kiện.
* Thực hiện các thao tác: thêm mới, chỉnh sửa, xóa, xuất file Excel, xem đánh giá sản phẩm.

Thanh công cụ trên cùng biểu thị:

| Nút                                                                                                 | Mô tả                                                                                 |
| --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| <div><figure><img src="/files/Vvr0UtBeNTDRs5YA9lEP" alt=""><figcaption></figcaption></figure></div> | Mở form thêm sản phẩm thủ công (1 sản phẩm/lần)                                       |
| <div><figure><img src="/files/ZR8Rb6K5BTlXahVGPZCu" alt=""><figcaption></figcaption></figure></div> | Mở popup nhập hàng loạt sản phẩm từ file mẫu `.xlsx` (hỗ trợ biến thể, thuộc tính...) |

Bộ lọc sản phẩm cho phép lọc theo các điều kiện sau:

| Trường lọc     | Mô tả                                                                                                                                                                                     |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Danh mục**   | Lọc sản phẩm theo nhóm đã phân loại                                                                                                                                                       |
| **Chi nhánh**  | Lọc theo khu vực được phân phối                                                                                                                                                           |
| **Tình trạng** | Gồm 3 trạng thái: `Còn hàng`, `Hết hàng`, `Ngừng kinh doanh`                                                                                                                              |
| **Quà tặng**   | Phân biệt sản phẩm là quà tặng hay sản phẩm chính                                                                                                                                         |
| **Khoảng giá** | Nhập giá tối thiểu và tối đa để lọc theo mức giá                                                                                                                                          |
| **Thao tác**   | <p><code>Đặt lại</code>: xoá toàn bộ điều kiện lọc</p><p><code>Áp dụng</code>: áp dụng điều kiện</p><p><code>Xuất Excel</code>: xuất danh sách hiện tại thành file <code>.xlsx</code></p> |

Dữ liệu hiển thị dưới dạng bảng, gồm các cột:

| Cột                            | Mô tả                                                                                                                                                                                                            |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **STT**                        | Số thứ tự                                                                                                                                                                                                        |
| **Tên sản phẩm**               | Tên đầy đủ, có ảnh đại diện kèm theo                                                                                                                                                                             |
| **Giá**                        | Giá bán hiển thị trên Mini App                                                                                                                                                                                   |
| **Mức độ quan tâm**            | Thống kê lượt bán + điểm đánh giá trung bình                                                                                                                                                                     |
| **Loại**                       | Phân biệt `Sản phẩm` hay `Quà tặng`                                                                                                                                                                              |
| **Thứ tự hiển thị (Mini App)** | Số nhỏ hiển thị trước                                                                                                                                                                                            |
| **Trạng thái**                 | Còn hàng, Hết hàng, Ngừng kinh doanh                                                                                                                                                                             |
| **Thao tác**                   | <p>   <img src="/files/WGMdgqUlVaORYBs5zpNd" alt=""> Sửa sản phẩm<br>  <img src="/files/2U0y8PRgPprhxFGX2Qsa" alt=""> Xóa sản phẩm<br>  <img src="/files/5y0rkIaWxqiaz2Y5yzF0" alt="">Xem/chỉnh sửa đánh giá</p> |

## Thêm mới sản phẩm

<figure><img src="/files/7Mk4zPJGQ2q855voUfMd" alt=""><figcaption><p>Thêm mới sản phẩm</p></figcaption></figure>

* Nhấn nút ![](/files/zRB8HELr3kZGPWoEVJV9)
* Điền đầy đủ các thông tin cơ bản sau:

<table><thead><tr><th>Trường</th><th width="174.47265625">Bắt buộc</th><th>Mô tả</th></tr></thead><tbody><tr><td><strong>Tên sản phẩm</strong></td><td>✅</td><td>Nhập tên đầy đủ. Gợi ý chuẩn: <code>Thương hiệu + Model + RAM/ROM</code>. VD: <code>iPhone 15 Pro Max 256GB</code></td></tr><tr><td><strong>Thứ tự hiển thị</strong></td><td>⛔</td><td>Dùng để sắp xếp sản phẩm trên Mini App. Số càng nhỏ càng lên đầu. Gợi ý mặc định: <code>0</code></td></tr><tr><td><strong>Loại sản phẩm</strong></td><td>✅</td><td>Chọn <code>Sản phẩm</code> hoặc <code>Quà tặng</code>. Nếu là quà tặng trong khuyến mãi thì chọn “Quà tặng”</td></tr><tr><td><strong>Danh mục</strong></td><td>✅</td><td>Chọn danh mục cha mà sản phẩm này thuộc về. Danh mục phải được tạo sẵn trước</td></tr><tr><td><strong>Giá bán</strong></td><td>✅</td><td>Giá hiển thị cho người dùng. Nhập số nguyên dương, không nhập ký tự <code>,</code> hoặc <code>.</code></td></tr><tr><td><strong>Lượt bán / Lượt đánh giá / Điểm đánh giá</strong></td><td>⛔</td><td>Dữ liệu này được sinh tự động từ thống kê Mini App. Không cần nhập tay</td></tr><tr><td><strong>Trạng thái hoạt động</strong></td><td>✅</td><td>Chọn một trong các giá trị: <code>Còn hàng</code>, <code>Hết hàng</code>, <code>Ngừng kinh doanh</code></td></tr><tr><td><strong>Chi nhánh</strong></td><td>✅</td><td>Chọn chi nhánh áp dụng (nơi có hàng hoặc trưng bày). Có thể chọn nhiều</td></tr><tr><td><strong>Mô tả sản phẩm</strong></td><td>⛔</td><td>Thông tin chi tiết sản phẩm, tính năng nổi bật, ưu điểm. Có thể nhập theo định dạng HTML cơ bản</td></tr><tr><td><strong>Chọn phân loại</strong></td><td>⛔</td><td>Nếu sản phẩm có nhiều biến thể (màu, dung lượng…), chọn phân loại để hiển thị danh sách biến thể</td></tr><tr><td><strong>Giá sản phẩm theo từng loại</strong></td><td>✅ nếu có phân loại</td><td>Hệ thống sẽ hiển thị các biến thể (VD: Màu Đỏ - 23tr, Màu Xanh - 22tr…) để nhập giá riêng cho từng loại</td></tr><tr><td><strong>Ảnh</strong></td><td>✅</td><td>Tải lên 1 hoặc nhiều ảnh (ưu tiên ảnh đầu tiên là đại diện). Chấp nhận <code>.jpg</code>, <code>.png</code>, <code>.webp</code> ≤ 2MB/ảnh</td></tr></tbody></table>

## Tải lên hàng loạt sản phẩm từ file Excel

<figure><img src="/files/yzKAd8JWzosrWovYD4tC" alt=""><figcaption><p>Tải lên từ file Excel</p></figcaption></figure>

Cho phép quản trị viên nhập hàng loạt sản phẩm (có hoặc không có biến thể) từ file Excel theo định dạng chuẩn. Hệ thống hỗ trợ tối đa:

* 100 sản phẩm chính mỗi lần import
* Không giới hạn số biến thể của mỗi sản phẩm

**Bước 1: Tải file mẫu Excel**

* Nhấn nút ![](/files/JJpsWs5IFRwQumZUgIoa) để tải về mẫu chuẩn từ hệ thống.
* Không tự ý thêm/bớt cột – tránh lỗi khi import.

**Bước 2: Chuẩn bị file Excel**

* Nhập dữ liệu theo định dạng mẫu.
* Mỗi hàng là một biến thể của sản phẩm.
* Cột "Tên sản phẩm" chỉ điền ở hàng đầu tiên của nhóm biến thể.

**Bước 3: Chọn file Excel để tải lên**

* Chỉ hỗ trợ `.xlsx` và `.xls`
* Nhấn ![](/files/tFrdgDuerADAyfXGuo69) để tải lên file đã điền sẵn.
* Nhấn ![](/files/OUxy9H0C63IFnF3KZre8)để gửi lên hệ thống xử lý.

### Cấu trúc file excel

| Cột                            | Mô tả                                                                | Bắt buộc                                  |
| ------------------------------ | -------------------------------------------------------------------- | ----------------------------------------- |
| **Tên sản phẩm**               | Tên sản phẩm chính. Nếu có biến thể thì chỉ cần điền ở dòng đầu tiên | ✅                                         |
| **Tên thuộc tính 1, 2, 3**     | Tên các thuộc tính như: Màu sắc, Size, Chất liệu (tối đa 3)          | ⛔ (Có thể để trống nếu không có biến thể) |
| **Giá trị thuộc tính 1, 2, 3** | Giá trị cụ thể của thuộc tính: Đỏ, L, Cotton                         | ⛔                                         |
| **Giá**                        | Giá bán (VND, không dấu chấm, không ký tự)                           | ✅                                         |
| **Tồn kho**                    | Số lượng tồn kho                                                     | ✅                                         |
| **Ảnh**                        | Link URL ảnh, phân cách dấu `,` nếu có nhiều ảnh                     | ⛔                                         |
| **Danh mục**                   | Tên danh mục cấp cha (VD: Thời trang nam)                            | ⛔                                         |
| **Mô tả**                      | Mô tả sản phẩm (text)                                                | ⛔                                         |

### Cách xử lý sản phẩm có biến thể

<figure><img src="/files/cy2wpeP6Oj20khwKD7Xt" alt=""><figcaption><p> Ví dụ mẫu - Import từ Excel</p></figcaption></figure>

> **Mỗi biến thể** sẽ là một dòng trong file Excel, trong đó:

* Các cột “Giá trị thuộc tính” là khác nhau
* Tên sản phẩm giữ nguyên (để trống các dòng sau dòng đầu tiên)

**✅ Ví dụ:**

| Tên SP      | TT1 (Màu) | TT2 (Size) | TT3 (Chất liệu) | Giá    | Tồn kho |
| ----------- | --------- | ---------- | --------------- | ------ | ------- |
| Áo thun nam | Đen       | L          | Cotton          | 150000 | 50      |
| *(trống)*   | Trắng     | L          | Cotton          | 150000 | 40      |
| *(trống)*   | Đen       | XL         | Cotton          | 170000 | 20      |

### Lưu ý quan trọng:

* **Tối đa 3 thuộc tính/phân loại** cho mỗi sản phẩm.
* Không được để trống cột “Giá” và “Tồn kho”.
* Nếu chỉ có 1 biến thể duy nhất, có thể điền tất cả trên một dòng duy nhất.
* Ảnh chỉ được upload bằng **link URL trực tiếp**, không hỗ trợ ảnh cục bộ từ máy.

Gợi ý kiểm tra trước khi import:

| Mục                                 | Kiểm tra |
| ----------------------------------- | -------- |
| File đúng định dạng mẫu?            | ✔        |
| Không thêm/bớt cột trong Excel?     | ✔        |
| Không bỏ trống các dòng bắt buộc?   | ✔        |
| Ảnh là link URL hợp lệ?             | ✔        |
| Dữ liệu không trùng tên thuộc tính? | ✔        |

## Chỉnh sửa thông tin sản phẩm

<figure><img src="/files/X4VRndg7OOYH6YeLmQjL" alt=""><figcaption><p>Cập nhật sản phẩm</p></figcaption></figure>

Cho phép admin chỉnh sửa thông tin chi tiết của một sản phẩm đã có sẵn, bao gồm tên, giá, danh mục, mô tả, hình ảnh, chi nhánh áp dụng... cụ thể các thông tin như sau:

| Nhóm                     | Mô tả                                                                               |
| ------------------------ | ----------------------------------------------------------------------------------- |
| **Tên sản phẩm**         | Tên hiển thị trên Mini App, nên đầy đủ và rõ ràng.                                  |
| **Thứ tự hiển thị**      | Số nhỏ hơn sẽ ưu tiên hiển thị ở đầu danh sách trên Mini App.                       |
| **Loại sản phẩm**        | “Sản phẩm” hoặc “Quà tặng”. Không chỉnh nếu không cần thiết.                        |
| **Danh mục**             | Chọn danh mục cha và con (VD: MacBook → Đồ Công Nghệ). Có thể thuộc nhiều danh mục. |
| **Giá bán**              | Nhập giá sản phẩm chính (nếu không dùng biến thể).                                  |
| **Chi nhánh**            | Chọn các chi nhánh có áp dụng sản phẩm này.                                         |
| **Trạng thái hoạt động** | Chọn “Còn hàng”, “Hết hàng” hoặc “Ngừng kinh doanh”.                                |
| **Mô tả sản phẩm**       | Nhập thông tin mô tả (có thể định dạng cơ bản).                                     |
| **Phân loại (biến thể)** | Nếu sản phẩm có phân loại như màu, size... thì chọn tại đây.                        |
| **Ảnh**                  | Có thể upload nhiều ảnh, ảnh đầu tiên là ảnh đại diện.                              |

Ấn Cập nhật để Lưu lại toàn bộ chỉnh sửa, ấn Đóng để thoát khỏi popup, không lưu thay đổi

## Xoá sản phẩm

<figure><img src="/files/CDBf5vGgB39AU9rekDgz" alt=""><figcaption><p>Xoá sản phẩm</p></figcaption></figure>

* Nhấn ![](/files/26t8gmoOdQ72CceVF01S)→ hệ thống sẽ hiển thị cảnh báo xác nhận.
* Dữ liệu sẽ **không thể khôi phục** sau khi xóa.

## Xem đánh giá sản phẩm

<figure><img src="/files/Di85W3B3vdPY9452iNfb" alt=""><figcaption><p>Xem đánh giá sản phẩm</p></figcaption></figure>

Click biểu tượng đánh giá ![](/files/mAmc1hlmRiuEGCVX0o5j)

Có thể:

* Xem ảnh kèm theo
* Bật/tắt hiển thị đánh giá trên Mini App


---

# 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:

```
GET https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/san-pham/danh-sach-san-pham.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.