FAQ — Máy in & thiết bị

import { Aside } from ‘@astrojs/starlight/components’;

Phiên bản tiếng Anh

FAQ — print & hardware (English)

Mục lục

• Bill không in
• Bill in sai / in lệch
• Terminal không phản hồi
• Thanh toán thẻ kẹt ở “chờ”
• Bố cục tem sai
• Ngăn kéo tiền không mở
• Bridge mất kết nối
• Vẫn bị kẹt?

Bill không in

Sau khi thanh toán thành công, **không có bill** nào được in ra (và cũng không có hộp thoại xem trước).

Cách xử lý (5 bước):

1. Kiểm tra chế độ in bill trong cài đặt cửa hàng — phải là “Tự động” hoặc “Hỏi” (không phải “Tắt”). Chủ cấu hình trong Cài đặt cửa hàng → In bill.
2. Xác nhận máy in đã bật — vào Cài đặt → Máy in bill, đảm bảo thiết bị đang Bật và là máy in mặc định.
3. In thử từ cùng trang cài đặt — nếu in thử OK mà bill vẫn không ra, vấn đề ở flow thanh toán.
4. Khởi động lại Vendor Desktop sau khi đổi driver máy in trên hệ điều hành (Windows: thay driver; macOS: thay máy in mặc định).
5. Dùng “Xem trước bill” trên màn đơn để chắc chắn dữ liệu tải được.

Xem: Cài đặt máy in bill.

Bill in sai / in lệch

Bill in ra nhưng **nội dung lệch**, **font bị cắt**, **logo mờ** hoặc **mất dòng**.

Cách xử lý:

• Font quá nhỏ / quá to: chỉnh cỡ chữ trong Cài đặt → Máy in bill → Mẫu in.
• Logo cửa hàng bị mờ: upload lại logo PNG ≥ 300dpi trong Cài đặt cửa hàng → Thương hiệu.
• Mất dòng cuối: kiểm tra chiều rộng giấy (mặc định 80mm) khớp với cuộn giấy thực tế.
• Mã vạch không quét được: đảm bảo dùng Code128 (không phải EAN-13).

Terminal không phản hồi

Panel thanh toán hiển thị terminal nhưng khi bấm **"Thẻ"** thì **không có phản hồi** từ thiết bị.

Cách xử lý (4 bước):

1. Kiểm tra nguồn & mạng của terminal — đèn nguồn sáng, cáp LAN/USB cắm chắc, hoặc WiFi/4G có tín hiệu.
2. Xác nhận Vendor Desktop đang chạy trên PC quầy — bridge cần app chạy nền. Nếu app bị đóng, mở lại.
3. Kiểm tra bridge vào Cài đặt → Bridge (chỉ desktop) — trạng thái phải là “Đã kết nối”.
4. Nếu vẫn không phản hồi, chủ xem Dashboard → Terminals → Bridge activity để check log.

Xem: Cấu hình terminal.

Thanh toán thẻ kẹt ở “chờ”

Spinner xoay mãi với dòng "Đang chờ phản hồi từ terminal…"

Cách xử lý: xem FAQ — bán & thanh toán → Thanh toán kẹt ở trạng thái chờ.

Bố cục tem sai

Tem mã vạch in ra **quá nhỏ**, **bị cắt cạnh**, hoặc **nội dung tràn ra ngoài**.

Cách xử lý:

1. Vào Cài đặt → Máy in tem.
2. Chỉnh chiều rộng giấy tem (thường 40mm hoặc 50mm).
3. Chỉnh số cột trên 1 hàng (mặc định 2 cột).
4. In thử 1 tem trước khi in cả lô.

Xem: Tem mã vạch & kệ.

Ngăn kéo tiền không mở

Sau khi thanh toán tiền mặt, **ngăn kéo không bật ra**.

Cách xử lý:

1. Kiểm tra cáp kết nối ngăn kéo với máy in bill (chuẩn RJ12).
2. Vào Cài đặt → Ngăn kéo tiền → bật “Mở khi thanh toán tiền mặt”.
3. Test thủ công từ cùng trang cài đặt — nếu test OK mà vẫn không mở khi bán, kiểm tra flow bán đã chọn đúng phương thức tiền mặt.

Xem: Máy in tem, cân & ngăn kéo.

Bridge mất kết nối

Icon bridge trên top bar đỏ hoặc báo "Mất kết nối"; terminal & máy in ngừng phản hồi.

Cách xử lý (3 bước):

1. Refresh bridge — vào Cài đặt → Bridge → click “Kết nối lại”.
2. Kiểm tra mạng PC quầy — ping server hoặc mở trang web bất kỳ.
3. Khởi động lại Vendor Desktop nếu vẫn không lên — đây là biện pháp cuối, cần đóng ca trước.

Bridge là **WebSocket chạy nền trên Vendor Desktop** — trung gian giữa API LionPOS và các thiết bị phần cứng (terminal, máy in). Nếu bridge tắt, mọi giao tiếp với thiết bị đều ngưng.

Vẫn bị kẹt?

- Screenshot **banner lỗi** trên app. - **Tên thiết bị** (máy in / terminal) — thường thấy trong cài đặt. - **Model & firmware** (nhãn dán trên thiết bị). - **Thời gian** lỗi + **ca làm việc** đang chạy.

Gửi chủ cửa hàng hoặc support@lionpos.com. Sự cố thiết bị phần cứng cần thông tin model để chẩn đoán.

Xem thêm

• Cài đặt máy in bill
• Cấu hình terminal
• Tem mã vạch & kệ
• Máy in tem, cân & ngăn kéo
• POS terminals (PAX) — kỹ thuật
• CodePay — kỹ thuật