Perangkat & Printer
Daftar & Tambah Printer
Cara melihat daftar printer terkonfigurasi, menambah printer baru dari perangkat, memeriksa status koneksi, dan menyinkronkan konfigurasi dari server.
Siapa yang menggunakan fitur ini?
Kasir dan Manajer — untuk memastikan printer terhubung dengan benar sebelum beroperasi.
Membuka Pengaturan Printer
- Dari menu utama POS, ketuk Pengaturan → Printer (atau navigasi ke Pengaturan Printer).
- Halaman Pengaturan Printer terbuka, menampilkan:
- Toggle Perangkat pencetak dapur otomatis di bagian atas
- Panel Status Perangkat untuk uji perangkat
- Daftar printer yang terdaftar di cabang ini
Menyinkronkan Konfigurasi dari Server
Konfigurasi printer (nama, alamat, stasiun, routing) diatur oleh merchant di Dashboard Merchant, lalu diunduh ke perangkat POS. Untuk memastikan konfigurasi terbaru terpasang:
- Ketuk ikon sinkronkan (panah putar, pojok kanan atas).
- Tunggu sebentar. Notifikasi muncul:
- "Konfigurasi printer diperbarui" — berhasil mengambil data terbaru dari server
- "Offline — pakai konfigurasi tersimpan" — tidak ada koneksi; aplikasi menggunakan data lokal terakhir
Alternatif: tarik layar ke bawah (pull-to-refresh) pada halaman ini untuk efek yang sama.
Tip: Selalu sinkronkan konfigurasi setelah admin merchant menambah atau mengubah pengaturan printer/stasiun di Dashboard Merchant.
Memahami Daftar Printer
Setiap printer ditampilkan sebagai kartu berisi:
| Elemen | Keterangan |
|---|---|
| Nama printer | Nama yang ditetapkan saat pendaftaran (mis. "Printer Kasir 1") |
| Ikon | Bluetooth (ikon BT) atau Printer biasa (LAN/USB) |
| Indikator status | Lingkaran kecil: abu-abu = belum dicek, hijau = terhubung, merah = gagal |
| Chip koneksi | bluetooth / lan / usb / cloud |
| Chip jenis | RECEIPT / KITCHEN / BILL / CHECKER / LABEL (label berwarna biru) |
| Lebar kertas | 58mm atau 80mm |
| Bisa Buka Laci | Chip hijau jika printer mendukung kick laci kas |
| Ada Buzzer | Chip hijau jika printer mendukung bunyi buzzer |
| Alamat | IP:port (LAN) atau MAC address (Bluetooth, setelah ditautkan) |
| BT belum ditaut | Chip kuning — printer Bluetooth belum dipasangkan di perangkat ini |
| nonaktif | Chip abu-abu — printer dinonaktifkan oleh merchant |
Tipe Koneksi Printer
| Tipe | Cara kerja |
|---|---|
| Bluetooth | Terhubung via Bluetooth ke printer termal portabel. Perlu ditautkan per perangkat (lihat di bawah). |
| LAN (Jaringan) | Terhubung via Wi-Fi/kabel ke printer dengan alamat IP tetap di jaringan lokal. Tidak perlu pairing. |
| USB | Terhubung via kabel USB (jalur perangkat, mis. /dev/usb/lp0). |
| Cloud | Melalui layanan cloud (dalam pengembangan — belum aktif). |
Menambah Printer Baru
Printer didaftarkan dari perangkat yang secara fisik terhubung ke printer. Ini memastikan alamat dan jenis koneksi terdeteksi dengan akurat. Setelah didaftarkan, printer otomatis muncul di Dashboard Merchant untuk diatur stasiun dan routing-nya.
- Ketuk tombol Tambah Printer (tombol biru-oranye di pojok kanan bawah).
- Dialog Tambah Printer terbuka. Isi:
- Nama Printer — nama pengenal (mis. "Printer Dapur A")
- Jenis Koneksi — pilih
Bluetooth,LAN, atauUSB
- Tergantung jenis koneksi:
- Bluetooth: Pilih perangkat dari daftar BT yang sudah dipasangkan di sistem (dari pengaturan Bluetooth perangkat Android/tablet). MAC terisi otomatis.
- LAN: Masukkan Alamat IP (mis.
192.168.1.100) dan Port (default9100). - USB: Masukkan jalur perangkat (mis.
/dev/usb/lp0).
- Pilih Lebar Kertas:
58mmatau80mm. - (Opsional) Ketuk Test untuk mencetak halaman uji sebelum mendaftar.
- Ketuk Daftarkan untuk menyimpan. Printer akan muncul di daftar dan juga terkirim ke merchant untuk konfigurasi lebih lanjut.
Perhatian: Untuk printer Bluetooth, pastikan perangkat sudah dipasangkan terlebih dahulu melalui pengaturan Bluetooth sistem operasi tablet, bukan dari dalam aplikasi POS.
Menautkan Printer Bluetooth ke Perangkat Ini
Setiap perangkat POS perlu "menautkan" printer Bluetooth secara lokal (menyimpan MAC address di perangkat ini). Ini dilakukan terpisah dari pendaftaran.
- Pada kartu printer yang bertuliskan BT belum ditaut, ketuk tombol Tautkan.
- Sheet pemindai Bluetooth terbuka, menampilkan perangkat BT yang terdeteksi di sekitar.
- Pilih nama printer dari daftar. Koneksi disimpan di perangkat ini.
- Notifikasi muncul: "[Nama Printer] ditautkan ke [Nama Perangkat BT]".
Jika ingin mengganti perangkat BT yang ditautkan, ketuk tombol Ganti pada kartu printer yang sudah terhubung.
Toggle Pencetak Dapur Otomatis
Toggle Perangkat pencetak dapur otomatis di bagian atas halaman berfungsi untuk menandai perangkat POS ini sebagai "pencetak dapur otomatis". Jika aktif, perangkat ini akan otomatis mencetak tiket dapur untuk pesanan yang masuk dari saluran web/kiosk (tanpa kasir yang menekan Kirim ke Dapur). Cukup satu perangkat per cabang yang perlu diaktifkan.
Panel Antrean Cetak
Jika ada pekerjaan cetak yang gagal dan menunggu percobaan ulang, panel Antrean Cetak muncul di bagian bawah halaman. Panel ini menampilkan:
- Jumlah job dalam antrean
- Status masing-masing job (
failed/ menunggu) - Tombol Coba lagi — memproses ulang semua job
- Tombol Bersihkan — menghapus semua job dari antrean
Tip: Job masuk antrean ketika printer tidak terjangkau saat pesanan dikirim. Setelah printer kembali terhubung, tekan Coba lagi agar struk/tiket yang tertunda tercetak.