Bantuan → Troubleshooting

Troubleshooting

Solusi untuk masalah yang sering muncul.

🔧Troubleshooting

🔧 Tidak Bisa Login

Gejala: PIN salah terus, tidak bisa masuk

Solusi:

  1. Pastikan username & PIN benar
    • Username & PIN case-sensitive
    • Cek CAPS LOCK
  2. Coba beberapa kali (mungkin salah ketik)
  3. Jika yakin benar tapi tetap salah:
    • Mungkin lupa PIN yang sebenarnya
    • Untuk owner: Tap Lupa PIN di halaman login → masukkan Kode Lisensi → set PIN baru
    • Untuk kasir: Owner bisa reset PIN via Pengaturan → Manajemen User

🔧 Produk Tidak Muncul di Kasir

Gejala: Produk ada di list tapi tidak tampil saat kasir

Solusi:

  1. Cek Status Produk:
    • Buka menu Produk
    • Tap produk
    • Pastikan Status Aktif ON
    • Jika OFF → toggle ON → Simpan
  2. Gunakan Search:
    • Ketik nama produk di search bar
    • Memastikan produk benar-benar ada
  3. Filter Kategori:
    • Mungkin produk di kategori lain
    • Reset filter (tampilkan semua)
  4. Stok 0 Tetap Muncul:
    • Produk stok 0 tetap muncul di kasir
    • Bisa dijual (stok jadi minus)
    • Tidak ada hubungan dengan tidak muncul

🔧 Struk Tidak Tercetak

Gejala: Print gagal, tidak ada output dari printer

1. Cek Koneksi:

  • Menu Pengaturan → Printer Bluetooth
  • Status: Terhubung (hijau)?
  • Jika tidak → Sambungkan ulang

2. Cek Printer:

  • Printer nyala?
  • Ada kertas?
  • Battery/power cukup?
  • Jika tidak → charge/ganti kertas

3. Test Print:

  • Di menu printer, tap Test Print
  • Jika test print berhasil → printer OK
  • Jika test gagal → masalah printer/koneksi

4. Restart:

  • Putuskan koneksi printer
  • Restart printer
  • Restart HP
  • Sambungkan ulang
  • Test print lagi

5. Jarak:

  • Dekatkan HP ke printer (≤5 meter)
  • Bluetooth bisa terhalang dinding/benda

6. Printer Busy:

  • Jangan print berkali-kali cepat
  • Tunggu print selesai baru print lagi

7. Printer Tidak Kompatibel:

  • Pastikan printer support ESC/POS
  • Coba printer lain untuk validasi

🔧 Stok Tidak Sinkron dengan Fisik

Gejala: Stok di aplikasi beda dengan barang fisik

1. Stok Opname (Hitung Fisik):

  • Hitung barang fisik yang ada
  • Catat jumlahnya

2. Bandingkan dengan Aplikasi:

  • Buka menu Stok
  • Lihat stok di aplikasi
  • Catat selisihnya

3. Adjust Manual:

Buka menu Stok → Penyesuaian Stok, pilih produk yang selisih, isi:

  • Jika aplikasi lebih besar dari fisik (fisik lebih sedikit):
    • Tipe Penyesuaian: Kurang
    • Masukkan selisih + Alasan: "Stok Opname" atau "Barang Rusak"/"Hilang"
  • Jika aplikasi lebih kecil dari fisik (fisik lebih banyak):
    • Tipe Penyesuaian: Tambah
    • Masukkan selisih + Alasan: "Stok Opname"

4. Cari Penyebab:

  • Buka Stok → Riwayat Stok untuk lihat pergerakan
  • Filter tab Masuk/Keluar, atau filter tanggal kalender
  • Apakah ada transaksi yang tidak tercatat?
  • Apakah ada barang yang rusak tidak di-input?
  • Apakah ada pencurian?

5. Rutinkan Stok Opname:

  • Minimal sebulan sekali
  • Untuk produk fast-moving: seminggu sekali
  • Deteksi selisih lebih cepat

🔧 Aplikasi Force Close/Crash

Gejala: Aplikasi keluar sendiri, crash, error

1. Clear Cache:

  • Buka Setting HP → Apps → KasGo
  • Storage → Clear Cache
  • Jangan Clear Data (data hilang!)
  • Buka aplikasi lagi

2. Restart HP:

  • Matikan HP
  • Nyalakan lagi
  • Buka aplikasi

3. Reinstall (jika masih crash):

  • BACKUP DULU! (penting!)
  • Uninstall KasGo
  • Install ulang APK
  • Restore dari backup
  • Login

4. Update Aplikasi:

  • Pastikan pakai versi terbaru
  • Update jika ada versi baru

5. Report Bug:

  • Screenshot error (jika ada)
  • Catat langkah sebelum crash
  • Kirim ke Customer Support Via WA:
    • Model HP
    • Versi Android
    • Versi aplikasi
    • Langkah reproduce
    • Screenshot

🔧 Data Hilang Setelah Update

Gejala: Setelah update aplikasi, data (produk/transaksi) hilang

Penyebab:

  • Seharusnya tidak hilang saat update!
  • Data tersimpan di /data/data/id.kasgo.pos/
  • Update (install over) tidak menghapus data

Solusi:

  1. Jangan Panik:
    • Cek dulu semua menu
    • Buka Produk, Riwayat, dll
    • Pastikan benar-benar hilang
  2. Restore dari Backup:
    • Menu Pengaturan → Backup & Restore
    • Restore dari backup terakhir sebelum update
    • Data kembali
  3. Jika Tidak Ada Backup:
    • Tidak ada cara mengembalikan 😢
    • Lesson learned: SELALU backup sebelum update!

Prevent di Masa Depan:

  • WAJIB backup sebelum update
  • Simpan backup di cloud/HP lain
  • Tidak ada backup = tidak ada jaminan

🔧 Backup Gagal

Gejala: Error saat backup, tidak bisa backup

Solusi:

  1. Cek Storage:
    • Pastikan ruang HP cukup (minimal 100MB free)
    • Hapus file tidak perlu jika ruang kurang
  2. Permission:
    • Pastikan aplikasi punya izin akses storage
    • Setting HP → Apps → KasGo → Permissions → Storage → Allow
  3. Coba Lagi:
    • Kadang error sesaat
    • Tap Backup Sekarang lagi
  4. Restart HP:
    • Restart
    • Buka aplikasi
    • Coba backup lagi
  5. Gunakan Export ke Lokasi Eksternal:
    • Buat backup lewat menu Backup & Restore dulu
    • Di Histori Backup, tap tombol Export pada backup tersebut
    • Dialog sistem Android terbuka — pilih lokasi simpan (Google Drive, Downloads, SD card, dll)
    • File tersimpan sesuai lokasi yang dipilih
    • Ini adalah cara yang direkomendasikan karena kompatibel dengan Android 11+ (SAF)

🔧 Restore Backup Gagal

Gejala: Error saat restore, data tidak kembali

Solusi:

  1. Cek File Backup:
    • Pastikan file valid (format .json)
    • Ukuran file wajar (tidak 0 KB)
    • Jika corrupt → gunakan backup lain
  2. Cek Format:
    • File harus dari backup KasGo
    • Jangan edit manual file JSON (bisa corrupt)
  3. Pilih File yang Benar:
    • Pastikan pilih file backup yang sesuai
    • File terbaru mungkin bukan yang terbaik (jika data sudah corrupt sebelum backup)
  4. Reinstall:
    • Jika gagal terus:
    • Uninstall KasGo
    • Install ulang
    • Restore dari backup
  5. Report:
    • Jika tetap gagal → report ke Customer Support Via WA
    • Kirim file backup (jika tidak mengandung data sensitif)

🔄Multi-Kasir: Stok di Client & Server beda

Karena Multi-Kasir pakai stock reservation per Client, kadang stok yang ditampilkan Client tidak sama dengan Server saat ada transaksi paralel.

Solusi:

  1. Pull-to-refresh di Kasir Client untuk fetch stok terbaru.
  2. Cek apakah Client lain ada yang reserve stok produk tersebut (cart belum checkout). Tunggu sampai Client itu selesai atau cancel cart.
  3. Cek Server: apakah ada Penyesuaian Stok atau PO baru yang belum di-fetch Client.
  4. Restart aplikasi Client (force stop di Android Settings → Apps), buka ulang, koneksi auto reconnect ke Server.
  5. Kalau persistent, hentikan operasional sebentar, semua Client tutup transaksi, cek selisih di Server, lakukan Penyesuaian Stok kalau perlu.

📲Multi-Kasir: Client gagal connect ke Server

Error "Terputus" atau "Connection refused" saat Client coba hubungkan ke Server.

Check list:

  1. Kedua HP di WiFi/Hotspot yang sama (SSID identik).
  2. HP Server dalam mode Server (status: "Perangkat ini sebagai server utama").
  3. Port 8765 di Server tidak di-block firewall router.
  4. Sinyal WiFi cukup di kedua HP (cek bar Android).
  5. Coba pakai Scan QR Code dari Server (lebih akurat dari manual IP/port).
  6. Kalau pakai WiFi router publik, kemungkinan client isolation menyala — gunakan Hotspot dari HP Server sebagai WiFi alternatif.
  7. Restart mode Server: pilih Standalone dulu, tunggu 5 detik, pilih Server lagi.
  8. Restart kedua HP kalau tidak juga konek.

🔑Aktivasi License Error

License key di-input, tapi muncul error "License tidak valid" / "Already used" / "Connection error".

Solusi per error:

"Tidak valid":

  • License key salah ketik — copy-paste dari pesan WA/email.
  • Hapus spasi tambahan di awal/akhir.
  • Cek format key — biasanya 10 karakter alfanumerik kapital.

"Already used":

  • License sudah aktif di device lain. Reset license di device lama dulu (Pengaturan → Pindah ke Device Baru → Reset License).
  • Kalau device lama hilang, hubungi sales untuk transfer license manual.

"Connection error":

  • Internet tidak aktif. Cek WiFi/Mobile Data.
  • Server aktivasi sedang down — coba 5 menit lagi.
  • Firewall di jaringan kantor block server aktivasi — coba di jaringan lain (Hotspot HP).

💾File Backup Corrupt / Restore Gagal

File .zip backup gagal restore — pesan "File backup tidak valid" atau "Database corrupt".

Solusi:

  1. Cek file size — file backup biasanya 100KB–10MB. Kalau 0KB atau terlalu kecil (<10KB), file kosong/corrupt.
  2. Download ulang file dari source (WhatsApp / Drive). Mungkin saat kirim file kepotong.
  3. Coba file backup yang sebelumnya (kalau ada cadangan lain). Lebih lama dikit lebih baik daripada hilang total.
  4. Pastikan file extension .zip (bukan ter-rename jadi .download oleh browser).
  5. Restore di device dengan storage cukup (file backup ter-extract butuh space 2× ukuran file).
← Sebelumnya
FAQ