Danh sách Voucher

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

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
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
Các nút thao tác	Sửa voucher / 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.