Panduan Koneksi Printer

Daftar Isi

1. Gambaran Umum Sistem Print
2. Prasyarat
3. Langkah 1 — Pengaturan Printer di Dashboard
4. Langkah 2 — Install & Setup Aplikasi PesanPOS di Android
5. Koneksi via Bluetooth
6. Koneksi via WiFi / LAN
7. Menguji Koneksi
8. Pengaturan Tambahan
9. Troubleshooting

1. Gambaran Umum Sistem Print

Pesan POS menggunakan sistem Print Bridge berbasis polling. Printer tidak terhubung langsung ke browser/dashboard, melainkan melalui aplikasi Android native bernama PesanPOS.

flowchart LR
    A[Dashboard Web] -->|Buat print job| B[(Server Pesan POS)]
    C[Aplikasi PesanPOS Android] -->|Poll setiap 5 detik| B
    B -->|Kirim data ESC/POS| C
    C -->|Print via Bluetooth / WiFi| D[🖨️ Thermal Printer]

Komponen yang terlibat:

2. Prasyarat

Download Aplikasi Printer disini : https://dashboard.pesan.cafe/PesanPos.apk

Sebelum memulai setup printer, pastikan hal-hal berikut sudah terpenuhi:

3. Langkah 1 — Pengaturan Printer di Dashboard

Buka halaman Settings → Printer di dashboard (/settings/printer).

3.1 Salin Printer API Token

Di bagian Thermal Printer (PesanPOS App), Anda akan melihat:

Printer API Token: [xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx]  [📋 Copy]  [🔄 Regenerate]

Cara mendapatkan token:

1. Buka Settings → Printer
2. Token sudah otomatis digenerate saat akun dibuat
3. Klik tombol 📋 Copy untuk menyalin token ke clipboard
4. Atau scan QR Code yang tersedia langsung dari aplikasi PesanPOS

⚠️ Jangan bagikan token ini ke pihak yang tidak berwenang. Token ini memberikan akses untuk mengambil print job dari server Anda.

🔄 Jika token dirasa tidak aman atau dicuri, klik Regenerate untuk generate token baru. Setelah regenerate, aplikasi PesanPOS harus diupdate dengan token baru.

3.2 Salin Server URL

Masih di halaman yang sama, terdapat informasi Server URL:

Server URL: https://dashboard.pesan.cafe  [📋 Copy]

Klik Copy untuk menyalin URL server. URL ini akan dimasukkan ke aplikasi PesanPOS.

3.3 Konfigurasi Ukuran Kertas

Di bagian Paper Size, pilih ukuran kertas yang sesuai dengan printer Anda:

3.4 Aktifkan Kitchen Print (Opsional)

Di bagian Kitchen Print, aktifkan toggle Auto Print Nota Dapur jika Anda ingin struk nota dapur otomatis dicetak saat ada order baru.

Fitur ini membutuhkan Kitchen Tracking diaktifkan di Settings → Tenant.

Klik Save Settings untuk menyimpan.

4. Langkah 2 — Install & Setup Aplikasi PesanPOS di Android

4.1 Install Aplikasi

1. Install file .apk PesanPOS di perangkat Android Anda
2. Izinkan instalasi dari sumber tidak dikenal jika diminta
3. Buka aplikasi PesanPOS

4.2 Setup Pertama Kali (First Run)

Saat pertama kali dibuka, aplikasi akan langsung menampilkan layar Pengaturan Printer & Koneksi dengan banner "Selamat datang!".

Isi kolom-kolom berikut:

Cara mengisi token lebih cepat — Scan QR:

1. Di aplikasi PesanPOS, tekan ikon 📷 di samping kolom Printer API Token
2. Arahkan kamera ke QR code yang ada di halaman Settings → Printer di dashboard
3. Token akan otomatis terisi

5. Koneksi via Bluetooth

Pilih 📱 Bluetooth (paling umum) sebagai cara sambung printer.

flowchart TD
    A[Buka Pengaturan Bluetooth Android] --> B[Pair printer ke HP]
    B --> C[Buka Aplikasi PesanPOS]
    C --> D[Settings - Cara Sambung: Bluetooth]
    D --> E[Klik Perbarui Daftar Printer]
    E --> F{Printer muncul di daftar?}
    F -->|Ya| G[Tap nama printer untuk terhubung]
    F -->|Tidak| H[Pair ulang di Pengaturan Bluetooth Android]
    G --> I[Status: Terhubung - Simpan Pengaturan]
    H --> E

Langkah-langkah Detail:

1. Pair printer ke HP Android terlebih dahulu:
   • Buka Pengaturan Android → Bluetooth
   • Aktifkan printer (biasanya tekan tombol power printer)
   • Cari nama printer di daftar, lalu tap Pair/Sambungkan
   • Masukkan PIN jika diminta (biasanya 0000 atau 1234)
2. Di aplikasi PesanPOS:
   • Pastikan Cara Sambung Printer dipilih: 📱 Bluetooth (paling umum)
   • Tekan tombol 🔄 Perbarui Daftar Printer
   • Izinkan akses Bluetooth jika diminta
   • Daftar printer yang sudah di-pair akan muncul
   • Tap nama printer Anda
3. Konfirmasi koneksi:
   • Status chip akan berubah: Izin BT: OK, Bluetooth: ON, Koneksi: Terhubung
   • Kolom Kode Printer Bluetooth akan terisi otomatis dengan MAC address
4. Klik 💾 Simpan Pengaturan

Catatan: MAC address printer adalah kode unik seperti 00:11:22:33:44:55. Ini tersimpan otomatis saat Anda tap printer dari daftar.

6. Koneksi via WiFi / LAN

Pilih 🌐 WiFi / Kabel LAN sebagai cara sambung printer.

flowchart TD
    A[Pastikan printer dan HP terhubung ke WiFi yang sama] --> B[Buka Aplikasi PesanPOS]
    B --> C[Settings - Cara Sambung: WiFi / Kabel LAN]
    C --> D{Tahu IP printer?}
    D -->|Ya| E[Masukkan IP Printer manual]
    D -->|Tidak| F[Tekan Cari Printer di Jaringan]
    F --> G[Pilih printer dari hasil pencarian]
    G --> H[Port otomatis terisi 9100]
    E --> H
    H --> I[Simpan Pengaturan]

Langkah-langkah Detail:

1. Pastikan HP Android dan printer berada di jaringan WiFi yang sama
2. Di aplikasi PesanPOS:
   • Pilih Cara Sambung Printer: 🌐 WiFi / Kabel LAN
   • Isi Alamat IP Printer (contoh: 192.168.1.50)
   • Port default: 9100 (biarkan default kecuali printer Anda berbeda)
3. Atau gunakan fitur auto-scan:
   • Tekan 🔍 Cari Printer di Jaringan
   • Tunggu beberapa detik, hasil pencarian akan muncul
   • Tap printer yang ditemukan
4. Klik 💾 Simpan Pengaturan

Cara menemukan IP printer:

• Cetak self-test dari printer (biasanya tekan tombol Feed saat menyalakan printer)
• IP akan tercetak di struk test
• Atau cek di router/access point Anda di daftar perangkat yang terhubung

7. Menguji Koneksi

Setelah menyimpan pengaturan, aplikasi akan kembali ke layar utama Listener Dashboard.

7.1 Dashboard Listener

Layar utama menampilkan 4 status card:

7.2 Test Print

Klik tombol 🖨️ Coba Print Struk di bagian bawah layar listener untuk mencetak struk test.

Atau dari halaman Settings di aplikasi, klik 🖨️ Coba Print Struk.

7.3 Refresh Koneksi

Jika status "Tidak dapat terhubung", tekan tombol 🔄 di samping card Koneksi Server untuk memaksa koneksi ulang ke server.

8. Pengaturan Tambahan

Encoding / Jenis Huruf

Pilih encoding yang sesuai agar karakter Indonesia (seperti huruf berdiakritik) tercetak benar:

Mengganti Printer Token

Jika token di dashboard di-regenerate:

1. Buka aplikasi PesanPOS → ⚙️ Pengaturan
2. Hapus token lama di kolom Printer API Token
3. Paste atau scan token baru
4. Simpan Pengaturan

9. Troubleshooting

🔴 "Token tidak valid" di status koneksi

Penyebab: Token di aplikasi tidak sesuai dengan token di server.

Solusi:

1. Buka Settings → Printer di dashboard
2. Salin token terbaru
3. Di aplikasi PesanPOS → ⚙️ Pengaturan → perbarui token
4. Simpan dan tunggu polling berikutnya (maks 5 detik)

🔴 "Belum ada perangkat Bluetooth yang dipasangkan"

Penyebab: Printer belum di-pair ke Android, atau printer mati.

Solusi:

1. Nyalakan printer
2. Buka Pengaturan Android → Bluetooth
3. Scan perangkat dan pair printer
4. Kembali ke aplikasi PesanPOS → Perbarui Daftar Printer

🔴 "Tidak dapat terhubung" ke server

Penyebab: HP tidak ada koneksi internet, atau URL server salah.

Solusi:

1. Pastikan HP memiliki koneksi internet (WiFi atau data seluler)
2. Di aplikasi PesanPOS → ⚙️ Pengaturan
3. Periksa URL Server — harus https://dashboard.pesan.cafe (tanpa garis miring di akhir)
4. Tekan 🔄 di card Koneksi Server untuk reconnect

🔴 Struk tercetak tapi karakter aneh / kotak-kotak

Penyebab: Encoding tidak sesuai dengan printer.

Solusi:

1. Di aplikasi PesanPOS → ⚙️ Pengaturan
2. Ganti Jenis Huruf ke cp850 Indonesia
3. Simpan dan coba print test lagi

🔴 Struk terpotong / terlalu lebar

Penyebab: Ukuran kertas di aplikasi tidak sesuai dengan printer fisik.

Solusi:

1. Samakan ukuran kertas di dua tempat:
   • Dashboard → Settings → Printer → Paper Size
   • Aplikasi PesanPOS → Pengaturan → Ukuran Kertas Struk
2. Keduanya harus menunjukkan nilai yang sama (58mm / 72mm / 80mm)

🔴 Kitchen print tidak tercetak otomatis

Penyebab: Kitchen Print toggle belum diaktifkan, atau Kitchen Tracking belum aktif.

Solusi:

1. Dashboard → Settings → Tenant → pastikan Kitchen Tracking = ON
2. Dashboard → Settings → Printer → aktifkan toggle Auto Print Nota Dapur
3. Klik Save Settings
4. Pastikan aplikasi PesanPOS sedang berjalan dan terhubung

🟡 Struk lama dicetak setelah koneksi ulang

Penyebab: Ada print job lama dalam status pending di server.

Penjelasan: Normal terjadi jika printer sempat offline. Saat koneksi kembali, semua job pending akan dicetak.

💡 Tips: Biarkan aplikasi PesanPOS selalu berjalan di background (jangan force-close) agar tidak ada print job yang terlewat. Notifikasi foreground service di notification bar menandakan aplikasi sedang aktif memantau.