> 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

Hiển thị danh sách voucher trên Miniapp và CMS

| 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![](/files/auaZ6Xm7hHb3JTDHlMdw) | | Trạng thái (filter) |

Chọn: Tất cả / Đang hoạt động / Ngưng hoạt động

| | 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![](/files/lJNKN7FYZbOMt806WqQh) | | Các nút thao tác | ![](/files/wsJQCvFTQ3gGoqIA6XLs)Sửa voucher / ![](/files/0Le5Y55w3lojeKawtLsL)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

Thêm mới voucher

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:

Chọn "Có" để Voucher đổi bằng điểm thành viên

| 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)

Tải lên voucher hàng loạt bằng file Excel

* 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** ### **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**. ### 2**. Import Voucher - Tab “Upload file”**

Nhập Excel - Upload File

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

Tặng Voucher theo Tag

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ể

Tặng Voucher cho Khách hàng cụ thể

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

Xuất Excel

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

Sửa Voucher

* 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

Xoá voucher

* 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. --- # 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://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/voucher/danh-sach-voucher.md?ask=&goal= ``` `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.