Troubleshooting

Gejala: Pembayaran selesai tapi KOT tidak keluar dari printer dapur

1. Cek Pengaturan → Printer Bluetooth: apakah Printer KOT (Dapur) sudah di-pair?
2. Kalau belum di-set, KOT akan fallback ke Printer Thermal (Struk) — set Printer KOT terpisah
3. Pastikan Status Bluetooth: Aktif + permission Bluetooth granted
4. Restart printer dapur (matikan, nyalakan lagi) — Bluetooth thermal printer kadang perlu re-pair
5. Tap Cetak KOT dari Detail Transaksi (Riwayat) untuk reprint manual
6. Pastikan jarak HP ke printer dapur < 10m tanpa halangan tembok beton
7. Kalau muncul "Izin Bluetooth tidak diberikan" — buka Setting Android → Apps → Kasgo F&B → Permissions → grant Bluetooth

Gejala: Menu yang seharusnya punya Add-on tidak menampilkan dialog modifier

1. Buka detail produk → cek section Modifier / Add-on
2. Pastikan ada modifier group yang ter-link (tap Kelola ungu untuk lihat & assign)
3. Toggle Modifier/Add-on di form produk harus ON
4. Pastikan Modifier Group statusnya Aktif (cek di Hub Produk → Modifier/Add-on)
5. Pastikan minimal 1 opsi dalam group (ada chip "Pilih Satu" atau "Multi" + opsi)
6. Di kasir, dialog Add-on/Modifier sifatnya collapsible — perlu di-tap untuk expand. Cek apakah produk punya badge oranye ADD-ON di card kasir

Gejala: Menu terjual tapi stok bahan tidak ter-deduct otomatis

1. Buka detail produk → section Bahan Baku → tap Kelola
2. Pastikan ada bahan-bahan dalam resep (tidak boleh empty state "Belum ada resep")
3. Kalau produk punya varian, setiap varian harus punya resep sendiri
4. Cek Laporan → Bahan per Transaksi — apakah ada entry untuk transaksi tersebut?
5. Kalau tidak ada entry, kemungkinan resep belum di-setup saat transaksi terjadi (setup resep tidak retroaktif)
6. Untuk Bahan Olahan: stok yang turun adalah stok Olahan, bukan Bahan Mentah-nya. Stok Mentah baru turun saat produksi Bahan Olahan

Gejala: Meja masih Terisi (merah) padahal customer sudah bayar & pergi

1. Pastikan Pesanan Terbuka di meja sudah benar-benar diselesaikan (Proses Pembayaran atau dihapus)
2. Cek di kasir → tab Pesanan Terbuka — kalau masih ada untuk meja itu, selesaikan dulu
3. Kalau berkaitan dengan Reservasi, pastikan reservasi sudah di-tap Selesai (status terakhir) — meja akan auto-balik ke Tersedia
4. Workaround: edit meja dari Pengaturan → Manajemen Meja → tap meja → ubah status manual

Gejala: Nomor antrian kemarin masih lanjut di hari ini

1. Reset otomatis terjadi saat aplikasi membuat order Take Away pertama di hari baru (setelah tengah malam)
2. Kalau HP tidak terbuka kasirnya saat tengah malam, reset terjadi di order Take Away pertama keesokan harinya
3. Kalau masih masalah, restart aplikasi (force close + buka ulang)
4. Cek Pengaturan → Pengaturan Nomor Antrian — pastikan ada konfigurasi yang aktif

Gejala: Sistem tolak Proses Pembayaran karena total split tidak sesuai

1. Cek total tagihan (termasuk fee & pajak yang sudah di-apply)
2. Mode Bagi per Nominal: jumlah dari semua entry harus tepat sama dengan total tagihan
3. Mode Bagi per Orang: sistem hitung otomatis (mungkin ada pembulatan untuk angka ganjil)
4. Mode Bagi per Item: pastikan semua item ter-assign ke salah satu pembayar (tidak ada item yang tertinggal)
5. Kalau error masih terjadi: tap Back → Lanjut ke Pembayaran lagi (reset state)

Gejala: Saat login muncul error koneksi server

1. Pastikan internet HP aktif (WiFi atau data seluler) — login butuh internet untuk validasi license
2. Coba buka browser ke kasgo.id — kalau tidak bisa, masalah di koneksi HP
3. Server kasgo mungkin sedang maintenance — tunggu 5-10 menit
4. Kalau license sudah pernah validasi sebelumnya, biasanya bisa login offline (login ulang dengan PIN)
5. Kalau masih error, hubungi Customer Support via WhatsApp dengan info error message

Gejala: Aplikasi keluar sendiri saat dipakai

1. Setting HP → Apps → Kasgo F&B → Clear Cache (JANGAN Clear Data — data akan hilang!)
2. Restart HP
3. Kalau masih crash: backup dulu → uninstall → install APK baru → Restore backup
4. Report bug ke Customer Support via WhatsApp dengan info:
   • Model HP & versi Android
   • Versi aplikasi (Pengaturan → Tentang)
   • Langkah yang dilakukan sebelum crash
   • Screenshot error kalau ada

Gejala: Error saat tap "Backup Sekarang"

1. Cek ruang storage HP — minimal 200MB kosong (kasgo backup file biasanya kecil tapi proses butuh temp space)
2. Grant permission storage di Setting HP → Apps → Kasgo F&B → Permissions
3. Restart HP, coba lagi
4. Kalau masih gagal, coba export via Google Drive (lebih reliable di Android 11+)
5. Cek apakah tab Gambar juga gagal — mungkin masalah specific tab Data atau image

Gejala: Sudah set harga khusus untuk Take Away/Delivery tapi di kasir masih pakai harga Dine-in

1. Cek detail produk → section Informasi Harga → Harga Jual: pastikan kolom Take Away / Delivery sudah diisi (bukan kosong)
2. Kosong artinya pakai harga Dine-in. Isi nominal untuk pakai harga berbeda
3. Di kasir, pastikan Tipe Pesanan dipilih sebelum tambah item — di Step 1 Detail ada card "Tipe Pesanan"
4. Item yang sudah masuk keranjang sebelum ganti Tipe Pesanan akan pakai harga awal — hapus & tambahkan ulang setelah ganti tipe

Gejala: Sudah buat promo tapi diskon tidak otomatis di kasir

1. Cek Hub Produk → Promo/Happy Hour: apakah promo masih aktif?
2. Pastikan jam saat ini dalam range Waktu Mulai - Waktu Selesai
3. Pastikan hari saat ini termasuk di chip Hari Aktif (default Sen-Jum, Sab-Min OFF)
4. Cek Berlaku Untuk:
   • Kategori Tertentu: pastikan menu yang dijual masuk kategori yang dipilih
   • Produk Tertentu: pastikan menu yang dijual ada di list Produk Terpilih
5. Cek jam HP — kalau jam HP salah, sistem tidak detect range dengan benar

Gejala: Pattern selisih kas KURANG konsisten di 1 kasir

1. Buka Laporan → Riwayat Shift → filter per kasir tersebut → review semua shift terakhir
2. Tap card shift → Detail Shift → cek Hitungan Sistem vs Uang Aktual
3. Kalau variance kecil (Rp 5K-10K) konsisten — kemungkinan kasir lupa input pengeluaran tunai kecil (parkir, kresek, dll). Edukasi: catat semua pengeluaran walau kecil
4. Kalau variance besar (> Rp 50K) — review histori transaksi shift item per item, mungkin ada salah hitung kembalian atau salah input qty
5. Kalau pola tetap berlanjut setelah review & edukasi — bicarakan baik-baik dengan kasir, jangan langsung menuduh
6. Pakai Recalculate di Detail Shift kalau ada transaksi yang baru di-update setelah shift tutup

Gejala: Anda bayar cash ke supplier tapi sistem catat hutang otomatis

1. Untuk PO tipe Beli Putus: hutang otomatis dibuat saat Penerimaan Barang — ini default behavior
2. Setelah Penerimaan, langsung bayar di tab Hutang di Detail Supplier (status: Hutang Penuh → Lunas)
3. Untuk supplier yang konsisten dibayar cash di tempat: pertimbangkan pakai PO tipe Konsinyasi kalau memang barang titip jual, atau langsung input pembayaran setelah Penerimaan
4. Tidak ada toggle "Buat Hutang" terpisah di Penerimaan — hutang selalu auto-create untuk Beli Putus

Gejala: Edit resep Bahan Olahan tapi total HPP per Modifier / per Produk masih pakai value lama

1. Bahan Olahan: HPP per porsi auto-hitung dari sub-resep saat di-save
2. Kalau Bahan Olahan sudah di-link ke produk lain, HPP produk akan auto-update saat hitung berikutnya
3. Untuk transaksi yang sudah selesai: HPP transaksi tetap pakai value pada saat itu (tidak retroaktif)
4. Hanya transaksi baru yang akan pakai HPP yang updated
5. Cek Laporan → Margin Produk setelah ada transaksi baru untuk verifikasi

Gejala: Tombol "Proses Refund" disabled atau error

1. Pastikan minimal 1 item dicentang di section "Pilih Item untuk Refund" (atau tap Pilih Semua)
2. TOTAL REFUND harus > Rp0 (tidak bisa refund 0 rupiah)
3. Untuk transaksi BON/Piutang yang belum lunas: lunasi piutang dulu sebelum refund
4. Untuk item yang sudah pernah di-refund parsial sebelumnya: cek "Sisa: x/y" — kalau sudah 0/y artinya semua qty sudah di-refund
5. Catatan Alasan Refund opsional — bisa pilih chip preset atau ketik manual