Mode offline — kasir tetap jalan saat sinyal hilang

Bagian ini menjelaskan fitur yang sudah ada di kode tetapi, saat panduan ini direvisi (7 Sep 2026), belum dipasang ke server produksi. Kalau Anda belum pernah melihat bilah kuning "Mode offline" di aplikasi, berarti versinya belum sampai ke Anda.

Yang bisa dikerjakan tanpa sinyal baru satu, tetapi yang paling penting: mencatat penjualan di Kasir, lengkap dengan pembayarannya. Penjualan disimpan dulu di HP dengan nomor transaksi sementara, lalu dikirim sendiri ke server begitu ada sambungan dan mendapat nomor resmi. Tidak ada yang perlu Anda tekan.

Kapan bilah kuning muncul. Aplikasi menganggap dirinya offline bila HP melapor tidak ada jaringan, atau bila satu saja panggilan ke server tidak sampai — jadi wifi warung yang tersambung tetapi tanpa internet juga dihitung offline. Begitu ada satu panggilan yang berhasil, keadaannya kembali normal sendiri. Bilahnya ada di atas semua halaman aplikasi dan berbunyi:

Mode offline — penjualan tetap tercatat, dikirim otomatis saat tersambung.

Kalau sudah ada yang mengantre, di belakangnya ditambah "· 3 belum terkirim". Saat offline bilah hanya punya tombol Antrean; begitu tersambung dan masih ada yang menunggu, muncul juga Kirim sekarang.

Yang bisa dan tidak bisa saat offline

Bisa	Tidak bisa — tombolnya mati atau butuh sambungan
Kasir: tap produk dari katalog yang tersalin di HP, cari pelanggan lama dari salinan itu, pelanggan baru, jenis pelanggan, item bebas, cabang, catatan	Simpan pesanan dan Simpan draf tagihan di kasir — keduanya hidup di server
Terbitkan tagihan + Sudah dibayar? (Tunai / Transfer / QRIS)	Halaman lain — daftar tagihan, pelanggan, produk, laporan, pengeluaran — membaca data dari server; tanpa sambungan isinya tidak termuat dan muncul "Tidak dapat terhubung ke server. Periksa koneksi Anda."
Melihat & mencetak tagihan sementara dan struk sementara	Bagikan tautan — tautan publik baru ada setelah nomor resmi terbit
Membuka aplikasi tanpa sinyal, asal HP itu pernah masuk saat online dalam 7 hari terakhir	Pengingat & rekap WhatsApp, toko online, ekspor
Halaman Antrean offline	Mencatat pembayaran atas tagihan lama, pengeluaran, pelanggan baru sebagai catatan tersendiri — rencana tahap berikutnya, belum ada

Katalog yang dipakai kasir saat offline adalah salinan yang diperbarui tiap kali Anda online: sesudah masuk, tiap 10 menit selama aplikasi terbuka, dan sesudah setiap antrean terkirim. Harga yang berlaku adalah harga saat Anda menjual (yang tampil di keranjang), bukan harga saat terkirim.

Mencatat penjualan tanpa sinyal

1. Buka Kasir, tap produk seperti biasa, Lanjut.
2. Di layar checkout ada kotak kuning: "Tidak ada sambungan. "Terbitkan tagihan" tetap bisa: penjualan disimpan di perangkat dengan nomor transaksi sementara dan dikirim otomatis saat tersambung. Pesanan dan draf butuh sambungan."
3. Isi Sudah dibayar? kalau uangnya diterima, lalu ketuk Terbitkan tagihan.
4. Muncul "Tersimpan di perangkat sebagai SMT-7F3A — dikirim otomatis saat tersambung." dan Anda dibawa ke halaman Tagihan sementara SMT-7F3A.

Nomor sementara selalu berbentuk SMT- + 4 huruf/angka (tanpa 0, O, 1, I supaya tidak tertukar di kertas struk). Ia hanya nomor tampilan untuk mencocokkan struk dengan antrean — tidak pernah menjadi nomor tagihan; nomor resmi hanya diberikan server.

Tagihan sementara & struk sementara

Halaman tagihan sementara memuat kotak kuning "Nomor sementara — nomor resmi menyusul saat tersambung." beserta keadaannya: "Tidak ada sambungan. Dikirim otomatis begitu sinyal kembali.", "Menunggu dikirim.", "Sedang dikirim…", "Menunggu giliran kirim ulang.", atau — bila ditolak — "Ditolak server: …". Di bawahnya rincian barang, total, dan "Dibayar (Tunai)" bila ada pembayaran. Untuk pelanggan baru tertulis "Pelanggan baru — dibuat di server saat sinkron"; untuk jenis pelanggan berdiskon, "Diskon jenis pelanggan dihitung server saat sinkron — total resmi bisa lebih kecil."

Ketuk Cetak struk sementara (58mm). Struknya sama bentuknya dengan struk biasa, hanya berbeda tiga baris: "No : SMT-7F3A", "** NOMOR SEMENTARA **", dan "Nomor resmi menyusul saat tersambung." Di bawah struk tertulis "Struk ini memakai nomor transaksi sementara dan tetap sah bagi pembeli. Cetak ulang setelah tersambung memakai nomor resmi." Kalau pembeli minta struk bernomor resmi, cetak ulang dari halaman yang sama setelah terkirim: nomornya sudah INV-… dan ada baris "(menggantikan SMT-7F3A)".

Tombol Bagikan tautan sengaja ditampilkan tetapi mati, dengan keterangan "Bagikan tautan aktif setelah tersambung dan nomor resmi terbit."

Halaman Antrean offline (/antrean)

Dari ikon orang di kanan atas → Antrean offline (ada angka kuning kalau masih ada yang menggantung), atau dari tombol Antrean di bilah. Isinya:

Label	Artinya	Yang bisa dilakukan
Menunggu	Disimpan di HP, belum terkirim	Tunggu, atau Kirim sekarang kalau sudah tersambung
Mengirim	Sedang dikirim	Tidak ada — tunggu beberapa detik
Perlu perhatian	Server menolak penjualan ini; alasannya tertulis merah di bawah baris, mis. "Pelanggan tidak ditemukan." atau "Masa langganan berakhir. Hubungi operator untuk mengaktifkan paket."	Coba lagi (setelah penyebabnya dibereskan) atau Hapus — hanya baris ini yang punya tombol Hapus
Terkirim (bagian "Terkirim (7 hari terakhir)")	Sudah masuk pembukuan	Ketuk nomor resminya untuk membuka tagihan. Baris ini hilang sendiri setelah 7 hari; tautan lama tetap mengarah ke tagihan resminya

Tiap baris menampilkan nomor transaksi sementara, nama pelanggan, jam pencatatan, jumlah baris, total, dan "2× dicoba" bila pernah gagal terkirim. Kalau semuanya sudah sampai, halamannya berbunyi "Tidak ada yang menunggu" — "Semua penjualan dari perangkat ini sudah sampai ke server."

Hapus memunculkan "Hapus dari antrean?" dengan peringatan: "SMT-7F3A — Ani, Rp 30.000 — akan dihapus dari perangkat ini dan tidak pernah tercatat di server. Pastikan penjualannya memang batal atau sudah dicatat ulang." Hapus tidak bisa dibatalkan; setelahnya muncul "SMT-7F3A dihapus dari antrean perangkat ini."

Saat tersambung kembali

Antrean dikirim sendiri — saat sinyal kembali, saat Anda kembali ke aplikasi, dan tiap 30 detik selama masih ada yang menunggu — urut sesuai waktu Anda mencatat, supaya nomor resminya berurutan seperti struk yang sudah dicetak. Bilah berganti "Mengirim 3 transaksi…", lalu hijau "Semua terkirim." selama beberapa detik, lalu hilang.

• Kalau Anda sedang berada di halaman tagihan sementara, ia berpindah sendiri ke tagihan resminya dengan pesan "Nomor resmi: INV-2026-0042".
• Tanggal terbit dan tanggal bayar memakai tanggal di HP saat mencatat, bukan hari terkirim — penjualan Senin yang baru terkirim Rabu tetap masuk laporan hari Senin.
• Mengirim ulang tidak pernah menggandakan tagihan: kalau sambungan putus tepat setelah server menyimpan, kiriman berikutnya dijawab dengan hasil yang sama.
• Kalau server sedang tidak bisa dihubungi, aplikasi mencoba lagi sendiri dengan jeda yang membesar (5 detik sampai 2 menit); bilah menunjukkan "3 belum terkirim · coba lagi dalam 40 dtk".
• Pemilik yang membuka aplikasi di HP lain melihat angka lonceng dan daftarnya ikut disegarkan begitu antrean kasirnya masuk.

Kalau server menolak

Bilah menjadi merah: "1 transaksi perlu perhatian". Penjualan itu tidak hilang dan tidak dihapus sendiri — ia menunggu keputusan Anda di Antrean. Sebab yang biasa: produk sudah diarsipkan, pelanggan sudah dihapus, nominal bayar melebihi total, langganan berakhir. Bereskan penyebabnya (aktifkan produknya, perpanjang langganan), lalu Coba lagi — server memproses ulang dari awal. Kalau memang batal, Hapus.

Peringatan lain yang bisa muncul di bilah dan di Antrean

Tulisan	Artinya	Yang dilakukan
"Jam perangkat melenceng ±25 menit dari server — tanggal transaksi mengikuti jam perangkat; periksa pengaturan waktu."	Jam HP berbeda lebih dari 10 menit dari server	Betulkan jam HP (setel otomatis dari jaringan). Tanggal tagihan & pembayaran mengikuti jam HP
"Antrean melewati batas (512 dari 500 operasi, atau lebih dari 7 hari). Kirim segera begitu ada sinyal — pencatatan masih boleh."	Terlalu banyak (500) atau terlalu lama (7 hari) tanpa tersambung	Cari sinyal, Kirim sekarang. Mencatat tetap boleh, tetapi makin lama makin berisiko kalau HP rusak
"Penyimpanan lokal tidak tersedia (…) — penjualan belum bisa dicatat sampai tersambung lagi."	Browser menolak menyimpan: mode privat/penyamaran, data situs diblokir, atau "Ruang penyimpanan peramban penuh."	Keluar dari mode privat, izinkan data situs, kosongkan ruang. Sampai itu beres, kasir hanya jalan saat tersambung
"Sesi berakhir — masuk lagi untuk mengirim."	Sesi Anda habis saat masih ada antrean	Masuk lagi dengan akun yang sama; antrean tetap tersimpan
"Dicatat oleh akun lain di perangkat ini — masuk dengan akun itu untuk mengirimnya."	Penjualan dicatat saat akun lain (mis. staf) sedang masuk di HP yang sama	Masuk dengan akun itu, lalu Kirim sekarang

Keluar dari akun ditolak selama antrean belum kosong. Kalau Anda menekan Keluar saat masih ada yang menunggu, muncul "3 penjualan belum terkirim ke server. Sambungkan internet dan kirim dulu dari halaman Antrean sebelum keluar." — atau, bila ada yang ditolak, "1 penjualan ditolak server dan masih menunggu keputusan Anda di halaman Antrean (coba lagi atau hapus) sebelum keluar." Ini disengaja: keluar menghapus semua data offline di HP itu, dan penjualan yang belum terkirim tidak boleh ikut terhapus diam-diam.

Membuka aplikasi tanpa sinyal. Aplikasi bisa terbuka tanpa jaringan hanya kalau HP itu pernah masuk saat online dalam 7 hari terakhir — salinan sesinya disimpan tiap kali Anda online. Kalau tidak, yang muncul layar Tidak ada sambungan dengan tombol Coba lagi dan salah satu penjelasan:

• "Aplikasi belum pernah dibuka di perangkat ini saat tersambung, jadi belum ada data yang bisa dipakai tanpa jaringan." — HP baru: sambungkan internet sekali, masuk, buka Kasir; setelah itu mode offline siap.
• "Sesi tersimpan di perangkat ini sudah lebih dari 7 hari. Sambungkan internet dan masuk lagi untuk memakainya tanpa jaringan."

Hal yang harus Anda pahami

• Antrean hidup di HP itu saja. Sebelum terkirim, penjualan belum ada di server — tidak terlihat di daftar Penjualan, tidak di laporan, tidak di HP pemilik. HP hilang, rusak, atau data situsnya dihapus berarti penjualan yang belum terkirim ikut hilang. Kirim begitu ada sinyal, walau sebentar.
• Jangan mencatat ulang penjualan yang masih di antrean. Kalau Anda membuatnya lagi saat online, hasilnya dua tagihan. Periksa Antrean dulu.
• Batas 20 tagihan/bulan paket Gratis tidak menolak penjualan offline — tagihannya tetap terbit saat terkirim, dengan tanda "BATAS_PAKET" di daftar Terkirim. Lihat bagian 6.
• Struk sementara sah bagi pembeli; nomor resminya ada setelah terkirim.
• Pasang aplikasi ke layar utama (bagian 1.4) — terutama di iPhone.
• Ini tahap 1. Pembayaran atas tagihan lama, pelanggan baru sebagai catatan tersendiri, pengeluaran, kunci PIN offline, dan nomor tagihan per cabang belum ada; semuanya rencana, bukan janji tanggal.