Cara Menggunakan Halaman Ini

Temukan gejala yang paling mirip dengan masalah Anda, ikuti langkah diagnosisnya dari atas ke bawah. Jika masalah belum teratasi setelah semua langkah, hubungi manajer atau tim dukungan teknis.

---

Printer Tidak Mencetak Struk

Gejala: Setelah pembayaran berhasil, struk tidak keluar. Atau tombol Test Cetak tidak menghasilkan apapun.

Langkah Diagnosis

1. Periksa koneksi printer:

   • Printer LAN: pastikan printer dan tablet berada di jaringan WiFi yang sama. Ping IP printer dari pengaturan jaringan bila memungkinkan.
   • Printer Bluetooth: buka Pengaturan → Perangkat → Printer dan periksa apakah printer tampil sebagai Terhubung. Bila tidak, tekan Hubungkan Ulang.

2. Periksa konfigurasi printer di POS:

   • Buka Pengaturan → Perangkat → Printer.
   • Pastikan printer yang benar sudah dipilih sebagai printer kasir.
   • Tekan Test Buka Laci atau Test Cetak — jika printer merespons di sini tapi tidak saat transaksi, masalahnya ada di routing.

3. Periksa routing stasiun:

   • Di dashboard merchant, manajer bisa mengatur printer mana yang mencetak tiket kasir vs tiket dapur.
   • Pastikan perangkat kasir ini sudah dikaitkan ke stasiun yang benar dengan printer kasir yang sesuai.

4. Kertas habis atau macet:

   • Periksa sisa kertas di printer. Masukkan kertas baru bila perlu. Bersihkan kertas yang macet dengan hati-hati.

5. Restart printer:

   • Matikan printer, tunggu 10 detik, nyalakan kembali. Sambungkan ulang dari POS.

Tips: Jika printer berhasil cetak saat Test Cetak tapi tidak saat transaksi nyata, kemungkinan masalah ada di template struk — hubungi manajer untuk memeriksa konfigurasi template di dashboard.

---

Tidak Sinkron / Data Tidak Diperbarui

Gejala: Menu lama masih muncul padahal sudah diubah manajer. Pesanan dari perangkat lain tidak muncul. Indikator koneksi menunjukkan Terputus atau Menghubungkan kembali terlalu lama.

Langkah Diagnosis

1. Periksa koneksi jaringan perangkat:

   • Buka pengaturan WiFi/data perangkat. Pastikan terhubung ke jaringan yang benar.
   • Coba buka browser dan akses website — bila tidak bisa, masalah ada di jaringan, bukan di POS.

2. Lihat indikator status di app bar:

   • Terputus (abu-abu): tidak ada koneksi → sambungkan perangkat ke jaringan.
   • Menghubungkan kembali (kuning, sudah lama): koneksi ada tapi SSE bermasalah → coba langkah berikutnya.

3. Lakukan sinkron manual:

   • Di halaman yang mendukung, geser layar ke bawah (pull-to-refresh).
   • Atau buka Pengaturan → Sinkronisasi → Sinkron Sekarang.

4. Paksa refresh koneksi:

   • Tutup aplikasi sepenuhnya (hapus dari recent apps), buka kembali.
   • Ini akan membangun ulang koneksi SSE dari nol.

5. Periksa apakah server sedang dalam pemeliharaan:

   • Hubungi manajer atau tim teknis untuk konfirmasi status server.

Perhatian: Data yang dibuat saat offline tidak hilang — tersimpan di antrian lokal dan akan dikirim saat koneksi pulih. Jangan paksa restart perangkat bila masih ada transaksi yang belum terkirim.

---

PIN Terkunci (Lockout)

Gejala: Muncul pesan "Akun terkunci, coba lagi dalam X detik/menit" di layar login PIN.

Penjelasan

POS menerapkan proteksi brute-force: setelah 3 kali salah PIN berturut-turut, akun dikunci sementara. Durasi kunci meningkat setiap kali gagal lebih lanjut:

Solusi

1. Tunggu hingga hitungan mundur selesai, lalu coba lagi dengan PIN yang benar.
2. Jika lupa PIN, tekan Lupa PIN di halaman login → ikuti proses reset via email atau WhatsApp OTP.
3. Jika tidak ada akses ke email/WA terdaftar, hubungi manajer untuk reset PIN dari dashboard merchant (Karyawan → Edit → Reset PIN).

Tips: Kunci PIN tersimpan per perangkat dan per akun — kunci di Tablet A tidak memengaruhi login di Tablet B.

---

Fake GPS Terdeteksi saat Absen

Gejala: Muncul pesan "Fake GPS Terdeteksi! Tidak dapat absen." saat mencoba Absen Masuk atau Absen Pulang.

Penjelasan

POS mendeteksi aplikasi GPS palsu (mock location) yang sering digunakan untuk memalsukan lokasi absensi. Demi integritas data absensi, absen tidak bisa dilakukan selama GPS palsu aktif.

Solusi

1. Buka Pengaturan perangkat Android → Opsi Pengembang (Developer Options).
2. Temukan Pilih aplikasi lokasi tiruan (Mock location app) atau Izinkan lokasi tiruan.
3. Set ke Tidak ada atau nonaktifkan.
4. Keluar dari POS dan buka kembali, coba absen ulang.

Jika Anda tidak pernah mengaktifkan GPS palsu dan pesan ini muncul, kemungkinan ada aplikasi pihak ketiga yang mengaktifkannya di latar belakang. Periksa daftar aplikasi yang terpasang dan hapus yang mencurigakan.

Perhatian: Jika ada kondisi khusus di mana lokasi memang perlu di-override (misalnya jaringan GPS di gedung buruk), hubungi manajer untuk melakukan Koreksi Absensi Manual dari dashboard.

---

Laci Kas Tidak Terbuka

Gejala: Setelah transaksi tunai berhasil, laci tidak terbuka. Atau tombol Buka Laci / Buka Laci (No-Sale) tidak bereaksi.

Langkah Diagnosis

1. Periksa koneksi printer kasir:

   • Laci kas biasanya terhubung ke printer melalui kabel RJ-11. Pastikan printer kasir terhubung dan menyala — laci membuka melalui sinyal dari printer.
   • Jika printer tidak merespons, laci pun tidak akan terbuka.

2. Uji coba laci:

   • Buka Pengaturan → Perangkat → Printer → tekan Test Buka Laci.
   • Jika laci terbuka di sini tapi tidak saat transaksi, kemungkinan ada masalah di konfigurasi routing pembayaran tunai.

3. Periksa konfigurasi laci di merchant:

   • Manajer bisa memeriksa apakah opsi Buka laci saat pembayaran tunai aktif di pengaturan perangkat di dashboard.

4. Kabel laci:

   • Periksa kabel RJ-11 antara laci dan printer — pastikan tidak longgar atau rusak.

---

Tiket Dapur Tidak Muncul di KDS

Gejala: Kasir atau pelayan sudah menekan Kirim ke Dapur, tapi layar dapur tidak menampilkan tiket baru.

Langkah Diagnosis

1. Periksa apakah kitchenEnabled aktif:

   • Fitur alur dapur hanya aktif jika manajer mengaktifkan pengaturan KDS/Alur Dapur di dashboard merchant untuk cabang ini.
   • Jika nonaktif, pesanan tidak akan dikirim ke KDS — dianggap langsung siap.
   • Hubungi manajer untuk memeriksa Pengaturan Dapur di dashboard.

2. Periksa akses perangkat KDS:

   • Perangkat dapur perlu login dengan akun yang memiliki peran Dapur atau akses aplikasi display.
   • Jika login dengan akun yang salah, KDS Board tidak terlihat.

3. Periksa koneksi KDS:

   • Lihat indikator status di layar dapur — bila Terputus, tiket tidak akan masuk real-time.
   • Lakukan pull-to-refresh di halaman Antrian Pesanan untuk menarik tiket yang mungkin terlewat.

4. Periksa routing printer/stasiun:

   • Jika menggunakan routing per-stasiun, pastikan item yang dipesan memiliki kategori yang dikaitkan ke stasiun dapur yang benar.
   • Item yang tidak dikaitkan ke stasiun manapun mungkin tidak dikirim ke KDS.

Tips: Bila masalah terjadi pertama kali setelah perubahan konfigurasi dari merchant, minta kasir melakukan Sinkron Manual agar konfigurasi terbaru diterapkan.