Troubleshooting

Cek Pengaturan → Printer Bluetooth: apakah Printer KOT (Dapur)-nya sudah di-pair?

Kalau ia belum disetel, KOT-nya akan jatuh ke Printer Thermal untuk struk — jadi setel Printer KOT-nya secara terpisah.

Pastikan Status Bluetooth-nya Aktif, dan permission Bluetooth-nya sudah diberikan.

Restart printer dapurnya — matikan lalu nyalakan lagi; Bluetooth thermal printer kadang perlu di-pair ulang.

Ketuk Cetak KOT dari Detail Transaksi di Riwayat, untuk mencetaknya ulang secara manual.

Pastikan jarak HP ke printer dapurnya kurang dari 10m, tanpa terhalang tembok beton.

Kalau muncul “Izin Bluetooth tidak diberikan”, buka Setting Android → Apps → Kasgo F&B → Permissions, lalu berikan izin Bluetooth-nya.

Buka detail produknya, lalu cek bagian Modifier / Add-on.

Pastikan ada modifier group yang ter-link; ketuk Kelola untuk melihat dan meng-assign-nya.

Toggle Modifier/Add-on di form produknya harus menyala.

Pastikan status Modifier Group-nya Aktif; ceknya di Hub Produk → Modifier/Add-on.

Pastikan ada minimal 1 opsi di dalam groupnya — ada chip “Pilih Satu” atau “Multi”, beserta opsinya.

Di kasir, dialog Add-on atau Modifiernya bersifat collapsible, jadi ia perlu diketuk untuk di-expand. Cek juga apakah produknya punya badge oranye ADD-ON di card kasirnya.

Buka detail produknya, masuk ke bagian Bahan Baku, lalu ketuk Kelola.

Pastikan ada bahan-bahan di dalam resepnya; ia tidak boleh berstatus “Belum ada resep”.

Kalau produknya punya varian, setiap variannya harus punya resepnya sendiri.

Cek Laporan → Bahan per Transaksi — apakah ada entri untuk transaksi tersebut?

Kalau entrinya tidak ada, kemungkinan resepnya belum disetel saat transaksinya terjadi; setup resep tidak berlaku retroaktif.

Untuk Bahan Olahan, stok yang turun adalah stok Olahannya, bukan Bahan Mentahnya. Stok Mentahnya baru turun saat Bahan Olahannya diproduksi.

Pastikan Pesanan Terbuka di meja itu sudah benar-benar diselesaikan — lewat Proses Pembayaran, atau dihapus.

Cek di kasir pada tab Pesanan Terbuka; kalau ia masih ada untuk meja itu, selesaikan dulu.

Kalau ia berkaitan dengan Reservasi, pastikan reservasinya sudah diketuk Selesai sebagai status terakhirnya; mejanya akan otomatis kembali ke Tersedia.

Workaround-nya: edit mejanya dari Pengaturan → Manajemen Meja, ketuk mejanya, lalu ubah statusnya secara manual.

Reset otomatisnya terjadi saat aplikasinya membuat order Take Away yang pertama di hari baru, setelah tengah malam.

Kalau kasirnya tidak dibuka saat tengah malam, resetnya terjadi di order Take Away pertama keesokan harinya.

Kalau ia masih bermasalah, restart aplikasinya — force close lalu buka ulang.

Cek Pengaturan → Pengaturan Nomor Antrian, dan pastikan konfigurasinya aktif.

Cek total tagihannya, termasuk fee dan pajak yang sudah diterapkan.

Mode Bagi per Nominal: jumlah dari semua entrinya harus tepat sama dengan total tagihannya.

Mode Bagi per Orang: sistem menghitungnya otomatis, dan mungkin ada pembulatan untuk angka yang ganjil.

Mode Bagi per Item: pastikan semua itemnya ter-assign ke salah satu pembayar, sehingga tidak ada item yang tertinggal.

Kalau errornya masih terjadi, ketuk Back lalu Lanjut ke Pembayaran lagi, untuk me-reset state-nya.

Pastikan internet HP-nya aktif, lewat WiFi atau data seluler; login membutuhkan internet untuk memvalidasi licensenya.

Coba buka browser ke kasgo.id; kalau ia tidak bisa dibuka, masalahnya ada di koneksi HP-nya.

Server kasgo mungkin sedang maintenance — tunggu 5-10 menit.

Kalau licensenya sudah pernah divalidasi sebelumnya, biasanya ia bisa login offline; coba login ulang dengan PIN-nya.

Kalau ia masih error, hubungi Customer Support via WhatsApp beserta info error message-nya.

Buka Setting HP → Apps → Kasgo F&B → Clear Cache. Jangan Clear Data, karena datanya akan hilang.

Restart HP-nya.

Kalau ia masih crash: backup dulu, uninstall, install APK barunya, lalu restore backupnya.

Laporkan bug-nya ke Customer Support via WhatsApp, beserta model HP dan versi Androidnya, versi aplikasinya dari Pengaturan → Tentang, langkah yang dilakukan sebelum ia crash, dan screenshot errornya kalau ada.

Cek ruang storage HP-nya — minimal 200MB kosong. File backup kasgo biasanya kecil, tetapi prosesnya membutuhkan temp space.

Berikan permission storage-nya di Setting HP → Apps → Kasgo F&B → Permissions.

Restart HP-nya, lalu coba lagi.

Kalau ia masih gagal, coba export lewat Google Drive; ia lebih reliable di Android 11+.

Cek apakah tab Gambar-nya juga gagal — mungkin masalahnya spesifik pada tab Data, atau pada imagenya.

Cek detail produknya di bagian Informasi Harga → Harga Jual; pastikan kolom Take Away dan Delivery-nya sudah diisi, bukan dibiarkan kosong.

Kolom yang kosong berarti ia memakai harga Dine-in. Isi nominalnya untuk memakai harga yang berbeda.

Di kasir, pastikan Tipe Pesanan-nya dipilih sebelum itemnya ditambahkan; di Step 1 Detail ada card “Tipe Pesanan”.

Item yang sudah masuk keranjang sebelum Tipe Pesanannya diganti akan tetap memakai harga awalnya — hapus lalu tambahkan ulang setelah tipenya diganti.

Cek Hub Produk → Promo/Happy Hour: apakah promonya masih aktif?

Pastikan jam saat ini berada dalam rentang Waktu Mulai sampai Waktu Selesainya.

Pastikan hari ini termasuk di chip Hari Aktifnya; bawaannya Senin sampai Jumat, sedangkan Sabtu dan Minggu dimatikan.

Cek Berlaku Untuk-nya: untuk Kategori Tertentu, pastikan menu yang dijual masuk ke kategori yang dipilih; untuk Produk Tertentu, pastikan menu yang dijual ada di list Produk Terpilihnya.

Cek jam HP-nya — kalau jamnya salah, sistem tidak mendeteksi rentangnya dengan benar.

Buka Laporan → Riwayat Shift, filter per kasir tersebut, lalu review semua shift terakhirnya.

Ketuk card shiftnya untuk membuka Detail Shift, lalu cek Hitungan Sistem terhadap Uang Aktual-nya.

Kalau variance-nya kecil — Rp 5K sampai 10K — dan konsisten, kemungkinan kasirnya lupa menginput pengeluaran tunai yang kecil, seperti parkir dan kresek. Edukasikan agar semua pengeluaran dicatat, walaupun ia kecil.

Kalau variance-nya besar, lebih dari Rp 50K, review histori transaksi shiftnya item per item; mungkin ada kesalahan menghitung kembalian, atau salah menginput qty-nya.

Kalau polanya tetap berlanjut setelah direview dan diedukasi, bicarakanlah baik-baik dengan kasirnya; jangan langsung menuduh.

Pakai Recalculate di Detail Shift, kalau ada transaksi yang baru di-update setelah shiftnya ditutup.

Untuk PO bertipe Beli Putus, hutangnya otomatis dibuat saat Penerimaan Barang; ini perilaku bawaannya.

Setelah Penerimaannya, langsung bayarkan ia di tab Hutang di Detail Supplier, sehingga statusnya berubah dari Hutang Penuh menjadi Lunas.

Untuk supplier yang konsisten dibayar cash di tempat, pertimbangkan memakai PO bertipe Konsinyasi kalau barangnya memang titip jual; atau langsung input pembayarannya setelah Penerimaan.

Tidak ada toggle “Buat Hutang” yang terpisah di Penerimaan — hutangnya selalu dibuat otomatis untuk Beli Putus.

Untuk Bahan Olahan, HPP per porsinya dihitung otomatis dari sub-resepnya saat ia disimpan.

Kalau Bahan Olahannya sudah di-link ke produk lain, HPP produknya akan ter-update otomatis pada perhitungan berikutnya.

Untuk transaksi yang sudah selesai, HPP transaksinya tetap memakai nilai pada saat itu; ia tidak berlaku retroaktif.

Hanya transaksi yang baru yang akan memakai HPP yang sudah di-update.

Cek Laporan → Margin Produk setelah ada transaksi baru, untuk memverifikasinya.

Pastikan minimal 1 item dicentang di bagian “Pilih Item untuk Refund”, atau ketuk Pilih Semua.

TOTAL REFUND-nya harus lebih besar dari Rp0; refund senilai 0 rupiah tidak memungkinkan.

Untuk transaksi BON atau Piutang yang belum lunas, lunasi piutangnya dulu sebelum ia di-refund.

Untuk item yang sudah pernah di-refund parsial sebelumnya, cek “Sisa: x/y”-nya; kalau ia sudah 0/y, berarti semua qty-nya sudah di-refund.

Catatan Alasan Refundnya opsional — Anda bisa memilih chip presetnya, atau mengetiknya manual.