Kasir Toko (POS) โ€” Panduan Pengguna

Aplikasi kasir toko berbasis web + REST API, multi-toko (SaaS). Satu platform dipakai banyak toko; data setiap toko terpisah.

Akun demo

Semua password: password.

Peran Email 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

  1. 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.
  2. 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.
  3. Tambah staff kasir (Staff Kasir โ†’ Tambah kasir): beri email & password untuk login kasir. Staff bisa dinonaktifkan kapan saja.
  4. Master data: kategori, satuan, dan supplier.
  5. 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.
  6. Stok masuk (Stok Masuk โ†’ Catat): pilih supplier, tambahkan item (qty & harga beli). Stok bertambah dan harga beli produk diperbarui.
  7. Penyesuaian stok (stock opname): set stok sesuai hitungan fisik, atau tambah/kurangi (mis. -2 barang rusak). Wajib isi alasan.
  8. Riwayat mutasi memperlihatkan setiap perubahan stok (stok awal, stok masuk, penjualan, penyesuaian, batal transaksi) beserta stok sebelum/sesudah.
  9. Stok menipis: produk dengan stok โ‰ค stok minimum; juga tampil di dashboard dan badge menu.
  10. Membatalkan transaksi (void): buka detail transaksi โ†’ Batalkan โ†’ isi alasan. Stok dikembalikan otomatis dan poin pelanggan ditarik.
  11. 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

  1. 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.
  2. (Opsional) Buka shift di menu Shift Kasir dengan saldo kas awal.
  3. Tambah item: scan barcode / ketik nama atau SKU lalu Enter, atau ketuk kartu produk. Ketik 3*kode untuk 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).
  4. 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.
  5. (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.
  6. 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.
  7. 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.
  8. 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

  1. 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).
  2. Setelah masuk, halaman Akun menampilkan kode member, poin, total belanja, dan riwayat nota.
  3. 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)