Khắc phục sự cố

Trang này giúp bạn xử lý nhanh các vấn đề hay gặp khi quét vé tại cửa. Mỗi mục theo cấu trúc vấn đề → giải pháp. Nếu bạn cần xem chi tiết một trạng thái quét cụ thể, hãy mở Bảng trạng thái quét.

Các vấn đề thường gặp

1. Màn hình báo “hết phiên đăng nhập” / bị đá ra

Phiên đăng nhập của bạn đã hết hạn hoặc bị hủy, thường do đăng nhập từ thiết bị khác hoặc do tài khoản bị cấp lại quyền.

Thoát khỏi màn hình lỗi

Bấm “Đăng nhập lại” hoặc tải lại trang quét.
Đăng nhập lại

Dùng tài khoản hoặc mã đăng nhập bằng mã QR như hướng dẫn trong Đăng nhập máy quét.
Chọn lại sự kiện và cửa

Sau khi đăng nhập, chọn lại sự kiện và cửa bạn đang phụ trách. Các lượt quét đang chờ vẫn an toàn trong thiết bị và sẽ đồng bộ khi có mạng.

2. Mất mạng / màn hình báo lỗi mạng

Khi mạng đứt, hệ thống tự động lưu tạm các lượt quét thành công và hiển thị thông báo “đang chờ đồng bộ” (màu hổ phách). Chỉ khi thử lại mà vẫn lỗi mới báo lỗi mạng (màu đỏ).

Màn hình màu hổ phách (đang chờ đồng bộ)
Màn hình màu đỏ (lỗi mạng)

Máy quét đang ngoại tuyến, lượt check-in đã được lưu tạm an toàn.
Tiếp tục quét như bình thường — không cần đổi gì.
Trấn an khách: “Vé đã quét xong, đang đợi đồng bộ.”
Khi có mạng lại, hệ thống tự đồng bộ theo đúng thứ tự thời gian.

3. Không đăng nhập được vào máy quét

Triệu chứng	Nguyên nhân	Cách xử lý
Sai tên đăng nhập / mật khẩu	Gõ sai hoặc nhớ nhầm	Nhờ ban tổ chức cấp lại mật khẩu.
Tài khoản không có quyền quét	Chưa được gán quyền nhân viên cửa	Liên hệ ban tổ chức cấp quyền truy cập sự kiện/cửa.
Mã đăng nhập QR không quét được	Mã hết hạn hoặc đã dùng ở thiết bị khác	Yêu cầu ban tổ chức cấp mã mới.
Chưa thấy sự kiện cần quét	Sự kiện chưa được gán cho bạn	Nhờ ban tổ chức gán sự kiện + cửa cho tài khoản của bạn.

4. Khách bảo “tôi mới quét mà” nhưng cần vào lại

Đây là trường hợp phân biệt giữa sự kiện có bật check-out và sự kiện chỉ vào một lần.

Sự kiện CÓ bật check-out
Sự kiện KHÔNG bật check-out (vào một lần)

Quét lại một khách đang ở trong sẽ tự động check-out khách đó (màn hình xanh dương).
Lần quét kế tiếp sẽ check-in lại — khách ra vào nhiều lần được.
Bạn không cần làm gì thêm, chỉ cần báo khách đã được xử lý.

5. Cửa báo hết chỗ

Cửa đã đạt sức chứa tối đa theo cấu hình.

Hướng dẫn khách sang một cửa khác còn chỗ.
Hoặc chờ có khách check-out để giải phóng chỗ.
Nếu bạn nghĩ đây là lỗi cấu hình, liên hệ ban tổ chức để kiểm tra lại sức chứa cửa.

6. Màn hình báo khung giờ đóng / chưa mở

Thời điểm hiện tại đã sau giờ kết thúc check-in.
Nhờ ban tổ chức kéo dài khung giờ (giờ kết thúc check-in) trong trang quản trị.
Khi khung giờ được mở rộng, quét lại sẽ thành công.

7. Camera không hoạt động / không được cấp quyền

Máy quét không mở được camera, thường gặp nhất trên iPhone dùng trình duyệt Safari. Có ba tình huống riêng, mỗi cách xử lý khác nhau.

Trình duyệt vừa hiện hỏi “Cho phép dùng camera?” và bạn chưa bấm Đồng ý.
Bấm Bật camera trên màn hình để xin quyền lại.
Nếu hộp hỏi không hiện nữa, xem tình huống “Từ chối vĩnh viễn” bên dưới.

Camera chỉ chạy trên đường dẫn bảo mật (có ổ khóa ở thanh địa chỉ). Nếu bạn mở trang qua địa chỉ thường, không bảo mật, camera sẽ không khởi động được.
Đảm bảo bạn mở đúng trang máy quét tại portal.qrs.com.vn.

8. Dùng máy quét mã vạch rời (USB/Bluetooth)

Máy quét mã vạch rời — dạng súng quét cắm USB hoặc nối Bluetooth — hoạt động giống như một bàn phím: quét mã, nó tự điền chuỗi ký tự và tự gửi. Bạn không cần cài đặt thêm gì, cũng không cần bật camera.

Cắm hoặc nối thiết bị

USB: cắm vào cổng USB của máy tính/tablet. Bluetooth: ghép nối theo hướng dẫn máy quét.
Đặt con trỏ vào ô nhập mã vé

Trên màn hình máy quét, mở ô nhập mã vé bằng tay rồi nhấp vào ô nhập để con trỏ hiện ra.
Quét vé

Hướng máy quét vào mã vé. Chuỗi mã sẽ tự điền vào ô và tự gửi — kết quả hiển thị như quét bằng camera.

9. “Tôi vừa bị đăng xuất / bị đá ra khỏi phiên”

Có hai loại thông báo khác nhau, cả hai đều đưa bạn về màn hình đăng nhập:

Màn hình 'Phiên bị chiếm quyền' (màu cam)
Màn hình 'Phiên làm việc đã hết hạn' (màu đỏ)

Một thiết bị khác đã đăng nhập cùng tài khoản của bạn và chiếm phiên máy quét này.
Hành vi này là đúng theo thiết kế: mỗi tài khoản chỉ giữ một phiên máy quét active tại một thời điểm, để tránh hai người quét trùng lược trên cùng tài khoản.
Đăng nhập lại để lấy lại phiên, hoặc quét lại mã đăng nhập QR do ban tổ chức cấp.
Lượt quét đang chờ trên thiết bị vẫn an toàn và sẽ đồng bộ khi có mạng.

Các lỗi ít gặp khác

Trạng thái	Màu	Xử lý nhanh
Mã QR không hợp lệ	🔴 Đỏ	QR không có trong hệ thống. Dùng tra cứu thủ công (nút “No Ticket”) nếu khách có tài khoản.
Vé không hợp lệ	🔴 Đỏ	Vé hết hạn hoặc bị thu hồi. Hướng khách tới ban tổ chức.
Sai sự kiện	🔴 Đỏ	Vé thuộc sự kiện khác. Hướng khách tới đúng sự kiện.
Sai hạng vé cho cửa này	🔴 Đỏ	Hạng vé không được vào cửa này. Hướng khách tới cửa được phép.
Cửa đã tắt / Sự kiện đã tắt	🟠 Cam	Cửa hoặc sự kiện bị tắt. Liên hệ ban tổ chức.

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

Quét xong nhưng trên trang quản trị không thấy lượt check-in? Nếu máy quét đang ngoại tuyến, lượt nằm trong hàng đợi tạm. Khi mạng phục hồi và số lượt đang chờ về 0, lượt sẽ xuất hiện trên trang quản trị. Kiểm tra hai chỉ báo Online / Pending ở đầu máy quét.

Mất điện thì lượt đang chờ có mất không? Không. Lượt được lưu trên thiết bị, không phải bộ nhớ tạm. Mở lại ứng dụng (cùng thiết bị, cùng hồ sơ) là dữ liệu vẫn còn.

Khách quét được vé nhưng tên hiển thị sai? Tên/sự kiện/hạng vé lấy từ hồ sơ vé điện tử. Liên hệ ban tổ chức sửa thông tin khách trong trang quản trị — bạn không sửa được tại máy quét.

Có cần bấm “Đồng bộ” thủ công khi có mạng lại không? Không. Đồng bộ hoàn toàn tự động. Bạn chỉ cần tiếp tục công việc ở cửa.

Khách mất điện thoại, không có vé QR? Dùng nút “No Ticket” trên máy quét để tìm khách theo tên/email và check-in thủ công (cần vé đang hoạt động). Xem hướng dẫn tại Trường hợp đặc biệt.

Tìm hiểu thêm

Tham chiếu đầy đủ 15 trạng thái kèm màu và hành động.

Các tình huống hiếm gặp và cách xử lý chi tiết.

Chi tiết về hàng đợi offline và đồng bộ tự động.

Tra cứu thủ công, quét trùng và các tình huống tại cửa.

Trở về trang hướng dẫn tổng quan.