Semua panduan

Dashboard Merchant

Kelola menu, stok, karyawan, promo, laporan, pengaturan cabang, perangkat, dan langganan.

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.

5 menit baca

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:

  1. Lakukan hard refresh: tekan Ctrl + Shift + R (Windows/Linux) atau Cmd + Shift + R (Mac).
  2. Jika belum berhasil, buka DevTools browser → tab Application → Service Workers → klik Unregister, lalu refresh halaman.
  3. Sebagai alternatif: buka Settings browser → Clear browsing data → centang Cached images and files → hapus.
  4. 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:

  1. Cek koneksi printer — pastikan printer menyala, kertas tersedia, dan kabel LAN/Wi-Fi terhubung ke jaringan yang sama dengan perangkat POS.
  2. Cek konfigurasi printer — buka Printer & Struk → Printer dan pastikan printer sudah terdaftar dengan alamat IP yang benar.
  3. 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).
  4. Cek routing cetak — buka Printer & Struk → Routing Cetak dan pastikan kategori menu yang dipesan sudah di-routing ke stasiun yang benar.
  5. Gunakan Simulator — buka Printer & Struk → Simulator Routing untuk menguji apakah pesanan dengan menu tertentu akan diteruskan ke printer yang diharapkan.
  6. 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:

PenyebabSolusi
Penerimaan barang belum diinputInput Purchase Order yang sudah diterima di Inventori → Purchase Order
Ada bahan terbuang yang belum dicatatCatat waste di Inventori → Waste / Susut
Transfer stok antar cabang belum diprosesSelesaikan transfer di Inventori → Transfer Stok
Resep (recipe) belum dikonfigurasiPeriksa konfigurasi bahan olahan di Pengaturan Menu → Bahan Olahan
Selisih tidak diketahui penyebabnyaLakukan 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:

  1. 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.
  2. 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.
  3. Cek status perangkat — buka Langganan & Tagihan → Perangkat & Lisensi dan pastikan device seat perangkat POS masih aktif (tidak kedaluwarsa).
  4. Restart aplikasi POS — tutup dan buka kembali aplikasi POS untuk memperbarui koneksi SSE (Server-Sent Events) yang digunakan untuk notifikasi pesanan real-time.
  5. 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:

  1. Di halaman login dashboard, klik Lupa Password?
  2. Masukkan alamat email akun Anda.
  3. Cek email masuk (dan folder Spam) untuk link reset password.
  4. 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:

PenyebabCara CekSolusi
Fitur belum aktif di paketBuka Langganan → Ringkasan, lihat enabled_featuresUpgrade paket atau aktifkan add-on
Mode Semua Usaha aktifLihat tombol scope di navbar atasPilih brand tertentu di scope switcher
Role tidak memiliki aksesTanyakan Owner/AdminOwner grant akses menu di Hak Akses → User
Feature flag brand dinonaktifkanCek Pengaturan Cabang → BrandAktifkan 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:

  1. Periksa koneksi Wi-Fi — pastikan perangkat terhubung ke jaringan yang memiliki akses internet.
  2. Periksa lisensi device seat — buka Langganan & Tagihan → Perangkat & Lisensi. Jika seat perangkat kedaluwarsa, perbarui langganan device.
  3. Restart perangkat — matikan dan nyalakan kembali perangkat POS, lalu buka aplikasi POS kembali.
  4. 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.

SebelumnyaEkspor & Impor Data
WhatsApp Kami