Thiết lập Kiosk Self-Checkout

Quy trình cho Kỹ thuật triển khai và Cửa hàng trưởng khi đưa một máy bán hàng tự động (Kiosk) vào vận hành — từ tạo quầy Self-Checkout, cài đặt thanh toán, phần cứng đến kết nối thiết bị và nghiệm thu.

Thông tin chung

Trường	Nội dung
Mục đích	Chuẩn hóa trình tự triển khai một máy Kiosk Self-Checkout để khách tự quét hàng, thanh toán điện tử và nhận hóa đơn mà không cần thu ngân; tránh sai sót về Device Code, thanh toán và thiết bị ngoại vi
Đối tượng áp dụng	Kỹ thuật triển khai (cấu hình admin + thiết bị), Cửa hàng trưởng (cấp OTP, nghiệm thu) — khớp vai trò trong Phân quyền
Phạm vi	Máy bán hàng tự động (Kiosk Self-Checkout). Không áp dụng cho quầy POS có thu ngân — xem SOP Thiết lập điểm bán & máy POS
Tần suất	Khi phát sinh — lắp Kiosk mới hoặc thay thiết bị Kiosk

Điều kiện tiên quyết

Cửa hàng và kho trừ tồn đã cấu hình — xem Cửa hàng
Tích hợp thanh toán đã kích hoạt cho phương thức dự kiến dùng (VNPAY QR / VNPAY SmartPOS / SePay) — xem Kết nối VNPAY QR, Kết nối VNPAY SmartPOS
Đã xác định tài khoản nhân viên định danh phiên bán trên máy; người cấp OTP có quyền SELFCHECKOUT_BINDING — xem Tạo quầy Self-Checkout
Thiết bị Kiosk màn hình cảm ứng có Internet ổn định; máy in 80mm, máy đọc RFID, máy quẹt thẻ (tùy nhu cầu) đã sẵn sàng

Sơ đồ quy trình

Các bước thực hiện

Bước 1: Tạo quầy Self-Checkout trên admin

Ai làm: Kỹ thuật triển khai
Thao tác: Vào Cửa hàng > Quầy bán hàng > Thêm mới. Ở phần Thông tin quầy: chọn Cửa hàng (bắt buộc — kho trừ tồn lấy theo kho liên kết của cửa hàng), chọn Loại quầy là Tự thanh toán (Self-checkout) (bắt buộc — không đổi được sau khi tạo), nhập Tên quầy (bắt buộc), Mã quầy và Ghi chú (tùy chọn), đặt Trạng thái là Có hiệu lực. Khi chọn loại quầy này, phần Cài đặt máy tự thanh toán hiện ra với các trường:
- Mã thiết bị (bắt buộc, tối đa 128 ký tự) — định danh máy selfcheckout, phải duy nhất; đây chính là Device Code sẽ nhập trên máy Kiosk
- Cơ chế xác thực (bắt buộc) — chọn Supervisor dùng OTP nhập vào máy self-checkout
- Tài khoản nhân viên định danh phiên bán (bắt buộc) — tài khoản gắn với phiên làm việc trên máy, không nhất thiết là người cụ thể và không phải nhân viên supervisor cấp OTP
- Danh sách IP cho phép (tùy chọn) — nhập IP, cách nhau bằng dấu phẩy hoặc mỗi IP một dòng
Xem Tạo quầy Self-Checkout
Kết quả mong đợi: Quầy Self-Checkout ở trạng thái Có hiệu lực; nút Đăng nhập máy selfcheckout hiển thị với người có quyền

Bước 2: Cài đặt phương thức thanh toán cho Kiosk

Ai làm: Kỹ thuật triển khai
Thao tác: Vào Cửa hàng > Cài đặt POS > tab Máy Kiosk, chọn phương thức thanh toán áp dụng (chỉ hỗ trợ VNPAY QR, VNPAY SmartPOS, SePay), kéo thả sắp thứ tự hiển thị rồi lưu — xem Cài đặt Kiosk trên Admin
Kết quả mong đợi: Danh sách phương thức thanh toán cho Kiosk đã lưu; cài đặt áp dụng chung cho mọi Kiosk trong công ty

Bước 3: Chuẩn bị phần cứng và gán thiết bị vào quầy

Ai làm: Kỹ thuật triển khai
Thao tác: Khai báo máy in hóa đơn, máy đọc RFID, máy quẹt thẻ (Terminal Code) trong Thiết bị bán hàng và gán vào quầy Self-Checkout ở tab Thiết bị; cài QZ Tray trên thiết bị Kiosk nếu in tự động — xem Phần cứng & Thiết bị ngoại vi
Kết quả mong đợi: Quầy Self-Checkout đã gán đủ thiết bị; QZ Tray chạy trên thiết bị Kiosk

Bước 4: Kết nối thiết bị Kiosk (Device Code + OTP)

Ai làm: Kỹ thuật triển khai tại máy; Cửa hàng trưởng (hoặc admin) cấp OTP
Thao tác: Mở ứng dụng Kiosk, nhập Device Code đúng như khai báo (phân biệt hoa/thường); trên admin nhấn Đăng nhập máy selfcheckout để lấy OTP, rồi nhập 6 số hoặc quét mã QR OTP trên Kiosk — xem Kết nối thiết bị Kiosk
Kết quả mong đợi: Kiosk nhận thông tin công ty, cửa hàng, quầy, nhân viên đại diện; dữ liệu sản phẩm bắt đầu đồng bộ và máy vào Manager Mode

Bước 5: Kiểm tra trên Manager Mode

Ai làm: Kỹ thuật triển khai
Thao tác: Trên Manager Mode, kiểm tra bảng trạng thái phần cứng (máy in, RFID, máy quẹt thẻ đều kết nối), vào Cấu hình thiết bị (chi tiết) chọn máy in QZ; nếu dùng chế độ giỏ hàng RFID thì ở tab Máy đọc RFID bật Live Cart (RFID) và đặt Timeout xoá (giây) — mặc định 2 giây, chỉnh được từ 2 đến 60 giây (tag ngừng bắn quá thời gian này sẽ tự xóa khỏi giỏ); nhấn Đồng bộ lại dữ liệu — xem Phần cứng & Thiết bị ngoại vi, Chế độ quản lý (Manager Mode)
Kết quả mong đợi: Mọi thiết bị báo Đã kết nối; phiên bản dữ liệu Product / Product Variant là mới nhất

Bước 6: Mua thử và nghiệm thu

Ai làm: Kỹ thuật triển khai thực hiện, Cửa hàng trưởng nghiệm thu
Thao tác: Nhấn Bắt đầu chế độ bán hàng để vào chế độ khách mua, thực hiện một giao dịch trọn luồng (quét sản phẩm, thanh toán thật giá trị nhỏ, nhận hóa đơn) — xem Luồng mua hàng; kiểm tra đơn xuất hiện trong OMS với Nguồn đơn hàng là Tự thanh toán (Kiosk) — mọi đơn tạo từ Kiosk đều mang nguồn này
Kết quả mong đợi: Giao dịch thử thành công, hóa đơn in tự động; Cửa hàng trưởng xác nhận đưa Kiosk vào vận hành

Xử lý ngoại lệ

Tình huống	Cách xử lý
Kiosk báo "Device Code không hợp lệ" hoặc "Device Code không tồn tại hoặc quầy chưa được kích hoạt"	Đối chiếu Mã thiết bị trên admin (phân biệt hoa/thường, không thừa dấu cách); kiểm tra quầy đã chọn đúng loại Tự thanh toán (Self-checkout)
OTP bị từ chối hoặc hết hạn	Nhấn Lấy mã khác trong modal OTP (hoặc mở lại nút Đăng nhập máy selfcheckout), nhập ngay OTP mới; kiểm tra đồng hồ thiết bị Kiosk đúng múi giờ
Không thấy nút Đăng nhập máy selfcheckout	Kiểm tra quầy đúng loại Tự thanh toán (Self-checkout), trạng thái Có hiệu lực, Cơ chế xác thực đã chọn OTP và đã khai Mã thiết bị; tài khoản phải có quyền SELFCHECKOUT_BINDING
Phương thức thanh toán không hiện trong dropdown tab Máy Kiosk	Tích hợp tương ứng (VNPAY / SePay) chưa kích hoạt trong Company Features — bật tích hợp trước rồi cấu hình lại
Máy in báo Lỗi trên bảng trạng thái phần cứng	Vào Cấu hình thiết bị (chi tiết) > tab Máy in, nhấn Kết nối lại, dùng Tìm máy in chọn đúng tên máy in; kiểm tra QZ Tray đang chạy trên thiết bị
RFID báo Chưa cấu hình / Không có kết nối	Kiểm tra thiết bị RFID đã gán vào quầy Self-Checkout trên admin; nhấn Kết nối lại trong tab Máy đọc RFID, kiểm tra host:port và mạng

Checklist hoàn thành

Quầy Self-Checkout tạo đúng loại Tự thanh toán (Self-checkout), có Mã thiết bị duy nhất và tài khoản nhân viên định danh phiên bán hợp lệ
Tab Máy Kiosk đã lưu đủ phương thức thanh toán cần dùng
Kiosk kết nối thành công bằng OTP, tự đăng nhập lại sau khi tải lại trang
Bảng trạng thái phần cứng trên Manager Mode: máy in, RFID, máy quẹt thẻ đều kết nối; dữ liệu đã đồng bộ
Giao dịch mua thử trọn luồng thành công, đơn trong OMS ghi nhận Nguồn đơn hàng Tự thanh toán (Kiosk); đã bàn giao cách cấp OTP và thoát chế độ bán hàng cho Cửa hàng trưởng

Tài liệu liên quan

SOP liên quan: Vận hành & xử lý sự cố Kiosk, Thiết lập điểm bán & máy POS
Tính năng: Máy bán hàng tự động (KIOSK), Thiết lập Kiosk, Tạo quầy Self-Checkout, Kết nối thiết bị Kiosk, Cài đặt Kiosk trên Admin

Thiết lập Kiosk Self-Checkout

On this page