Printer & Cetak Struk

Terakhir diperbarui / Last updated: 4 September 2026 · Versi / Version: 1.4

🆕 Sejak 4 September 2026: halaman pengaturan printer digabung jadi satu — Inventaris Printer. Sekarang Anda tidak lagi "memilih 1 metode cetak" untuk seluruh outlet; sebaliknya, Anda menambahkan printer satu per satu ke sebuah daftar, dan metode cetak outlet mengikuti otomatis dari printer apa saja yang ada. Bisa mencetak struk lewat LAN DAN label lewat Bluetooth sekaligus, di satu tablet yang sama. Panduan di bawah sudah disesuaikan ke tampilan baru ini.

---

Ringkasan / Overview

FirstJournal mendukung 4 cara sambung printer yang berbeda untuk mengakomodasi berbagai jenis printer dan kebutuhan bisnis. Dari printer USB sederhana sampai sistem cloud yang mencetak otomatis ke dapur dan bar tanpa sentuhan — semua tersedia, dan bisa dikombinasikan dalam satu outlet.

Untuk mengakses pengaturan printer: masuk ke POS → Outlet → Inventaris Printer. Halaman ini adalah satu daftar semua printer fisik outlet — bukan lagi memilih satu mode untuk seluruh outlet. Klik + Tambah Printer, lalu pilih salah satu dari 4 Cara Sambung di atas untuk printer tersebut. Setiap printer yang Anda tambahkan otomatis diberi tugas mencetak jenis dokumen tertentu (Struk, Label, Tiket Dapur, dst.) — lihat "Cakupan dokumen" di bagian atas halaman untuk melihat dokumen mana yang sudah/belum punya printer.

🔀 Kombinasi dalam 1 outlet, bahkan 1 tablet: karena setiap printer ditambahkan satu per satu, sebuah outlet bisa punya, misalnya, 1 printer Struk via LAN + 1 printer Label via Bluetooth + beberapa printer Jaringan untuk dapur/bar — semua terdaftar di satu Inventaris Printer yang sama, tanpa saling mengganggu.

Gunakan panduan ini untuk memilih cara sambung yang sesuai saat menekan + Tambah Printer:

• Printer USB biasa (sudah ada driver di komputer/tablet) → Browser
• Tidak ada WiFi, pakai laptop/HP → Bluetooth (asalkan Chrome/Edge)
• F&B dengan dapur/bar, butuh cetak otomatis, beberapa printer sekaligus → Printer Jaringan (Cloud-Pull)
• Lokasi sering mati internet, pakai Android → LAN / WiFi warung
• Sudah pakai LAN untuk struk, mau tambah printer label terpisah → tambahkan printer KEDUA dengan cara sambung Bluetooth — tidak perlu mengubah printer LAN yang sudah ada

Mode default. Menggunakan dialog cetak bawaan sistem operasi (Windows/Mac/iOS). Kompatibel dengan hampir semua printer yang sudah terpasang driver-nya.

Cara Setup

1. Buka POS → Outlet → Inventaris Printer
2. Klik + Tambah Printer → pilih Cara Sambung Lewat browser
3. Isi nama printer (opsional) → klik Tambah Printer Browser — tersimpan otomatis
4. Saat cetak struk, dialog cetak sistem akan muncul
5. Pilih printer dari daftar → klik Print

Tips

• Untuk printer thermal 58mm: di dialog cetak, atur ukuran kertas ke 58mm atau pilih preset thermal
• Untuk thermal 80mm: atur ke 80mm
• Untuk printer A4 biasa: pilih A4

⚠️ Catatan: Setiap kali cetak, dialog sistem selalu muncul dan harus diklik manual. Jika butuh cetak otomatis tanpa klik, gunakan Mode Printer Jaringan.

Cetak langsung ke printer thermal via Bluetooth — tanpa WiFi, tanpa dialog cetak. Ada 2 cara memakainya, tergantung dari mana FirstJournal dibuka:

Cara Connect — Lewat Browser (Chrome/Edge)

⚠️ Syarat penting: Hanya bekerja di Chrome atau Edge. Safari (iPhone/iPad) dan Firefox tidak mendukung fitur ini. Hanya untuk printer BLE — printer Bluetooth Classic tidak bisa dipakai lewat jalur browser (gunakan app Android, lihat di bawah).

1. Aktifkan Bluetooth di perangkat (laptop/tablet/HP)
2. Nyalakan printer thermal Bluetooth — pastikan dalam mode pairing (lampu berkedip)
3. Buka FirstJournal di Chrome atau Edge
4. Buka POS → Outlet → Inventaris Printer
5. Klik + Tambah Printer → pilih Cara Sambung Printer kecil Bluetooth
6. Klik tombol Sambungkan Printer
7. Popup daftar perangkat Bluetooth akan muncul — pilih nama printer Anda → klik Pair
8. Printer otomatis masuk ke daftar Inventaris Printer setelah berhasil connect
9. Klik Test Print pada kartu printer tersebut untuk verifikasi

Cara Connect — Lewat Aplikasi Android FirstJournal

Kalau memakai app Android FirstJournal (bukan browser), ada jalur Bluetooth sendiri yang mendukung BLE maupun Classic (SPP) — mencakup mayoritas printer thermal murah generik yang beredar di marketplace, yang biasanya justru Classic, bukan BLE.

1. Nyalakan printer thermal Bluetooth
2. Buka app Android FirstJournal → POS → Outlet → Inventaris Printer
3. Klik + Tambah Printer → pilih Cara Sambung Printer kecil Bluetooth
4. Klik Cari Printer Bluetooth — daftar perangkat BLE dan Classic yang ditemukan akan tampil bersama, tidak perlu tahu bedanya
5. Ketuk nama printer Anda dari daftar — otomatis masuk ke Inventaris Printer
6. Klik Tes Cetak pada kartu printer tersebut untuk verifikasi
7. Khusus printer Classic: dialog pemasangan (pairing)/PIN bawaan Android bisa muncul otomatis saat Tes Cetak pertama kali — cukup konfirmasi atau masukkan PIN sesuai instruksi di layar, ini normal bukan error

🆕 Dukungan printer Classic (SPP) di dalam app Android baru tersedia mulai 29 Agustus 2026 — jika sebelumnya laporan "printer Bluetooth tidak ketemu di app" untuk printer generik murah, coba lagi setelah update app terbaru.

Printer Bluetooth yang Kompatibel

• Xprinter XP-58 / XP-80 (BLE variant)
• Hoin HOP-E200 / E300
• Zonerich AB-POS58 (BLE)
• Sebagian besar printer thermal 58mm BLE dari marketplace
• Khusus di app Android: printer Bluetooth Classic (SPP) generik yang lebih murah juga didukung — kalau tidak yakin printer Anda BLE atau Classic, coba saja pakai jalur "Cari Printer Bluetooth" di app Android, keduanya akan tampil di daftar yang sama

💡 Tips beli printer untuk dipakai via browser (Chrome/Edge): pastikan spesifikasi menyebut "BLE" atau "Bluetooth Low Energy", bukan hanya "Bluetooth Classic" — jalur browser hanya mendukung BLE. Kalau berencana pakai app Android, kedua jenis sama-sama didukung.

Mode paling canggih untuk F&B. Printer di dapur dan bar mencetak otomatis setiap ada pesanan masuk — tanpa sentuhan kasir. Menggunakan protokol Epson Server Direct Print (SDP) atau Star CloudPRNT.

Cara Kerja

Ini adalah sistem Cloud-Pull: printer aktif "bertanya" ke server FirstJournal setiap 2–5 detik. Saat ada order masuk, server antri cetak, dan printer mengambil dan mencetak secara otomatis.

Kasir input order → Server firstjournal.id ← Printer polling setiap 3 detik → Cetak otomatis

Printer harus terhubung ke internet (via WiFi atau LAN dengan akses internet).

Langkah 1 — Tambah Printer di FirstJournal

1. Buka POS → Outlet → Inventaris Printer
2. Klik + Tambah Printer → pilih Cara Sambung Printer Jaringan (Cloud-Pull)
3. Isi formulir:
   • Nama Printer: contoh "Printer Dapur", "Printer Bar", "Printer Kasir"
   • Station/Role: Kasir / Dapur / Bar / Semua
   • Lebar Kertas: 58mm atau 80mm
4. Klik Simpan
5. Salin URL Polling yang muncul di kartu printer — URL ini dimasukkan ke pengaturan printer fisik

💡 Field Protokol (Epson SDP vs Star CloudPRNT) tidak perlu dipilih manual di sini — kedua protokol memakai URL Polling yang sama, tinggal ikuti langkah setup di printer fisik masing-masing merek di bawah.

Contoh URL Polling:

https://firstjournal.id/api/pos/cloudprnt/poll?token=xxxxxxxxxxxxxxxx

🆕 Punya sedikit printer fisik? (mis. cuma 1 printer Dapur + 1 printer Kasir, bar digabung ke Kasir). Station/Role hanya menentukan 1 kategori default per printer. Untuk membuat 1 printer menerima LEBIH dari satu jenis dokumen (mis. Struk + Checker Bar sekaligus di printer Kasir), klik ikon Edit (pensil) pada kartu printer tersebut di Inventaris Printer lalu centang jenis dokumen tambahan di "Jenis Dokumen yang Dicetak di Sini".

Langkah 2A — Setup di Printer Epson (SDP)

1. Download Epson Device Configuration Tool di laptop yang satu jaringan dengan printer
2. Buka tool → pilih printer Epson yang terdeteksi
3. Masuk ke tab Server Direct Print (atau Network → Server Direct Print)
4. Di kolom Server URL: paste URL Polling dari FirstJournal
5. Atur polling interval: 3 detik
6. Klik Save → restart printer
7. Tunggu 10–15 detik → cek status di FirstJournal (harus jadi hijau "Terhubung")

Langkah 2B — Setup di Printer Star (CloudPRNT)

1. Cetak self-test printer untuk melihat IP address (tahan tombol Feed saat nyalakan)
2. Buka IP printer di browser: misalnya http://192.168.1.105
3. Masuk ke menu CloudPRNT → Service URL
4. Paste URL Polling dari FirstJournal
5. Klik Save → restart printer
6. Tunggu 10–15 detik → cek status di FirstJournal

Verifikasi Berhasil

Status printer berubah dari 🔴 Belum terhubung → 🟢 Terhubung

Klik Tes Cetak — printer harus mencetak struk tes dalam 3–5 detik.

Printer yang Direkomendasikan

Cetak langsung dari aplikasi Android FirstJournal ke printer melalui jaringan LAN lokal (port 9100). Tidak membutuhkan koneksi internet — cocok untuk lokasi yang sering mati internet.

📱 Syarat: Mode ini membutuhkan aplikasi Android FirstJournal yang terinstall di tablet/HP kasir. Tidak tersedia dari browser biasa.

Cara Setup — LAN Langsung

1. Install app Android FirstJournal di tablet kasir (tersedia di Google Play Store)
2. Pastikan printer thermal dan tablet Android terhubung ke WiFi/LAN yang sama
3. Cari IP address printer:
   • Cetak self-test (tahan tombol Feed saat nyalakan printer)
   • IP tercetak di struk, contoh: 192.168.1.105
4. Atur IP printer menjadi statis di router (DHCP reservation berdasarkan MAC address printer) — agar IP tidak berubah setiap restart
5. Buka app Android FirstJournal → POS → Outlet → Inventaris Printer
6. Klik + Tambah Printer → pilih Cara Sambung LAN / WiFi warung → isi nama, IP address, dan lebar kertas
7. Klik Tes Cetak pada kartu printer tersebut untuk verifikasi

💡 IP Statis penting: Jika IP printer berubah setiap kali di-restart, koneksi akan putus. Selalu atur IP statis via pengaturan router.

🔀 Kombinasi struk LAN + label Bluetooth di 1 device: tambahkan 2 printer terpisah di Inventaris Printer yang sama — satu dengan Cara Sambung LAN / WiFi warung untuk struk, satu lagi dengan Cara Sambung Printer kecil Bluetooth untuk label. Keduanya berjalan independen di tablet/HP yang sama, tanpa saling mengganggu.

Setiap outlet memiliki Inventaris Printer yang independen. Jika bisnis Anda memiliki beberapa outlet, atur printer di masing-masing outlet secara terpisah.

• Ukuran struk: 58mm (struk kecil) atau 80mm (struk standar) — diatur PER PRINTER (bukan per outlet) saat menambah/mengedit printer di POS → Outlet → Inventaris Printer
• Auto-print saat selesai transaksi: tersedia untuk printer dengan Cara Sambung Bluetooth dan Printer Jaringan
• Cetak KOT (Kitchen Order Ticket): khusus F&B — printer dapur mencetak daftar item masakan setiap ada pesanan baru. Diatur saat menambah/mengedit printer (pilih Station/Role "Dapur" atau "Bar")

Selain memilih cara mencetak (mode di atas), Anda juga bisa mengatur tampilan dua jenis cetakan secara terpisah:

• Template Struk — tampilan struk yang dicetak untuk pelanggan: header/tagline, footer, tampilkan/sembunyikan alamat outlet, banner promo, dan bahasa.
• Template Tiket Dapur (KOT) — tampilan tiket yang dicetak ke printer dapur/bar setiap ada pesanan: judul tiket (default "TIKET DAPUR"), footer opsional, dan tampilkan/sembunyikan nama outlet, tipe order, nomor meja, serta nama pelanggan.

Keduanya diatur per-outlet, berlaku otomatis ke semua mode cetak di atas (Browser Print, Bluetooth, Printer Jaringan, LAN Langsung) — tidak perlu diatur ulang per mode.

Rincian diskon per item (otomatis, tidak perlu diatur): pada struk dan bill, item yang mendapat diskon (diskon manual per item, promo seperti Happy Hour, atau promo persen untuk semua item) menampilkan harga sebelum diskon, nominal dan persen diskon, lalu Setelah diskon. Item tanpa diskon tampil seperti biasa. Diskon yang berlaku untuk seluruh pesanan (potongan Rp tetap, voucher, poin, member) tetap tampil di baris bawah. Preview Struk dan Preview Bill di halaman template sudah menampilkan contoh item berdiskon.

Cara Buka

1. Buka POS → Outlet → [nama outlet] → Printer & Dapur
2. Klik kartu Template Struk untuk mengatur tampilan struk pelanggan, atau kartu Template Tiket Dapur untuk tampilan tiket dapur
3. Ubah field yang diinginkan — preview di sisi kanan langsung menunjukkan hasilnya persis seperti yang akan tercetak
4. Klik Simpan Pengaturan

💡 Contoh pakai Template Tiket Dapur: kalau outlet Anda tidak pernah pakai nomor meja (misalnya toko take-away saja), matikan toggle "Tampilkan nomor meja" supaya tiket dapur lebih ringkas dan hemat kertas.

❓ Status printer tetap "Belum terhubung"

1. Sudahkah printer di-restart setelah mengubah URL Polling?
2. URL yang di-paste lengkap dan benar (tidak ada spasi/karakter hilang)?
3. Coba akses firstjournal.id dari browser di jaringan yang sama dengan printer — jika tidak bisa, berarti printer tidak punya akses internet
4. Cek firewall router — koneksi keluar (outbound HTTPS) harus diizinkan
5. Tunggu 30 detik setelah restart, baru cek status lagi

❓ Bluetooth tidak muncul / tidak bisa connect

Kalau pakai browser (Chrome/Edge):

1. Pastikan pakai browser Chrome atau Edge (bukan Safari atau Firefox)
2. Bluetooth di perangkat sudah ON?
3. Printer dalam mode pairing (lampu berkedip)?
4. Jika sebelumnya pernah connect tapi kini gagal: klik Hapus printer lama di halaman pengaturan, lalu sambungkan ulang
5. Coba refresh halaman pengaturan printer
6. Printer Anda mungkin Bluetooth Classic, bukan BLE — jalur browser tidak mendukung Classic sama sekali. Gunakan app Android FirstJournal sebagai gantinya (lihat Mode 2 di atas).

Kalau pakai app Android FirstJournal:

1. Bluetooth di HP/tablet sudah ON dan izin Bluetooth untuk app sudah diberikan?
2. Printer dalam jangkauan dan menyala?
3. Coba Cari Printer Bluetooth ulang — printer tidak selalu langsung muncul di percobaan pertama
4. Untuk printer Classic: kalau muncul dialog pairing/PIN dari Android saat Tes Cetak, pastikan dikonfirmasi/diisi, jangan diabaikan atau ditutup
5. Fitur ini masih baru (per 29 Agustus 2026) dan belum diuji di semua model printer/HP — kalau tetap gagal setelah langkah di atas, laporkan ke tim support dengan menyebutkan merek/model printer

❓ Struk terlalu lebar / teks terpotong

• Struk terlalu sempit (teks terpotong) → printer 80mm tapi diset 58mm — ubah ke 80mm di pengaturan
• Struk punya margin putih besar di kanan → printer 58mm tapi diset 80mm — ubah ke 58mm
• Untuk Browser Print: sesuaikan ukuran kertas di dialog cetak sistem

❓ Tes Cetak berhasil, tapi order tidak auto-cetak

• Pastikan mode cetak tersimpan sebagai Printer Jaringan (bukan Browser Print)
• Cek apakah fungsi printer sudah sesuai: printer Dapur hanya cetak KOT, printer Kasir hanya cetak struk
• Coba restart printer dan tunggu 30 detik

❓ Mode LAN Langsung tidak bisa cetak

1. Pastikan pakai app Android (bukan browser)
2. IP address printer benar? Cetak self-test untuk konfirmasi
3. Tablet Android dan printer dalam jaringan WiFi yang sama?
4. IP printer sudah statis? Jika tidak, set static IP di router
5. Port 9100 diblokir firewall? Cek pengaturan router

Apakah bisa punya lebih dari 1 printer per outlet? Ya. Di mode Printer Jaringan, Anda bisa menambahkan beberapa printer sekaligus — misalnya 1 Printer Kasir + 1 Printer Dapur + 1 Printer Bar. Setiap printer akan mencetak jenis dokumen yang sesuai fungsinya secara otomatis.

Apakah printer thermal biasa (bukan SDP/CloudPRNT) bisa dipakai? Ya, lewat Browser Print (langsung dari driver) atau Bluetooth (jika punya fitur BLE). Mode Printer Jaringan hanya untuk printer yang support protokol SDP atau CloudPRNT.

Berapa delay cetak di mode Printer Jaringan? Rata-rata 2–5 detik setelah order dikonfirmasi. Printer polling setiap 3 detik secara default.

Apakah bisa cetak struk saat offline? Di mode Browser Print dan Bluetooth: struk bisa dicetak dari cache lokal. Di mode Printer Jaringan: tidak bisa (butuh internet). Di mode LAN Langsung: bisa (100% offline).

Apakah iOS (iPhone/iPad) bisa pakai Bluetooth Printer? Tidak jika menggunakan browser Safari. Safari tidak mendukung WebBluetooth. Alternatif untuk iPad: gunakan Browser Print atau Printer Jaringan.

Apakah semua jenis printer Bluetooth didukung? Tergantung dari mana FirstJournal dibuka. Lewat browser (Chrome/Edge): hanya BLE. Lewat app Android FirstJournal: BLE dan Classic (SPP) — mencakup mayoritas printer thermal murah generik yang beredar di marketplace, yang biasanya justru Classic bukan BLE. Kalau tidak yakin jenis printer Anda, cara termudah cek: kalau printer harus dipasangkan dulu lewat menu Bluetooth Settings HP baru muncul di app lain, itu tandanya Classic — di app Android FirstJournal, tidak perlu langkah itu, tinggal "Cari Printer Bluetooth" langsung dari dalam app.