Tài liệu tải về
Cài đặt máy in

Cài đặt máy in nhiệt

Bridge Device · LAN / USB · Auto-print · docs.xcaphe.vn

Kiến trúc tổng quan

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

Bước 1 — Cài Bridge Device

  1. Vào Dashboard → Cài đặt → Máy in → Thêm Bridge Device
  2. Tải file cài đặt Bridge App cho Windows
  3. Cài đặt và chạy — Bridge App hiển thị mã kết nối 6 ký tự
  4. Quay lại Dashboard → nhập mã kết nối → chọn chi nhánh → Xác nhận
  5. 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: Task Scheduler → Create Basic Task → Bridge.exe → At startup.

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

  1. Vào Dashboard → Cài đặt → Máy in → + Thêm máy in
  2. Chọn model máy in từ catalog
  3. Chọn phương thức kết nối:

Kết nối LAN (khuyến nghị)

  1. Cắm máy in vào cùng router/switch với máy tính Bridge
  2. Lấy IP của máy in (giữ nút feed khi bật nguồn để in thông số)
  3. Nhập IP và Port (mặc định: 9100)
  4. Nhấn Kiểm tra kết nối → ✓ nếu kết nối thành công

Kết nối USB

  1. Cắm cáp USB từ máy in vào máy tính Bridge
  2. Cài driver máy in (từ CD kèm theo hoặc website hãng)
  3. Nhập tên máy in Windows (xem trong Control Panel → Devices and Printers)
  4. Nhấn Kiểm tra kết nối

Bước 3 — Cấu hình cơ bản

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

Nếu vai trò là Kitchen, cần gắn máy in với một Khu vực bếp (vào Cài đặt → Khu vực bếp để tạo trước).

Bước 4 — Tùy chỉnh hóa đơn (Receipt)

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

Cài đặt auto-print:

Sự kiệnKhi nào dùng
new_orderIn ngay khi đơn mới vào
order_completeIn khi đơn hoàn thành
payment_completeIn khi thanh toán xong

Bước 5 — In thử và kiểm tra

Nhấn In thử trên card máy in. Nếu in thành công → cài đặt đã đúng.

Nếu không in được, kiểm tra:

  1. Bridge Device đang 🟢 Online
  2. Ping IP máy in: mở CMD → gõ ping [IP_may_in]
  3. Máy in đang bật và có giấy
  4. Port 9100 không bị Windows Firewall chặn

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

Q: Bridge Device có hỗ trợ macOS không? Hiện chỉ hỗ trợ Windows. Dùng Mac → cần 1 máy Windows mini (mini PC) riêng cho Bridge.

Q: Một Bridge Device kết nối được bao nhiêu máy in? Không giới hạn. Một Bridge quản lý nhiều máy in LAN và USB cùng lúc.

Q: Mất điện, Bridge tắt thì sao? Lệnh in giữ trong hàng đợi, in lại ngay khi Bridge kết nối trở lại. Không mất đơn.

Hướng dẫn đầy đủ: docs.xcaphe.vn/getting-started/printer-setup

Checklist khai trươngCâu hỏi thường gặp