📖 Wiki — PosPro: Aplikasi Kasir & Manajemen Bisnis Berbasis Web
Selamat datang di dokumentasi lengkap PosPro — panduan ini ditujukan untuk siapa saja yang ingin memahami, menggunakan, atau mengembangkan aplikasi ini, mulai dari kasir toko hingga pemilik bisnis.
Apa itu PosPro?
PosPro adalah aplikasi kasir berbasis web yang dirancang untuk bisnis modern — percetakan digital, toko kelontong, kafe, konveksi, atau usaha jasa lainnya. Tidak perlu install aplikasi tambahan, cukup buka browser dan langsung bisa digunakan.
Yang membedakan PosPro dari kasir biasa adalah ekosistemnya yang lengkap: bukan hanya mencatat penjualan, tapi juga mengelola stok, membuat penawaran harga profesional ke klien perusahaan, melacak arus kas, memetakan posisi kompetitor, dan mengirim laporan otomatis ke grup WhatsApp pemilik toko.
Daftar Isi Wiki
Baru di sini? Mulai dari 🔄 Alur Bisnis untuk memahami bagaimana semua fitur terhubung, lalu baca panduan sesuai peran Anda.
| # | Halaman | Ringkasan |
|---|---|---|
| 0 | 🔄 Alur Bisnis | Setup awal, alur harian kasir, alur produksi, review keuangan — mulai dari sini |
| 1 | Login & Dashboard | Cara masuk dan membaca ringkasan bisnis harian |
| 2 | Kasir / POS | Cara melayani pelanggan dan mencatat transaksi |
| 3 | Manajemen Produk & Stok | Cara kelola produk, varian, foto, stok, harga bertingkat |
| 4 | DP / Piutang | Melacak pelanggan yang belum lunas |
| 5 | Laporan Penjualan | Riwayat semua transaksi dengan filter tanggal |
| 6 | Laporan Tutup Shift | Rekonsiliasi kas dan rekening bank akhir shift |
| 7 | Laporan Laba Kotor | Profit & margin per produk berdasarkan HPP |
| 8 | Data Pelanggan | Database & riwayat belanja pelanggan |
| 9 | WhatsApp Bot | Setup bot laporan otomatis ke grup WA owner |
| 10 | 💰 Cashflow Bisnis | Arus kas pemasukan & pengeluaran, chart, export |
| 11 | 📄 Invoice & Penawaran Harga | Buat invoice & SPH profesional untuk klien B2B |
| 12 | 🗺️ Peta Cuan Lokasi | Peta cabang, kompetitor, dan pencarian bisnis |
| 13 | 🎨 Tampilan Login | Upload foto latar, atur tagline, animated logo |
| 14 | 🖨️ Antrian Produksi | Antrian cetak, job satuan & batch, produk rakitan multi-tahap, search, detail invoice |
| 15 | 📋 Stok Opname | Hitung fisik stok via link operator untuk karyawan |
| 16 | 🏭 Data Supplier | Kelola data supplier dan harga beli per varian produk |
| 17 | 💾 Backup & Restore | Backup database ke ZIP, preview, dan restore dari file |
| 18 | 🧮 Kalkulator HPP | Worksheet biaya produksi, multi-varian, biaya tambah, simpan sebagai produk |
| 19 | 🚀 Panduan Deployment | Setup di home server / VPS dengan Cloudflare Tunnel |
🔐 1. Login ke Aplikasi
Buka browser dan akses alamat aplikasi (contoh: http://localhost:3000).
- Email: masukkan email akun Anda (contoh:
admin@toko.com) - Password: masukkan kata sandi
Klik Sign In. Jika berhasil, Anda akan masuk ke halaman Dashboard.
Lupa password? Hubungi administrator toko untuk mereset akun Anda.
🏠 2. Halaman Utama / Dashboard
Setelah login, Anda akan melihat Dashboard — halaman ringkasan kondisi bisnis hari ini secara sekilas.
| Kartu Informasi | Penjelasan |
|---|---|
| Total Penjualan Hari Ini | Jumlah uang yang masuk dari semua transaksi hari ini |
| Jumlah Transaksi | Berapa kali terjadi transaksi penjualan |
| Produk Terjual | Total item yang sudah laku |
| Saldo per Rekening | Saldo terkini di setiap rekening bank yang terdaftar |
Di Dashboard juga terdapat grafik penjualan yang menampilkan tren harian atau mingguan, sehingga pemilik toko bisa langsung melihat perkembangan bisnis tanpa perlu membuka laporan detail.
🛒 3. Kasir / Point of Sale (POS)
Halaman kasir adalah inti dari aplikasi — tempat mencatat setiap transaksi penjualan secara real-time.
Cara Bertransaksi
Langkah 1 — Cari dan Tambah Produk
- Ketik nama produk di kotak pencarian, atau
- Gunakan scanner barcode (kamera HP atau scanner fisik) — klik ikon kamera di sebelah kotak pencarian
- Klik produk untuk menambahkannya ke keranjang
Langkah 2 — Atur Keranjang
- Klik tombol + / − untuk mengubah jumlah
- Untuk produk Digital Printing (banner, sticker, MMT): masukkan ukuran lebar dan tinggi — harga dihitung otomatis sesuai satuan:
- Meter (m²): harga per m², masukkan Lebar × Tinggi dalam meter
- Sentimeter (cm²): harga per cm², masukkan Lebar × Tinggi dalam cm — cocok untuk produk harga-per-cm²
- Menit: harga per menit, masukkan durasi di kolom lebar
- Produk dengan ∞ (Tanpa Lacak Stok) bisa ditambahkan ke keranjang tanpa batas
- Klik ikon tempat sampah untuk menghapus item dari keranjang
Langkah 3 — Pilih Metode Pembayaran
- Tunai (Cash): masukkan nominal yang diterima, sistem otomatis hitung kembalian
- Transfer Bank: pilih rekening tujuan transfer yang diinginkan pelanggan
- QRIS: tampilkan QR code ke pelanggan untuk dipindai
Langkah 4 — Selesaikan Transaksi
- Klik Bayar Lunas untuk pembayaran penuh
- Klik Bayar DP jika pelanggan hanya membayar sebagian (uang muka) — transaksi akan masuk ke daftar Piutang
Langkah 5 — Struk
- Setelah transaksi selesai, struk muncul otomatis
- Klik Cetak untuk mencetak ke printer thermal
- Klik Kirim WA untuk mengirim ringkasan tagihan ke WhatsApp pelanggan
Tips: Produk mode Area Based akan otomatis memunculkan modal input Lebar × Tinggi saat ditambahkan ke keranjang. Pilih satuan yang sesuai produk (m, cm, atau menit) — harga dan stok dihitung secara independen berdasarkan satuan tersebut.
📦 4. Manajemen Produk & Stok
Halaman untuk mengelola semua produk, varian, bahan baku, dan stok yang dijual di toko.
Yang Bisa Dilakukan
Menambah Produk Baru
- Klik + Tambah Produk
- Isi nama, kategori, satuan, dan harga jual
- Pilih Mode Harga:
- Normal (per unit): untuk produk yang dijual per pcs, lusin, kg, dll
- Area Based: untuk banner, sticker, MMT, kain — harga dihitung dari lebar × tinggi. Pilih satuan:
- m → harga per m² (standar percetakan)
- cm → harga per cm² (produk dengan harga satuan cm²)
- menit → harga per menit (jasa berbasis durasi)
- Atur Lacak Stok:
- Aktif (default): stok terpotong otomatis setiap transaksi, bisa dimonitor & diisi ulang
- Nonaktif (Tanpa Lacak Stok): produk/jasa tidak butuh kontrol stok — tampil ∞ di kasir dan inventori, bisa diorder tanpa batas
- Upload foto produk (opsional tapi direkomendasikan; format JPG, PNG, WEBP, JFIF)
- Tambahkan Varian jika produk memiliki pilihan ukuran/warna/jenis
- Tambahkan Bahan Baku jika ingin stok bahan baku otomatis terpotong saat produk terjual
- Klik Simpan
Mengelola Stok
- Stok terpotong otomatis setiap kali ada transaksi di kasir (hanya produk yang Lacak Stok aktif)
- Produk dengan Tanpa Lacak Stok ditampilkan dengan simbol ∞ — tidak perlu diisi stoknya, tetap bisa diorder
- Untuk penambahan stok (restock), buka produk → klik Tambah Stok → masukkan jumlah
- Semua pergerakan stok tercatat di Riwayat Stok (masuk, keluar, penyesuaian)
Varian Produk
Cocok untuk produk yang punya variasi. Contoh:
- Kaos → Varian: S, M, L, XL (stok dan harga bisa berbeda per varian)
- Tinta Printer → Varian: Hitam, Cyan, Magenta, Yellow
Harga Bertingkat (Price Tiers)
Setiap varian bisa punya beberapa level harga berdasarkan jumlah qty yang dibeli. Contoh:
| Range Qty | Harga per Unit |
|---|---|
| 1–5 pcs | Rp 25.000 |
| 6–20 pcs | Rp 22.000 |
| 21 pcs ke atas | Rp 18.000 |
- Cara set: buka halaman Edit Produk → bagian Varian → klik + Tambah Tier
- Di kasir POS: harga otomatis berubah sesuai qty yang dimasukkan operator
- Harga yang tampil di kartu produk kasir = harga tier pertama (harga qty terendah)
- Harga yang tampil di inventori = harga tier pertama, dengan badge jumlah tier aktif
- Jika qty tidak cocok tier manapun, harga fallback ke Harga Jual utama varian
Tipe Produk
Saat membuat produk, pilih tipe yang sesuai:
| Tipe | Keterangan |
|---|---|
| Produk Jual (SELLABLE) | Produk/jasa yang dijual ke pelanggan — muncul di kasir |
| Bahan Baku (RAW_MATERIAL) | Material produksi — tidak muncul di kasir, dipakai di BOM/Ingredient |
| Jasa (SERVICE) | Layanan tanpa stok fisik |
Impor Produk Massal (Bulk Import)
Untuk menambahkan banyak produk sekaligus tanpa input satu per satu:
- Buka halaman Inventori → klik tombol Import Excel
- Klik Download Template — unduh file Excel dengan contoh isi dan panduan kolom
- Isi data produk di file Excel (nama, kategori, varian, harga, HPP, stok)
- Upload file yang sudah diisi → sistem menampilkan preview validasi sebelum data disimpan
- Klik Impor — produk yang valid langsung tersimpan; error per baris ditampilkan terpisah
Pengaturan Material Roll
Untuk produk berbahan gulungan (banner, vinyl, MMT, kain):
- Di halaman Edit Produk → bagian Varian → centang Bahan roll (banner, MMT, dll)
- Isi Lebar Fisik (m) — lebar total gulungan saat diterima dari supplier
- Isi Lebar Cetak Efektif (m) — lebar yang bisa dipakai untuk cetak (setelah dikurangi tepi/waste)
Data ini digunakan operator di halaman Antrian Produksi untuk menghitung pemakaian bahan aktual per job.
Stok Menipis
Badge "Menipis" (merah) hanya muncul untuk produk yang mengaktifkan Lacak Stok. Produk dengan simbol ∞ (Tanpa Lacak Stok) tidak pernah masuk daftar peringatan stok menipis — baik di dashboard maupun di halaman inventori.
💳 5. Daftar DP / Piutang
Daftar semua transaksi yang belum sepenuhnya dilunasi oleh pelanggan.
Ini muncul ketika kasir memilih Bayar DP saat bertransaksi — artinya pelanggan baru membayar sebagian dan masih punya sisa tagihan.
Informasi yang Ditampilkan
| Kolom | Keterangan |
|---|---|
| Nama Pelanggan | Siapa yang punya piutang |
| Total Tagihan | Harga total transaksi |
| Sudah Dibayar | Jumlah DP yang sudah masuk |
| Sisa Tagihan | Yang masih harus dilunasi |
| Jatuh Tempo | Deadline pelunasan |
Cara Mencatat Pelunasan
Saat pelanggan datang untuk melunasi:
- Cari nama pelanggan di daftar piutang
- Klik tombol Lunasi
- Pilih metode pembayaran pelunasan
- Klik Konfirmasi — sistem otomatis mencatat pembayaran dan mengupdate sisa tagihan
Setiap pelunasan otomatis tercatat di Cashflow sebagai pemasukan.
📊 6. Laporan Penjualan
Ringkasan lengkap semua transaksi yang pernah terjadi, bisa difilter berdasarkan rentang tanggal.
Yang tersedia:
- Filter tanggal (pilih dari–sampai)
- Detail setiap transaksi: waktu, kasir, item terjual, metode bayar, total
- Tombol Cetak Ulang Struk untuk transaksi lama
- Export ke Excel untuk laporan eksternal atau pembukuan manual
📈 Laporan Laba Kotor
Analisis margin profit per produk dalam periode tertentu — tersedia di Laporan → Laba Kotor (/reports/profit).
| Kolom | Keterangan |
|---|---|
| Nama Produk / Varian | Item yang terjual pada periode tersebut |
| Total Pendapatan | Harga jual × jumlah terjual |
| Total HPP | Modal per unit × jumlah terjual |
| Laba Kotor | Pendapatan − Total HPP |
| Margin % | (Laba Kotor ÷ Pendapatan) × 100% |
Cara menggunakan:
- Buka Laporan → Laba Kotor
- Pilih rentang tanggal (filter dari–sampai)
- Laporan menampilkan breakdown per produk/varian yang terjual dalam periode tersebut
- Klik Export Excel untuk menyimpan laporan
Sumber HPP: nilai HPP yang dipakai di laporan ini berasal dari field Modal/HPP yang diset di setiap varian produk. Pastikan HPP varian sudah diisi (bisa melalui Kalkulator HPP) agar laporan ini akurat.
📋 7. Laporan Tutup Shift ⭐
Fitur unggulan PosPro — sistem rekonsiliasi kas yang membantu kasir dan pemilik toko memastikan tidak ada selisih keuangan di akhir shift.
Konsep Dasar
Sistem secara otomatis menghitung berapa uang yang seharusnya ada berdasarkan data transaksi. Kasir kemudian menginput berapa yang aktualnya ada. Sistem langsung menampilkan selisihnya.
Cara Mengisi Form Tutup Shift
Step 1 — Identitas Kasir
- Pilih nama kasir dari dropdown
- Pilih jenis shift: Shift Pagi / Shift Siang / Long Shift
Step 2 — Panel Kiri: "Data Sistem" (Baca Saja)
Panel ini sudah terisi otomatis, kasir hanya perlu membacanya:
| Label | Artinya |
|---|---|
| Total Gross Shift | Total pendapatan kotor shift ini |
| Cash | Total uang tunai dari transaksi |
| Transfer BCA / Mandiri / dll | Total transfer masuk per rekening |
| QRIS | Total pembayaran via QRIS |
| Target Saldo Bank | Prediksi saldo rekening sekarang (saldo awal + masuk shift ini) |
Step 3 — Panel Kanan: "Aktual" (Isi Oleh Kasir)
- Uang Tunai di Laci: hitung fisik uang di laci kasir, lalu masukkan totalnya
- Total QRIS Hari Ini: buka aplikasi QRIS, lihat total mutasi masuk
- Setelah diisi, badge otomatis muncul:
- 🟢 LEBIH — uang aktual lebih dari target
- 🔴 KURANG — uang aktual kurang dari target
- ✅ BALANCE — tepat sesuai
Step 4 — Catat Pengeluaran Shift
Catat semua pengeluaran yang terjadi selama shift:
- Klik + Tambah Item
- Isi: keterangan (contoh: "Beli kertas HVS"), nominal, metode bayar (cash/transfer)
Step 5 — Saldo Rekening Bank
Buka mBanking masing-masing rekening, lalu isi:
- Saldo di Laporan mBanking: angka yang terlihat di aplikasi bank
- Saldo Real: saldo yang dikonfirmasi sudah benar-benar masuk
Step 6 — Lampirkan Foto & Kirim
- Upload foto bukti (foto laci uang, layar EDC QRIS, layar mBanking) — maksimal 20 foto
- Klik Kirim Laporan Shift ke WA → laporan terkirim otomatis ke grup WhatsApp pemilik
👥 8. Data Pelanggan
Database seluruh pelanggan toko, lengkap dengan riwayat transaksi dan statistik belanja.
Informasi per pelanggan:
- Nama, nomor HP, alamat
- Total pembelian sepanjang waktu
- Frekuensi belanja
- Rata-rata nilai transaksi
- Daftar transaksi terakhir
Kegunaan:
- Lacak pelanggan setia untuk program loyalitas
- Identifikasi pelanggan dengan piutang terbesar
- Export data pelanggan untuk kebutuhan pemasaran
🤖 9. Pengaturan WhatsApp Bot
Bot WhatsApp berjalan langsung di dalam server PosPro — tidak perlu aplikasi atau layanan pihak ketiga.
Cara Menghubungkan Bot
- Buka halaman Pengaturan → WhatsApp Bot
- Tunggu QR Code muncul di layar
- Di HP Anda: buka WhatsApp → Perangkat Tertaut → Tautkan Perangkat
- Scan QR Code
- Status berubah menjadi "TERHUBUNG SEDIA" ✅
Cara Setup Grup Penerima Laporan
- Buat atau buka grup WhatsApp yang akan menerima laporan (contoh: "Owner VOLIKO")
- Tambahkan nomor WhatsApp bot ke grup tersebut
- Ketik
!getgroupiddi grup — bot akan balas dengan ID grup - Salin ID tersebut (formatnya angka panjang diakhiri
@g.us) - Ketik:
!botadmin setreportgroup [ID_GRUP_TADI] - Bot siap mengirim laporan shift ke grup tersebut ✅
Perintah Bot
| Perintah | Fungsi |
|---|---|
!getgroupid | Tampilkan ID grup ini |
!botadmin status | Cek status bot |
!botadmin addgroup [ID] | Izinkan bot beroperasi di grup ini |
!botadmin removegroup [ID] | Cabut izin grup |
!botadmin listgroups | Lihat semua grup yang diizinkan |
!botadmin setreportgroup [ID] | Atur grup tujuan laporan shift |
Broadcast & Pengumuman
Selain laporan shift, bot WhatsApp juga mendukung dua fitur pesan massal:
Broadcast ke Banyak Grup
- Kirim satu pesan ke semua grup yang terdaftar di daftar
broadcastGroupssekaligus - Cocok untuk mengumumkan promosi, perubahan harga, atau info toko
- Konfigurasi grup broadcast via API:
POST /whatsapp/broadcastdengan payload{ message: "..." }
Announcement Channel
- Kirim pesan ke satu saluran pengumuman khusus (
announcementChannelId) - Cocok untuk notifikasi internal ke tim atau channel toko
- Endpoint:
POST /whatsapp/announcedengan payload{ message: "..." }
Konfigurasi broadcastGroups[] dan announcementChannelId disimpan di backend/whatsapp_bot_config.json (sama seperti reportGroupId).
Perbedaan Broadcast vs Report: Broadcast mengirim ke semua grup di
broadcastGroups[], sedangkan laporan shift hanya dikirim ke satureportGroupIdyang ditentukan.
Jika Bot Terputus
Masuk ke Pengaturan → WhatsApp Bot, klik Logout & Restart Bot, lalu scan QR Code ulang.
🎨 10. Pengaturan Tampilan Halaman Login
Pemilik toko dapat menyesuaikan tampilan halaman login agar sesuai dengan identitas brand.
Buka Pengaturan → Tampilan Login untuk mengakses pengaturan ini.
Gambar Latar (Background Slideshow)
- Klik Upload Gambar untuk mengunggah foto (JPG, PNG, WEBP)
- Bisa upload beberapa foto sekaligus
- Foto akan tampil bergantian setiap 6 detik dengan efek Ken Burns (zoom + geser halus) otomatis
- Klik ikon × pada thumbnail untuk menghapus gambar
- Jika tidak ada gambar yang diupload, halaman login menggunakan gradient gelap bawaan
Tagline / Slogan
Teks yang berganti-ganti di bagian bawah panel kiri halaman login.
- Ketik tagline di kolom input, lalu klik Tambah (atau tekan Enter)
- Tagline berganti setiap 5 detik
- Jika tidak ada tagline, tampil default: "Solusi POS Terpadu untuk Bisnis Anda"
Logo & Nama Toko
Logo dan nama toko yang tampil di pojok kiri atas panel login diambil otomatis dari pengaturan Profil Toko — tidak perlu diatur ulang di sini.
Setelah mengubah gambar atau tagline, klik Simpan Perubahan agar tersimpan.
❓ FAQ Umum
Q: Apakah PosPro bisa dipakai di HP?
Ya. Tampilan responsif untuk layar HP, tablet, dan PC. Untuk kasir aktif, tablet atau PC lebih nyaman digunakan.
Q: Apakah data tersimpan secara online atau lokal?
Data tersimpan di database server lokal milik toko (MySQL). Anda memiliki kendali penuh atas data sendiri.
Q: Apakah bisa multi-kasir (lebih dari satu perangkat)?
Ya — karena berbasis web, beberapa perangkat bisa login dan mengakses PosPro secara bersamaan dari jaringan yang sama.
Q: Apakah ada fitur laporan pajak?
PosPro mendukung PPN pada Invoice & Penawaran Harga. Untuk laporan pajak formal, gunakan fitur export Excel dan olah di aplikasi akuntansi Anda.
Q: Bagaimana cara menambah akun kasir baru?
Login sebagai Admin → buka Pengaturan → Manajemen User → klik + Tambah User → isi nama, email, dan password.
📚 Halaman Wiki Lanjutan
Dokumentasi lengkap untuk fitur-fitur bisnis tingkat lanjut:
| Wiki | Isi |
|---|---|
| 🔄 Alur Bisnis | Mulai dari sini — setup awal, alur harian, alur produksi, review keuangan |
| 💰 Cashflow Bisnis | Arus kas, chart tren, kategorisasi, export Excel |
| 📄 Invoice & Penawaran Harga | Invoice B2B, SPH, catalog picker, area-based pricing |
| 🗺️ Peta Cuan Lokasi | Peta cabang, kompetitor, pencarian bisnis by keyword |
| 🖨️ Antrian Produksi | Antrian cetak, batch, produk rakitan multi-tahap, search pelanggan, detail invoice |
| 📋 Stok Opname | Link operator blind count, review admin, update stok otomatis |
| 🏭 Data Supplier | Kelola supplier dan harga beli per varian produk |
| 💾 Backup & Restore | Backup database ke ZIP, restore dengan mode skip/overwrite |
| 🧮 Kalkulator HPP | Worksheet biaya produksi, multi-varian, biaya tambah, simpan sebagai produk |
| 🚀 Panduan Deployment Cloudflare | Setup produksi di Home Server (MySQL, PM2, Cloudflare Tunnel) |
Dokumentasi PosPro — Terakhir diperbarui: 26 Maret 2026 | v2.8 — Alur Bisnis, Supplier Management, Backup & Restore, Stok Opname, Antrian Produksi Rakitan, HPP Multi-Varian, Harga Bertingkat