Bantuan & Referensi
Pemecahan Masalah Umum
Solusi cepat untuk masalah yang paling sering ditemui: tampilan tidak update, printer tidak cetak, stok tidak sesuai, pesanan tidak masuk, dan akses login.
Tampilan Dashboard Tidak Update (Cache PWA)
Gejala: Perubahan menu, harga, atau pengaturan yang baru disimpan tidak muncul di layar, padahal sudah di-refresh.
Penyebab: Dashboard merchant adalah Progressive Web App (PWA) yang menggunakan service worker untuk menyimpan aset di cache browser. Setelah pembaruan sistem, browser mungkin masih menampilkan versi lama dari cache.
Solusi:
- Lakukan hard refresh: tekan
Ctrl + Shift + R(Windows/Linux) atauCmd + Shift + R(Mac). - Jika belum berhasil, buka DevTools browser → tab Application → Service Workers → klik Unregister, lalu refresh halaman.
- Sebagai alternatif: buka Settings browser → Clear browsing data → centang Cached images and files → hapus.
- Tunggu beberapa detik hingga halaman memuat ulang sepenuhnya.
Tips: Jika ada notifikasi banner "Pembaruan tersedia — muat ulang?" di bagian atas dashboard, klik tombol tersebut untuk memperbarui ke versi terbaru secara otomatis.
Printer Tidak Mencetak Struk atau Label
Gejala: Klik cetak di POS atau dashboard tidak menghasilkan cetakan; tidak ada error, tapi struk tidak keluar.
Langkah diagnosa:
- Cek koneksi printer — pastikan printer menyala, kertas tersedia, dan kabel LAN/Wi-Fi terhubung ke jaringan yang sama dengan perangkat POS.
- Cek konfigurasi printer — buka Printer & Struk → Printer dan pastikan printer sudah terdaftar dengan alamat IP yang benar.
- Cek stasiun cetak — buka Printer & Struk → Stasiun Cetak dan pastikan ada stasiun yang aktif untuk jenis dokumen yang ingin dicetak (struk kasir, struk dapur, label).
- Cek routing cetak — buka Printer & Struk → Routing Cetak dan pastikan kategori menu yang dipesan sudah di-routing ke stasiun yang benar.
- Gunakan Simulator — buka Printer & Struk → Simulator Routing untuk menguji apakah pesanan dengan menu tertentu akan diteruskan ke printer yang diharapkan.
- Cek riwayat cetak — buka Printer & Struk → Riwayat Cetak untuk melihat apakah ada percobaan cetak yang gagal beserta pesan error-nya.
Perhatian: Jika printer berada di subnet jaringan yang berbeda dari perangkat POS (misalnya beda VLAN), printer tidak akan bisa dijangkau. Pastikan semua perangkat berada di jaringan yang sama.
Stok Tidak Sesuai dengan Kondisi Fisik
Gejala: Sistem menampilkan stok yang berbeda dari jumlah fisik bahan baku di gudang/dapur.
Penyebab umum dan solusi:
| Penyebab | Solusi |
|---|---|
| Penerimaan barang belum diinput | Input Purchase Order yang sudah diterima di Inventori → Purchase Order |
| Ada bahan terbuang yang belum dicatat | Catat waste di Inventori → Waste / Susut |
| Transfer stok antar cabang belum diproses | Selesaikan transfer di Inventori → Transfer Stok |
| Resep (recipe) belum dikonfigurasi | Periksa konfigurasi bahan olahan di Pengaturan Menu → Bahan Olahan |
| Selisih tidak diketahui penyebabnya | Lakukan Stok Opname di Inventori → Stok Opname untuk menyesuaikan stok fisik |
Tips: Jadwalkan stok opname minimal seminggu sekali untuk menjaga akurasi data stok. Selisih yang kecil dan terus-menerus sering mengindikasikan kebocoran atau kesalahan input resep.
Pesanan dari Web Order / Kiosk Tidak Masuk ke POS
Gejala: Tamu melaporkan sudah memesan, tapi pesanan tidak muncul di POS atau KDS.
Langkah diagnosa:
- Cek koneksi internet perangkat POS — POS memerlukan koneksi aktif untuk menerima pesanan online. Jika koneksi terputus, POS beroperasi dalam mode offline dan pesanan online tertunda.
- Cek aktivasi Web Order / Kiosk — pastikan saluran penjualan aktif di Saluran Penjualan → Web Order atau Kiosk → Pengaturan. Jika ada jadwal tutup sementara yang aktif, pesanan tidak akan diterima.
- Cek status perangkat — buka Langganan & Tagihan → Perangkat & Lisensi dan pastikan device seat perangkat POS masih aktif (tidak kedaluwarsa).
- Restart aplikasi POS — tutup dan buka kembali aplikasi POS untuk memperbarui koneksi SSE (Server-Sent Events) yang digunakan untuk notifikasi pesanan real-time.
- Cek daftar transaksi — buka Dashboard → Daftar Transaksi di dashboard merchant. Jika pesanan muncul di sini tapi tidak di POS, masalahnya ada di sinkronisasi perangkat POS.
Lupa Password atau Akun Terkunci
Gejala: Tidak bisa login ke dashboard merchant karena lupa password atau terlalu banyak percobaan salah.
Solusi:
- Di halaman login dashboard, klik Lupa Password?
- Masukkan alamat email akun Anda.
- Cek email masuk (dan folder Spam) untuk link reset password.
- Klik link reset → masukkan password baru → login kembali.
Jika akun terkunci sementara karena terlalu banyak percobaan salah, tunggu beberapa menit sebelum mencoba lagi. Lockout bersifat sementara dan akan terbuka otomatis.
Untuk reset PIN kasir di POS: PIN kasir dikelola terpisah dari password dashboard. Hubungi Owner atau Admin untuk mereset PIN karyawan melalui Hak Akses → User di dashboard.
Menu atau Fitur Tidak Muncul di Sidebar
Gejala: Menu tertentu (misalnya Inventori, Kepegawaian, atau Reservasi) tidak muncul di sidebar meskipun merasa sudah berlangganan.
Kemungkinan penyebab:
| Penyebab | Cara Cek | Solusi |
|---|---|---|
| Fitur belum aktif di paket | Buka Langganan → Ringkasan, lihat enabled_features | Upgrade paket atau aktifkan add-on |
| Mode Semua Usaha aktif | Lihat tombol scope di navbar atas | Pilih brand tertentu di scope switcher |
| Role tidak memiliki akses | Tanyakan Owner/Admin | Owner grant akses menu di Hak Akses → User |
| Feature flag brand dinonaktifkan | Cek Pengaturan Cabang → Brand | Aktifkan feature flag yang relevan di pengaturan brand |
Lihat juga artikel Memahami Paket & Fitur Aktif untuk penjelasan lebih lengkap tentang feature gating.
Perangkat POS Tidak Bisa Sinkronisasi / Offline
Gejala: Perangkat POS menampilkan status offline; data menu atau pesanan tidak tersinkronisasi.
Solusi:
- Periksa koneksi Wi-Fi — pastikan perangkat terhubung ke jaringan yang memiliki akses internet.
- Periksa lisensi device seat — buka Langganan & Tagihan → Perangkat & Lisensi. Jika seat perangkat kedaluwarsa, perbarui langganan device.
- Restart perangkat — matikan dan nyalakan kembali perangkat POS, lalu buka aplikasi POS kembali.
- Mode offline POS — FnB POS memiliki kemampuan offline untuk transaksi tunai (data tersimpan lokal dan disinkronisasi saat koneksi pulih). Namun, pesanan Web Order dan notifikasi real-time memerlukan koneksi aktif.
Perhatian: Jika perangkat sudah lama offline dan ada banyak transaksi tertunda, biarkan proses sinkronisasi selesai sepenuhnya sebelum menutup aplikasi. Menutup paksa dapat menyebabkan sebagian data tidak tersinkronisasi.