Luồng mua hàng

Khi Kiosk ở chế độ bán hàng (Buyer Mode), khách hàng trải qua luồng mua hàng gồm 7 bước. Thanh tiến trình (progress bar) ở đầu mỗi màn hình hiển thị bước hiện tại.

Sơ đồ luồng mua hàng

Bước 1        Bước 2           Bước 3–4          Bước 5         Bước 6         Bước 7
WELCOME → TÀI KHOẢN → QUÉT HÀNG / GIỎ HÀNG → MÃ GIẢM GIÁ → THANH TOÁN → HOÀN THÀNH
                                                                                  │
                                                      (auto-reset) ←──────────────┘

Bước 1 — Chào mừng (Welcome)

Khi không có khách hàng sử dụng, Kiosk hiển thị màn hình chào mừng toàn màn hình:

• Lời chào: "Xin chào!" + "Sẵn sàng tự thanh toán nhanh chóng chỉ trong vài bước đơn giản".
• Nút BẮT ĐẦU: nút chính (xanh navy, nhấp nháy) — nhấn để bắt đầu giao dịch.
• 4 biểu tượng bước ở dưới nút BẮT ĐẦU (giới thiệu quy trình):
  1. Tài khoản — Bước 1
  2. Quét hàng — Bước 2
  3. Nhập Voucher — Bước 3
  4. Thanh toán — Bước 4

Thanh nhanh phía dưới

• Nút Tài khoản (icon 👤): chuyển thẳng đến bước nhập tài khoản thành viên.
• Nút LANGUAGE: chọn ngôn ngữ hiển thị (Tiếng Việt / English).

Khách hàng nhấn BẮT ĐẦU hoặc chạm vào bất kỳ nút nào → chuyển sang bước tiếp theo.

Bước 2 — Thông tin tài khoản (Thành viên)

Kiosk hỏi khách hàng có phải thành viên không:

Màn hình chọn

Hiển thị 2 lựa chọn:

Quét mã thành viên

Sau khi chọn "Có tài khoản", màn hình Quét mã thành viên hiển thị:

• Quét mã QR Zalo Miniapp: đưa mã QR từ Zalo Miniapp vào máy đọc.
• HOẶC nhập số điện thoại thủ công: nhấn vào ô NHẬP SỐ ĐIỆN THOẠI → bàn phím số hiển thị.

Hệ thống tự động chuyển đổi định dạng số điện thoại:

• tel:+84xxxxxxxxx → 0xxxxxxxxx
• 84xxxxxxxxx → 0xxxxxxxxx

Nút hỗ trợ

• Bắt đầu lại: quay về màn hình chào mừng.
• Bỏ qua: bỏ qua tích điểm, chuyển đến quét hàng.

Bước 3–4 — Quét hàng & Giỏ hàng

Sau khi kiểm tra thành viên (hoặc bỏ qua), Kiosk chuyển sang chế độ quét sản phẩm.

Màn hình quét sản phẩm

Màn hình chia thành 2 tab:

Cách thêm sản phẩm

• RFID: đặt sản phẩm có gắn thẻ RFID lên khay quét → tự động nhận diện và thêm vào giỏ.
• Barcode: quét mã vạch sản phẩm bằng máy quét → thêm vào giỏ.
• Nhập thủ công: mở modal quét barcode để nhập SKU bằng bàn phím ảo.

Giỏ hàng

Phía dưới danh sách sản phẩm hiển thị:

• Số lượng sản phẩm trong giỏ
• Tổng cộng (VNĐ)

Thao tác

Nhấn nút Thanh toán (hoặc chuyển sang bước tiếp theo) khi đã quét đủ sản phẩm.

Bước 5 — Mã giảm giá (Voucher)

Kiosk cho phép nhập hoặc quét mã giảm giá trước khi thanh toán:

Quét mã giảm giá

• Quét mã vạch: đưa mã giảm giá vào máy đọc barcode — hệ thống tự động áp dụng.
• HOẶC nhập thủ công: nhấn vào ô NHẬP MÃ GIẢM GIÁ → gõ mã bằng bàn phím ảo.

Nút thao tác

Kết quả

• Hợp lệ ✅: hiển thị số tiền giảm giá, cập nhật tổng tiền mới.
• Không hợp lệ ❌: hiển thị thông báo lỗi, cho phép nhập mã khác hoặc bỏ qua.

Bước 6 — Thanh toán (Check Out)

Chọn phương thức thanh toán

Hiển thị tóm tắt đơn hàng:

Hai phương thức thanh toán hiển thị dạng thẻ lớn:

Xử lý thanh toán — Mã QR

• Hiển thị mã QR lớn trên màn hình kèm hình minh họa quét.
• Số tiền thanh toán: hiển thị rõ ràng phía trên.
• Đồng hồ đếm ngược: "Thời gian để thanh toán còn X:XX" (5 phút).

Xử lý thanh toán — Thẻ

• Hướng dẫn: "Đưa thẻ VISA / MASTERCARD vào máy hoặc chạm để thanh toán".
• Hình minh họa thiết bị SmartPOS.
• Đồng hồ đếm ngược: "Thời gian để thanh toán còn X:XX" (5 phút).

Nút thao tác

Kiểm tra trạng thái

Hệ thống tự động kiểm tra trạng thái thanh toán mỗi 3 giây:

• Kiểm tra từ cổng thanh toán (payment attempt).
• Kiểm tra trực tiếp trạng thái đơn hàng (admin có thể xác nhận thủ công).
• Khi phát hiện COMPLETED → chuyển sang bước hoàn thành.

Bước 7 — Hoàn thành (Success)

Hiển thị kết quả:

• Tiêu đề: "Thanh toán thành công!" (chữ lớn, xanh navy).
• Lời cảm ơn: "Trong cuộc sống có quá nhiều lựa chọn, cảm ơn bạn đã lựa chọn [tên cửa hàng] 💙".

Xuất hóa đơn VAT

• Hiển thị thông báo: "Xuất hóa đơn VAT — Bạn có thể thực hiện sau trong vòng 2 tiếng bằng cách quét QR code trên hóa đơn được in ra".

In hóa đơn

• Hệ thống tự động in hóa đơn qua QZ Tray (nếu đã cấu hình).
• Hiển thị trạng thái: "Đã in hóa đơn thành công. Vui lòng lấy hóa đơn tại máy in." hoặc thông báo lỗi nếu không in được.

Nút thao tác

Kiosk cũng tự động quay về màn hình chào mừng sau vài giây nếu khách không thao tác gì.

Bước phụ — Màn hình lỗi (ERROR)

Khi có lỗi xảy ra (hết thời gian thanh toán, lỗi kết nối cổng thanh toán...), Kiosk hiển thị:

• Thông báo lỗi cụ thể.
• Sau một khoảng thời gian, tự động quay về màn hình chào mừng.

Timeout tự động

Để tránh trường hợp khách bỏ đi giữa chừng, Kiosk có 3 cơ chế timeout:

• Idle timeout không áp dụng trong các trạng thái: WELCOME, IDLE, PAYMENT_PROCESSING, SUCCESS, ERROR.
• Mọi thao tác chạm màn hình đều reset bộ đếm idle timeout.
• Payment timeout hoạt động độc lập — có đồng hồ đếm ngược riêng hiển thị trên màn hình.