Fixes for common problems

Labels in bold are written exactly as they appear in the app.

A bill will not close

• Symptom: a table bill is still in Tagihan Terbuka although the guest left.
• Cause (what can be confirmed): (a) the bill was loaded but not paid: the button is Tutup Tagihan, not Simpan Ulang; (b) the previous shift ended with open bills, which are deliberately not closed automatically; (c) its payment is still queued offline, so the server bill only closes when that sale is sent; (d) a void request is waiting for a manager; (e) the guest left without paying.
• Fix: (a) load the bill from Tagihan Terbuka and Tutup Tagihan; (b) the next cashier closes it; (c) open Lihat on the sync pill and wait or press Sinkron sekarang; (d) a manager approves or rejects in the yellow POS strip; (e) on Denah Lantai pick the table, Tutup tanpa bayar (recorded as a loss). If Transaksi already shows the order as paid but the bill stays open, that is abnormal: do not pay again, report it to support.

A manager cannot approve a void or refund

• Symptom: no approve button, or the manager PIN is refused, or "Belum ada yang memasang PIN persetujuan" (nobody has set an approval PIN).
• Cause: (a) the person lacks Setujui Void; the built-in roles holding them are Owner, Manager and Supervisor, custom roles choose their own and a per-user override can switch them off; (b) the approver has not set a PIN persetujuan void (4 to 8 digits); (c) too many wrong PINs lock it for 15 minutes; (d) refunds are approved on the Permintaan Refund tab, which the Owner and roles holding the approve-refund permission (Manager and Supervisor by default) see; refunds use no PIN.
• Fix: check the Izin tab in the staff detail sheet; have the approver set the PIN under Pengaturan → Akun & keamanan → Keamanan → PIN persetujuan void; wait 15 minutes if locked; for refunds the Owner approves.

Stock does not match the shelf

• Symptom: the app's number differs from the physical count.
• Cause (from the guides): a product without a recipe deducts nothing; an ingredient with Potong stok otomatis saat terjual off is not deducted; a wrong recipe unit (g vs kg); usage not logged (waste, staff meal, complimentary); counting during a rush, when incoming sales create false variances; sales are still allowed at zero stock, so stock can go negative until recounted; sales still queued offline have not reached the server.
• Fix: check the recipe and its units, log usage under Terbuang / dipakai, recount at a quiet hour with Hitung Stok (Opname) and confirm in Riwayat → Rekonsiliasi; make sure Antrian sinkron is empty. A variance is recorded as a Penyesuaian (adjustment) in the stock card.

The kitchen board is empty

• Symptom: the KDS is empty: "Nothing is routed to this station" or "No station has items yet".
• Cause: the screen is not broken; products are not assigned to a station. An Instan product without a station never fires a ticket; a deleted station leaves its products marked Stasiun tidak ada. Every business starts with a Kitchen and a Bar station.
• Fix: open the product, Penjualan & Dapur, choose Perlu Dapur and a Stasiun KDS; on the Products list use the chips Tanpa KDS and KDS · Perlu dicek, or Set stasiun KDS for many products. Stations are created under Pengaturan → Stasiun dapur (KDS).

Staff cannot clock in

• Symptom: no clock chip, no Absen masuk button, or the clock-in is refused.
• Cause: (a) Wajib absen is off for that person, so the chip does not show; (b) Blokir absen is on and the day is unscheduled; (c) the business requires a photo and the device is offline: a clock-in with a photo cannot be queued; (d) wrong active outlet; (e) the clock-in was already sent ("Absen masuk sudah terkirim..." reload and retry); (f) the staff member's Lokasi is limited to another outlet. Bar and kitchen staff use the Absen masuk/pulang button in the KDS header.
• Fix: switch Wajib absen on in the staff sheet, Profil tab; check the Absen di hari libur setting; fill the schedule; get online if a photo is needed; change the outlet picker; check Lokasi. Without a photo and without signal, clock in and out are still queued ("Menunggu sinyal"); breaks need internet.

A Paket is not showing at the POS or QR menu

• Symptom: the package is grey with Habis, cannot be tapped, or is missing from the QR menu.
• Cause: (a) it is outside its selling schedule (days, hours or validity dates): a grey card, "Di luar jam jual" (outside selling hours); (b) an inactive product cannot be a content option; (c) it was never saved, since the Buat Paket guide does not save by itself: save with Simpan in the product form; (d) the QR menu only displays packages, guests cannot order them there ("To order a package, tell the cashier or your server."); if loading fails: "Paket tidak dapat dimuat." with Coba lagi.
• Fix: check the Jadwal step (empty time = all day; hours past midnight count to the start day); activate the content products; press Simpan. Sales already queued offline skip the schedule check when sent (The sync queue, Perlu perhatian and stuck items).

Shift cash variance

• Symptom: a Selisih kas (cash difference) of Kurang (short) or Lebih (over) on a closed shift.
• Cause: expected cash is computed by the server from Kas awal (opening cash), cash sales, refunds (already deducted), Kas masuk and Kas keluar. A difference appears when money leaving or entering the drawer was not logged under Lainnya → Kontrol Kas, the physical count is wrong (a force-ended shift with a count of Rp 0 produces a large shortage), change was wrong on a two-method payment (change comes from the cash part only), or non-cash methods (EDC, QRIS) were compared with the drawer: they are matched against bank statements. Sales still queued offline land on their original shift once sent, so the figure can move afterwards.
• Fix: log every cash withdrawal under Kontrol Kas, count the drawer carefully, get online before closing the shift, read the handover note on a force-ended shift, and use the Selisih per Kasir table to spot patterns.

A sale is not on the server

• Symptom: the sale shows on the cashier device but not in reports or on another device.
• Cause: still queued offline (pill Offline · {n} penjualan menunggu sinkron, receipt BELUM TERSINKRON), or failing repeatedly (Perlu perhatian in Antrian sinkron).
• Fix: get the device online, tap Sinkron sekarang, open Lihat, read the reason. Do not discard an item before checking Transaksi. Do not clear browser data or reinstall while the queue is not empty.

Recipe cost (HPP) does not update

• Symptom: a product's HPP stays put or looks too low.
• Cause: (a) a recipe ingredient has no purchase price (tagged Belum ada harga): when the computed result is zero the old HPP is not overwritten; (b) a product without a recipe has a manually entered cost; (c) the cost field is locked ("Dihitung dari resep", calculated from recipe) while recipe lines exist, so typing there does nothing; (d) variants have no cost of their own, all use the product HPP; (e) the Profitabilitas Menu report uses the cost recorded at sale time, so old sales do not change. The recipes guide does not describe it yet.
• Fix: fill in ingredient purchase prices (use the Ada bahan tanpa harga filter), check units and portion yield, and edit the recipe, not the cost field.

Receipt or printer problems

• Symptom: no receipt, a cut-off receipt, or "Print failed. Printer disconnected".
• Cause: printer disconnected or off; wrong paper width (58 mm or 80 mm): text is cut off or spacing too wide; Bluetooth Classic is not seen by a browser ("This printer cannot be reached from the browser"); a LAN printer on a different wifi; cover open or out of paper; a desktop browser forgets the printer after a reload.
• Fix: under Pengaturan → Printer use Hubungkan Ulang then Cetak Tes; check the paper width; for LAN, Cek koneksi; copy Diagnosa printer for support. Reprint from the transaction history: the data is on the server, not in the printer. Each tablet keeps its own printer.

Fear of a duplicate sale

• Symptom: a slow screen, a cashier pressing Konfirmasi Pembayaran twice, the app reloading after the receipt, or signal lost midway.
• Resending the same key is recognised as the same sale. A paid cart that is restored reuses the same key. The limit, per a code comment: the key only protects a resend of the same sale; two people each charging the same bill count as two separate sales.
• Fix: wait for the receipt; read "Pesanan sudah tercatat ({number})" (order already recorded); before charging again check Transaksi and Tagihan Terbuka. A queue item that is truly a duplicate may be discarded in Antrian sinkron.

How to update the app

• Symptom: a device is still on an old version, or a new feature has not appeared.
• Cause: the automatic update waits until no sale, shift close or queue send is running, and automatic checks run every few hours. In the Android app the new version is used the next time the app opens.
• Fix: tap Perbarui beside the version number (POS Lainnya menu, sidebar, KDS header, device settings). On Android, if needed close the app fully and open it again. The offline queue is not erased by an update.