CV. SAM Brangkal - Kasir Digital

Panduan Lengkap Aplikasi

Ditulis untuk pemula total. Termasuk alur Koh Hadi: barang masuk (PO Pengambilan → Nota Pembelian) dan barang keluar (Surat Jalan → Nota Penjualan/Faktur). Baca sekali dari atas, lalu pakai daftar isi sebagai referensi harian.

RINGKASAN ALUR BISNIS (sesuai permintaan Koh Hadi)
BARANG MASUK
1. PO Pengambilan (POP-...)
↓ barang sampai
2. Nota Pembelian (PO-...)
Kasir input harga → stok naik, HPP terisi
|
BARANG KELUAR
1. Surat Jalan (SJ-...)
↓ kirim ke pelanggan
2. Nota Penjualan / Faktur (TRX-...)
Kasir bayar → cetak struk + faktur A4

1. Pengenalan - Apa ini?

Aplikasi ini adalah sistem kasir (POS) dan inventory (stok barang) untuk toko CV. SAM Brangkal. Data tersimpan di cloud, bisa diakses dari komputer/tablet asalkan login.

Cari cepat: ketik di kotak pencarian atas (mis. “beras”) — kata yang cocok kuning, fokus aktif oranye. Tekan Enter untuk loncat ke kemunculan berikutnya.

Yang bisa dilakukan: jual barang, catat pembelian, PO pengambilan, surat jalan, faktur penjualan, konversi giling, laporan laba, backup database.

Peran pengguna:

2. Kamus Singkatan & Istilah

Istilah Arti Lengkap Contoh / Di Aplikasi
POPPO Pengambilan - pesanan/ambil barang ke supplier. Belum masuk stok, belum ada harga.POP-260611-0001
PO (Nota Beli)Nota Pembelian - barang sudah datang, harga sudah diinput, stok naik.PO-260611-0001
SJSurat Jalan - dokumen barang keluar ke pelanggan. Stok berkurang.SJ-260611-0001
TRX / FakturNota Penjualan - transaksi kasir resmi. Struk kecil (58/80mm) + Faktur A4.TRX-260611-0001
HPPHarga Pokok Penjualan - modal per kg. Dari nota pembelian atau giling.Beli Rp 12.000/kg → HPP 12.000
ModalUang beli barang (= HPP). Bukan harga jual ke pelanggan.Kolom HPP di tab Produk
OmzetTotal penjualan sebelum PPN.Subtotal di laporan
PPNPajak Pertambahan Nilai 11% jika diaktifkan di kasir.Default bisa 0 (mati)
Laba KotorOmzet - HPP. Belum dikurangi gaji/sewa.Kartu hijau di Laporan
Laba BersihLaba Kotor - Beban Operasional.Kartu ungu di Laporan
StokSisa barang di gudang (kg).Naik saat beli, turun saat SJ/jual
SupplierPemasok barang masuk.Tab Supplier / form PO
PelangganPembeli barang keluar.Form Surat Jalan / Kasir
KontrolNomor kontrol di dokumen fisik (opsional di cetak).Kolom di contoh surat jalan
Coverage HPP% omzet yang sudah punya data modal.Grade A = bagus (95%+)

3. Alur Kerja Harian (Urutan yang Benar)

  1. Pagi: Login → cek stok tab Produk.
  2. Mau ambil barang ke supplier: Admin buat PO Pengambilan → cetak → bawa ke supplier.
  3. Barang sampai: Kasir buka PO → klik Terima → isi harga beli → jadi Nota Pembelian otomatis.
  4. Kirim ke pelanggan: Buat Surat Jalan → cetak → barang keluar.
  5. Tagih / jual resmi: Dari SJ klik Nota → kasir bayar → cetak Struk + Faktur A4.
  6. Penjualan eceran langsung: Tab Kasir biasa (tanpa SJ) untuk walk-in customer.
  7. Giling gabah: Tab Giling / Konversi.
  8. Akhir hari/bulan: Tab Laporan → cek KPI, HPP, beban operasional.
  9. Backup: Tab Database mingguan.

4. Tab Kasir - Menjual ke Pelanggan

Langkah jual biasa: Cari produk → klik masuk keranjang → atur qty → isi nama pelanggan (opsional) → bayar → cetak struk.

Langkah jual dari Surat Jalan: Lihat bab 19 bagian A - keranjang terisi otomatis dari SJ.

Setelah bayar sukses:

PPN: Aktifkan toggle PPN di kasir jika perlu. Default bisa 0.

Harga partai: Jika produk punya harga grosir & min qty, harga otomatis ganti saat qty cukup.

Qty cepat di keranjang

  • Tombol − / + untuk ubah 1 unit; atau ketik angka langsung di kotak qty (cocok untuk kg desimal, mis. 12.5).
  • Baris Qty cepat: tombol +5 / +10 / +25 / −5 — praktis untuk beras, gula, minyak (banyak kg sekaligus).
  • Jika stok hampir habis dan Anda tekan +10/+25, qty otomatis di-set ke sisa stok maksimal (bukan error kosong).

Parkir transaksi (hold keranjang)

Dipakai saat pelanggan A masih belanja / nunggu uang, lalu datang pelanggan B. Keranjang A disimpan sementara tanpa harus bayar dulu.

  1. Isi keranjang + nama pelanggan (opsional) → klik Parkir di atas keranjang.
  2. Isi label singkat (contoh: “Pak Budi · nunggu”) → keranjang kosong, siap layani pelanggan lain.
  3. Klik Parkiran (n) untuk lihat daftar. Tombol Ambil mengembalikan ke keranjang; Hapus buang parkiran.
  4. Saat Ambil: stok dicek ulang. Jika stok sudah berubah, qty bisa dipotong otomatis (ada peringatan).
  5. Maksimal 20 parkiran. Data tersimpan di browser komputer/HP ini (bukan di server). Ganti perangkat / hapus data browser = parkiran hilang.

Peringatan HPP / jual rugi

  • Jika harga jual < HPP (modal), baris keranjang merah + badge Rugi, dan banner merah di bawah keranjang menampilkan estimasi rugi.
  • Jika produk belum punya HPP (belum ada pembelian/konversi), muncul badge kuning “HPP belum ada”.
  • Saat klik Bayar dan ada item rugi, sistem minta konfirmasi — boleh dilanjutkan (mis. diskon khusus), tapi kasir sadar dulu.
  • HPP diambil dari avg_cost di tab Produk. Isi HPP lewat pembelian / giling agar peringatan akurat.

Pelanggan favorit & terakhir

  • Di bawah nama konsumen ada chip Favorit (bintang) dan Terakhir — 1 ketuk langsung isi nama, tanpa ketik ulang.
  • Tombol di kanan kotak nama: pin/lepas favorit. Jika nama belum di master, otomatis didaftarkan dulu.
  • Di tab Pelanggan, kolom Aksi juga punya bintang untuk pin favorit (sinkron ke semua kasir).
  • Chip “Terakhir” menyimpan hingga 8 nama di browser ini setelah transaksi sukses.

Riwayat jual cepat

Di bawah tombol Bayar/Kosongkan ada panel Riwayat jual cepat (10 transaksi terakhir, 14 hari).

  • Cetak — cetak ulang struk thermal tanpa buka tab Laporan.
  • Link — buat/salin link nota publik ke clipboard (siap tempel WhatsApp).
  • Detail — buka popup ringkasan transaksi (sama seperti setelah bayar).
  • Klik judul panel untuk buka/tutup. Ikon sync memuat ulang daftar.
  • Layout desktop: kolom produk (kiri) dan keranjang (kanan) scroll mandiri — tidak perlu scroll halaman mentok bawah untuk riwayat/bayar.

Cari produk lebih cepat (update terbaru)

  • Chip kategori warna-warni di atas daftar produk — klik Beras / Minyak / Gula / … untuk menyaring. Chip Semua menampilkan seluruh produk. Setiap kategori punya warna lembut berbeda agar mudah dikenali.
  • Kotak pencarian — ketik nama, kode, atau grup varian.
  • Muat lagi — awalnya tampil ~36 produk agar tidak scroll terlalu panjang. Klik tombol untuk menampilkan batch berikutnya.
  • Panah atas / bawah (kanan layar) — loncat ke atas atau bawah halaman tanpa scroll manual. Muncul otomatis saat halaman panjang.
  • Scan Kamera — lihat bab 4b (tanpa beli alat barcode scanner).

4b. Scan Barcode dengan Kamera HP (Tanpa Alat Scanner)

Fitur Scan Kamera memakai kamera belakang HP/tablet/laptop. Tidak perlu membeli mesin barcode scanner USB. Cukup arahkan kamera ke barcode di kemasan produk.

Langkah pakai (HP / tablet — direkomendasikan Chrome)
  1. Buka aplikasi: https://cv-sam-brangkal-kasir.pages.dev lalu login.
  2. Masuk tab Kasir → di bagian Pilih Produk, klik tombol Scan Kamera (ikon kamera).
  3. Browser akan minta izin: pilih Izinkan / Allow akses kamera.
  4. Arahkan kamera ke barcode (garis-garis hitam putih di kemasan) atau QR. Jaga jarak ±10–25 cm, pastikan fokus & cukup cahaya.
  5. Jika kode cocok dengan Kode Produk di master, produk otomatis masuk keranjang dan kamera menutup.
  6. Jika kode terdeteksi tapi belum ada di produk, isi kotak pencarian otomatis — admin perlu daftarkan kode yang sama di tab Produk.

Syarat agar berhasil

Yang didukung

Jenis kode Contoh Keterangan
Barcode EAN-13 / EAN-8899… (umum di Indonesia)Barcode kemasan retail
Code 128 / Code 39Kode internal tokoBisa dicetak sendiri
QR CodeKotak hitam-putihJuga didukung

Troubleshooting kamera

Izin ditolak? Buka pengaturan browser situs → Kamera = Izinkan, lalu refresh (Ctrl+F5 / pull-to-refresh).

Kamera hitam / tidak muncul? Tutup aplikasi lain yang memakai kamera (WhatsApp, Zoom). Coba Chrome terbaru.

Barcode tidak terbaca? Perbaiki pencahayaan, jangan goyang, pastikan barcode tidak rusak/terlipat. Coba zoom mendekat.

Terdeteksi tapi “belum ada di produk”? Salin kode yang muncul → tab Produk → Edit / Tambah → isi field Kode Produk sama persis.

Catatan: alat scanner USB tetap bisa dipakai (ketik ke kotak cari seperti keyboard). Scan Kamera adalah alternatif gratis untuk HP.

5. Tab Produk

Master data barang. Kolom penting: Kode, Nama, Harga Jual, HPP (Modal Rata-rata), Stok.

HPP terisi otomatis dari Nota Pembelian atau Giling. Jika HPP = 0, laporan laba tidak akurat.

Foto produk: Saat admin upload gambar (meski sangat besar), sistem otomatis kompres jadi thumbnail (~240px) agar hemat data & loading Kasir tetap cepat. Akan muncul keterangan “Dikompres otomatis: … MB → … KB”.

Fitur Arsip (Sembunyikan Produk Lama): Terdapat tombol sakelar bertuliskan Arsip. Produk yang sudah tidak dijual lagi tidak boleh dihapus karena dapat merusak riwayat laporan lama; cukup jadikan statusnya "Diarsipkan". Jika sakelar dimatikan, produk arsip disembunyikan agar tabel rapi. Jika sakelar dinyalakan (biru), produk yang diarsipkan akan muncul kembali di tabel.

Agar Scan Kamera berfungsi: isi Kode Produk = angka barcode kemasan (lihat bab 4b).

6. Tab Pembelian - Ringkasan

Tab ini punya 2 sub-tab:

Filter tanggal & cari supplier/no PO ada di sub-tab Nota Pembelian.

7. Tab Giling / Konversi

Mengubah bahan (gabah/BLKP/dll.) menjadi hasil utama + opsional hasil samping. Biaya proses masuk ke HPP hasil utama. Stok berubah otomatis; setiap proses tercatat di Riwayat Konversi dan bisa dicetak sebagai Nota Giling.

Panduan visual (halaman terpisah): klik di sini atau tombol Petunjuk Penggunaan di header tab Giling.

7.1 Profil proses (pilih dulu)

Di atas form ada 3 tombol profil. Ini mengatur SMART FILL, hasil samping, dan peringatan timbangan:

7.2 Cara proses (langkah aman)

  1. Pilih profil yang sesuai.
  2. Pilih bahan — satu baris atau multi-bahan (+ Tambah Bahan Lain).
  3. Isi qty & harga beli/kg. Untuk lot tertentu: klik supplier di pelacakan stok (baris utama) atau pilih batch di baris tambahan (FIFO otomatis = batch terlama).
  4. Isi hasil utama (+ hasil samping jika profil Giling). Boleh pakai SMART FILL lalu koreksi dari timbangan.
  5. Pilih Kredit Hasil Samping (lihat 7.3), isi biaya proses/kg & catatan bila ada.
  6. Cek banner peringatan timbangan (hijau = wajar, kuning = curiga). Total hasil tidak boleh > bahan.
  7. Klik PROSES KONVERSI STOK → konfirmasi. Stok langsung berubah; tab Produk & Kasir ikut di-refresh otomatis.
  8. Opsional: CETAK NOTA GILING (dialog print sistem, tanpa popup browser).

7.3 Kredit hasil samping

HPP hasil utama = (Modal bahan + ongkos proses − kredit sampingan) ÷ qty hasil utama.

Angka di panel preview sama rumusnya dengan yang disimpan server. HPP tidak boleh negatif.

7.4 Rendemen vs Susut

7.5 Riwayat Konversi & Nota

7.6 Tips & kesalahan umum

8. Tab Laporan - Penjelasan Detail

Pusat analisis keuangan. Otomatis muat Bulan Ini. Ganti periode pakai preset atau tanggal manual.

8 Kartu KPI Utama

Transaksi - jumlah nota penjualan.
Subtotal - omzet sebelum PPN.
PPN - total pajak.
Grand Total - uang dibayar pelanggan.
Rata-rata/Trx - nilai rata per struk.
Laba Kotor - Subtotal - HPP.
Beban Ops - gaji, sewa, listrik, dll.
Laba Bersih - Laba Kotor - Beban.

Coverage HPP

Banner hijau/kuning/merah menunjukkan % omzet yang punya data modal. Grade A = bagus. Grade D/F = segera catat pembelian.

Bagian lain di Laporan

9. HPP & Kesehatan Data

Di tab Laporan, scroll ke Kesehatan HPP & Akurasi Laba.

Setiap Nota Pembelian yang dicatat benar akan memperbaiki HPP & Coverage.

10. Beban Operasional & Laba Bersih

Form merah di tab Laporan: catat gaji, sewa, listrik, dll. Laba Bersih = Laba Kotor - total beban.

11. Tab Dashboard

Grafik omzet, transaksi, produk terlaris. Pantauan cepat harian untuk admin.

12. Tab Database

Backup & restore JSON. Lakukan backup mingguan sebelum update besar.

13. Troubleshooting

PO tidak bisa diterima? → Pastikan harga/kg diisi semua baris. Minta kasir/admin yang login.

Surat Jalan gagal simpan - stok tidak cukup? → Cek stok di tab Produk. Terima pembelian dulu atau kurangi qty SJ.

SJ sudah dibuat tapi belum ada nota? → Klik tombol Nota di baris SJ → selesaikan di kasir.

Faktur kosong / salah item? → Pastikan pembayaran kasir sudah sukses. Cetak ulang dari popup sukses.

Laba Kotor terlalu tinggi? → Cek Coverage HPP. Catat Nota Pembelian yang belum diinput.

Giling: hasil ditolak / error melebihi bahan? → Jumlah beras+menir+katul+dedak tidak boleh lebih dari kg bahan. Koreksi timbangan.

Cetak Nota Giling tidak muncul? → Muat versi terbaru (badge merah). Cetak memakai dialog print sistem (bukan popup). Izinkan print di browser bila diminta.

Kamera Scan tidak muncul / izin ditolak? → Izinkan kamera di pengaturan browser untuk situs pages.dev. Pakai Chrome Android. Lihat bab 4b.

Stok tidak sesuai fisik? → Cek urutan: POP belum terima? SJ sudah keluar? Penjualan kasir?

Panduan tampil aneh (huruf rusak)? → Tekan Ctrl+F5 refresh halaman.

Tombol tidak muncul? → Cek role login. POP hanya Admin. Terima PO & SJ bisa Kasir.

14. FAQ

Q: Apa beda POP dan PO di Nota Pembelian?
A: POP = pesan dulu (belum ada harga/stok). PO- di Nota Pembelian = barang sudah datang + harga + stok naik.

Q: Harus selalu buat POP dulu?
A: Tidak wajib. Kalau barang langsung datang, bisa langsung Nota Pembelian. POP berguna kalau sopir berangkat dulu ke supplier.

Q: Siapa input harga beli?
A: Kasir (Mba Nana) saat klik Terima di PO Pengambilan, atau Admin di form Tambah Pembelian.

Q: Apa beda Surat Jalan dan Struk?
A: SJ = bukti barang keluar gudang. Struk = bukti pembayaran penjualan. Urutan: SJ dulu, lalu nota/struk.

Q: Bisa jual tanpa Surat Jalan?
A: Bisa - langsung di Kasir untuk eceran. SJ untuk pengiriman partai/pelanggan besar.

Q: Harus beli alat barcode scanner?
A: Tidak wajib. Pakai tombol Scan Kamera di Kasir (bab 4b). Alat USB tetap opsional.

Q: Kenapa scan berhasil tapi produk tidak masuk keranjang?
A: Kode di barcode belum sama dengan field Kode Produk. Daftarkan/edit kode di tab Produk.

Q: Kapan pakai Faktur A4?
A: Untuk pelanggan yang minta dokumen formal (kredit/partai). Eceran cukup struk kecil.

Q: Apa beda Laba Kotor dan Laba Bersih?
A: Kotor = setelah modal barang. Bersih = setelah gaji/sewa/listrik.

Q: Dimana panduan ini?
A: Tab Panduan di menu atas - selalu tersedia.

15. Alur Koh Hadi - Penjelasan Lengkap

Permintaan dari Koh Hadi: pisahkan dokumen sebelum dan sesudah barang fisik bergerak. Jangan campur jadi satu langkah.

Kenapa dipisah?

Contoh hari kerja nyata

07:00 - Admin buat POP-... untuk ambil 1000 kg Beras Dua Kelapa ke PT. Supplier ABC. Cetak, beri sopir.

10:00 - Barang sampai. Kasir buka tab Pembelian → PO Pengambilan → Terima → isi harga Rp 13.500/kg → simpan. Stok +1000 kg, HPP terupdate.

14:00 - Kirim 500 kg ke CV. Sukses Agro. Buat SJ-... → cetak surat jalan → sopir antar.

15:00 - Klik Nota dari SJ → kasir proses bayar → cetak Faktur A4 untuk pelanggan.

16. PO Pengambilan Barang (POP-...) - Detail

Lokasi: Tab Pembelian → sub-tab PO Pengambilan (tombol hijau).

Siapa buat: Admin / Super Admin.

Langkah membuat PO Pengambilan

  1. Klik Buat PO Pengambilan.
  2. Isi Tanggal, pilih Supplier (atau ketik manual).
  3. Isi Sopir dan Plat Kendaraan (contoh: S 9236 WH).
  4. Isi Perkiraan tiba (opsional).
  5. Tambah Item: pilih produk + qty (kg) saja. Tidak perlu harga di tahap ini.
  6. Klik Simpan & Cetak - dokumen format "PESANAN/PENGAMBILAN BARANG" terbuka untuk print.

Isi dokumen cetak POP

Status PO

Tip: POP hanya pesan. Kalau barang langsung datang tanpa POP, bisa langsung buat Nota Pembelian di sub-tab berikutnya.

17. Nota Pembelian (PO-...) - Detail

Lokasi: Tab Pembelian → sub-tab Nota Pembelian.

Cara A - Dari PO Pengambilan (disarankan)

  1. Buka sub-tab PO Pengambilan.
  2. Cari baris status Menunggu → klik Terima.
  3. Form muncul: produk & qty sudah terisi dari PO.
  4. Kasir isi Harga/kg (harga beli/modal) untuk setiap baris.
  5. Klik Simpan Nota Pembelian.
  6. Sistem otomatis: buat nomor PO-..., tambah stok, hitung HPP, ubah status PO jadi Diterima.

Cara B - Langsung tanpa POP

  1. Sub-tab Nota PembelianTambah Pembelian.
  2. Pilih supplier, tambah item, isi qty & harga modal per kg.
  3. Simpan - langsung masuk stok & HPP.

Apa yang terjadi setelah simpan?

Peran Kasir (Mba Nana): Boleh terima PO & input harga. Tidak boleh buat PO Pengambilan baru (itu tugas Admin).

18. Surat Jalan (SJ-...) - Detail

Lokasi: Tab Surat Jalan (menu biru di atas).

Siapa buat: Admin & Kasir.

Langkah membuat Surat Jalan

  1. Klik Buat Surat Jalan.
  2. Isi Tanggal.
  3. Isi Pelanggan (wajib), Alamat, Telepon.
  4. Isi Sopir & Plat kendaraan pengiriman.
  5. Pilih Cara Bayar: CREDIT (tempo) atau TUNAI.
  6. Isi Jatuh Tempo jika kredit.
  7. Isi Ongkir jika ada biaya kirim.
  8. Tambah Item keluar: produk, qty, satuan, harga jual (referensi).
  9. Simpan & Cetak SJ - dokumen A4 format surat jalan terbuka.

Isi dokumen cetak Surat Jalan

Setelah Surat Jalan dibuat

19. Nota Penjualan & Faktur (TRX-...) - Detail

Ada dua jenis penjualan di CV. SAM:

A. Penjualan dari Surat Jalan (partai/pelanggan besar)

  1. Di tab Surat Jalan, klik Nota pada baris SJ yang sesuai.
  2. Sistem pindah ke tab Kasir - keranjang sudah terisi item & nama pelanggan.
  3. Cek qty & harga, sesuaikan jika perlu.
  4. Proses pembayaran seperti biasa.
  5. Setelah sukses: SJ otomatis tertaut ke transaksi (status: Sudah Nota).
  6. Klik Cetak Faktur (A4) untuk dokumen formal ke pelanggan.

B. Penjualan langsung di Kasir (eceran)

  1. Tab Kasir → pilih produk → bayar.
  2. Cetak Struk 58mm/80mm untuk pelanggan.
  3. Opsional: Cetak Faktur (A4) dari popup sukses pembayaran.

Bedanya Struk vs Faktur

Struk POSFaktur A4
Kertas kecil 58/80mmKertas A4 formal
Cepat untuk eceranUntuk pelanggan partai/kredit
Label: Struk PenjualanLabel: FAKTUR (mirip contoh pink)
Nomor TRX-...Nomor TRX-... + tanda tangan

Isi Faktur A4

Panduan v3 - CV. SAM Brangkal · Scan Kamera HP, chip kategori, scroll cepat · Juli 2026