> 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/voucher/danh-sach-voucher.md).

# Danh sách Voucher

Giúp Admin quản lý tất cả voucher hiện có trong hệ thống.

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FJeJFJMMR55of6dJmF8La%2F73.png?alt=media&amp;token=0c048173-57ab-46d3-a1c5-a2e3ed01257b" alt=""><figcaption><p>Hiển thị danh sách voucher trên Miniapp và CMS</p></figcaption></figure>

| Thành phần             | Mô tả                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 🔎 Bộ lọc tìm kiếm     | Tìm theo tên, loại voucher, trạng thái                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Loại voucher (filter)  | Chọn: Tất cả / Giảm giá đơn hàng / sản phẩm / vận chuyển![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FSGIbnUxAH1eOArtubEfC%2FScreenshot%202025-06-27%20at%2012.01.53.png?alt=media\&token=b3fefd55-3828-4337-b01b-10f8fe82cc89)                                                                                                                                                                                                                      |
| Trạng thái (filter)    | <p>Chọn: Tất cả / Đang hoạt động / Ngưng hoạt động</p><p><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FLeBxZcOe8zCNDsQn731a%2FScreenshot%202025-06-27%20at%2012.02.35.png?alt=media&amp;token=7d2163b4-cbbd-47be-88ad-87a732f03479" alt=""></p>                                                                                                                                                                                                |
| Bảng danh sách voucher | Hiển thị STT, Tên voucher, Mã, Giá trị, Giảm tối đa, Trạng thái, Ngày bắt đầu – kết thúc – hết hạn                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Trạng thái             | Dấu chấm xanh: Đang hoạt động![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FhZwoDN7CMnK74KZWU0sP%2FScreenshot%202025-06-27%20at%2012.03.24.png?alt=media\&token=e187b2cc-a652-4b93-9e2a-9339d467b3cd)                                                                                                                                                                                                                                                 |
| Các nút thao tác       | ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FLAwDOME5eBoVfJV7LRVq%2FScreenshot%202025-06-30%20at%2011.50.01.png?alt=media\&token=1df63a8f-28bd-494d-9e4c-0c7a3e6657ab)Sửa voucher / ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2F4XDkpjrsn7jyRdEWoqm4%2FScreenshot%202025-06-30%20at%2011.50.14.png?alt=media\&token=813f214c-2790-49a2-bd55-ee83d506b833)Xóa voucher |

✅ **Lưu ý:**

* Voucher xóa sẽ không khôi phục được.
* Có thể xuất/nhập Excel để quản lý hàng loạt.

## Thêm mới Voucher

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FXVf28BiKskGke3hPgfrC%2F74.png?alt=media&amp;token=00141868-8c61-496c-b1a2-85b3f6157e6c" alt=""><figcaption><p>Thêm mới voucher</p></figcaption></figure>

Cho phép tạo mới voucher với đầy đủ điều kiện áp dụng.

Phần form nhập gồm:

#### 🗂 Thông tin cơ bản

| Trường           | Ý nghĩa                          |
| ---------------- | -------------------------------- |
| Tên voucher (\*) | Tiêu đề voucher                  |
| Mã voucher (\*)  | Mã code (duy nhất)               |
| Trạng thái       | Đang hoạt động / Ngưng hoạt động |
| Mô tả            | Thông tin thêm về voucher        |

#### 🗂 Thời gian áp dụng

| Trường             | Ý nghĩa                                  |
| ------------------ | ---------------------------------------- |
| Ngày bắt đầu (\*)  | Khi voucher có hiệu lực                  |
| Ngày kết thúc (\*) | Hạn cuối áp dụng                         |
| Ngày hết hạn       | Thời gian hết hạn của voucher khách nhận |

🗂 **Điều kiện giảm giá**

| Trường             | Ý nghĩa                             |
| ------------------ | ----------------------------------- |
| Loại áp dụng (\*)  | Đơn hàng / Sản phẩm / Vận chuyển    |
| Loại giảm (\*)     | Phần trăm / Số tiền                 |
| Giá trị giảm (\*)  | 10%, 50.000đ, ...                   |
| Giảm tối đa        | Giá trị tối đa giảm                 |
| Đơn hàng tối thiểu | Mức giá trị đơn hàng để áp dụng     |
| Số lượng (\*)      | Giới hạn số lượng voucher phát hành |

#### 🗂 Điều kiện đổi điểm

Nếu Voucher cần đồi bằng điểm thành viên để sử dụng, vui lòng chọn có và nhập thông tin tại mục này:

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FNLH4TSRNqPzFDfuPljlU%2F75.png?alt=media&amp;token=b5dcd843-a0cd-4e6e-9737-78b993240cf1" alt=""><figcaption><p>Chọn "Có" để Voucher đổi bằng điểm thành viên</p></figcaption></figure>

| Trường            | Ý nghĩa                               |
| ----------------- | ------------------------------------- |
| Có đổi bằng điểm  | Có/Không                              |
| Số điểm cần đổi   | Số điểm khách cần đổi để nhận voucher |
| Số điểm được cộng | Điểm cộng thêm sau khi sử dụng        |
| Đơn hàng hành vi  | Điều kiện hành vi đơn hàng            |

#### 🗂 Sản phẩm áp dụng

* Chọn loại sản phẩm voucher áp dụng (nếu cần).

✅ **Nút thao tác:**

* **Lưu**: Lưu voucher mới.
* **Làm mới**: Reset nội dung form.
* **Đóng**: Hủy tạo.

## Tải Voucher lên hàng loạt bằng file Excel (Import Voucher)

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FKQdZItlxlhL3qV4tmdEm%2F76.png?alt=media&amp;token=2b4607c7-be8d-46af-a3bd-3baf0ce58b3b" alt=""><figcaption><p>Tải lên voucher hàng loạt bằng file Excel</p></figcaption></figure>

* Cho phép **tạo hàng loạt voucher** bằng cách tải file Excel lên hệ thống.
* Giúp tiết kiệm thời gian, tránh nhập tay từng voucher.

#### 🗂 **Bố cục màn hình**

Màn hình này gồm 2 tab lớn:

1️⃣ **Tab Tải file mẫu**\
2️⃣ **Tab Upload file**

### &#x20;**1. Import Voucher - Tab “Tải file mẫu”**

Tải file Excel mẫu hệ thống cung cấp, để nhập dữ liệu voucher chuẩn định dạng.

**Hệ thống quy định bắt buộc:**\
✅ File phải có định dạng Excel (.xlsx).\
✅ Không thay đổi tên các cột trong file.\
✅ Nhập đúng định dạng dữ liệu cho từng cột.

Bảng **Cấu trúc file** giải thích rõ từng cột:

| Cột           | Mô tả               | Định dạng                | Bắt buộc          |
| ------------- | ------------------- | ------------------------ | ----------------- |
| Name          | Tên voucher         | Text                     | ✅ Có              |
| Code          | Mã voucher (unique) | Text                     | ✅ Có + Unique     |
| Description   | Mô tả               | Text                     | 🚫 Không bắt buộc |
| DiscountValue | Giá trị giảm giá    | Số                       | ✅ Có              |
| PointRequired | Điểm yêu cầu        | Số nguyên                | ✅ Có              |
| StartDate     | Ngày bắt đầu        | dd/MM/yyyy               | ✅ Có              |
| EndDate       | Ngày kết thúc       | dd/MM/yyyy               | ✅ Có              |
| ExpiryDate    | Ngày hết hạn        | dd/MM/yyyy               | ✅ Có              |
| DiscountType  | Loại giảm giá       | Percentage / FixedAmount | ✅ Có              |
| Quantity      | Số lượng voucher    | Số nguyên                | ✅ Có              |
| ExchangeTimes | Số lần đổi voucher  | Số nguyên                | ✅ Có              |

📌 **Giải thích thêm về DiscountType:**

* **Percentage:** Giảm theo % (vd: 10).
* **FixedAmount:** Giảm cố định (vd: 50000).

✅ **Mẹo quan trọng:**

* Nếu cột *Code* trùng với mã đã có, hệ thống sẽ báo lỗi.
* Đảm bảo ngày tháng đúng định dạng **dd/MM/yyyy**.

### &#x20;&#x32;**. Import Voucher - Tab “Upload file”**

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FZH5Sdj0Vu8WnWDVA3E1u%2F77.png?alt=media&amp;token=785c2e09-f888-4186-91a1-a4067fc68429" alt=""><figcaption><p>Nhập Excel - Upload File</p></figcaption></figure>

Tải file Excel đã điền dữ liệu lên để import voucher.

**Các bước thao tác:**

✅ **Bước 1:**\
Bấm **Chọn file Excel (.xlsx)**.

* Tải lên file vừa soạn dựa trên file mẫu.

✅ **Bước 2:**\
Kiểm tra tên file hiện ra cạnh nút Choose File.

✅ **Bước 3:**\
Bấm **Import** để bắt đầu tải dữ liệu vào hệ thống.

✅ **Bước 4:**\
Hệ thống hiển thị kết quả:

* Nếu thành công: Voucher được thêm mới.
* Nếu lỗi: Hiển thị thông báo chi tiết.

✅ **Bước 5:**\
Nếu muốn hủy thao tác, bấm **Hủy**.

Lưu ý quan trọng cho Admin:

* **Không chỉnh sửa tiêu đề cột** trong file Excel.
* **Code voucher phải duy nhất**.
* **Ngày hết hạn không được sớm hơn ngày bắt đầu**.
* Nếu hệ thống báo lỗi, kiểm tra kỹ dữ liệu từng dòng.

#### **Quy trình gợi ý chuẩn**

1. Tải file mẫu.
2. Điền dữ liệu voucher đầy đủ.
3. Kiểm tra kỹ file.
4. Upload file.
5. Kiểm tra kết quả import.

Hãy luôn:

* Tuân thủ định dạng dữ liệu.
* Kiểm tra file trước khi import.
* Đảm bảo **Mã voucher** không trùng lặp.

## Tặng Voucher

* Chức năng này cho phép Admin **gửi (cấp phát) voucher cho khách hàng**.
* Có **2 chế độ gửi**:
  * **Tặng theo Tag** – gửi cho toàn bộ khách hàng theo nhóm (tag).
  * **Tặng khách hàng cụ thể** – chọn đích danh khách hàng.

### 1. Tặng theo Tag

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FrWuSCJK0uAvrNwQHW7H5%2F79.png?alt=media&amp;token=bea39bda-7330-4560-a5c6-d276c9402066" alt=""><figcaption><p>Tặng Voucher theo Tag</p></figcaption></figure>

Tặng voucher cho tất cả khách trong 1 hoặc nhiều nhóm (tag) được chọn.

#### Các bước hướng dẫn:

1️⃣ Chọn chế độ **Tặng theo Tag** (nút đầu tiên được highlight màu xanh).\
2️⃣ Ở **CHỌN NGƯỜI NHẬN**:

* Mở dropdown, chọn Tag nhóm khách hàng muốn tặng.
* Có thể chọn nhiều tag hoặc chọn “Tất cả khách hàng”
* Tip: Tất cả khách trong tag sẽ nhận voucher.

3️⃣ Ở **CHỌN VOUCHER**:

* Chọn 1 hoặc nhiều voucher muốn tặng.
* Có thể chọn từ danh sách các voucher đang hoạt động.

4️⃣ Nhấn **Tặng Voucher** để gửi.

### 2. Tặng Khách hàng cụ thể

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FKdjLyA9AXC9YYwfuhDon%2F78.png?alt=media&amp;token=6f36c53f-bcfe-4ea6-8a42-31a2b04a42c7" alt=""><figcaption><p>Tặng Voucher cho Khách hàng cụ thể</p></figcaption></figure>

#### Các bước hướng dẫn:

1️⃣ Chọn chế độ **Tặng Khách hàng cụ thể** (nút thứ hai được highlight màu xanh).\
2️⃣ Ở **CHỌN NGƯỜI NHẬN**:

* Mở dropdown, tìm và chọn khách hàng đích danh.
* Có thể chọn nhiều khách hàng cùng lúc.

3️⃣ Ở **CHỌN VOUCHER**:

* Chọn 1 hoặc nhiều voucher muốn tặng.

4️⃣ Nhấn **Tặng Voucher** để hoàn tất.

### 3. Mẹo và lưu ý cho Admin

⭐ **Chọn đúng chế độ tặng** – tránh nhầm giữa tặng hàng loạt (tag) và tặng riêng lẻ.\
⭐ **Kiểm tra kỹ voucher còn hiệu lực** trước khi gửi.\
⭐ **Voucher có thể giới hạn số lượng phát hành** – không gửi vượt quá quota.\
⭐ Sau khi gửi, khách hàng sẽ nhận voucher trong tài khoản hoặc qua thông báo (tùy hệ thống).

### 4. Ví dụ minh họa dễ hiểu

🎯 **Ví dụ 1 – Tặng theo Tag**

* Mục đích: Tặng 50.000đ freeship cho toàn bộ nhóm “VIP”.
* Chọn **Tặng theo tag**.
* Tag nhận: VIP.
* Voucher: FREESHIP50.
* Nhấn **Tặng Voucher**.

🎯 **Ví dụ 2 – Tặng Khách hàng cụ thể**

* Mục đích: Tặng giảm 10% cho khách hàng “Nguyễn Văn A” và “Trần Thị B”.
* Chọn **Tặng Khách hàng cụ thể**.
* Người nhận: Nguyễn Văn A, Trần Thị B.
* Voucher: GIAM10.
* Nhấn **Tặng Voucher**.

## Xuất Excel Dữ liệu Voucher

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FaE5AvbVF6cH6DRQ1oY6z%2F82.png?alt=media&amp;token=bf0fa02b-4332-414b-8720-cb11fd76d326" alt=""><figcaption><p>Xuất Excel</p></figcaption></figure>

Chọn Xuất Excel để tải về dữ liệu Voucher trên hệ thống

## Sửa Voucher

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FwMJIZOMYeT8ApFgawVKt%2F80.png?alt=media&amp;token=faa87c59-59f8-46e0-adc9-66e135ad4ef6" alt=""><figcaption><p>Sửa Voucher</p></figcaption></figure>

* Cho phép admin xem chi tiết thông tin voucher đã tạo.
* Admin có thể chỉnh sửa các trường và lưu thay đổi.

✅ **Hành động cuối cùng:**

* **Cập nhật**: Lưu các thay đổi.
* **Đóng**: Hủy và quay lại danh sách.

## Xóa Voucher

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FLcvzJ3VmSBNmOu7fFSun%2F81.png?alt=media&amp;token=d8c001fa-33d4-436c-812e-d451f5baec2f" alt=""><figcaption><p>Xoá voucher</p></figcaption></figure>

* Sau khi xóa, voucher biến mất hoàn toàn khỏi hệ thống.
* Cần kiểm tra kỹ trước khi xác nhận.