Penjualan (Kasir)
Scan Barcode
Cara menggunakan scanner barcode HID (keyboard-wedge) atau kamera untuk menambah produk ke keranjang.
Scan Barcode
Siapa: Kasir dan Pelayan.
Aplikasi POS mendukung dua metode scan barcode: scanner HID (USB atau Bluetooth yang meniru keyboard) dan kamera perangkat. Keduanya menggunakan alur yang sama — produk langsung masuk keranjang setelah kode dikenali.
Metode 1 — Scanner HID (Keyboard-Wedge)
Scanner USB atau Bluetooth yang umum digunakan di kasir bekerja dengan cara "mengetik" karakter barcode sangat cepat lalu menekan Enter. Aplikasi mendeteksi pola ketikan cepat ini secara otomatis.
Tidak perlu pengaturan tambahan — cukup sambungkan scanner dan arahkan ke barcode produk.
Cara kerja
- Pastikan tidak ada kolom teks yang sedang aktif (kursor tidak di dalam kotak pencarian atau kolom lain).
- Arahkan scanner ke barcode produk dan tekan trigger.
- Aplikasi mendeteksi burst karakter cepat + Enter sebagai "scan", lalu mencari produk.
- Produk ditemukan → langsung ditambahkan ke keranjang, disertai suara klik dan getaran singkat.
Perhatian: Jika kursor sedang aktif di kolom Cari menu atau kolom lain, input scanner tidak akan ditangkap sebagai scan — karakter akan masuk ke kolom teks tersebut. Ketuk area di luar kolom teks terlebih dahulu sebelum scan.
Metode 2 — Kamera
- Tap tombol ikon scan barcode yang ada di samping kolom pencarian (kanan atas area menu).
- Layar kamera terbuka — arahkan kamera ke barcode atau QR code produk.
- Setelah kode terdeteksi, sheet kamera otomatis menutup dan produk dicari.
- Hasil: sama seperti HID — produk masuk keranjang atau sheet modifier terbuka.
Tips: Metode kamera lebih praktis untuk pelayan yang bergerak membawa tablet; HID scanner lebih cepat untuk kasir dengan volume transaksi tinggi.
Alur Setelah Scan (Keduanya Sama)
Setelah kode terdeteksi, aplikasi menjalankan langkah berikut secara otomatis:
- Debounce 1 detik — scan fisik yang sama tidak ditambahkan dua kali dalam 1 detik.
- Cek e-receipt — jika kode berupa URL
/receipt/atau UUID struk lama, aplikasi menampilkan detail struk (bukan menambah produk ke keranjang). - Cari produk — cari berdasarkan barcode atau SKU di data menu yang sudah tersinkron.
- Produk punya modifier → sheet modifier terbuka; pilih modifier lalu tap Tambahkan.
- Produk tanpa modifier → langsung ditambahkan, muncul snackbar hijau singkat.
Jika Scan Gagal
| Kondisi | Respons Aplikasi |
|---|---|
| Barcode tidak dikenal | Suara alert + getaran kuat + snackbar merah "Barcode tidak dikenal: {kode}" |
| Koneksi gagal / lookup error | Snackbar merah "Gagal mencari barcode: {kode}" |
| QR e-receipt terdeteksi | Tampil detail struk pembayaran (tidak menambah produk) |
Perhatian: Scan QR dari struk atau bukti pembayaran tidak akan menambah item ke keranjang — aplikasi mengenalinya sebagai e-receipt dan menampilkan detail transaksi. Ini adalah fitur verifikasi, bukan penambahan produk.
Tips Penggunaan
- Daftarkan barcode produk di Dashboard Merchant → Menu → Edit Menu → Barcode agar dapat dipindai.
- Jika produk tidak ditemukan padahal barcode sudah terdaftar, lakukan sinkronisasi terlebih dahulu (ikon sinkronisasi di drawer navigasi).
- Untuk SKU tanpa barcode fisik, bisa juga diketik manual di kolom pencarian.