--- title: "Barang" summary: "Master data setiap barang yang dijual — kode, kategori, brand, warna, ukuran optik, serta harga beli dan jual. Dipakai untuk menambah barang (satuan, massal, atau impor CSV), mengubah harga secara massal, dan mengatur status aktif barang." slug: gudang-barang product: LENSIRO source: https://lensiro.com/dokumentasi/gudang-barang updated: 2026-07-03 --- # Barang > Master data setiap barang yang dijual — kode, kategori, brand, warna, ukuran optik, serta harga beli dan jual. Dipakai untuk menambah barang (satuan, massal, atau impor CSV), mengubah harga secara massal, dan mengatur status aktif barang. ## Pengertian Menu **Gudang → Barang** adalah tempat mengelola master data seluruh barang: kode, nama, kategori, brand, warna, ukuran optik (SPH, CYL, ADD), harga beli, dan harga jual. Data barang di sini terhubung langsung dengan modul **Penjualan**, **Pembelian**, dan **Stok**. Berbeda dengan menu **Stok** yang menampilkan jumlah persediaan, menu **Barang** fokus pada identitas dan atribut produk — termasuk menambah barang baru dan mengatur harganya. ## Fitur Utama - Menampilkan daftar barang dengan kode, nama, harga beli, harga jual, status aktif, dan tanggal kedaluwarsa. - Filter berdasarkan kategori & sub kategori, brand & sub brand, warna & sub warna, ukuran SPH/CYL/ADD, status aktif, dan riwayat transaksi. - Tiga cara menambah barang: **Item Satuan**, **Item Massal**, dan **Import CSV**. - Tombol **Set Harga** untuk memperbarui harga secara massal. - Riwayat pergerakan stok per barang. - Operasi massal: aktifkan, nonaktifkan, tampilkan barcode, dan hapus barang. ## Langkah Penggunaan ### Melihat & menyaring barang 1. Buka menu **Gudang → Barang**. 2. Gunakan filter (kategori, brand, warna, ukuran, status aktif, riwayat transaksi) sesuai kebutuhan. 3. Daftar barang tampil dalam tabel berisi kode, nama, harga beli & harga jual, status, kedaluwarsa, serta brand dan kategori. ![Tangkapan Layar 2026-07-02 pukul 17.10.11.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2F79d9e7da-17de-41fd-804d-068cd73d8a03-Tangkapan_Layar_2026-07-02_pukul_17.10.11.png) *Tampilan: Daftar Barang* ### Menambahkan barang (Item Satuan) 1. Klik **Tambah Barang** di kanan atas — form terbuka pada tab **Item Satuan**. 2. Isi kategori, sub kategori, brand & sub brand, warna, ukuran optik (SPH, CYL, ADD), harga beli, dan harga jual. 3. Klik **Simpan** untuk menyimpan barang. ![Tangkapan Layar 2026-07-03 pukul 08.31.11.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2F15699de5-2485-4bb4-bd5e-e0d305108fdc-Tangkapan_Layar_2026-07-03_pukul_08.31.11.png) *Tampilan: Form Tambah Barang* ### Membuat banyak barang sekaligus (Item Massal) Tab **Item Massal** membuat banyak barang otomatis dari kombinasi nilai resep optik (SPH, CYL, dan ADD). Cocok untuk lensa, yang satu jenisnya bisa punya puluhan hingga ratusan variasi ukuran. 1. Klik **Tambah Barang**, lalu pilih tab **Item Massal**. 2. Isi **Informasi Dasar** (kategori, sub kategori, brand, warna). 3. Pilih nilai **SPH**, **CYL**, dan **ADD** yang diinginkan. Sistem menampilkan jumlah kombinasi dan contoh item yang akan dibuat. 4. Klik **Create Bulk Items** untuk membuat semua kombinasi sekaligus. ![Tangkapan Layar 2026-07-03 pukul 08.33.41.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2F5e7c4806-4515-467f-84fe-5092be3edfb4-Tangkapan_Layar_2026-07-03_pukul_08.33.41.png) *Tampilan: Form Item Massal berdasarkan kombinasi SPH, CYL, dan ADD* Contohnya, untuk produk **Essilor Eyezen Bluecut** dengan rentang SPH +0.25 s/d −6.00, CYL 0.00/−0.25/−0.50/−0.75, dan ADD +0.75/+1.25, sistem membuat seluruh kombinasi lengkap dengan kode otomatis seperti `LNS-EYEZEN-(-2.25/-0.50/+1.25)`. > **Catatan:** Maksimal 30.000 item dapat dibuat sekaligus. Kombinasi yang besar (ratusan item) butuh waktu proses lebih lama — gunakan dengan hati-hati. ### Impor barang dari file CSV Tab **Import CSV** menambahkan banyak barang sekaligus dari file. Cocok untuk input stok awal atau update massal. 1. Klik **Tambah Barang**, lalu pilih tab **Import CSV**. ![Tangkapan Layar 2026-07-02 pukul 17.26.45.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2F20f74361-e911-40f7-b9e6-2647be4f1248-Tangkapan_Layar_2026-07-02_pukul_17.26.45.png) *Tampilan: Import Barang via CSV* 2. Klik **Download Template CSV**, lalu buka file dengan Excel atau Google Sheets. Kolomnya: | Kolom | Wajib | Keterangan | |---|---|---| | Category Name | Ya | Kategori barang (harus sudah ada di master data) | | Branch Name | Ya | Nama cabang (harus sudah ada di master data) | | Brand Name | Ya | Merek barang (dibuat otomatis jika belum ada) | | Sub Category Name | Tidak | Sub kategori barang | | Sub Brand Name | Tidak | Sub brand / seri barang | | SPH, CYL, ADD | Tidak | Nilai resep untuk lensa (kosongkan bila tak perlu) | | Color | Tidak | Warna utama | | Sub Color | Tidak | Warna tambahan / tone | | Sell Price | Ya | Harga jual (angka saja, tanpa "Rp" atau koma) | | Supplier Price | Tidak | Harga beli dari supplier | | Expired Date | Tidak | Format `YYYY-MM-DD`, contoh `2025-12-31` | | Qty | Tidak | Jumlah stok awal barang | | Memo | Tidak | Catatan tambahan | ![02 - Barang-10.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2F87677048-c47a-4e00-b29d-00c3109066e4-02_-_Barang-10.png) *Tampilan: Contoh isi template CSV* 3. Isi data. Aturan penting: tanggal wajib format `YYYY-MM-DD`; harga ditulis angka saja (`300000`, bukan `Rp 300.000`); kolom yang tak perlu dikosongkan; jangan ada baris ganda atau kosong di tengah data. Simpan kembali sebagai **CSV**. 4. Kembali ke jendela import, lalu unggah file lewat area **Upload File CSV** atau drag-and-drop. ![02 - Barang-11.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2Ff829f1ec-243b-44f9-bec0-990ae54c6587-02_-_Barang-11.png) *Tampilan: Area unggah file CSV* Sistem membaca seluruh baris dan menambahkan barang ke daftar. Sub kategori, sub brand, warna, dan sub warna yang belum ada akan dibuat otomatis. Jika ada baris bermasalah (misal kategori tidak ditemukan), sistem menampilkan pesan error untuk diperbaiki. > **Catatan:** Konsep import CSV ini sama seperti di menu Master lain (Cabang, Kategori, Brand, dll.): unduh template → isi data → simpan sebagai CSV → unggah kembali. ### Melihat riwayat pergerakan barang 1. Pada daftar barang, klik tanda panah (**>**) di samping kode barang. 2. Sistem menampilkan riwayat keluar–masuk barang secara kronologis (pembelian, penjualan, retur, mutasi). ![Tangkapan Layar 2026-07-03 pukul 08.38.09.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2F3c892c0a-afed-482c-b26b-d777e5048b19-Tangkapan_Layar_2026-07-03_pukul_08.38.09.png) *Tampilan: Riwayat Pergerakan Barang* > **Hijau (+)** = barang masuk (pembelian, retur penjualan, mutasi masuk). **Merah (−)** = barang keluar (penjualan, retur pembelian, mutasi keluar). ### Operasi massal pada barang 1. Centang satu atau beberapa barang. 2. Klik **Lakukan Operasi**, lalu pilih: | Opsi | Fungsi | |---|---| | **Aktifkan** | Mengaktifkan barang agar bisa dipakai pada transaksi. | | **Nonaktifkan** | Menonaktifkan barang agar tidak muncul di daftar pemilihan transaksi. | | **Tampilkan Barcode** | Menampilkan dan mencetak barcode barang terpilih. | | **Hapus** | Menghapus barang yang belum pernah punya transaksi. | ![02 - Barang operasi.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2Fad14be08-3ca6-4a4e-a75f-f162c9fb2c22-02_-_Barang_operasi.png) *Tampilan: Menu Lakukan Operasi* > **Catatan:** Barang yang sudah pernah bertransaksi tidak bisa dihapus. Bila tak ingin dipakai lagi, ubah statusnya menjadi **Nonaktif**. ### Memperbarui harga secara massal (Set Harga) 1. Pilih barang yang ingin diubah, lalu klik **Set Harga**. 2. Pilih tipe harga yang akan diperbarui — **Harga Jual**, **Harga Beli**, atau tipe harga lain yang dikonfigurasi di Master. 3. Masukkan harga baru. Tabel di bawah menampilkan barang yang akan diperbarui beserta harga sebelum dan sesudah. 4. Klik untuk menyimpan; harga langsung diperbarui di seluruh modul terkait. ![02 - Barang-8.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2Fddc3b8b5-517c-4ff9-8bdf-0b4719333a55-02_-_Barang-8.png) *Tampilan: Setel Harga Barang* ## Catatan & Tips - Data barang terhubung langsung dengan modul **Penjualan**, **Pembelian**, dan **Stok**. - Barang nonaktif tidak muncul di daftar pemilihan transaksi. - Gunakan struktur kategori dan brand yang konsisten agar laporan mudah dibaca. - Untuk perubahan kecil pada satu barang, lebih baik gunakan **Edit Barang** daripada import CSV. ## Lampiran - [02 - Barang-5.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2Fabe13929-e342-404d-9681-13d7e9809be7-02_-_Barang-5.png) — image/png, 251 KB - [02 - Barang-6.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2F3b1f8629-167d-44f6-b6d4-10de2ba016dc-02_-_Barang-6.png) — image/png, 162 KB - [02 - Barang-7.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2F2d1e72b1-9222-46d5-b2b6-f88bc7412e60-02_-_Barang-7.png) — image/png, 263 KB - [02 - Barang-9.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2F9405b2a8-789b-490e-811c-54cf62c9dbbd-02_-_Barang-9.png) — image/png, 99 KB - [02 - Barang-10.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2F87677048-c47a-4e00-b29d-00c3109066e4-02_-_Barang-10.png) — image/png, 139 KB - [02 - Barang-11.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2Ff829f1ec-243b-44f9-bec0-990ae54c6587-02_-_Barang-11.png) — image/png, 22 KB - [02 - Barang riwayat-1.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2F78809268-9175-4b82-bb85-5ce5d45964a3-02_-_Barang_riwayat-1.png) — image/png, 284 KB - [02 - Barang operasi.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2Fad14be08-3ca6-4a4e-a75f-f162c9fb2c22-02_-_Barang_operasi.png) — image/png, 95 KB - [02 - Barang-8.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2Fddc3b8b5-517c-4ff9-8bdf-0b4719333a55-02_-_Barang-8.png) — image/png, 157 KB - [Tangkapan Layar 2026-07-02 pukul 17.10.11.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2F79d9e7da-17de-41fd-804d-068cd73d8a03-Tangkapan_Layar_2026-07-02_pukul_17.10.11.png) — image/png, 253 KB - [Tangkapan Layar 2026-07-02 pukul 17.26.45.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2F20f74361-e911-40f7-b9e6-2647be4f1248-Tangkapan_Layar_2026-07-02_pukul_17.26.45.png) — image/png, 151 KB - [Tangkapan Layar 2026-07-02 pukul 17.30.50.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2Fdd92246d-b1c7-415a-9ae6-c47102c7b7ea-Tangkapan_Layar_2026-07-02_pukul_17.30.50.png) — image/png, 676 KB - [Tangkapan Layar 2026-07-03 pukul 08.31.11.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2F15699de5-2485-4bb4-bd5e-e0d305108fdc-Tangkapan_Layar_2026-07-03_pukul_08.31.11.png) — image/png, 111 KB - [Tangkapan Layar 2026-07-03 pukul 08.33.41.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2F5e7c4806-4515-467f-84fe-5092be3edfb4-Tangkapan_Layar_2026-07-03_pukul_08.33.41.png) — image/png, 110 KB - [Tangkapan Layar 2026-07-03 pukul 08.38.09.png](https://lentera.lensiro.com/api/docs/media?key=knowledge%2F27%2F3c892c0a-afed-482c-b26b-d777e5048b19-Tangkapan_Layar_2026-07-03_pukul_08.38.09.png) — image/png, 687 KB --- Dokumentasi Lensiro · https://lensiro.com/dokumentasi/gudang-barang · diperbarui 3 Juli 2026