Kasir Toko (POS) โ Panduan Pengguna
Aplikasi kasir toko berbasis web + REST API, multi-toko (SaaS). Satu platform dipakai banyak toko; data setiap toko terpisah.
- Aplikasi web: https://belajar-api.unama.ac.id/kasir
- Dokumentasi API: https://belajar-api.unama.ac.id/kasir/docs
- OpenAPI 3: https://belajar-api.unama.ac.id/api/kasir/openapi ยท Postman: https://belajar-api.unama.ac.id/api/kasir/postman
Akun demo
Semua password: password.
| Peran | Toko | |
|---|---|---|
| Superadmin | [email protected] |
โ |
| Owner | [email protected] |
Toko Berkah Jaya (/kasir/t/toko-berkah-jaya) |
| Kasir | [email protected], [email protected] |
Toko Berkah Jaya |
| Pelanggan | [email protected] |
Toko Berkah Jaya |
| Owner | [email protected] |
Kopi Senja (/kasir/t/kopi-senja, pajak 10%, struk 80 mm) |
| Kasir | [email protected] |
Kopi Senja |
| Pelanggan | [email protected] |
Kopi Senja |
Data demo berisi ยฑ600 transaksi 30 hari terakhir per toko, beberapa produk stok menipis, 2 transaksi batal, dan shift kasir yang sedang terbuka.
Peran
| Peran | Bisa melakukan |
|---|---|
| Owner (pemilik toko) | Semua: pengaturan toko, staff kasir, kategori/satuan/supplier, produk, stok masuk, penyesuaian stok, pelanggan, transaksi & pembatalan, shift, laporan |
| Kasir (staff) | Layar POS, melihat produk, menambah/mengubah pelanggan, melihat transaksinya sendiri, cetak struk, buka/tutup shift |
| Pelanggan | Daftar sendiri di halaman toko, melihat poin & riwayat belanja |
| Superadmin | Ringkasan seluruh platform, daftar toko, aktif/nonaktifkan toko |
Alur Owner
-
Daftar toko di
/kasir/register: isi nama toko + akun pemilik. Alamat toko dibuat otomatis (mis./kasir/t/warung-maju). Kategori (Umum, Makanan, Minuman) dan satuan (pcs, box, kg, liter, pack) awal langsung tersedia. -
Pengaturan toko (
Pengaturan Toko): alamat, telepon, logo, pajak % (ditambahkan otomatis ke nota), poin (1 poin per kelipatan Rp tertentu), footer struk, lebar kertas struk 58/80 mm. -
Tambah staff kasir (
Staff Kasirโ Tambah kasir): beri email & password untuk login kasir. Staff bisa dinonaktifkan kapan saja. - Master data: kategori, satuan, dan supplier.
-
Produk (
Produkโ Tambah): nama, SKU (kosong = otomatis), barcode, kategori, satuan, harga beli (HPP), harga jual, stok awal, stok minimum, gambar opsional, aktif/nonaktif. Stok tidak diubah dari form produk, melainkan lewat menu stok agar tercatat. -
Stok masuk (
Stok Masukโ Catat): pilih supplier, tambahkan item (qty & harga beli). Stok bertambah dan harga beli produk diperbarui. -
Penyesuaian stok (stock opname): set stok sesuai hitungan fisik, atau tambah/kurangi (mis.
-2barang rusak). Wajib isi alasan. - Riwayat mutasi memperlihatkan setiap perubahan stok (stok awal, stok masuk, penjualan, penyesuaian, batal transaksi) beserta stok sebelum/sesudah.
- Stok menipis: produk dengan stok โค stok minimum; juga tampil di dashboard dan badge menu.
- Membatalkan transaksi (void): buka detail transaksi โ Batalkan โ isi alasan. Stok dikembalikan otomatis dan poin pelanggan ditarik.
-
Laporan (
Laporan): penjualan harian, per produk, per kasir, per metode bayar, laba kotor, dan stok. Pilih periode (hari ini, 7/30 hari, bulan ini, bulan lalu, atau tanggal bebas). Tombol CSV untuk Excel dan Cetak / PDF untuk mencetak atau menyimpan PDF dari browser.- Laba kotor = penjualan bersih (setelah diskon, sebelum pajak) โ HPP (harga beli pada saat transaksi).
Alur Kasir
- Login di
/kasir/loginโ langsung masuk ke layar kasir (POS). Layar kasir tampil penuh: sidebar disembunyikan (buka lewat tombol โฐ), ada tombol layar penuh. Di tablet produk dan keranjang tetap berdampingan; di HP produk memenuhi layar dengan bar total + Bayar di bawah, dan keranjang dibuka sebagai panel dari bawah. - (Opsional) Buka shift di menu
Shift Kasirdengan saldo kas awal. -
Tambah item: scan barcode / ketik nama atau SKU lalu Enter, atau ketuk kartu produk. Ketik
3*kodeuntuk langsung menambah 3. Saat mencari, โ/โ/โ/โ memilih produk yang disorot. Kartu produk menampilkan stok (kuning = menipis, merah = habis) dan jumlah yang sudah ada di keranjang. Bila scanner mengetik saat fokus di tempat lain, input otomatis diarahkan ke kolom cari. Ada bunyi "bip" saat item masuk / gagal (bisa dimatikan di bar atas). - Keranjang: tombol โ/+ per baris, atau ketuk nama item (F8) untuk mengubah jumlah dan diskon item dalam Rp atau % (tombol cepat 5โ50%). Dengan kolom cari kosong: โ/โ pilih baris, +/โ ubah jumlah, Del hapus. Diskon nota (F7) bisa Rp atau %. Pajak toko dihitung otomatis.
- (Opsional) Pilih pelanggan (F3; cari nama/kode/HP, โ/โ + Enter) atau tambah pelanggan baru, agar pelanggan mendapat poin. Tahan transaksi (F4) menyimpan keranjang sementara โ misalnya pelanggan mengambil barang lagi โ lalu layani pelanggan berikutnya. Ditahan (F6) memanggil kembali. Transaksi ditahan tersimpan di perangkat dan tidak mengurangi stok sampai dibayar.
- Tekan Bayar (F9) โ muncul jendela Pembayaran berisi total tagihan. Pilih jenis pembayaran (Tunai, Transfer, QRIS, E-Wallet; pintasan Alt+1โฆ4). Untuk tunai, kursor langsung di kolom Uang diterima (ada tombol uang pas, pecahan terdekat, dan keypad angka untuk layar sentuh) dan kembalian tampil otomatis saat diketik. Non-tunai dibayar sesuai total dan boleh diisi nomor referensi.
- Tekan Enter โ transaksi tersimpan, nomor nota dibuat otomatis per toko (
INV-yymmdd-0001), dan dialog cetak struk (thermal 58/80 mm) langsung muncul. Cetak otomatis bisa dimatikan lewat centang Cetak struk otomatis; tombol Cetak ulang tersedia di layar selesai dan Struk terakhir di bar atas. Tekan Enter lagi untuk transaksi baru. - Akhir shift: Tutup shift, masukkan uang aktual di laci. Sistem menampilkan kas seharusnya dan selisihnya.
Pintasan: F1 = daftar pintasan, F2 = cari/scan, F3 pelanggan, F4 tahan, F6 panggil, F7 diskon nota, F8 ubah baris, F9 = pembayaran (F9 lagi / Enter = simpan & cetak), Esc = batal. Di semua halaman, Ctrl+K membuka pencarian menu untuk berpindah halaman dengan cepat. Keranjang tersimpan di browser bila halaman tidak sengaja ditutup. Stok dikunci di database saat transaksi disimpan, sehingga dua kasir yang menjual barang yang sama bersamaan tidak membuat stok minus.
Alur Pelanggan
- Buka halaman toko, mis.
/kasir/t/toko-berkah-jaya, lalu Daftar Member (nama, email, nomor HP, password).- Jika kasir sudah pernah mencatat data Anda dengan email & nomor HP yang sama, akun otomatis tersambung ke data lama (poin & riwayat ikut tampil).
- Setelah masuk, halaman Akun menampilkan kode member, poin, total belanja, dan riwayat nota.
- Sebutkan kode member / nomor HP ke kasir saat membayar agar poin bertambah.
Superadmin
/kasir/admin menampilkan jumlah toko, pengguna, transaksi, GMV seluruh toko, grafik 30 hari, dan toko teratas. Di Daftar Toko superadmin dapat menonaktifkan toko: owner/kasir toko tersebut tidak bisa login (web & API) dan halaman tokonya ditutup sampai diaktifkan lagi.
Untuk developer (API)
# 1. Login, simpan token
curl -X POST https://belajar-api.unama.ac.id/api/kasir/auth/login \
-H "Content-Type: application/json" -H "Accept: application/json" \
-d '{"email":"[email protected]","password":"password"}'
# 2. Cari produk
curl "https://belajar-api.unama.ac.id/api/kasir/products?q=mi" -H "Authorization: Bearer $TOKEN"
# 3. Simpan transaksi tunai
curl -X POST https://belajar-api.unama.ac.id/api/kasir/sales \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"items":[{"product_id":1,"qty":1}],"payment_method":"cash","paid":100000}'
Semua response berbentuk { "success": bool, "message": string, "data": ..., "meta": ... }. Detail setiap endpoint ada di halaman dokumentasi.
Catatan teknis (pengelola server)
- Kode:
app/Providers/KasirServiceProvider.php,routes/kasir_web.php,routes/kasir_api.php,app/*/Kasir/*,resources/views/kasir,public/kasir. - Tabel berprefix
kasir_. Migrasi:php artisan migrate --path=database/migrations/kasir --force. - Data demo (menghapus & membuat ulang 2 toko demo saja):
php artisan db:seed --class="Database\Seeders\Kasir\KasirDemoSeeder" --force. - Uji otomatis (SQLite in-memory, tidak menyentuh database produksi):
php artisan test tests/Feature/Kasir. - Isolasi tenant: model data toko memakai trait
BelongsToTenant(global scopetenant_id+ isi otomatis saat create); route tidak memakai implicit model binding sehingga pencarian ID selalu melalui scope tersebut. - WAF aaPanel (
/www/server/free_waf) mengembalikan HTTP 500 untuk request POST tanpa body (juga terjadi di API v2). Klien sebaiknya selalu mengirim body{}; contoh di dokumentasi sudah melakukannya. - Nginx server ini melayani URL berakhiran
.jsonsebagai file statis, sehingga spesifikasi tersedia di/api/kasir/openapi(tanpa ekstensi) dan salinan statis/kasir/openapi.json.