Bắt đầu sử dụng
Cài đặt máy in

Cài đặt máy in

XCaphe kết nối máy in nhiệt qua Bridge Device — một ứng dụng nhẹ chạy trên máy tính Windows tại quán. Bridge Device đóng vai trò trung gian giữa server XCaphe và máy in vật lý (kết nối LAN hoặc USB).

Tổng quan kiến trúc

Server XCaphe ──► Bridge Device (Windows PC) ──► Máy in nhiệt
                        ↕ (WebSocket)
                   Dashboard XCaphe
  • Bridge Device: Máy tính Windows thường trực tại quán (có thể là máy tính thu ngân)
  • Máy in nhiệt: Kết nối qua LAN (khuyến nghị) hoặc USB
  • Dashboard: Nơi cấu hình tất cả — không cần cài thêm phần mềm ngoài Bridge

Bước 1 — Cài Bridge Device

Tải Bridge App

Vào Dashboard → Cài đặt → Máy in → nhấn Thêm Bridge Device → tải file cài đặt Bridge App cho Windows.

Cài đặt và chạy

Cài như ứng dụng Windows thông thường. Sau khi chạy, Bridge App hiển thị mã kết nối (6 ký tự).

Kết nối với XCaphe

Quay lại Dashboard → nhập mã kết nối → chọn chi nhánh → nhấn Xác nhận.

Bridge Device xuất hiện trong danh sách với trạng thái 🟢 Online.

Bridge Device cần chạy liên tục trong giờ vận hành. Nên bật cùng Windows startup để không quên.

Bước 2 — Thêm máy in

Mở catalog máy in

Trong Dashboard → Cài đặt → Máy in → nhấn + Thêm máy in.

Catalog hiển thị danh sách máy in phổ biến kèm hướng dẫn kết nối chi tiết theo từng model.

Chọn model và phương thức kết nối

Chọn máy in từ catalog → chọn kết nối:

Kết nối LAN qua mạng nội bộ

  1. Cắm máy in vào cùng router/switch với máy tính Bridge
  2. Vào cài đặt máy in để lấy IP (thường in khi giữ nút feed)
  3. Nhập IP và Port (mặc định: 9100) vào Dashboard
  4. Nhấn Kiểm tra kết nối

Ưu điểm: Ổn định, nhiều thiết bị có thể gửi lệnh in, không phụ thuộc một máy tính.

Cấu hình cơ bản

Cài đặtTùy chọnMô tả
Khổ giấy58mm / 80mmĐo chiều rộng giấy cuộn thực tế
Vai tròReceipt / KitchenReceipt = in hóa đơn khách; Kitchen = in ticket bếp
Số bản in1–3Số lượng bản in cho mỗi lệnh

Gắn vào Kitchen (nếu là máy in bếp)

Nếu chọn Kitchen, cần gắn máy in với một khu vực bếp cụ thể (VD: Bếp chính, Bar, Bếp lạnh).

Vào Dashboard → Cài đặt → Khu vực bếp để tạo khu vực trước khi cài máy in.

Bước 3 — Tuỳ chỉnh hóa đơn (Receipt)

Dành cho máy in vai trò Receipt.

Chọn template

TemplateĐặc điểm
classicĐầy đủ thông tin, header/footer rõ ràng
minimalGọn, ít thông tin, phù hợp quán nhỏ
premiumThiết kế đẹp hơn, có khoảng trắng tốt

Các tùy chọn hiển thị

Tùy chọnMặc địnhMô tả
Header(trống)Dòng chào/slogan in đầu hóa đơn
Footer(trống)Dòng cảm ơn/thông tin in cuối
Hiện số bànBậtIn số bàn trên hóa đơn
Hiện số đơnBậtIn mã đơn hàng
Hiện QR codeTắtIn QR dẫn đến trang theo dõi đơn

Auto-print

Cài đặt Tự động in khi có sự kiện:

  • new_order — In ngay khi đơn mới vào
  • order_complete — In khi đơn hoàn thành
  • payment_complete — In khi thanh toán xong

In thử

Sau khi cấu hình xong, nhấn In thử trên card máy in. Nếu in thành công, cài đặt đã đúng.

⚠️

Nếu in thử không ra, kiểm tra:

  1. Bridge Device đang Online (xanh)
  2. IP máy in đúng — thử ping [IP máy in] trên máy tính Bridge
  3. Máy in đang bật và có giấy
  4. Port 9100 không bị firewall chặn (với kết nối LAN)

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

Q: Bridge Device có hỗ trợ macOS không?

Hiện tại chỉ hỗ trợ Windows. Nếu quán dùng Mac, cần một máy Windows nhỏ (mini PC) riêng cho Bridge.

Q: Một Bridge Device có kết nối được nhiều máy in không?

Có. Một Bridge Device có thể quản lý nhiều máy in cùng lúc — cả LAN lẫn USB.

Q: Máy in bếp và máy in hóa đơn có thể là cùng một máy không?

Không nên. Nên dùng 2 máy in riêng biệt — một cho receipt (quầy), một cho kitchen ticket (bếp) — để tránh nhầm lẫn và đảm bảo in liên tục.

Q: Khi mất điện hoặc Bridge Device tắt thì sao?

Lệnh in sẽ được giữ trong hàng đợi và in lại ngay khi Bridge kết nối trở lại. Không mất đơn.

Cài đặt Barista App (PWA)Màn hình Barista (POS)