Hướng dẫn cài đặt XCaphe trong 30 phút
Phiên bản: Tháng 1/2026 · docs.xcaphe.vn/getting-started/quick-start
Tổng quan
| Bước | Nội dung | Thời gian |
|---|---|---|
| 1 | Đăng ký & Wizard thiết lập | ~10 phút |
| 2 | Kiểm tra menu từ template | ~3 phút |
| 3 | Thêm nhân viên | ~5 phút |
| 4 | Kết nối thiết bị Barista | ~5 phút |
| 5 | In QR bàn & Test đơn đầu tiên | ~5 phút |
| Tổng | ~30 phút |
Bước 1 — Đăng ký và hoàn thành Wizard
- Truy cập app.xcaphe.vn → nhấn Đăng ký dùng thử
- Wizard dẫn qua 10 bước:
- Chọn loại hình: café, trà sữa, nhà hàng, bánh...
- Điền tên quán, địa chỉ, số bàn, giờ mở cửa
- Tạo tài khoản Chủ quán: họ tên + số điện thoại + PIN 6 chữ số (nhớ PIN này!)
- Chọn template menu (21 template cho từng ngành F&B)
- Nhấn Hoàn tất — hệ thống tạo menu, bàn, nguyên liệu trong vài giây
- Bạn được chuyển tự động vào Dashboard
Chọn template phù hợp nhất để không phải nhập thủ công. Có thể chỉnh sửa sau.
Bước 2 — Kiểm tra menu
- Vào Menu từ sidebar trái
- Kiểm tra giá bán đúng chưa — sửa nếu cần
- Tắt các món chưa bán (bỏ chọn "Hiển thị trên menu")
- Thêm/sửa biến thể size, nhiệt độ nếu cần
Bước 3 — Thêm nhân viên
Vào Nhân viên → + Thêm nhân viên cho từng người:
| Trường | Nội dung |
|---|---|
| Họ tên | Tên thật của nhân viên |
| Số điện thoại | Dùng để đăng nhập |
| Vai trò | Pha chế hoặc Thu ngân |
| PIN | 4–6 chữ số (nhân viên cần nhớ) |
Vai trò phù hợp:
- Pha chế → nhận đơn trên màn hình barista, cập nhật trạng thái
- Thu ngân → tạo đơn POS, xác nhận thanh toán
Bước 4 — Kết nối thiết bị Barista
4a. Tạo mã ghép trên Dashboard (Chủ quán làm)
- Vào Cài đặt → Thiết bị → Tạo mã ghép
- Ghi lại mã 6 ký tự (hiệu lực 15 phút)
4b. Kết nối trên tablet/điện thoại (Nhân viên làm)
- Mở Chrome (Android) hoặc Safari (iOS) → truy cập barista.xcaphe.vn
- Nhập mã 6 ký tự + đặt tên thiết bị (ví dụ: "Quầy 1")
- Nhấn Kết nối
4c. Đăng nhập ca (mỗi ca làm)
- Chọn tên mình từ danh sách nhân viên
- Nhập PIN → vào màn hình barista
⚠️
Mã ghép hết hạn sau 15 phút. Nếu quá thời gian, Chủ quán tạo mã mới từ Dashboard.
Bước 5 — In QR và Test đơn
In QR bàn
- Vào Bàn từ sidebar
- Nhấn In QR cho từng bàn hoặc In tất cả QR
- In ra, cắt, đặt tại bàn tương ứng
Test đơn hàng
- Dùng điện thoại quét QR bàn bất kỳ
- Chọn vài món → Đặt hàng → chọn VietQR
- Xác nhận đơn xuất hiện trên màn hình barista ✓
- Nhân viên nhấn Xác nhận → Xong
✅ Nếu đơn test thành công → quán sẵn sàng khai trương!
Cần hỗ trợ?
| Kênh | Thông tin |
|---|---|
| Docs | docs.xcaphe.vn |
| Zalo/hotline | Xem trong Dashboard → Hỗ trợ |
| SLA | Phản hồi trong 2 giờ làm việc |
Tài liệu này được tạo tự động từ docs.xcaphe.vn. Phiên bản mới nhất luôn có tại docs.xcaphe.vn/getting-started/quick-start (opens in a new tab)