QR Tiger Device Hub - In bếp / bar
Cập nhật 2026-07-15: QR Tiger Device Hub là ứng dụng local merchant-facing duy nhất cho cài đặt mới. Module Kitchen / Bar Print thay thế nhu cầu cài riêng Kitchen Print Agent, giữ sổ theo dõi chống phát lại thông thường, máy in đã cài, RAW LAN và máy in mô phỏng. In phần cứng không được cam kết exactly-once trong khoảng lỗi giữa lúc máy in nhận dữ liệu và lúc trạng thái được lưu.
Kitchen Print Agent độc lập đã ngừng hỗ trợ, không còn đường tạo bộ cài và không phải phương án dự phòng. Các lệnh cũ start:kitchen-print-agent và package:kitchen-print-agent chỉ chuyển hướng sang QR Tiger Device Hub.
Khi nào dùng
Dùng khi cửa hàng cần in phiếu bếp/bar từ máy tính cục bộ bằng QR Tiger Device Hub.
Điều kiện cần
- Đăng nhập lần đầu bằng tên đăng nhập root/chủ cửa hàng QR Tiger đang hoạt động; tài khoản nhân viên/khách hàng không dùng để gắn Device Hub.
- Tenant phải còn quyền sử dụng gói hợp lệ. Khi gói hết hạn, nhận lệnh, in thử và thử lại lệnh lỗi sẽ bị khóa cho đến khi quyền được khôi phục và kiểm tra lại.
- Chọn đúng cửa hàng, chi nhánh và khu vực bếp/bar.
- Máy in hoặc kênh in cần sẵn sàng trên máy đang chạy Device Hub.
Cấu hình máy in
- Mở ứng dụng QR Tiger Device Hub.
- Đăng nhập bằng tài khoản ch ủ cửa hàng trong lần thiết lập đầu tiên.
- Chọn hồ sơ Máy in bếp / bar hoặc bật module Kitchen / Bar Print.
- Chọn chi nhánh cần in.
- Gắn máy in với từng khu vực bếp/bar.
- Lưu cấu hình.
- Tạo đơn hoặc gửi món vào bếp để kiểm tra job in.
Loại máy in hỗ trợ
| Loại | Ghi chú |
|---|---|
| Máy in đã cài trong hệ điều hành | Dùng tên máy in có sẵn trên máy |
| RAW LAN | Dùng cho máy in mạng nội bộ hỗ trợ in trực tiếp; P0 chuyển chữ tiếng Việt sang ASCII |
| IPP/AirPrint | Sắp hỗ trợ, không dùng như đường in thật trong P0 |
| Simulated printer | Ghi file kiểm tra tại máy cục bộ, không gửi ra phần cứng |
Máy in Windows đã cài là đường in có khả năng giữ Unicode tiếng Việt. Cần kiểm tra cả đường Windows Unicode và đường RAW/TCP ASCII trên đúng phần cứng trước khi dùng tại cửa hàng.
Xử lý lỗi thường gặp
- Không thấy lệnh in: kiểm tra đơn đã vào đúng bếp/bar và Device Hub đang chạy.
- Sai chi nhánh hoặc khu vực bếp: mở lại cấu hình và chọn đúng chi nhánh/khu vực.
- Máy in offline: kiểm tra nguồn, mạng nội bộ và trạng thái máy in trên hệ điều hành.
- Device Hub chưa gắn cửa hàng: đăng nhập lại bằng chủ cửa hàng và lưu cấu hình.
- Simulated printer không tạo file: kiểm tra thư mục ghi file của ứng dụng và quyền ghi trên máy.
- Chỉ dùng Thử lại cho lệnh đang ở trạng thái lỗi, thuộc đúng tenant và chi nhánh đã cấu hình. Không thử lại lệnh đã in, đã hủy, khác thiết bị hoặc khác chi nhánh.
Sổ in cục bộ giúp chặn phát lại sau khi bản ghi đã được lưu. Tuy nhiên, nếu ứng dụng hoặc máy tính dừng sau khi máy in thật đã nhận dữ liệu nhưng trước khi sổ cục bộ/trạng thái cloud được lưu, quá trình khôi phục vẫn có thể in trùng. Phải kiểm tra tình huống này trong pilot phần cứng.
Nếu không thấy nút/tính năng
Kiểm tra quyền Bếp, quyền cấu hình liên quan, chi nhánh đang chọn và máy đang chạy QR Tiger Device Hub. Xem thêm Không thấy nút hoặc tính năng.
Màn hình liên quan
- QR Tiger Device Hub
- Bếp
- Đơn hàng
Khi nào nên gửi nhân viên hỗ trợ
Gửi hỗ trợ khi Device Hub đã chạy, cấu hình đúng chi nhánh/khu vực nhưng lệnh in vẫn không xuất hiện hoặc in ra sai máy.