Xử lý sự cố
Các sự cố thường gặp khi vận hành Kiosk Self-Checkout và cách khắc phục.
Trang này tổng hợp các sự cố thường gặp khi vận hành máy bán hàng tự động (Kiosk) và cách xử lý.
Kết nối & Thiết lập
Lỗi "Mã thiết bị không hợp lệ" khi nhập Device Code
Nguyên nhân: Device Code nhập trên Kiosk không khớp với mã đã khai báo trên admin.
Cách xử lý:
- Kiểm tra lại Device Code trên admin: Cửa hàng > Quầy bán hàng > [quầy Self-Checkout].
- Đảm bảo nhập chính xác (phân biệt hoa/thường, không thừa dấu cách).
- Kiểm tra quầy đã chọn loại "Máy bán hàng tự động".
OTP bị từ chối hoặc hết hạn
Nguyên nhân: OTP có thời hạn ngắn hoặc đã được dùng.
Cách xử lý:
- Trên admin, nhấn lại nút Đăng nhập máy selfcheckout để cấp OTP mới (hoặc nhấn Cấp mã mới trong modal nếu đang mở).
- Nhập OTP mới trên Kiosk ngay sau khi cấp, hoặc quét mã QR từ modal admin.
- Kiểm tra đồng hồ hệ thống của thiết bị Kiosk đúng múi giờ.
Kiosk bị mất kết nối sau khi restart
Nguyên nhân: Thông tin xác thực có thể hết hạn.
Cách xử lý:
- Tải lại trang Kiosk.
- Nếu vẫn lỗi, cấp OTP mới từ admin và kết nối lại.
- Device Code được giữ lại — chỉ cần nhập OTP.
Quét sản phẩm
RFID không nhận diện sản phẩm
Nguyên nhân có thể:
- Máy đọc RFID chưa kết nối.
- Thẻ RFID trên sản phẩm bị hỏng hoặc không được ghi SKU.
- Sản phẩm chưa đồng bộ xuống thiết bị.
Cách xử lý:
- Kiểm tra trạng thái RFID trên Manager Mode → tab "Máy đọc RFID".
- Nhấn "Kết nối lại" nếu hiển thị "Không có kết nối".
- Thử quét sản phẩm khác để xác định do thẻ hay do máy.
- Đồng bộ dữ liệu để cập nhật danh sách sản phẩm mới nhất.
Quét barcode không tìm thấy sản phẩm
Nguyên nhân: SKU trên barcode không khớp với SKU trong hệ thống.
Cách xử lý:
- Kiểm tra SKU sản phẩm trên admin (PIM).
- Đồng bộ dữ liệu trên Manager Mode.
- Đảm bảo barcode/SKU đúng và sản phẩm đang ở trạng thái hoạt động.
Sản phẩm mới không hiển thị trên Kiosk
Nguyên nhân: Dữ liệu chưa được đồng bộ xuống thiết bị.
Cách xử lý:
- Vào Manager Mode.
- Nhấn Đồng bộ dữ liệu.
- Kiểm tra phiên bản dữ liệu: Product và Product Variant phải cập nhật.
Thanh toán
Mã QR VNPAY không hiển thị
Nguyên nhân có thể:
- Tích hợp VNPAY chưa được kích hoạt.
- Lỗi kết nối cổng thanh toán.
Cách xử lý:
- Kiểm tra tính năng tích hợp VNPAY đã bật trên admin.
- Kiểm tra cấu hình VNPAY trong Cài đặt > Website > tab Thanh toán.
- Kiểm tra kết nối internet của thiết bị.
Hết thời gian chờ thanh toán (5 phút)
Nguyên nhân: Khách chưa hoàn tất thanh toán trong 5 phút.
Cách xử lý:
- Đơn hàng tự động bị hủy.
- Khách cần bắt đầu lại từ đầu (quét sản phẩm lại).
- Nếu tiền đã bị trừ nhưng Kiosk báo lỗi, kiểm tra trạng thái đơn trên admin (OMS) và xác nhận thanh toán thủ công.
Đổi phương thức thanh toán không thành công
Nguyên nhân: Lỗi kết nối khi cập nhật đơn hàng.
Cách xử lý:
- Kiểm tra kết nối internet.
- Thử lại sau vài giây.
- Nếu vẫn lỗi, nhấn "Quay về giỏ hàng" để hủy đơn và bắt đầu lại.
In hóa đơn
Không in được hóa đơn
Nguyên nhân có thể:
- QZ Tray chưa cài đặt hoặc không chạy.
- Tên máy in QZ không đúng.
- Máy in hết giấy hoặc lỗi phần cứng.
Cách xử lý:
- Vào Manager Mode → Cấu hình → tab Máy in.
- Kiểm tra trạng thái QZ: phải hiển thị "Đã kết nối".
- Nếu "Lỗi" → nhấn "Kết nối lại".
- Nhấn "Tìm máy in" để kiểm tra tên máy in.
- Nếu QZ Tray không chạy → khởi động ứng dụng QZ Tray trên máy tính.
- Bật Tự động fallback để khi QZ lỗi, hệ thống dùng chế độ in trình duyệt.
Hóa đơn in ra bị cắt hoặc sai định dạng
Cách xử lý:
- Kiểm tra khổ giấy máy in (phải là 80mm).
- Kiểm tra driver máy in trên hệ điều hành.
- Thử in test page từ QZ Tray.
Chế độ hoạt động
Không thể thoát Buyer Mode
Cách xử lý:
- Nhấn vào đồng hồ (góc phải trên header) 4 lần liên tiếp trong 2 giây.
- Nhập OTP từ admin.
- Lưu ý: trên màn hình WELCOME (chào mừng), header bị ẩn → cần nhấn vào màn hình trước để chuyển sang GUIDE hoặc IDLE, khi đó header mới hiển thị.
Kiosk tự động quay về màn hình chào mừng
Nguyên nhân: Idle timeout 2 phút — không có thao tác nào.
Đây là hành vi bình thường: đảm bảo Kiosk luôn sẵn sàng cho khách tiếp theo. Timeout chỉ áp dụng ở bước nhập SĐT, giỏ hàng, mã giảm giá, chọn thanh toán — không áp dụng khi đang chờ quét sản phẩm hoặc xử lý thanh toán.
Kiosk hiển thị "Giỏ hàng trống" sau khi đặt sản phẩm lên khay
Nguyên nhân có thể:
- RFID chưa kết nối.
- Chế độ Live Cart bật nhưng timeout quá ngắn.
- Thẻ RFID không hợp lệ.
Cách xử lý:
- Kiểm tra RFID trên Manager Mode.
- Nếu dùng Live Cart, tăng timeout lên (ví dụ 15–30 giây).
- Thử quét bằng barcode để xác minh sản phẩm có trong hệ thống.
Liên hệ hỗ trợ
Nếu không tìm thấy giải pháp ở trên:
- Ghi nhận thông tin: Device Code, mã lỗi, thời gian xảy ra.
- Chụp ảnh màn hình lỗi (nếu có).
- Liên hệ đội hỗ trợ kỹ thuật kèm thông tin trên.