Company POS Cashier

Company POS Cashier (CompanyPOSCashier.jsx — 6.191 baris) adalah komponen terbesar di seluruh modul POS dan salah satu komponen terbesar di aplikasi SNISHOP ERP. Ini bukan sekadar halaman kasir — melainkan terminal kasir enterprise yang menggabungkan 60+ useState hooks, custom hooks modular, dan integrasi real-time dengan 7 modul lain dalam satu antarmuka yang dioptimalkan untuk kecepatan transaksi tinggi. Komponen ini mendukung multi-outlet melalui outlet selector, split payment (multi-tender), hold & recall transaksi, Bluetooth thermal printing, WhatsApp digital receipt, multi-location stock query, dan loyalty processing (poin/stamps/discount tier).

Arsitektur Komponen

Perbedaan dengan Kasir Personal

Aspek	POS Kasir (Personal)	Company POS Cashier
Komponen	`POS.jsx` — 948 baris	`CompanyPOSCashier.jsx` — 6.191 baris
Scope	Satu outlet tetap	Semua outlet (selector)
Harga	Harga outlet tetap	Harga per outlet dari `channel_pricing{}`
Stok	Stok outlet tetap	Stok per outlet + multi-location query
RLS	Owner-scoped (`POSTransaction`)	Company-scoped (`CompanyPOSTransaction`)
Split Payment	Tidak	Ya — `payments[]` array
Hold/Recall	Tidak	Ya — `heldTransactions[]`
Bluetooth Print	Tidak	Ya — thermal printer BLE
WhatsApp Receipt	Tidak	Ya — via WhatsApp gateway
Loyalty	Basic poin	Full tier + poin + stamps + scheme
Use Case	Kasir harian single-outlet	Multi-outlet, enterprise, manajer

60+ useState Hooks — Kategori

Fitur Utama

Fitur	Deskripsi	Implementasi
Outlet Selector	Pilih outlet target transaksi	Dropdown → filter harga & stok per outlet
Product Search	Cari berdasarkan nama, SKU, atau barcode	`searchQuery` state + debounced filter
Cart Otomatis	Kalkulasi subtotal, pajak, diskon, total	`usePOSCart` — 326 baris
Split Payment	Kombinasi beberapa metode pembayaran	`usePOSPayment` — 686 baris, `payments[]` array
Hold/Recall	Simpan transaksi sementara, panggil kembali	`heldTransactions[]` di localStorage
Bluetooth Print	Cetak struk ke thermal printer via BLE	Web Bluetooth API + ESC/POS commands
WhatsApp Receipt	Kirim struk digital ke WhatsApp pelanggan	WhatsApp gateway integration
Multi-Location Stock	Query stok dari lokasi lain jika out of stock	`transferInventoryLots` server function
Loyalty Processing	Poin, stamps, tier discount auto-apply	`manageCustomerLoyalty` server function
Transaction History	Riwayat transaksi di sidebar	`recentTransactions[]` + BroadcastChannel sync
Discount Approval	Diskon >20% butuh supervisor PIN	`approveCashierDiscount` server function
Quick Cash Buttons	Tombol nominal cepat (50rb, 100rb, 150rb)	UI shortcut untuk cash payment

Split Payment — Deep Dive

Step	Hook State	Deskripsi
1	`splitPaymentMode = true`	Aktifkan mode split payment
2	`payments = [{method:'cash', amount:100000}]`	Tambah tender pertama
3	`remainingAmount = total - sum(payments)`	Hitung sisa
4	`payments.push({method:'qris', amount:50000})`	Tambah tender kedua
5	`remainingAmount === 0`	Validasi: semua tender teralokasi
6	Submit ke server	Server validasi & simpan masing-masing tender

Hold & Recall Transaction

Properti	Deskripsi
Storage	`heldTransactions[]` di localStorage
Max Holds	Tidak terbatas (selama localStorage cukup)
Data	Full cart snapshot + timestamp + notes
Recall	Klik di sidebar → restore cart ke active state
Expiry	Tidak ada auto-expiry (manual delete)
Cross-Tab	Sync via `BroadcastChannel('snishop_pos_updates')`

Multi-Location Stock Query

Bluetooth Thermal Printing

Parameter	Nilai
Protocol	Web Bluetooth API (BLE 4.0+)
Command Set	ESC/POS
Paper Width	58mm / 80mm (auto-detect)
Content	Logo + nama toko + alamat + item list + total + barcode
Fallback	`window.print()` dengan CSS `@media print`
Connection	Pair sekali, auto-reconnect pada print berikutnya

WhatsApp Digital Receipt

Format pesan WhatsApp receipt:

━━━━━━━━━━━━━━━━
🧾 QUINN OF SPICY
━━━━━━━━━━━━━━━━
No: INV-20260110-0042
Tgl: 10 Jan 2026, 14:30
Kasir: Ahmad
━━━━━━━━━━━━━━━━
1x Ayam Geprek    25.000
2x Es Teh          10.000
1x Nasi Putih       5.000
━━━━━━━━━━━━━━━━
Subtotal:          40.000
Pajak (10%):        4.000
━━━━━━━━━━━━━━━━
TOTAL:             44.000
Pembayaran:
  Cash:            50.000
  Kembalian:        6.000
━━━━━━━━━━━━━━━━
Terima kasih! 🌶️

Transaction Integrity

Mekanisme	Deskripsi	Implementasi
Module Lock	Cegah double-submit	`isTransactionInProgress` flag
Safety Timeout	Auto-release lock jika stuck	60 detik timeout
WAL	Crash recovery	`TransactionQueue.js` — 241 baris
Idempotency Key	Cegah duplikasi transaksi	UUID per transaksi
Optimistic UI	Update UI sebelum server confirm	Rollback on error
Stock Validation	Cek stok real-time sebelum submit	Server-side validation

Cara Akses

Metode	Detail
URL	`/companyposcashier`
Sidebar	Menu POS → Company POS Cashier
Keyboard	`Ctrl+Shift+C`

Flow Penggunaan

Tips

Masukkan nomor member sebelum bayar agar poin dan diskon otomatis diterapkan
Gunakan shortcut keyboard (F1 search, F3 bayar, F4 hold) untuk mempercepat transaksi
Cek outlet yang dipilih sebelum memproses — stok dan harga bisa berbeda antar outlet
Manfaatkan hold/recall jika pelanggan belum memutuskan — simpan cart, lanjut transaksi berikutnya
Gunakan multi-location stock jika produk habis di outlet saat ini — sistem bisa auto-transfer
Test Bluetooth printer di awal shift untuk memastikan koneksi stabil

Mulai

Dashboard & Core

POS & Kasir

Inventori

Manufaktur

Keuangan

SDM & Kehadiran

CRM & Pelanggan

AI & Analitik

Analytics & Reporting

Produktivitas

Komunikasi

Marketing & B2B

Toko Online

Admin & Pengaturan

Company POS Cashier

Company POS Cashier

Arsitektur Komponen

Perbedaan dengan Kasir Personal

60+ useState Hooks — Kategori

Fitur Utama

Split Payment — Deep Dive

Hold & Recall Transaction

Multi-Location Stock Query

Bluetooth Thermal Printing

WhatsApp Digital Receipt

Transaction Integrity

Cara Akses

Flow Penggunaan

Tips

​Company POS Cashier

​Arsitektur Komponen

​Perbedaan dengan Kasir Personal

​60+ useState Hooks — Kategori

​Fitur Utama

​Split Payment — Deep Dive

​Hold & Recall Transaction

​Multi-Location Stock Query

​Bluetooth Thermal Printing

​WhatsApp Digital Receipt

​Transaction Integrity

​Cara Akses

​Flow Penggunaan

​Tips

Company POS Cashier

Arsitektur Komponen

Perbedaan dengan Kasir Personal

60+ useState Hooks — Kategori

Fitur Utama

Split Payment — Deep Dive

Hold & Recall Transaction

Multi-Location Stock Query

Bluetooth Thermal Printing

WhatsApp Digital Receipt

Transaction Integrity

Cara Akses

Flow Penggunaan

Tips