Perangkat & Printer
Barcode Scanner
Cara menggunakan barcode scanner HID (Bluetooth/USB keyboard-wedge) dan kamera untuk lookup produk, member, dan struk digital di aplikasi POS.
Siapa yang menggunakan fitur ini?
Kasir — untuk mempercepat penginputan item ke keranjang, lookup member, dan verifikasi struk digital.
Dua Jenis Barcode Scanner yang Didukung
Aplikasi POS mendukung dua metode pemindaian barcode:
| Jenis | Cara kerja | Cocok untuk |
|---|---|---|
| HID (Keyboard-wedge) | Scanner Bluetooth atau USB yang "mengetik" kode sebagai input keyboard | Kasir tetap dengan meja kasir |
| Kamera (mobile_scanner) | Kamera bawaan tablet/smartphone memindai barcode | Kasir mobile atau sebagai cadangan |
1. Scanner HID (Bluetooth / USB Keyboard-Wedge)
Scanner jenis ini bekerja seperti keyboard eksternal: saat barcode dipindai, kode karakter dikirim ke aplikasi seolah diketik oleh pengguna. Tidak diperlukan konfigurasi khusus di dalam aplikasi POS.
Memasangkan scanner Bluetooth HID
- Nyalakan scanner Bluetooth.
- Buka Pengaturan Bluetooth di tablet/perangkat Android (di luar aplikasi POS).
- Cari dan pasangkan (pair) scanner — biasanya bernama sesuai merek/model (mis. "Honeywell 1602g").
- Setelah terpasang, scanner siap digunakan. Tidak ada langkah tambahan di aplikasi POS.
Menggunakan scanner USB HID
- Colokkan scanner USB ke port USB tablet (mungkin memerlukan adaptor USB-C ke USB-A).
- Sistem operasi mengenali scanner sebagai perangkat HID secara otomatis.
- Scanner langsung siap digunakan tanpa konfigurasi tambahan.
Tip: Agar scanner HID bekerja dengan baik di halaman Penjualan, pastikan fokus berada di kolom pencarian produk atau area input yang relevan. Jika layar menampilkan dialog atau sheet terbuka, scan mungkin tidak terdeteksi.
2. Kamera (Pemindai Kamera Bawaan)
Untuk memindai barcode menggunakan kamera perangkat:
- Di halaman Penjualan, ketuk ikon kamera / Scan Barcode (ikon pindai) di area pencarian atau toolbar.
- Layar pemindai kamera terbuka dengan panduan bingkai pemindaian.
- Arahkan kamera ke barcode produk hingga kode terdeteksi.
- Produk langsung dicari dan (jika ditemukan) ditambahkan ke keranjang.
Izin kamera diperlukan. Jika muncul pesan "Izin kamera ditolak", aktifkan izin kamera untuk aplikasi POS melalui Pengaturan → Aplikasi → POS → Izin → Kamera.
Penggunaan: Lookup Produk
Saat kode barcode dipindai (HID atau kamera) di halaman Penjualan:
- Aplikasi mencari produk berdasarkan barcode di database lokal (offline-first).
- Jika ditemukan: notifikasi "Ditambahkan: [Nama Menu]" muncul dan item langsung masuk ke keranjang.
- Jika tidak ditemukan: notifikasi "Barcode tidak dikenal: [kode]" muncul. Cek apakah produk sudah memiliki barcode yang terdaftar di Dashboard Merchant → Menu.
- Jika pencarian gagal karena masalah teknis: notifikasi "Gagal mencari barcode: [kode]" muncul.
Tip: Lookup produk bekerja secara offline menggunakan data menu yang sudah disinkronkan. Pastikan sinkronisasi sudah dilakukan jika menu baru saja diperbarui.
Penggunaan: Scan QR Member
Untuk menghubungkan pelanggan dengan akun member-nya:
- Di halaman Penjualan, ketuk Scan QR Member (atau gunakan menu pencarian member → pilih ikon kamera).
- Minta pelanggan menunjukkan QR code dari aplikasi member mereka.
- Arahkan kamera ke QR tersebut.
- Member teridentifikasi dan terhubung ke transaksi, sehingga poin dan diskon member berlaku otomatis.
Penggunaan: Scan Struk Digital (E-Receipt)
Kasir dapat memverifikasi struk digital pelanggan dengan memindai QR code yang ada di struk:
- Di halaman Penjualan, gunakan pemindai (kamera atau HID) untuk memindai QR pada struk digital pelanggan.
- Aplikasi mengenali format URL struk (
/receipt/…atau UUID pesanan) dan membuka Struk Digital (E-Receipt). - Detail pesanan yang sesuai ditampilkan sebagai bukti verifikasi.
Pemindaian QR e-receipt bersifat read-only — hanya menampilkan data pesanan, tidak mengubah status pesanan.
Prioritas pengenalan kode
Saat kode dipindai di halaman Penjualan, aplikasi menentukan jenis kode secara otomatis dengan urutan prioritas:
- E-Receipt (URL struk digital atau UUID pesanan) → buka panel Struk Digital
- QR Member (format kode member) → hubungkan member ke transaksi
- Barcode produk → tambahkan item ke keranjang
Tips dan pemecahan masalah
- Scanner HID tidak bereaksi? Pastikan fokus keyboard ada di kolom input yang sesuai — ketuk area input terlebih dahulu.
- Kamera tidak bisa scan? Pastikan pencahayaan cukup, kode tidak kusut atau rusak, dan jarak kamera sekitar 10–30 cm dari barcode.
- Produk tidak ditemukan setelah scan? Pastikan produk sudah diberi barcode di Dashboard Merchant dan menu sudah disinkronkan ke POS.
- Untuk scanner Bluetooth yang terputus, buka Pengaturan Bluetooth sistem dan sambungkan ulang.