Master Produk & Inventaris
Katalog Master Produk adalah sumber kebenaran tunggal (Single Source of Truth / SSOT) untuk seluruh barang, jasa, dan paket yang diperjualbelikan atau disimpan oleh perusahaan Anda. Data pada master produk akan mengontrol perilaku transaksi di kasir POS, kalkulasi persediaan gudang, perhitungan HPP (Harga Pokok Penjualan), hingga pengenaan faktur pajak.
1. Rincian Formulir Master Produk
Saat Anda membuka menu Produk > Master Produk dan menekan tombol Tambah Produk Baru, formulir berikut akan ditampilkan:
| Nama Field | Tipe Data | Wajib? | Keterangan & Aturan Validasi |
|---|---|---|---|
Nama Produk (name) | String (Maks. 255) | Wajib | Nama resmi produk yang akan tercetak di struk kasir, invoice B2B, dan kartu stok gudang. Contoh: Kopi Susu Gula Aren 250ml. |
Kode Produk / SKU (code) | String (Sequence) | Opsional | Kode SKU unik barang. Jika dikosongkan saat simpan, sistem secara otomatis menerbitkan nomor urut dengan format PRD-xxxxxx. |
Tipe Produk (productType) | Enum | Wajib | Menentukan bagaimana stok diperlakukan: storable, service, consu, bundle, atau recipe. (Lihat penjelasan mendalam di bawah). |
Pelacakan Persediaan (tracking) | Enum | Wajib | Metode pelacakan unit/batch: none (Tanpa Pelacakan/Bulk), lot (Pelacakan Nomor Lot/Batch), atau serial (Pelacakan Nomor Seri Unik per Unit). Khusus tipe service, pelacakan otomatis dikunci ke none. Default: none. |
Harga Jual Standar (price) | Decimal (15,2) | Wajib | Harga jual dasar sebelum diskon. Digunakan sebagai harga patokan default pada Sales Order dan POS. |
Harga Pokok / Modal (defaultCost) | Decimal (15,2) | Opsional | Estimasi HPP awal per unit. Pada barang berjenis storable, nilai ini akan terus diperbarui secara otomatis saat penerimaan barang dari Purchase Order. |
Satuan Dasar (baseUomId) | Relasi (UoM) | Wajib* | Satuan hitung terkecil stok (Unit of Measure), misalnya Pcs, Kg, Liter. Wajib diisi jika produk bertipe storable/bundle/recipe/consu. |
Kategori Produk (categoryId) | Relasi (Category) | Opsional | Klasifikasi produk untuk mempermudah filter tab di kasir POS dan pemilihan lingkup audit Stock Opname. |
Lokasi Default (defaultLocationId) | Relasi (Location) | Opsional | Gudang atau rak standar produk. Dipakai sebagai gudang sumber outbound Sales Order bila dokumen tidak memilih Cabang bergudang (fallback kedua setelah Branch.warehouse), dan sebagai kolom saran lokasi pada template Saldo Awal Stok. |
Kode Barcode (barcode) | String | Opsional | Kode batang produk (EAN-13, UPC, Code 128) untuk pemindaian instan oleh barcode scanner kasir fisik. Opsional (boleh kosong jika barang tidak memiliki barcode). Jika diisi, kode wajib unik dalam tenant perusahaan. |
Tarif PPN (taxRate) | Decimal (5,2) | Opsional | Persentase pajak pertambahan nilai yang berlaku (misal: 11.00 untuk PPN 11%). Default bernilai 0. |
Termasuk Pajak (taxIncluded) | Boolean (Checkbox) | Opsional | Centang jika price sudah merupakan harga bersih termasuk PPN (Gross Pricing). Biarkan tidak tercentang jika PPN dihitung di luar harga (Net Pricing). |
Izin Stok Minus (allowNegativeStock) | Boolean (Checkbox) | Opsional | Menentukan apakah barang boleh dijual saat saldo fisik di sistem bernilai 0. Default: Tidak Aktif (False). |
Titik Pesan Ulang (reorderPoint) | Decimal (15,3) | Opsional | Ambang batas stok minimum (Safety Stock). Jika stok jatuh di bawah angka ini, sistem menampilkan peringatan kebutuhan pengadaan. |
Tampil di POS (availableInPos) | Boolean (Checkbox) | Opsional | Centang agar produk muncul di grid katalog layar kasir POS. |
2. Apa yang Perlu Diperhatikan dan Kenapa (Why)
A. Kenapa Memilih Tipe Produk yang Tepat Sangat Krusial?
Sistem menyediakan 5 klasifikasi tipe produk:
storable(Barang Berstok Fisik):- Perilaku: Menggerakkan mutasi stok fisik di gudang. Setiap penjualan atau pembelian akan menerbitkan pergerakan stok (Stock Move).
- Validasi: Sistem memeriksa ketersediaan saldo sebelum pengiriman dilakukan.
service(Jasa / Layanan):- Perilaku: Tidak memiliki stok fisik di gudang dan tidak pernah menerbitkan mutasi persediaan. Cocok untuk ongkos kirim, jasa perbaikan, atau jasa pasang.
- Pemanfaatan: Pada perakitan bundle, jasa dapat dimasukkan sebagai komponen biaya tenaga kerja perakitan.
consu(Barang Habis Pakai / Konsumabel):- Perilaku: Digunakan untuk barang operasional (misalnya lakban, kardus packing, atau kertas printer). Pergerakan stok dicatat, tetapi saldo habis tidak akan memblokir transaksi pengiriman.
bundle(Paket Kompilasi Fisik):- Perilaku: Produk paket yang memiliki stok fisik tersendiri dan harus dirakit terlebih dahulu dari komponen-komponen penyusunnya melalui formulir Perakitan Bundle (Assembly).
recipe(Menu Resep F&B):- Perilaku: Produk kuliner atau racikan instan (misal Secangkir Kopi). Produk ini tidak perlu dirakit terlebih dahulu; saat kasir POS menjual 1 unit recipe, sistem secara otomatis memotong saldo stok bahan baku penyusunnya (misal: 15 gr biji kopi, 150 ml susu) secara real-time.
Setelah produk disimpan dan terlibat dalam transaksi operasional (sudah memiliki riwayat mutasi stok atau invoice penjualan), tipe produk tidak dapat diubah kembali. Mengubah tipe barang dari berstok menjadi jasa di tengah jalan akan merusak integritas pembukuan kartu stok dan buku besar keuangan.
B. Kenapa Satuan Dasar (baseUom) Terkunci Permanen?
Satuan Dasar (baseUom) adalah denominator tunggal penyimpanan data di tingkat basis data (qty_base). Seluruh transaksi grosir, kemasan karton, atau konversi lusin akan selalu dikalikan dengan faktor konversi dan dicatat dalam qty_base.
Jika sebuah produk sudah pernah mengalami mutasi stok (pembelian, penjualan, atau opname), mencoba mengubah baseUomId akan langsung ditolak oleh server dengan pesan HTTP 409 Conflict. Hal ini diberlakukan demi melindungi validitas riwayat mutasi kartu stok historis. Jika terjadi kekeliruan penetapan satuan dasar pada produk baru yang telah terlanjur transaksi, arsipkan produk tersebut dan buat master produk baru yang benar.
C. Memilih Mode Pelacakan Persediaan (tracking): none, lot, atau serial
Sistem mendukung tiga tingkatan pelacakan persediaan yang dapat ditentukan berbeda untuk setiap produk (opt-in per product):
none(Tanpa Pelacakan / Bulk):- Karakteristik: Persediaan dihitung murni berdasarkan kuantitas fisik (misalnya: 50 Pcs, 10 Kg). Tidak ada nomor seri atau nomor batch yang dicatat.
- Kapan Digunakan: Barang konsumsi massal, makanan/minuman kafe, perlengkapan kantor, kabel eceran, baut, pakaian standar, atau seluruh inventaris toko ritel/warung yang ingin operasional cepat tanpa beban administratif (Zero-Burden).
- Perilaku Transaksi: Kasir POS dan petugas gudang cukup memasukkan jumlah kuantitas tanpa perlu memilih/memindai identitas unit.
lot(Pelacakan Berdasarkan Nomor Lot / Batch):- Karakteristik: Sekelompok barang diproduksi atau didatangkan dalam satu kelompok batch yang sama dan memiliki karakteristik seragam (seperti tanggal kedaluwarsa / expiry date).
- Kapan Digunakan: Obat-obatan farmasi, susu formula, makanan kemasan olahan, bahan kimia, atau cat.
- Perilaku Transaksi: Saat penerimaan barang atau penjualan, pengguna memilih atau menginput nomor lot asal barang tersebut dikeluarkan.
serial(Pelacakan Nomor Seri Unik per Unit):- Karakteristik: Setiap unit fisik barang memiliki identitas nomor seri unik tersendiri (Unique Identifier) dengan kuantitas dasar tepat 1 unit.
- Kapan Digunakan: Perangkat elektronik bergaransi, laptop, smartphone, kompresor mesin, sepeda motor, perhiasan bersertifikat, atau perkakas berharga tinggi.
- Perilaku Transaksi: Diwajibkan memilih atau memindai nomor seri unit fisik saat penerimaan barang dari vendor, transfer antar gudang, hingga kasir POS menyerahkan barang ke pelanggan.
Untuk produk bertipe service (Jasa / Layanan), kolom pelacakan persediaan secara otomatis dikunci ke none dan dinonaktifkan. Karena jasa tidak berwujud fisik dan tidak disimpan di rak gudang, jasa tidak dapat dilacak menggunakan nomor seri ataupun nomor lot.
D. Barcode Opsional: Kapan Perlu Diisi dan Kapan Boleh Kosong?
Sistem menganut prinsip fleksibilitas: Barcode Produk adalah Opsional.
- Kapan Dikosongkan?: UMKM, warung kelontong, restoran F&B, atau produk racikan sendiri yang tidak memiliki label barcode pabrikan dapat membiarkan kolom barcode kosong tanpa masalah. Di meja kasir POS, barang tetap dapat dicari dengan mengetik nama produk atau memilih foto dari grid kategori.
- Kapan Diisi?: Jika barang memiliki barcode pabrik (EAN-13, UPC, Code 128) atau toko Anda mencetak label barcode sendiri, isi kolom ini untuk mempercepat kasir memasukkan barang ke keranjang belanja menggunakan pemindai barcode (barcode scanner).
- Aturan Keunikan Barcode: Jika barcode diisi, nilainya wajib unik di antara seluruh produk aktif dalam perusahaan Anda (unique per tenant). Dua produk berbeda dilarang memiliki barcode yang sama demi mencegah salah ambil produk di meja kasir.
E. Tab Dinamis Nomor Seri / Nomor Lot di Bagian Bawah Formulir
Untuk memberikan kenyamanan operasional tingkat tinggi (Enterprise UX):
- Saat Anda membuka formulir detail produk yang bertipe pelacakan
serial, sistem secara otomatis menampilkan tab khusus Daftar Nomor Seri (Serial Numbers) di bagian bawah formulir.- Tab ini menyajikan daftar seluruh unit nomor seri yang terdaftar untuk produk ini, lengkap dengan status ketersediaan (Tersedia / Terjual / Keluar).
- Terdapat tombol cepat + Tambah Serial untuk mendaftarkan unit baru secara langsung tanpa perlu berpindah menu.
- Jika produk bertipe pelacakan
lot, sistem menampilkan tab Daftar Nomor Lot / Batch yang memuat nomor-nomor lot beserta tanggal kedaluwarsanya. - Jika produk tersebut juga memiliki resep / perakitan (BOM / Bundle), sistem menyatukan seluruh pengelolaan dalam bilah tab (tab switcher) terpadu di bagian bawah.
F. Kenapa Mematikan allowNegativeStock Sangat Disarankan?
Secara default, parameter allowNegativeStock disetel ke Non-aktif (false).
- Risiko Stok Minus: Menjual barang yang saldonya 0 di sistem menandakan ketidaksesuaian antara catatan administratif dan fisik di rak toko. Hal ini berpotensi menutupi kasus pencurian barang, barang tercecer, atau kelalaian penerimaan barang masuk dari supplier.
- Kapan Boleh Diaktifkan?: Hanya aktifkan opsi ini pada unit bisnis ritel dengan perputaran sangat cepat di mana barang fisik telah tiba di toko namun staf gudang belum sempat mengklik tombol terima dokumen pengadaan di sistem komputer.
G. Memahami Skema Pajak: taxRate dan taxIncluded
taxIncluded = false(Harga Bersih / Belum Termasuk PPN): Jika harga produk diinputRp 100.000dengan tarif pajak11%, maka saat produk dimasukkan ke kasir atau Sales Order, total tagihan yang harus dibayar konsumen adalahRp 111.000(Subtotal Rp 100.000 + PPN Rp 11.000).taxIncluded = true(Harga Kotor / Sudah Termasuk PPN): Jika harga produk diinputRp 100.000dengan tarif pajak11%, maka harga jual final di struk kasir tetapRp 100.000. Sistem secara otomatis mengekstrak nilai DPP (Dasar Pengenaan Pajak) sebesarRp 90.090,09dan nilai PPN sebesarRp 9.909,91. Skema ini lazim digunakan pada kafe, restoran, dan toko ritel modern.
3. Alur Kerja Langkah Demi Langkah Menambah Produk
- Masuk ke aplikasi web, buka menu Katalog Barang > Master Produk.
- Klik tombol + Tambah Produk di sudut kanan atas tabel.
- Isi kolom Nama Produk dengan jelas dan lengkap.
- Tentukan Tipe Produk:
- Pilih
storableuntuk barang fisik yang disimpan dan dimutasi di gudang. - Pilih
serviceuntuk ongkos kirim atau jasa instalasi.
- Pilih
- Tentukan Pelacakan Persediaan (
tracking):- Pilih
noneuntuk barang umum/bulk. - Pilih
serialjika barang adalah elektronik/gadget yang memiliki nomor seri unik bergaransi. - Pilih
lotjika barang memiliki tanggal kedaluwarsa atau diproduksi per batch.
- Pilih
- Pilih Satuan Dasar (Base UoM) yang tepat (misal
Pcs). - Masukkan Harga Jual Standar dan Estimasi Harga Pokok (HPP).
- Scan atau ketik kode barcode pada field Kode Barcode jika produk memiliki barcode kemasan (opsional, boleh dikosongkan).
- Tetapkan kategori produk pada Kategori Produk.
- Tentukan pengaturan pajak (
taxRatedantaxIncluded) sesuai kebijakan toko Anda. - Klik tombol Simpan. Sistem akan menerbitkan kode SKU otomatis (jika dikosongkan).
- Jika Anda memilih pelacakan
serialataulot, setelah disimpan Anda dapat langsung mendaftarkan unit nomor seri awal atau nomor batch melalui tab Daftar Nomor Seri atau Daftar Nomor Lot di bagian bawah halaman produk tersebut.