Kasir (POS) → Multi-Kasir Sync

Multi-Kasir Sync

Sinkronisasi kasir antar device dalam satu toko.

10. Multi-Kasir Sync

Multi-Kasir memungkinkan beberapa HP beroperasi bersamaan dalam satu toko, dengan data tersinkronisasi via WiFi lokal. Cocok untuk toko yang butuh lebih dari 1 kasir saat jam sibuk.

Kelebihan:

  • Tidak perlu internet (sync di jaringan lokal via WiFi/Hotspot)
  • Real-time: transaksi langsung masuk ke Server
  • Produk, harga, customer dikelola terpusat dari Server
  • Port default: 8765

Info dari aplikasi: "Fitur ini memungkinkan beberapa HP/tablet digunakan sebagai kasir secara bersamaan dalam satu toko. Satu perangkat menjadi Server (kasir utama) yang menyimpan semua data, dan perangkat lainnya menjadi Client yang terhubung ke server melalui jaringan WiFi/Hotspot lokal. Data produk, stok, dan transaksi akan tersinkronisasi secara otomatis antar perangkat."

A. Konsep: 3 Mode

Buka Pengaturan → Multi-Kasir. Halaman menampilkan card "Apa itu Multi-Kasir?", Status Saat Ini (mode yang sedang aktif), 3 card Pilih Mode, dan info Cara Penggunaan.

Halaman Multi-Kasir dengan 3 mode card: Standalone (selected), Server Mode, Client Mode, plus info Cara Penggunaan
Halaman Multi-Kasir — pilih mode operasional
1. Standalone

"Perangkat berjalan mandiri tanpa sync". Mode default. HP berdiri sendiri tanpa sync. Pilih ini kalau Anda hanya pakai 1 HP.

2. Server

"Perangkat ini sebagai server utama". HP yang dijadikan pusat data. Semua produk, customer, dan transaksi disimpan di sini.

Cocok untuk:

  • HP utama pemilik toko
  • Device dengan storage lebih besar
  • Device yang tidak bergerak-gerak (stationary)
3. Client

"Terhubung ke server". HP kasir tambahan yang mengambil data master dari Server dan mengirim transaksi baru ke Server.

Cocok untuk:

  • HP kasir kedua/ketiga
  • Tablet di meja resto (order type)
  • HP kasir outlet tambahan

B. Setup Server (HP Utama)

Persiapan:

  • HP utama sudah aktivasi & setup selesai
  • Sudah ada produk, kategori, metode pembayaran (HP Server adalah sumber data)
  • HP terhubung ke WiFi (bisa dari router atau hotspot HP lain)

Langkah:

  1. Buka Pengaturan → Multi-Kasir
  2. Baca card "Apa itu Multi-Kasir?" untuk orientasi
  3. Tap card Server Mode → muncul dialog Aktifkan Server Mode dengan input Port (default 8765)
  4. Tap Aktifkan — server mulai berjalan
  5. Muncul QR Code di halaman utama Multi-Kasir — ini yang akan di-scan oleh HP Client
  6. Status card "Status Saat Ini" berubah: "Perangkat ini sebagai server utama"
Dialog Aktifkan Server Mode dengan input Port 8765
Dialog Aktifkan Server Mode

⚠️ Penting:

  • Server harus tetap ON & terhubung WiFi selama Client beroperasi
  • Jangan matikan HP Server saat masih ada Client aktif
  • Edit produk/pengaturan hanya bisa dari Server (Client read-only)

C. Setup Client (HP Kasir Tambahan)

Persiapan:

  • HP Client sudah install KasGo & aktivasi device
  • HP Client terhubung ke WiFi yang sama dengan HP Server
  • HP Server sudah dalam mode Server & menampilkan QR Code

Langkah:

  1. Di HP Client, buka Pengaturan → Multi-Kasir
  2. Tap card Client Mode → muncul dialog Hubungkan ke Server
  3. Pilih salah satu cara:
    • Scan QR Code Server (recommended) — tap tombol biru, scan QR yang ditampilkan di HP Server
    • Input manual — isi IP Address server, Port (default 8765), & Nama Server (Opsional)
  4. Tap Hubungkan
  5. Tunggu proses koneksi. Status akan berubah:
    • "Menghubungkan..."
    • "Terhubung ke [nama server]" (sukses)
    • "Terputus" atau "Error: [pesan]" (gagal)
  6. Setelah terhubung, Client bisa langsung dipakai untuk kasir. Produk, kategori, customer otomatis di-fetch dari Server.
Dialog Hubungkan ke Server dengan opsi Scan QR Code Server atau input manual IP Address, Port, Nama Server
Dialog Hubungkan ke Server

⚠️ Mode Client bersifat Read-Only untuk data master:

9 menu otomatis terkunci di Client (dilakukan dari Server):

  • Produk, Kategori, Stok
  • Supplier, Pembelian (Purchase Order), Konsinyasi, Catatan Harga
  • Pengeluaran, Laporan

Menu yang aktif di Client:

  • Kasir, Riwayat, Pelanggan, Pre-Order, Pengaturan

D. Cara Kerja Sync

Komunikasi Server ↔ Client lewat HTTP API di port 8765. Client melakukan request ke Server saat butuh data atau saat melakukan transaksi.

Server → Client (data master, fetch on-demand):
  • Produk (termasuk varian, multi-unit, batch)
  • Kategori
  • Pelanggan (data + statistik)
  • Metode pembayaran
  • Pengaturan toko (logo, nama, alamat) + pengaturan bisnis & pajak
  • Pengaturan loyalty
  • Riwayat transaksi & shift milik server
Client → Server (transaksi & mutasi):
  • Transaksi penjualan baru
  • Refund
  • Pembayaran piutang customer
  • Buka / Tutup shift
  • Tambah / Edit pelanggan dari kasir (CRUD customer)

Poin loyalty earning & redemption dihitung otomatis di server saat transaksi customer di-attach — tidak perlu sync terpisah.

Stok & Stock Reservation:

Stok dikelola terpusat di Server. Saat Client menambah produk ke keranjang yang stok-nya tinggal sedikit, sistem melakukan stock reservation untuk slot waktu tertentu — mencegah oversell kalau Server & Client lain juga menjual produk yang sama bersamaan.

  • Reserve dilakukan otomatis saat add to cart di Client
  • Release otomatis kalau item dihapus dari keranjang atau transaksi dibatalkan
  • Commit saat transaksi berhasil → stok aktual di Server berkurang
  • Kalau stok habis di tengah transaksi (mis. Server jual lebih dulu), Client dapat error "Stok tidak mencukupi"

E. Troubleshooting Multi-Kasir

Client tidak bisa connect ke Server:
  • Pastikan kedua HP di WiFi/hotspot yang sama (SSID identik)
  • Matikan & nyalakan WiFi di kedua HP
  • Restart mode Server di HP utama (pilih Standalone dulu, lalu Server lagi)
  • Cek IP Address yang dimasukkan benar (tap Scan QR Code lebih akurat daripada manual)
  • Firewall/router mungkin block port 8765 — coba pakai hotspot dari HP Server sebagai WiFi alternatif
  • Jarak antar HP terlalu jauh atau sinyal WiFi lemah
Koneksi sering putus-nyambung:
  • Sinyal WiFi tidak stabil — cek bar sinyal di Android settings
  • HP Server masuk sleep mode → nyalakan Keep Screen On di developer options atau pasang charger
  • Power saving / battery optimizer Android sering bunuh koneksi background — buka Settings → Apps → KasGo → Battery → set ke Unrestricted
Produk baru di Server tidak muncul di Client:
  • Tutup & buka ulang menu Kasir di Client untuk force re-fetch dari Server
  • Atau pull-to-refresh di daftar produk
  • Pastikan produk di Server sudah di-Simpan (bukan masih draft)
Stok di Client beda dengan Server:
  • Pull-to-refresh di Kasir untuk fetch stok terbaru
  • Cek apakah ada Client lain yang sedang reserve stok produk tersebut (display di Client lain)
  • Cek apakah ada penyesuaian stok di Server yang belum di-fetch
Error "Stok tidak mencukupi" padahal stok ada:
  • Stok mungkin sudah di-reserve oleh Client lain yang belum checkout. Tunggu sebentar atau coba ulang.
  • Cek di Server apakah ada Client lain yang transaksi-nya pending
← Sebelumnya
Kasir & Transaksi
Selanjutnya →
Riwayat Transaksi