title: “POS Orders” description: “Manajemen pesanan POS SNISHOP ERP — status workflow, multi-channel order, split payment, void management, dan integrasi inventory lintas lokasi.”

POS Orders

Halaman POS Orders menampilkan daftar seluruh transaksi POS yang telah dibuat, baik dari kasir offline maupun channel online. Halaman ini terintegrasi penuh dengan sistem inventory, membership loyalty, dan financial recording.

Arsitektur Komponen

Status Workflow Pesanan

Status	Warna	Deskripsi	Aksi yang Tersedia
Pending	Kuning	Order baru diterima, belum diproses	Process, Cancel, Detail
Processing	Biru	Sedang disiapkan (dapur/kemasan)	Ship, Cancel, Detail
Shipped	Ungu	Sudah dikirim / siap diambil	Mark Delivered, Detail
Delivered	Hijau	Sudah diterima customer	Complete, Detail
Completed	Hijau Tua	Transaksi selesai (final)	Void (PRD-07), Detail
Cancelled	Merah	Dibatalkan	Detail only
Refunded	Abu-abu	Retur/dana dikembalikan	Detail only

Dual POS System

SNISHOP ERP memiliki dua sistem POS paralel yang melayani kebutuhan berbeda:

Aspek	Personal POS	Company POS
Entity	`POSTransaction`	`CompanyPOSTransaction`
Scope	Owner-only (RLS)	Company-scoped (multi-tenant)
Multi-cashier	Tidak	Ya
Multi-location	Tidak	Ya
Channel	Offline only	8 channel (offline, marketplace, website, WhatsApp, reseller, B2B, Grab, social media)
Split payment	Tidak	Ya
Hold/Recall	Tidak	Ya (localStorage)
Bluetooth printer	Basic	Full integration
Loyalty	Basic tier	Full scheme (5 types)
Void management	Tidak	Ya (PRD-07)

CompanyPOSTransaction Entity

Entity utama untuk transaksi POS company dengan 50+ field yang mencakup seluruh aspek transaksi:

Core Transaction Fields

Field	Type	Deskripsi
`company_id`	string	ID perusahaan (multi-tenant isolation)
`location_id`	string	ID lokasi/gudang tempat transaksi
`location_name`	string	Nama lokasi untuk display
`transaction_number`	string	Format: `TRX-YYYYMMDD-XXXXXX`
`invoice_number`	string	Nomor faktur (jika ada)
`transaction_date`	date-time	Tanggal dan waktu transaksi

Item & Pricing Fields

Field	Type	Deskripsi
`items`	array	Detail item: product_id, product_name, sku, quantity, price, discount, subtotal, unit, unit_cost, total_cost, note
`subtotal`	number	Total sebelum diskon
`discount_amount`	number	Nominal diskon
`discount_percentage`	number	Persentase diskon
`tax_amount`	number	Jumlah pajak
`total`	number	Total akhir
`total_amount`	number	Total amount (alias)

Payment Fields

Field	Type	Deskripsi
`payment_method`	enum	cash, card, transfer, ewallet, qris, saldo, mayar, debt, manual_transfer, midtrans, tripay, stripe, paypal
`payment_amount`	number	Jumlah bayar
`payments`	array	Split payment: method, amount, change_amount, account_id, reference, verified_by, verified_at
`payment_status`	enum	pending, pending_verification, partially_paid, paid, failed, refunded, rejected
`paid_amount`	number	Total sudah dibayar
`remaining_amount`	number	Sisa belum dibayar
`excess_amount`	number	Kelebihan bayar
`change_amount`	number	Kembalian
`payment_reference`	string	Referensi pembayaran non-tunai
`payment_verified_by`	string	Verifikator pembayaran
`payment_verified_at`	date-time	Waktu verifikasi

Customer & Loyalty Fields

Field	Type	Deskripsi
`customer_id`	string	ID customer
`customer_name`	string	Nama customer
`customer_phone`	string	Nomor telepon
`customer_address`	string	Alamat pengiriman
`points_earned`	number	Poin yang didapat dari transaksi ini
`points_used`	number	Poin yang digunakan untuk diskon

Operational Fields

Field	Type	Deskripsi
`cashier_id`	string	ID kasir yang memproses
`cashier_name`	string	Nama kasir
`assigned_to_id`	string	ID staff/therapist yang ditugaskan
`assigned_to_name`	string	Nama staff/therapist
`source`	enum	pos, online_catalog, website, marketplace, landing_page, whatsapp, reseller, b2b, grab, social_media
`sales_channel`	enum	offline_pos, offline, website, online_catalog, marketplace, landing_page, whatsapp, reseller, b2b, grab, social_media
`order_status`	enum	pending, processing, shipped, delivered, completed, cancelled, rejected
`status`	enum	pending, processing, shipped, delivered, completed, failed, refunded, cancelled
`tracking_number`	string	Nomor resi/tracking
`notes`	string	Catatan tambahan
`metadata`	object	Data tambahan (cogs_total, dll)

Timestamp Fields

Field	Type	Deskripsi
`verified_at`	date-time	Waktu verifikasi pembayaran
`verified_by`	string	User yang memverifikasi
`processed_at`	date-time	Waktu mulai diproses
`shipped_at`	date-time	waktu dikirim
`delivered_at`	date-time	Waktu diterima
`cancelled_at`	date-time	Waktu dibatalkan

Split Payment (Multi-Tender)

Transaksi POS mendukung split payment — customer bisa membayar dengan beberapa metode sekaligus: Implementasi:

Field payments[] menyimpan array tender
Setiap tender memiliki: method, amount, change_amount, account_id, reference, verified_by, verified_at
resolvePaymentTenders() menormalisasi single vs split payment untuk reporting
Total semua tender harus sama dengan total transaksi

8 Channel Penjualan

Channel	Kode	Deskripsi	Pricing Source
Offline POS	`offline_pos`	Kasir langsung	Base price
Website	`website`	Toko online sendiri	`channel_pricing.website`
Online Catalog	`online_catalog`	Katalog digital	`channel_pricing.website`
Marketplace	`marketplace`	Shopee, Tokopedia, dll	`channel_pricing.marketplace`
WhatsApp	`whatsapp`	Order via WhatsApp	`channel_pricing.whatsapp`
Reseller	`reseller`	Order dari reseller	`channel_pricing.reseller`
B2B	`b2b`	Order bisnis ke bisnis	`channel_pricing.b2b`
Grab	`grab`	GrabFood	`channel_pricing.grab`
Social Media	`social_media`	Instagram, TikTok, dll	`channel_pricing.social_media`

Channel Pricing Gate (A3):

Channel online wajib punya harga di channel_pricing{}
Jika harga channel tidak ada, item di-drop dengan notifikasi
Offline POS fallback ke base price

Void Management (PRD-07)

Transaksi yang sudah completed bisa di-void dengan mekanisme keamanan: Syarat Void:

Status harus completed
User harus punya permission can_edit_pos_transactions
Alasan void wajib diisi
Stock otomatis dikembalikan
Financial record dibuat reversal entry

Discount Approval Flow (A1)

Diskon di atas threshold memerlukan approval supervisor: Threshold: DISCOUNT_APPROVAL_THRESHOLD = 20% Implementasi:

Cashier input diskon > 20%
Dialog approval muncul minta PIN supervisor
Server function approveCashierDiscount validasi PIN
Jika valid, discountApprovedBy dicatat
Jika tidak valid, error ditampilkan

Transaction Integrity (DQ-01)

Sistem mencegah double-submission transaksi melalui beberapa mekanisme:

Mekanisme	Implementasi	Fungsi
Module-level lock	`isTransactionInProgress` flag	Prevent concurrent submissions
Safety timeout	60 detik auto-reset	Prevent permanent lock on crash
Idempotency key	`txq_{timestamp36}_{random6}`	Prevent duplicate transactions
Write-Ahead Log	`TransactionQueue` di localStorage	Crash recovery

Write-Ahead Log Lifecycle

Cross-Module Integration

Integrasi Detail

Modul	Entity/Function	Aksi	Trigger
Inventory	`Inventory.filter/update`	Deduct stock	On transaction complete
Inventory	`StockMovement.create`	Audit trail	On stock change
Inventory	`StockAlert.create`	Reconciliation	On deduction failure
Inventory	`transferInventoryLots`	Inter-location transfer	When stock unavailable at location
Finance	`FinancialRecord.create`	Record income, COGS, shipping	On transaction complete
Finance	`Account.filter/create`	Payment account	On payment processing
CRM	`Customer.filter/update`	Update stats	On transaction complete
CRM	`manageCustomerLoyalty`	Process points/stamps	On transaction complete
CRM	`POSMember.filter`	Membership lookup	On customer selection
Communication	`WhatsAppSession.filter`	Send receipt	Auto after transaction
Task	`Task.create`	Assign to therapist/staff	On order with assignment

Real-Time Synchronization

POS Orders menggunakan 3-tier sync strategy untuk memastikan data selalu terkini:

Layer	Teknologi	Scope	Latency
Cross-tab	BroadcastChannel	Same browser, different tabs	< 100ms
Server push	WebSocket subscribe	All devices	< 500ms
Polling	setInterval fallback	All clients	10-120s

BroadcastChannel Directory

Channel	Posted By	Listened By	Event
`snishop_pos_updates`	Cashier (on transaction)	Reports, Queue	NEW_TRANSACTION
`snishop_inventory_updates`	Cashier (on stock change)	Sync, Reports	TRANSACTION_COMPLETED
`snishop_order_queue`	Cashier, OrderManagement	Queue, Cashier	NEW_ORDER
`snishop_finance_updates`	Cashier (on payment)	Finance module	POS_TRANSACTION
`snishop_reports_updates`	Cashier (on transaction)	Reports	NEW_TRANSACTION

Best Practices

Untuk Kasir

Selalu cek stok sebelum menambah item ke cart
Pilih lokasi yang benar untuk transaksi
Verifikasi pembayaran non-tunai dengan referensi yang valid
Gunakan split payment jika customer bayar dengan multiple methods
Cetak struk sebelum customer meninggalkan kasir

Untuk Manager

Review void transactions setiap hari
Monitor split payment untuk anomali
Cek discount approvals untuk pola abuse
Verify online orders dalam 5 menit
Review channel performance di POS Reports

Untuk Developer

Selalu gunakan idempotency key saat create transaction
Handle stock deduction failure dengan StockAlert
Broadcast ke semua channel setelah transaction complete
Validate channel pricing sebelum submit
Log all void actions untuk audit trail

​title: “POS Orders” description: “Manajemen pesanan POS SNISHOP ERP — status workflow, multi-channel order, split payment, void management, dan integrasi inventory lintas lokasi.”

​POS Orders

​Arsitektur Komponen

​Status Workflow Pesanan

​Dual POS System

​CompanyPOSTransaction Entity

​Core Transaction Fields

​Item & Pricing Fields

​Payment Fields

​Customer & Loyalty Fields

​Operational Fields

​Timestamp Fields

​Split Payment (Multi-Tender)

​8 Channel Penjualan

​Void Management (PRD-07)

​Discount Approval Flow (A1)

​Transaction Integrity (DQ-01)

​Write-Ahead Log Lifecycle

​Cross-Module Integration

​Integrasi Detail

​Real-Time Synchronization

​BroadcastChannel Directory

​Best Practices

​Untuk Kasir

​Untuk Manager

​Untuk Developer