Kết nối thiết bị Kiosk
Hướng dẫn kết nối thiết bị Kiosk lần đầu — nhập Device Code, nhận OTP từ admin và hoàn tất binding.
Sau khi tạo quầy Self-Checkout trên admin, bạn cần kết nối thiết bị Kiosk vật lý với hệ thống. Quá trình này gồm 2 bước: nhập mã thiết bị và xác thực OTP.
Bước 1 — Nhập mã thiết bị (Device Code)
Khi mở ứng dụng Kiosk lần đầu (hoặc sau khi reset), màn hình Cấu hình thiết bị sẽ hiển thị:
- Nhập Device Code — chính là mã thiết bị đã khai báo khi tạo quầy Self-Checkout trên admin (ví dụ:
KIOSK-001). - Nhấn Lưu.
- Hệ thống xác minh mã thiết bị trên server:
- Nếu hợp lệ → chuyển sang bước nhập OTP.
- Nếu không tồn tại → hiển thị lỗi, kiểm tra lại mã trên admin.
Device Code phải khớp chính xác (phân biệt hoa/thường) với giá trị đã khai báo trên admin trong quầy Self-Checkout.
Bước 2 — Nhập OTP
Sau khi Device Code được xác minh, Kiosk hiển thị màn hình Nhập OTP:
- Trên admin, nhấn nút Đăng nhập máy selfcheckout để mở modal cấp OTP. Nút này có ở 2 nơi:
- Cửa hàng > Cửa hàng (danh sách cửa hàng) → cột Quầy → bên cạnh tên quầy Self-Checkout.
- Cửa hàng > Quầy bán hàng → bên dưới tên quầy Self-Checkout.
- Modal hiển thị mã QR và mã OTP kèm đồng hồ đếm ngược.
- Trên Kiosk, nhập OTP bằng 1 trong 2 cách:
- Quét mã QR: dùng máy quét barcode kết nối với Kiosk để quét mã QR từ modal admin.
- Nhập thủ công: gõ 6 chữ số OTP vào ô nhập trên Kiosk.
- Nhấn Xác nhận.
- Nếu OTP đúng:
- Kiosk nhận thông tin công ty, cửa hàng, quầy và nhân viên đại diện.
- Dữ liệu sản phẩm bắt đầu đồng bộ xuống thiết bị.
- Chuyển sang Manager Mode (bảng điều khiển quản lý).
Xử lý lỗi OTP
| Lỗi | Nguyên nhân | Cách xử lý |
|---|---|---|
| OTP không đúng | Nhập sai hoặc hết hạn | Cấp OTP mới từ admin, nhập lại |
| Lỗi kết nối | Mất internet hoặc server | Kiểm tra kết nối mạng, thử lại |
| Mã thiết bị không hợp lệ | Device Code sai | Nhấn "Đổi thiết bị" để nhập lại Device Code |
Thay đổi thiết bị
Trên màn hình nhập OTP, có 2 nút hỗ trợ:
- Nhập lại: xóa OTP đã nhập, nhập lại OTP mới.
- Đổi thiết bị: quay về màn hình nhập Device Code để thay đổi thiết bị.
Sau khi kết nối thành công
Thiết bị Kiosk sẽ vào Manager Mode — bảng điều khiển cho quản lý:
- Hiển thị thông tin: tên công ty, cửa hàng, quầy, mã thiết bị.
- Trạng thái phần cứng: máy in, RFID, máy quẹt thẻ.
- Phiên bản dữ liệu: Product, Product Variant.
- Các nút thao tác: Bắt đầu bán hàng, Cấu hình, Đồng bộ dữ liệu, Tải lại trang, Đăng xuất.
Sau khi kết nối thành công, thông tin thiết bị (Device Code, tài khoản) được lưu trên thiết bị. Khi tải lại trang hoặc khởi động lại, Kiosk sẽ tự động đăng nhập lại mà không cần nhập OTP.