Rewards: kho quà, đổi quà & nhân viên quét QR

Loại hình Rewards tập trung vào chương trình thành viên: khách tích điểm và đổi điểm lấy quà. Bài này gồm phần cấu hình trên dashboard và các luồng nhân viên thao tác trực tiếp trên Mini App.

1. Kho quà tặng (dashboard)

Vào menu Kho quà tặng ("Quản Lý Quà Tặng").

Bảng quà tặng

Bộ lọc:

• Ô tìm kiếm: "Tìm theo tên quà..."

Bảng:

Cột	Mô tả
Quà tặng	Ảnh + tên + mô tả ngắn
Điểm đổi	Số điểm cần để đổi
Kho	Số lượng tồn kho
Thứ tự	Thứ tự hiển thị trên Mini App
Hoạt động	Toggle bật/tắt
Thao tác	Sửa, Xóa

Tạo quà tặng mới

Nhấn "Thêm quà tặng":

Trường	Mô tả	Bắt buộc
Hình ảnh	Ảnh phần quà	Không
Tên quà tặng	Tên hiển thị	Có (*)
Mô tả	Mô tả chi tiết phần quà	Không
Điểm đổi	Số điểm khách cần để đổi	Có (*)
Số lượng tồn kho	Để trống = không giới hạn	Không
Giới hạn mỗi khách (Lần)	Số lần một khách được đổi. Để trống = không giới hạn	Không
Thứ tự hiển thị trang chủ	"Không ưu tiên" / 1-6 (1 = ưu tiên cao nhất)	Không
Trạng thái hiển thị	Cho phép khách hàng nhìn thấy quà này trên Mini App	Không

Lưu ý: Nếu gán hai quà cùng một vị trí ưu tiên, hệ thống tự hoán đổi vị trí cũ khi lưu.

2. Lịch sử đổi quà (dashboard)

Vào menu Lịch sử đổi quà.

Bộ lọc

• Ô tìm kiếm: "Tìm mã, SĐT, hoặc tên khách, quà..."
• Trạng thái: "Tất cả trạng thái" / "Chờ xử lý (Chưa giao)" / "Đã hoàn thành" / "Đã hết hạn" / "Đã hủy"

Bảng lịch sử

Cột	Mô tả
Mã lượt đổi	Mã đổi quà
Khách hàng	Tên + SĐT
Loại	"Voucher" (xanh) hoặc "Quà tặng" (cam)
Phần quà	Tên quà/voucher
Trạng thái	"Chờ xử lý" (vàng) / "Hoàn thành" (xanh) / "Đã hết hạn" (đỏ) / "Đã hủy" (xám)
Ngày đổi	Ngày đổi quà
Thao tác	"Đánh dấu Hoàn Thành" (chỉ khi Chờ xử lý)

Xác nhận trao quà

Với lượt "Chờ xử lý", nhấn nút "Đánh dấu Hoàn Thành" để xác nhận đã trao quà.

Việc trao quà thường được xác nhận nhanh hơn bằng cách quét QR trên Mini App — xem mục 4.

3. Phân quyền nhân viên (dashboard)

Vào menu Nhân viên quét QR.

Bảng nhân viên

Bộ lọc:

• Ô tìm kiếm: "Tìm theo tên hoặc SĐT..."

Bảng:

Cột	Mô tả
Nhân viên	Avatar + tên + SĐT
Quyền	Số quyền đã bật (X/5)
Điểm quét	Tổng điểm đã quét
Quà phát	Tổng quà đã phát
Trạng thái	"Hoạt động" (xanh) / "Tạm khóa" (xám)
Ngày tham gia	Ngày cấp quyền
Thao tác	"Gỡ quyền nhân viên"

Quyền (5 icon):

• ⭐ Tích điểm (earn_points) — Nhập số tiền đơn để quy đổi điểm
• 📦 Trao quà (confirm_pickup) — Quét QR để xác nhận phát quà
• 🎫 Voucher (activate_voucher) — Quét QR để xác nhận dùng voucher
• ⚙️ Điều chỉnh điểm (adjust_points) — Cộng/trừ điểm thủ công
• 📷 Check-in (checkin) — Quét QR để điểm danh và cộng điểm cố định

Thêm nhân viên

Nhấn "Thêm nhân viên":

• Tìm khách hàng theo tên hoặc SĐT
• Chọn khách hàng → Hệ thống cấp quyền nhân viên

Chi tiết nhân viên

Nhấn vào dòng để mở trang chi tiết:

• Bật/tắt từng quyền
• Thống kê: quà phát, điểm quét, voucher, điều chỉnh, check-in, số khách
• Khi bật Check-in cộng điểm, đặt thêm số điểm mỗi lần check-in

Quyền cập nhật tức thì: Mini App đọc quyền trực tiếp từ hệ thống, nên khi bạn bật/tắt quyền, nhân viên thấy thay đổi ngay — không cần đăng nhập lại. Đây là nhân viên thao tác trên Mini App, khác với tài khoản dashboard.

4. Nhân viên thao tác trên Mini App

Nhân viên mở Mini App và vào khu vực Nhân viên — màn hình Thao tác chỉ hiện những thẻ tương ứng quyền đã được cấp, kèm thẻ Lịch sử kích hoạt (luôn có). Tất cả các luồng đều dựa trên việc quét mã QR cá nhân của khách (khách mở mã QR trong app của họ), và đều có phương án dự phòng nhập số điện thoại thủ công nếu không mở được camera.

a) Tích điểm đơn hàng

1. Nhấn Mở camera quét mã để quét QR của khách (hoặc nhập SĐT → Tìm khách hàng).
2. Màn hình hiện thông tin khách: tên, SĐT, điểm hiện có, hạng thành viên → nhấn Tiếp tục.
3. Nhập Số tiền giao dịch. Hệ thống hiển thị điểm dự kiến theo công thức cấu hình (ví dụ mỗi 1.000đ = 1 điểm), có nhân hệ số theo hạng nếu khách thuộc hạng cao.
4. (Tùy chọn) nhập ghi chú → nhấn Tích điểm.
5. Màn hình kết quả: điểm cộng, số dư mới, hạn sử dụng điểm, và báo lên hạng nếu có.

b) Check-in cộng điểm (điểm danh)

Luồng rút gọn, không cần nhập số tiền — phù hợp phòng gym, salon:

1. Quét QR khách (hoặc nhập SĐT).
2. Xác nhận đúng khách → nhấn Check-in.
3. Điểm cố định (theo mức admin đã đặt) được cộng tự động. Giới hạn 1 lần/ngày cho mỗi khách.

c) Xác nhận trao quà / Kích hoạt voucher

Dùng khi khách đến nhận quà đã đổi hoặc dùng voucher:

1. Nhấn Mở camera quét mã và quét mã QR đổi quà/voucher hiển thị trên màn hình app của khách (hoặc bấm Nhập mã thủ công rồi dán mã).
2. Hệ thống xác nhận và hiển thị kết quả: tên quà, khách hàng, số điểm đã dùng.
3. Lượt đổi chuyển sang đã trao — đồng bộ với mục Lịch sử đổi quà ở dashboard.

d) Điều chỉnh điểm

1. Quét QR khách (hoặc nhập SĐT) → Tiếp tục.
2. Chọn Cộng điểm hoặc Trừ điểm, nhập số điểm và lý do (bắt buộc, tối thiểu 3 ký tự).
3. Khi trừ, hệ thống chặn nếu số dư không đủ và trừ theo nguyên tắc FIFO/FEFO (ưu tiên điểm cũ/sắp hết hạn). Nhấn xác nhận → kết quả hiển thị số dư cũ/mới và lý do.

e) Lịch sử kích hoạt

Thẻ Lịch sử kích hoạt luôn hiển thị, cho nhân viên xem lại các lần đã xử lý quà & voucher.

Mẹo vận hành: Khách chỉ cần mở mã QR cá nhân (chứa số điện thoại) cho các thao tác tích điểm/check-in/điều chỉnh; còn trao quà/voucher thì quét mã QR của lượt đổi. Luôn có thể nhập tay SĐT/mã nếu camera lỗi.

Bước tiếp theo

Cấu hình hạng bậc và quy tắc điểm ở Khách hàng, tích điểm & hạng thành viên.

Mẹo & Best Practices

1. Đặt thứ tự ưu tiên quà — Quà ưu tiên cao hiển thị trước trên Mini App
2. Giới hạn mỗi khách — Tránh một khách đổi hết quà
3. Cấu hình điểm check-in hợp lý — Quá thấp không thu hút, quá cao tốn chi phí
4. Kiểm tra lịch sử đổi quà — Đảm bảo xác nhận trao quà kịp thời
5. Phân quyền nhân viên rõ ràng — Chỉ cấp quyền cần thiết cho từng nhân viên

Câu hỏi thường gặp

Q: Khách đổi quà nhưng không đến nhận? A: Lượt đổi sẽ hết hạn sau thời gian quy định. Bạn có thể chủ động liên hệ khách.

Q: Tôi muốn thêm quà mới nhưng hết vị trí ưu tiên? A: Chỉ có 6 vị trí ưu tiên (1-6). Hãy thay đổi vị trí của quà hiện có hoặc đặt "Không ưu tiên".

Q: Nhân viên không thấy quyền đã cấp? A: Quyền cập nhật tức thì trên Mini App. Nếu vẫn không thấy, thử đóng và mở lại Mini App.

Q: Điểm check-in có giới hạn lượt không? A: Có, giới hạn 1 lần/ngày cho mỗi khách.