Troubleshooting - Panduan KasGo POS

A. Tidak Bisa Login

Gejalanya: PIN selalu ditolak dan Anda tidak bisa masuk.

Pastikan username dan PIN-nya benar. Keduanya membedakan huruf besar dan kecil, jadi periksa juga tombol CAPS LOCK.

Coba beberapa kali, siapa tahu hanya salah ketik.

Bila Anda yakin benar tetapi tetap ditolak, kemungkinan PIN-nya memang terlupa.

Untuk owner — ketuk Lupa PIN di halaman login, masukkan Kode Lisensi, lalu tetapkan PIN baru.
Untuk kasir — owner dapat menyetel ulang PIN-nya lewat Pengaturan → Manajemen User.

B. Produk Tidak Muncul di Kasir

Gejalanya: produknya ada di daftar, tetapi tidak tampil di kasir.

Periksa status produknya. Buka menu Produk, ketuk produknya, dan pastikan Status Aktif menyala. Bila mati, nyalakan lalu simpan.

Gunakan pencarian. Ketik nama produknya di kolom pencarian untuk memastikan ia memang ada.

Periksa filter kategorinya. Produknya mungkin berada di kategori lain; setel ulang filternya agar semua ditampilkan.

Stok nol bukan penyebabnya. Produk berstok nol tetap muncul di kasir dan masih bisa dijual — stoknya menjadi minus. Jadi hal itu tidak berkaitan dengan produk yang tidak muncul.

C. Struk Tidak Tercetak

Gejalanya: pencetakan gagal dan printer tidak mengeluarkan apa pun.

Periksa koneksinya. Buka Pengaturan → Printer Bluetooth, dan pastikan statusnya Terhubung berwarna hijau. Bila tidak, sambungkan ulang.

Periksa printernya. Apakah menyala, apakah kertasnya ada, dan apakah dayanya cukup. Isi ulang daya atau ganti kertasnya bila perlu.

Lakukan uji cetak. Di menu printer, ketuk Test Print. Bila berhasil, printernya baik-baik saja; bila gagal, masalahnya di printer atau koneksinya.

Mulai ulang semuanya. Putuskan koneksi printernya, mulai ulang printernya, mulai ulang HP-nya, sambungkan kembali, lalu coba cetak lagi.

Periksa jaraknya. Dekatkan HP ke printer, sebaiknya tidak lebih dari lima meter. Sinyal Bluetooth dapat terhalang dinding atau benda lain.

Printer mungkin sedang sibuk. Jangan mencetak berkali-kali dengan cepat; tunggu pencetakan sebelumnya selesai.

Printernya mungkin tidak kompatibel. Pastikan ia mendukung ESC/POS, dan cobalah printer lain untuk memastikan.

D. Stok Tidak Sinkron dengan Fisik

Gejalanya: stok di aplikasi berbeda dengan jumlah barang yang sebenarnya.

Lakukan stok opname. Hitung barang fisiknya, lalu catat jumlahnya.

Bandingkan dengan aplikasi. Buka menu Stok, lihat angkanya, dan catat selisihnya.

Sesuaikan secara manual lewat Stok → Penyesuaian Stok, lalu pilih produk yang selisih.

Bila angka aplikasi lebih besar daripada fisiknya, pilih tipe Kurang, masukkan selisihnya, dan beri alasan “Stok Opname”, “Barang Rusak”, atau “Hilang”.
Bila angka aplikasi lebih kecil daripada fisiknya, pilih tipe Tambah, masukkan selisihnya, dan beri alasan “Stok Opname”.

Cari penyebabnya lewat Stok → Riwayat Stok. Saring dengan tab Masuk atau Keluar, atau dengan rentang tanggal. Periksa apakah ada transaksi yang tidak tercatat, barang rusak yang belum dimasukkan, atau kemungkinan pencurian.

Rutinkan stok opname — minimal sebulan sekali, atau seminggu sekali untuk produk yang cepat bergerak. Selisihnya jadi lebih cepat ketahuan.

E. Aplikasi Menutup Sendiri

Gejalanya: aplikasi keluar sendiri, macet, atau menampilkan galat.

Bersihkan cache. Buka Pengaturan HP → Apps → KasGo → Storage → Clear Cache, lalu buka aplikasinya lagi.

Mulai ulang HP-nya, lalu buka aplikasinya.

Pasang ulang aplikasinya bila masih bermasalah — cadangkan datanya dulu, copot pemasangannya, pasang ulang APK-nya, pulihkan dari backup, lalu masuk kembali.

Perbarui aplikasinya. Pastikan Anda memakai versi terbaru.

Laporkan bugnya. Tangkap layar galatnya bila ada, catat langkah sebelum aplikasinya menutup, lalu kirim ke dukungan lewat WhatsApp beserta model HP, versi Androidnya, versi aplikasinya, langkah untuk menirunya, dan tangkapan layarnya.

Jangan menekan Clear Data — yang dibersihkan hanya cache. Clear Data menghapus seluruh data aplikasi Anda.

F. Data Hilang Setelah Update

Gejalanya: setelah aplikasi diperbarui, data produk atau transaksinya tampak hilang.

Sebenarnya data tidak seharusnya hilang saat update. Datanya tersimpan di /data/data/id.kasgo.pos/, dan pemasangan di atas versi lama tidak menghapusnya.

Jangan panik. Periksa dulu seluruh menunya — buka Produk, Riwayat, dan lainnya — untuk memastikan datanya memang benar-benar hilang.

Pulihkan dari backup. Buka Pengaturan → Backup & Restore, lalu pulihkan dari cadangan terakhir sebelum pembaruan.

Bila tidak ada backup, tidak ada cara untuk mengembalikannya.

Agar tidak terulang: wajib mencadangkan sebelum memperbarui, simpan cadangannya di cloud atau HP lain, dan ingat bahwa tanpa backup tidak ada jaminan apa pun.

G. Backup Gagal

Gejalanya: muncul galat saat mencadangkan, dan prosesnya tidak selesai.

Periksa ruang penyimpanannya. Pastikan tersisa minimal 100 MB; hapus berkas yang tidak perlu bila kurang.

Periksa izinnya. Pastikan aplikasi punya izin akses penyimpanan lewat Pengaturan HP → Apps → KasGo → Permissions → Storage → Allow.

Coba lagi. Kadang galatnya hanya sesaat; ketuk Backup Sekarang sekali lagi.

Mulai ulang HP-nya, buka aplikasinya, lalu coba mencadangkan lagi.

Gunakan ekspor ke lokasi eksternal. Buat backupnya dulu lewat menu Backup & Restore, lalu di Histori Backup ketuk tombol Export pada backup itu. Dialog sistem Android terbuka — pilih lokasi penyimpanannya seperti Google Drive, Downloads, atau kartu SD. Cara inilah yang disarankan karena kompatibel dengan Android 11 ke atas.

H. Restore Backup Gagal

Gejalanya: muncul galat saat memulihkan, dan datanya tidak kembali.

Periksa berkas backupnya. Pastikan formatnya sah, dan ukurannya wajar — bukan 0 KB. Bila rusak, pakai cadangan lain.

Periksa asal berkasnya. Ia harus benar-benar berasal dari backup KasGo, dan jangan pernah disunting manual karena bisa membuatnya rusak.

Pastikan berkasnya yang tepat. Berkas terbaru belum tentu yang terbaik — bila datanya sudah rusak sebelum dicadangkan, cadangan yang lebih lama justru lebih berguna.

Pasang ulang aplikasinya bila terus gagal — copot pemasangannya, pasang lagi, lalu pulihkan dari backup.

Laporkan. Bila tetap gagal, hubungi dukungan lewat WhatsApp, dan kirimkan berkas backupnya bila tidak memuat data sensitif.

I. Multi-Kasir: Stok Client dan Server Berbeda

Karena Multi-Kasir memakai stock reservation per Client, stok yang ditampilkan Client kadang berbeda dari Server ketika ada transaksi berbarengan.

Tarik ke bawah di Kasir Client untuk mengambil stok terbaru.

Periksa apakah Client lain sedang menahan stok produk itu karena keranjangnya belum diselesaikan. Tunggu sampai Client tersebut selesai atau membatalkannya.

Periksa Server: apakah ada Penyesuaian Stok atau PO baru yang belum diambil Client.

Mulai ulang aplikasi Client lewat force stop di pengaturan Android, lalu buka lagi; koneksinya tersambung kembali otomatis.

Bila terus berulang, hentikan operasional sejenak, minta semua Client menutup transaksinya, periksa selisihnya di Server, lalu lakukan Penyesuaian Stok bila perlu.

J. Multi-Kasir: Client Gagal Terhubung

Muncul galat “Terputus” atau “Connection refused” ketika Client mencoba terhubung ke Server.

Pastikan kedua HP berada di WiFi atau hotspot yang sama, dengan nama jaringan identik.

Pastikan HP Server berada dalam mode Server, ditandai status “Perangkat ini sebagai server utama”.

Pastikan port 8765 di Server tidak diblokir firewall router.

Pastikan sinyal WiFi-nya cukup kuat di kedua HP.

Coba pindai kode QR dari Server; caranya lebih akurat daripada mengetik IP dan port secara manual.

Bila memakai WiFi router publik, kemungkinan client isolation-nya menyala. Pakai hotspot dari HP Server sebagai jaringan alternatif.

Mulai ulang mode Server — pilih Standalone dulu, tunggu lima detik, lalu pilih Server lagi.

Mulai ulang kedua HP bila tetap tidak tersambung.

K. Aktivasi Lisensi Bermasalah

Kunci lisensi sudah dimasukkan, tetapi muncul galat seperti “License tidak valid”, “Already used”, atau “Connection error”.

“Tidak valid”Kuncinya salah ketik — salin dan tempel dari pesan WhatsApp atau email. Hapus spasi tambahan di awal maupun akhirnya, dan periksa formatnya: biasanya 10 karakter alfanumerik kapital.

“Already used”Lisensinya sudah aktif di perangkat lain. Setel ulang lisensinya di perangkat lama lewat Pengaturan → Pindah ke Device Baru → Reset License. Bila perangkat lamanya hilang, hubungi tim penjualan untuk memindahkan lisensinya secara manual.

“Connection error”Internetnya tidak aktif — periksa WiFi atau data seluler. Bisa juga server aktivasinya sedang tidak tersedia; coba lagi lima menit kemudian. Bila jaringan kantor memblokirnya, coba lewat jaringan lain seperti hotspot HP.

L. Berkas Backup Rusak

Berkas .zip gagal dipulihkan, dengan pesan “File backup tidak valid” atau “Database corrupt”.

Periksa ukuran berkasnya. Backup biasanya berukuran 100 KB sampai 10 MB. Bila 0 KB atau kurang dari 10 KB, berkasnya kosong atau rusak.

Unduh ulang berkasnya dari sumbernya, entah WhatsApp atau Drive — mungkin terpotong saat dikirim.

Coba berkas backup sebelumnya bila ada. Data yang sedikit lebih lama tetap jauh lebih baik daripada hilang seluruhnya.

Pastikan ekstensinya benar-benar .zip, bukan berubah menjadi .download oleh peramban.

Pulihkan di perangkat dengan ruang penyimpanan yang cukup — proses ekstraksinya membutuhkan ruang sekitar dua kali ukuran berkasnya.