Memulai

Printer Struk

Menyambungkan printer bluetooth, memakai printer dapur terpisah, dan apa yang harus dilakukan pengguna iPhone.

HeyKopi mencetak lewat Bluetooth langsung dari browser — tidak perlu aplikasi perantara, tidak perlu kabel, tidak perlu server.

Printer yang cocok#

Printer struk termal bluetooth yang mendukung perintah ESC/POS. Hampir semua printer struk murah di marketplace sudah mendukungnya.

Lebar kertas 58 mm — ini yang dipakai HeyKopi (32 huruf per baris)
Printer 80 mm juga bisa, hasilnya cetakannya saja yang tidak penuh selebar kertas

Menyambungkan printer#

Nyalakan printernya, pastikan kertas sudah terpasang.
Buka Kasir → ⚙️ Setting → 🖨 Pengaturan Printer.
Tekan tombol sambungkan, lalu pilih nama printermu di daftar yang muncul.
Tekan tombol tes cetak. Kalau keluar tulisan, berarti sudah siap.

ℹ️ Browser akan bertanya sekali

Saat pertama kali, Chrome menampilkan kotak pilihan perangkat bluetooth. Ini wajar — browser tidak mengizinkan aplikasi menyambung ke perangkat tanpa seizinmu.

Kalau printer tidak muncul di daftar#

Pastikan Bluetooth dan Lokasi HP menyala (Android butuh izin lokasi untuk memindai bluetooth)
Matikan printer, hidupkan lagi
Pastikan printer tidak sedang tersambung ke HP lain atau ke aplikasi kasir lain
Lepaskan dulu pasangan lama di Pengaturan Bluetooth HP, lalu cari ulang dari HeyKopi

Kalau sambungan putus-putus#

Printer bluetooth akan memutus sendiri kalau diam terlalu lama — itu normal. HeyKopi menyambung ulang otomatis saat kamu mencetak lagi. Kalau sering gagal:

Dekatkan HP ke printer (bluetooth printer murah jangkauannya pendek)
Isi baterai printer; printer yang baterainya tipis sering putus di tengah cetak
Jangan buka dua tab HeyKopi sekaligus — keduanya berebut printer yang sama

Kalau sudah dicoba semua tapi tetap tidak keluar#

Ada tombol 📋 Salin Catatan Koneksi Printer di bagian bawah Kasir → ⚙️ Setting → 🖨️ Printer Struk, Dapur & Label.

Caranya:

Tekan Tes pada printer yang bermasalah
Tekan 📋 Salin Catatan Koneksi Printer
Tempel (paste) ke WhatsApp, kirim ke admin

Catatan itu merekam tiap langkah penyambungan: printer mana yang dipilih, apakah sambungannya jadi, dan apakah datanya benar-benar terkirim. Dari situ ketahuan macetnya di mana tanpa tebak-tebakan.

Baris pertamanya sudah berisi kesimpulan. Yang paling sering muncul:

"Berhenti di: GATT tidak mau connect" — printernya belum menyala, sedang dipakai HP lain, atau perlu dilepas dulu dari Pengaturan Bluetooth HP
"Semua byte berhasil dikirim ke printer" padahal kertasnya kosong — koneksinya tidak bermasalah. Hampir selalu salah bahasa cetak (ESC/POS vs TSPL vs NIIMBOT) atau printernya sedang di mode yang salah. Printer label yang punya tombol mode biasanya harus dipindah antara Receipt dan Label

💡 Aman dikirim

Catatan itu hanya berisi data teknis printer: merek, ukuran label, dan langkah penyambungan. Tidak ada angka penjualan, nama pembeli, email, atau kode lisensi di dalamnya.

Printer dapur terpisah#

Buka Kasir → ⚙️ Setting → 🖨️ Printer Struk, Dapur & Label. Kamu bisa memasang printer berbeda untuk:

Struk — untuk pembeli
Dapur — tiket pesanan untuk barista/dapur
Label — untuk stiker gelas (kalau printermu mendukung)

Kalau printer dapur tidak diisi, tiket dapur ikut tercetak di printer struk.

Printer label (stiker gelas)#

Label stiker dipakai untuk menempel pesanan di gelas: nomor antrian, nama pembeli, nama minuman, dan catatannya. HeyKopi mendukung dua jenis printer label yang bahasanya berbeda — pilih dulu di Kasir → ⚙️ Setting → 🖨 Pengaturan Printer → 🏷️ Printer Label.

1. Printer struk biasa + kertas label (ESC/POS)#

Pilihan ESC/POS. Tidak perlu beli printer kedua: printer struk 58 mm yang sudah kamu punya tinggal diganti kertasnya pakai kertas label. Printer acuan yang sudah diuji: RPP02N (di Indonesia dijual juga sebagai Iware C-58BT).

Ukuran label yang didukung: 33 × 15 mm dan 40 × 30 mm.

💡 Paling murah

Kertas label polos jauh lebih murah daripada label bermerek, dan printernya sudah ada. Kalau belum punya printer label sama sekali, mulai dari sini.

2. NIIMBOT (B1, B21, D11)#

Pilihan NIIMBOT. NIIMBOT memakai bahasa cetaknya sendiri — bukan ESC/POS — jadi saklarnya harus dipindah dulu. Kalau tidak, printernya tersambung tapi kertasnya keluar kosong.

Setelah dipilih, ada dua setelan tambahan:

Kerapatan cetak 1–5 (bawaan 3). Kalau hasilnya pudar naikkan; kalau terlalu pekat dan kertasnya menghitam, turunkan.
Salin catatan koneksi — kalau printernya tidak mau mencetak, tombol ini menyalin riwayat komunikasinya untuk dikirim ke admin.

⚠️ Label NIIMBOT ber-chip RFID

Printer NIIMBOT membaca chip di gulungan labelnya. Label pihak ketiga yang tanpa chip bisa ditolak oleh printernya sendiri — itu di luar kendali aplikasi. Hitung dulu harga labelnya sebelum memutuskan: label resmi NIIMBOT jauh lebih mahal per lembar daripada kertas label polos.

3. TSPL (Xprinter, Gprinter, Zjiang, Kassen, dll)#

Pilihan TSPL. Ini bahasa yang dipakai kebanyakan printer label murah di marketplace — biasanya printer kecil khusus stiker 40 × 30 mm.

Sambungannya memakai Bluetooth yang sama dengan printer struk, jadi tombol Pasang / Ganti tetap seperti biasa. Yang perlu diatur:

Kerapatan cetak 0–15 (bawaan 8).
Jarak antar label (mm) — celah antar stiker di gulungannya, bawaan 2 mm. Kalau cetakannya meleset naik-turun tiap label, angka inilah yang perlu disesuaikan.

Kalau tulisannya tipis atau kekecilan#

Kasir → ⚙️ Setting → 🖨️ Printer → 🔤 Ukuran Huruf Label. Ada tiga ukuran (Kecil / Normal / Besar) dan saklar Huruf tebal semua.

Urutan yang disarankan kalau cetakan tipis atau putus-putus:

Nyalakan Huruf tebal semua — ini yang paling sering menyelesaikan
Masih tipis? Naikkan Kerapatan cetak (TSPL 0–15, NIIMBOT 1–5)
Masih tipis juga? Biasanya kertas labelnya yang kurang cocok, bukan setelannya

Kalau huruf Besar bikin tulisan terpotong, kembalikan ke Normal — kertas label memang sempit, dan HeyKopi memotong tulisan yang tidak muat daripada membiarkannya meluber keluar kertas.

Setelan ini berlaku untuk semua merek printer label, karena ketiganya menggambar dari gambar yang sama.

Mengganti jenis huruf#

Di bawah ukuran huruf ada 🔡 Jenis Huruf dengan empat pilihan:

Pilihan	Kapan dipakai
Normal	Bawaan, paling aman terbaca
Rapat	Label sempit — hurufnya lebih kurus, lebih banyak yang muat sebaris
Serif	Tampilan lebih klasik untuk label kemasan
Mono	Kode/SKU — lebar tiap huruf sama, angka lebih mudah dibaca

HeyKopi hanya memakai huruf bawaan HP, tidak mengunduh dari internet. Jadi label tetap tercetak walau sinyal hilang. Kalau jenis yang kamu pilih kebetulan tidak ada di HP itu, layarnya memberi tahu dan HeyKopi memakai huruf terdekat — labelnya tetap keluar, cuma bentuknya berbeda.

Ukuran, jenis, dan tebal huruf bisa diatur dari dua tempat: di pengaturan printer ini, dan langsung di layar Cetak Label Manual (lengkap dengan pratinjau). Keduanya mengubah setelan yang sama — jadi label pesanan dan label manual selalu seragam.

Yang belum didukung#

Printer berbahasa CPCL (umumnya printer mobile Zebra/Honeywell) belum bisa dipakai. Kalau kamu punya printer label merek lain dan ragu, tanyakan dulu ke admin sebelum membeli — sebutkan mereknya, biasanya di kotaknya tertulis bahasa cetaknya.

Tiket dapur sebelum struk#

Kasir → ⚙️ Setting → 🍳 Tiket Dapur Sebelum Struk. Kalau dinyalakan, begitu pembayaran selesai, tiket dapur keluar lebih dulu, baru struk pembeli. Barista bisa langsung bekerja sementara kasir menyerahkan kembalian.

Tiket dapur sengaja hanya berisi yang dibutuhkan dapur: nama item, jumlah, catatan/modifier, nama atau nomor meja. Tidak ada harga.

💡 Pesanan yang ditunda juga bisa cetak dapur

Kalau kamu memakai Tunda Bayar, ada tombol 🍳 di kartu bill untuk mencetak tiket dapur tanpa menagih dulu. Pesanan tambahan hanya mencetak item yang baru, bukan mengulang semuanya.

iPhone dan printer bluetooth#

Ini keterbatasan Apple, bukan HeyKopi: Safari di iPhone tidak mendukung Web Bluetooth, jadi printer tidak akan pernah terdeteksi dari Safari. Semua browser di iPhone (termasuk Chrome versi iPhone) memakai mesin Safari, jadi hasilnya sama.

Ada dua jalan keluar:

1. Pakai browser khusus Web Bluetooth#

Aplikasi seperti Bluefy atau WebBLE (berbayar, di App Store) adalah browser yang menambahkan dukungan Web Bluetooth. Buka heykopi.id dari dalam aplikasi itu, lalu sambungkan printer seperti biasa.

⚠️ Kekurangannya jujur ya

Data yang tersimpan di Bluefy terpisah dari data di Safari — anggap saja perangkat yang berbeda. Jadi kalau kamu sudah berjualan lewat Safari, jangan pindah ke Bluefy begitu saja tanpa Cloud Sync atau backup dulu. Dan karena bukan aplikasi resmi HeyKopi, kami tidak bisa menjamin tiap pembaruan iOS tidak merusaknya.

2. Pakai HP Android murah khusus kasir#

Ini yang paling banyak dipilih pemilik warung: HP Android bekas seharga beberapa ratus ribu, dipakai khusus sebagai mesin kasir di meja. iPhone-mu tetap dipakai untuk memantau laporan.

Kalau kamu berlangganan Cloud Sync, keduanya melihat data yang sama.

Cetak tanpa printer#

Tidak punya printer? Tetap bisa jualan:

Struk bisa dikirim lewat WhatsApp ke pembeli
Struk bisa ditampilkan di layar untuk difoto pembeli
Laporan bisa diekspor ke Excel/CSV dan dikirim ke WA