Dokumentasi POS Retail

Role	Email	Password	Cakupan
Owner	owner@pos-retail.test	password	Akses penuh — semua outlet, semua laporan, pengaturan sistem, approval transaksi
Manager	manager@pos-retail.test	password	Kelola data master, laporan, approval transaksi, manajemen tim
Admin	admin@pos-retail.test	password	Kelola data master, transaksi, inventori, laporan harian
Kasir	kasir@pos-retail.test	password	Transaksi penjualan, scan barcode, cetak struk, lihat produk & stok
Gudang	gudang@pos-retail.test	password	Kelola stok, stock opname, purchase order, transfer stok, mutasi

Tutorial Langkah demi Langkah

Ikuti tutorial berikut untuk menguasai seluruh alur bisnis POS Retail dari setup awal hingga integrasi.

Fase 1

Setup Awal

1 Buka halaman /admin dan login dengan akun demo di atas.

2 Tambah Outlet — ini adalah toko/cabang tempat Anda beroperasi. Isi nama, alamat, telepon, dan status aktif.

3 Atur System Settings — tentukan pajak default, mata uang, format nota, dan threshold approval.

4 Tambah User — buat akun untuk kasir, admin gudang, dan manager dengan role yang sesuai.

5 Assign user ke outlet melalui User Outlet — tentukan user mana yang bertugas di outlet mana.

Fase 2

Input Master Data

1 Tambah Kategori produk — misal: Makanan, Minuman, Elektronik, ATK. Bisa nested (sub-kategori).

2 Tambah Brand — merek produk seperti Indomie, Samsung, SariWangi.

3 Tambah Unit/Satuan — Pcs, Box, Kardus, Kg, Liter, Sachet, Botol, Kaleng, Pack.

4 Tambah Produk — lengkapi nama, kategori, brand, harga beli, harga jual, harga grosir, harga member, stok minimum & maksimum.

5 Barcode & SKU otomatis — setiap produk baru langsung dapat barcode EAN-13 (prefix 899) dan SKU sequential. Tidak perlu input manual, siap discan.

6 Tambah Varian Produk jika produk memiliki pilihan (warna, ukuran, rasa) — stok per varian, barcode otomatis juga.

7 Tambah Customer Group — Regular, Member, Reseller, Grosir. Tentukan diskon per grup.

8 Tambah Customer/Pelanggan — nama, telepon, email, alamat, grup pelanggan.

9 Tambah Supplier — pemasok barang, lengkap dengan kontak dan alamat.

10 Tambah Metode Pembayaran — Tunai, Debit, QRIS, Transfer Bank.

Fase 3

Transaksi Penjualan

1 Buka menu Orders dan klik Buat Pesanan Baru.

2 Pilih outlet tujuan transaksi dan customer (opsional — bisa walk-in).

3 Tambah item produk ke keranjang — scan barcode atau pilih dari daftar. Tentukan quantity dan diskon per item.

4 Sistem otomatis menghitung subtotal, diskon total, pajak, dan grand total.

5 Pilih status pesanan: Pending → Diproses → Selesai → Dibatalkan.

6 Lakukan Pembayaran — pilih metode bayar, masukkan jumlah dibayar, sistem hitung kembalian.

7 Pesanan selesai — stok produk otomatis berkurang, poin loyalitas pelanggan bertambah.

8 Cetak struk/nota dari halaman detail order.

Fase 4

Pembelian & Restock

1 Buka menu Purchase Orders dan buat PO baru.

2 Pilih supplier dan outlet tujuan restock.

3 Tambah item yang akan dibeli — cari produk, tentukan quantity dan harga beli.

4 Simpan PO dengan status Draft → Dipesan → Diterima.

5 Saat barang diterima, ubah status PO jadi Diterima — stok produk otomatis bertambah.

6 Pantau Stok Minimum di halaman produk — sistem memberi peringatan saat stok di bawah minimum.

Fase 5

Manajemen Inventori

1 Lakukan Stock Opname secara berkala — hitung fisik vs stok sistem, catat selisih.

2 Input hasil opname per produk — sistem mencatat selisih dan menghasilkan laporan akurasi stok.

3 Gunakan Stock Transfer untuk memindahkan stok antar outlet.

4 Pantau Stock Movement — setiap perubahan stok tercatat (penjualan, pembelian, transfer, opname, adjustment).

5 Filter mutasi stok berdasarkan produk, outlet, tipe pergerakan, dan rentang tanggal.

Fase 6

Program Loyalitas

1 Tambah Loyalty Rewards — hadiah yang bisa ditukar pelanggan dengan poin.

2 Tentukan poin yang dibutuhkan per reward, stok reward, dan status aktif.

3 Setiap transaksi otomatis menghasilkan Loyalty Points untuk pelanggan (jika pelanggan dipilih saat order).

4 Lihat riwayat poin pelanggan — earned dari transaksi, redeemed untuk reward.

5 Pelanggan dengan total belanja tinggi naik grup (Regular → Member → Reseller) otomatis berdasarkan konfigurasi.

Fase 7

Laporan & Analisis

1 Buka menu Laporan — tersedia laporan penjualan, pembelian, inventori, dan loyalitas.

2 Filter laporan berdasarkan outlet dan rentang tanggal.

3 Lihat Chart Penjualan — revenue harian/mingguan/bulanan.

4 Lihat Top Produk — produk paling laris berdasarkan quantity dan revenue.

5 Lihat Laporan Stok — produk dengan stok menipis, overstock, dan pergerakan stok.

6 Export laporan ke PDF atau Excel untuk analisis lebih lanjut.

Fase 8

Sistem & Keamanan

1 Kelola User — tambah, edit, nonaktifkan akun pengguna.

2 Atur Role user — Owner, Admin, Kasir, Gudang, Manager.

3 Konfigurasi Pengaturan Sistem — pajak, mata uang, logo usaha, approval threshold.

4 Upload Logo Usaha — tampil di admin panel dan struk.

5 Pantau Absensi Pegawai — clock in/out, status hadir/terlambat/izin/sakit.

6 Jalankan Backup Database secara berkala melalui scheduler.

Fase 9

Pengaturan Meja & Tipe Order

1 Tambah Area Meja — Indoor, Outdoor, VIP, Lantai 1, dll.

2 Tambah Meja — nama, kode, kapasitas, area, status (tersedia/terpakai/reserved).

3 Saat transaksi Dine In, pilih meja yang digunakan pelanggan.

4 Status meja otomatis berubah saat dipakai dan selesai.

5 Gunakan Tipe Order — Dine In, Takeaway, Delivery — sesuai kebutuhan.

6 Nomor Antrian otomatis untuk Takeaway dan Dine In.

Fase 10

Bahan Baku & Recipe

1 Tambah Bahan Baku di menu Raw Materials — tepung, gula, minyak, dll.

2 Catat harga per unit, stok saat ini, dan stok minimum.

3 Buat Recipe Items — hubungkan produk dengan bahan bakunya.

4 Tentukan quantity bahan baku yang dibutuhkan per produk.

5 Pantau stok bahan baku — alert saat di bawah minimum.

Fase 11

Diskon, Cicilan & Uang Muka

1 Buat Template Diskon — percent, fixed, atau Buy X Get Y.

2 Tentukan minimal pembelian, tanggal berlaku, dan status aktif.

3 Untuk cicilan: aktifkan Installment di form order.

4 Pilih periode cicilan: Mingguan, 2-Mingguan, atau Bulanan.

5 Tentukan jumlah cicilan — sistem otomatis generate jadwal bayar.

6 Gunakan Uang Muka (DP) — pelanggan bayar sebagian di awal.

7 Pantau Sisa Pembayaran di detail order.

Fase 12

Integrasi & POS Web

1 Konfigurasi Payment Gateway di menu Providers — Midtrans, Xendit, dll.

2 Aktifkan QRIS untuk pembayaran digital.

3 Gunakan POS Web di /pos — antarmuka kasir cepat via browser dengan layout 80/20 (produk/kranjang).

4 Produk grid bisa di-scroll vertikal — lihat semua 1000+ produk tanpa pindah halaman.

5 Scan barcode dengan USB Scanner (auto-detect) atau Kamera HP — produk langsung masuk keranjang.

6 Barcode produk auto-generate saat create di admin panel — format EAN-13 valid, langsung bisa discan.

7 Atur Tipe Order (Walk-in, Member, Online) via System Settings — fully dynamic, tidak hardcode.

8 Cetak struk via Bluetooth Thermal Printer atau Browser Print.

9 Integrasikan dengan Flutter Mobile App untuk Android kasir.

Fitur Lengkap dengan Screenshot

Setiap menu dijelaskan dengan screenshot tampilan asli aplikasi.

1. Master Data

pos-retail/admin/outlets

Outlet / Cabang

Kelola satu atau banyak outlet dalam satu dashboard. Setiap outlet punya stok, transaksi, dan laporan terpisah namun terintegrasi.

•Multi-outlet support dengan data terisolasi
•Informasi lengkap: nama, alamat, telepon, status aktif
•Laporan per outlet atau konsolidasi
•Transfer stok antar outlet
•Pengaturan pajak dan metode bayar per outlet

pos-retail/admin/categories

Kategori & Brand

Organisir produk Anda dengan kategori nested (induk-anak) dan brand. Memudahkan navigasi dan pelaporan.

•Kategori bertingkat (parent-child) tanpa batas
•Brand sebagai pengelompokan tambahan
•Filter produk berdasarkan kategori atau brand
•Laporan penjualan per kategori dan brand
•Slug otomatis untuk SEO-friendly URL

pos-retail/admin/products

Produk & Varian

Kelola ribuan produk (demo seed 1000 produk, 25 kategori, 25 brand) dengan SKU, barcode, dan varian. Barcode EAN-13 auto-generate. Multi-harga: eceran, grosir, member.

•Barcode EAN-13 & SKU auto-generate saat create
•25 kategori supermarket-style (makanan, minuman, elektronik, dll)
•25 brand ternama (Indofood, Unilever, Nestle, dll)
•Varian: warna, ukuran, rasa dengan stok terpisah
•Multi-harga: eceran, grosir, member
•Stok minimum & maksimum alert
•Upload gambar produk
•Status aktif/nonaktif untuk produk musiman

pos-retail/admin/customers

Pelanggan & Grup

Database pelanggan lengkap dengan grup dan riwayat belanja. Integrasi dengan program loyalitas poin.

•Grup pelanggan: Regular, Member, Reseller
•Riwayat pembelian dan total belanja
•Poin loyalitas otomatis per transaksi
•Auto-upgrade grup berdasarkan total belanja
•Kontak lengkap: telepon, email, alamat

pos-retail/admin/suppliers

Supplier & Metode Bayar

Kelola pemasok barang dan konfigurasi metode pembayaran yang diterima di toko.

•Data supplier lengkap dengan kontak
•Riwayat purchase order per supplier
•Metode bayar: Tunai, Debit, QRIS, Transfer
•Status aktif/nonaktif per metode
•Rekening tujuan untuk transfer

2. Transaksi

pos-retail/admin/order-create

Point of Sale

Antarmuka kasir kiosk single-viewport: 80% produk yang bisa discroll vertikal, 20% keranjang dengan subtotal yang tetap di tempat. Transaksi selesai dalam hitungan detik.

•Layout kiosk 80/20 — produk full scroll vertikal
•Scan barcode USB atau kamera — langsung ke keranjang
•Barcode & SKU auto-generate di setiap produk baru
•1000+ produk diload per halaman — scroll tanpa henti
•Kalkulasi otomatis: subtotal → diskon → pajak → total
•Multi-metode pembayaran dalam satu transaksi
•Hitung kembalian otomatis
•Cetak struk termal via Bluetooth / browser
•Tipe order dynamic via System Settings

pos-retail/admin/orders

Manajemen Pesanan

Lacak semua pesanan dari semua outlet. Filter, search, dan kelola status pesanan dengan mudah.

•Nomor order unik auto-generate
•Filter: outlet, customer, status, tanggal
•Detail item, diskon, pajak per order
•Riwayat pembayaran per order
•Batalkan pesanan dengan alasan
•Export data order ke Excel

pos-retail/admin/orders

Pembayaran

Setiap transaksi tercatat lengkap dengan metode bayar, jumlah, dan kembalian. Support split payment.

•Multi-payment dalam satu order
•Auto-hitung kembalian
•Status: Lunas, DP, Belum Bayar
•Riwayat pembayaran per customer
•Rekap kas per outlet per hari

3. Pembelian

pos-retail/admin/purchase-orders

Purchase Order (PO)

Buat dan lacak pesanan pembelian ke supplier. Status PO: Draft → Dipesan → Diterima. Stok otomatis update saat PO diterima.

•Workflow: Draft → Dipesan → Dikirim → Diterima
•Auto-update stok saat PO diterima
•Harga beli per item tercatat
•Riwayat PO per supplier
•Total biaya pembelian otomatis
•Filter PO berdasarkan status dan supplier

4. Inventori

pos-retail/admin/stock-opnames

Stock Opname

Lakukan penghitungan fisik stok secara berkala dan bandingkan dengan catatan sistem. Selisih tercatat dan stok terkoreksi.

•Buat sesi opname per outlet
•Input stok fisik vs stok sistem
•Hitung selisih otomatis (surplus/deficit)
•Approval sebelum koreksi diterapkan
•Laporan akurasi stok per periode

pos-retail/admin/stock-movements

Mutasi Stok

Setiap pergerakan stok tercatat — penjualan, pembelian, transfer, opname, adjustment manual. Audit trail lengkap.

•Tipe mutasi: in/out dari berbagai sumber
•Filter: produk, outlet, tipe, tanggal
•Quantity before → after setiap mutasi
•Reference ke order/PO/transfer sumber
•Audit trail untuk investigasi selisih

pos-retail/admin/stock-transfers

Transfer Stok

Pindahkan stok antar outlet dengan mudah. Stok outlet asal berkurang, outlet tujuan bertambah. Lacak status transfer.

•Transfer antar outlet dalam satu sistem
•Status: Draft → Dikirim → Diterima
•Auto-update stok di kedua outlet
•Catatan dan referensi pengiriman
•Riwayat transfer lengkap

5. Loyalitas

pos-retail/admin/loyalty-rewards

Poin & Reward

Program loyalitas otomatis — setiap transaksi menghasilkan poin, poin bisa ditukar reward. Tingkatkan retensi pelanggan.

•Poin otomatis per transaksi
•Reward catalog: hadiah dengan harga poin
•Stok reward terbatas dengan sistem klaim
•Riwayat poin earned & redeemed
•Auto-upgrade grup pelanggan

6. Laporan

pos-retail/admin/laporan-penjualan

Laporan Penjualan

Dashboard penjualan lengkap dengan chart, summary cards, dan tabel detail. Filter per outlet dan rentang tanggal.

•Chart penjualan harian/mingguan/bulanan
•Top produk by quantity dan revenue
•Rata-rata nilai transaksi
•Perbandingan antar periode
•Export PDF & Excel

pos-retail/admin/laporan-penjualan

Laporan Pembelian

Pantau total pembelian ke supplier, biaya restock, dan tren pembelian per periode.

•Total pembelian per periode
•Top supplier by volume
•Tren harga beli
•PO outstanding (belum diterima)

pos-retail/admin/laporan-stok

Laporan Inventori

Status stok terkini, produk di bawah minimum, overstock, akurasi opname, dan pergerakan stok.

•Stok menipis alert
•Overstock warning
•Akurasi stock opname
•Mutasi stok per periode
•Nilai inventori (cost × qty)

7. Sistem

pos-retail/admin/dashboard

Manajemen User & Role

Kelola akun pengguna dengan role-based access. Owner, Admin, Kasir, Gudang, Manager — masing-masing dengan hak akses berbeda.

•Multi-role: Owner, Admin, Kasir, Gudang, Manager
•Assign user ke outlet
•Dashboard berbeda per role
•Nonaktifkan user tanpa hapus data
•Audit log per user