Saldo Awal Stok (Opening Stock)
Saldo Awal Stok adalah pintu masuk resmi untuk memindahkan persediaan yang sudah Anda miliki secara fisik ke dalam sistem saat perusahaan mulai memakai aplikasi ini — atau saat membuka gudang/cabang baru dengan barang yang sudah ada di rak.
Alurnya massal dan terkendali: unduh template Excel, isi satu baris per produk, uji dengan Dry-run tanpa menyimpan apa pun, lalu posting dengan tombol Proses secara atomic (satu batch berhasil seluruhnya atau tidak sama sekali).
1. Kapan Memakai Saldo Awal Stok (dan Kapan Tidak)
Tiga jalur di bawah ini sering tertukar. Salah pilih berarti saldo stok dobel atau selisih yang tidak bisa dipertanggungjawabkan:
| Situasi Anda | Jalur yang Benar | Alasan |
|---|---|---|
| Barang fisik sudah ada di gudang sebelum sistem dipakai, jumlahnya banyak | Saldo Awal Stok (halaman ini) | Mengisi saldo pembukaan sekaligus, lengkap dengan nilai HPP dan jurnal saldo awalnya |
| Barang fisik belum ada, harus dibeli dari pemasok | Purchase Order → Terima Barang | Barang baru masuk lewat penerimaan pembelian, bukan lewat saldo awal |
| Saldo sistem sudah berjalan, lalu ditemukan selisih saat hitung fisik | Stock Opname | Opname adalah alat koreksi selisih, bukan alat input saldo pembukaan |
Saldo Awal Stok menambah stok, bukan menyetel ulang saldo. Barang yang sudah dicatat lewat Saldo Awal Stok tidak boleh dicatat lagi lewat Stock Opname atau penerimaan pembelian. Jika ragu, periksa dulu Kartu Stok produk tersebut sebelum mengirim batch saldo awal.
Saldo Awal Stok bukan sekadar penyesuaian stok. Setiap batch membentuk dokumen pergerakan barang sekaligus jurnal akuntansi (Debit Persediaan, Kredit Saldo Awal/Opening Balance Equity). Jadi angka di kartu stok dan angka di laporan keuangan selalu konsisten sejak hari pertama.
2. Prasyarat Sebelum Mengirim Batch Pertama
Pastikan hal-hal berikut sudah selesai (lihat urutan lengkapnya di Mulai dari Sini):
- Lokasi tujuan sudah dibuat — gudang/rak fisik tempat barang benar-benar disimpan. Saldo awal tidak boleh diarahkan ke lokasi virtual.
- Satuan Ukur (UoM) sudah tersedia — khususnya satuan dasar produk. Saldo Awal Stok tidak membuat UoM baru; kode UoM yang belum ada akan ditolak.
- Produk sudah ada atau siap dibuat dari template — produk yang belum ada boleh dibuat otomatis saat posting, asalkan kolom
product_name,base_uom_code, danunit_costdiisi. - HPP (harga pokok) diketahui — untuk produk yang sudah ada, nilai HPP master produk boleh dipakai; untuk produk baru,
unit_costwajib diisi. - Akun akuntansi saldo awal tersedia — akun
1300 Persediaan Barangdan3900 Saldo Awal / Opening Balance Equitybeserta pemetaannya sudah disiapkan otomatis saat perusahaan dibuat. Bila salah satu akun dihapus/dinonaktifkan, posting akan ditolak oleh validasi akun (errorACCOUNT_MAPPING_INVALID).
Siapa yang mengerjakan: peran Administrator Perusahaan (ADMIN_TENANT) atau Supervisor Toko (POS_ADMIN) — yaitu peran yang memiliki hak akses menu Saldo Awal Stok. Peran Kasir dan Pengguna Umum tidak melihat menu ini sama sekali.
3. Diagram Alur Saldo Awal Stok
4. Langkah di Aplikasi
Buka Inventaris & Gudang > Operasional Stok > Saldo Awal Stok (alamat halaman /inventory/opening-stock). Halaman bekerja dalam empat tahap yang tampil sebagai penanda langkah di bagian atas: Parameter → Upload → Dry-run → Commit.
Tahap 1 — Parameter batch
Isi panel Input batch di sisi kiri:
| Kolom | Wajib | Keterangan |
|---|---|---|
| Tanggal opening | Ya | Terisi otomatis dengan tanggal hari ini. Tanggal ini menjadi tanggal dokumen, tanggal pergerakan stok, dan tanggal jurnal. |
| Lokasi tujuan | Ya | Dipilih dari daftar lokasi (lokasi fisik gudang/rak). Satu batch hanya boleh menuju satu lokasi. |
| Workbook XLSX | Ya | File .xlsx hasil pengisian template. Format selain .xlsx ditolak. |
| Catatan | Tidak | Keterangan bebas, ikut tersimpan pada dokumen batch. |
Lokasi dipilih di aplikasi, bukan diulang pada setiap baris Excel. Bila stok awal Anda tersebar di beberapa gudang, buat satu batch terpisah untuk setiap gudang. Satu batch juga hanya boleh diposting sekali untuk kombinasi perusahaan + lokasi + tanggal yang sama.
Tahap 2 — Unduh template dan isi workbook
Klik Download template untuk mengunduh berkas opening-stock-template.xlsx yang sudah berisi daftar produk perusahaan Anda sebagai referensi. Isi hanya sheet pertama (lihat bagian 5).
Tahap 3 — Dry-run dan periksa hasil
Klik Dry-run. Sistem memvalidasi seluruh isi file tanpa menyimpan apa pun, lalu menampilkan panel Review hasil:
- Baris — jumlah baris valid dibanding total baris.
- Qty base — total kuantitas setelah dikonversi ke satuan dasar.
- Nilai — total nilai persediaan yang akan dijurnal.
- Error — jumlah baris bermasalah, ditambah daftar Error batch bila masalahnya menyangkut keseluruhan file.
- Lencana ringkasan: akun Debit, akun Kredit, jumlah Produk baru dan Kategori baru yang akan dibuat.
- Tabel baris berisi nomor baris, kode produk, status (
existingatauwill_create), kuantitas dasar, serta nilai atau pesan error per baris.
Bila masih ada baris error, perbaiki file Excel lalu jalankan Dry-run kembali. Dry-run tidak pernah membuat produk, kategori, stok, atau jurnal — aman diulang sebanyak yang Anda perlu.
Tahap 4 — Posting batch
Setelah seluruh baris valid, tombol Proses menjadi aktif. Saat diklik, sistem memvalidasi ulang file dari awal lalu memposting batch dalam satu transaksi:
- Berhasil — muncul notifikasi Saldo awal diposting beserta nomor dokumen barang dan nomor jurnalnya.
- Gagal — tidak ada satu pun produk, pergerakan stok, atau jurnal yang tersimpan. Perbaiki penyebabnya, jalankan Dry-run lagi, lalu coba Proses kembali.
Aplikasi tidak mengarahkan Anda otomatis ke dokumen hasil. Untuk melihat batch yang sudah masuk, buka tombol Riwayat di kanan atas.
5. Isi Workbook Template
Workbook berisi tiga sheet:
| Sheet | Fungsi |
|---|---|
OpeningStockInput | Satu-satunya sheet yang Anda isi. Baris pertama adalah judul kolom dan tidak boleh diubah. |
Rules | Penjelasan aturan setiap kolom (wajib/opsional, tipe data, contoh, kode error). Hanya baca. |
Reference | Daftar produk perusahaan Anda saat template diunduh: kode, nama, tipe, kategori, satuan, HPP, lokasi default, pelacakan, status aktif, dan pengaturan pajak. Hanya baca — dipakai untuk menyalin kode produk/satuan. |
Sheet Reference dibuat saat template diunduh. Bila master produk berubah setelah itu, isi sheet bisa berbeda. Sistem selalu memvalidasi ulang data Anda ke master yang berlaku saat Dry-run/Proses.
Kolom sheet OpeningStockInput
| Kolom | Wajib | Tipe | Aturan |
|---|---|---|---|
product_code | Ya | Teks | Kode produk. Kode yang belum ada direncanakan sebagai produk baru. |
product_name | Kondisional | Teks | Wajib untuk produk baru. Untuk produk yang sudah ada hanya dicocokkan sebagai peringatan; master tidak diubah. |
product_type | Tidak | Teks | Hanya menerima storable, consu, atau bundle (default storable untuk produk baru). service dan recipe ditolak. |
category_name | Tidak | Teks | Nama kategori produk perusahaan Anda. Kategori baru dibuat saat Proses, tidak saat Dry-run. |
base_uom_code | Kondisional | Teks | Wajib untuk produk baru dan harus menunjuk UoM yang sudah ada. |
quantity | Ya | Angka | Harus lebih besar dari nol. Dikonversi otomatis ke satuan dasar produk. |
uom_code | Tidak | Teks | Satuan transaksi. Kosong berarti satuan dasar. Bila diisi, harus berada pada kategori UoM yang sama. |
unit_cost | Kondisional | Angka | Wajib untuk produk baru. Untuk produk yang sudah ada, boleh dikosongkan dan sistem memakai HPP master produk. |
lot_code | Tidak | Teks | Wajib dibiarkan kosong. Produk berlacak lot/serial belum didukung pada versi ini. |
allow_negative_stock | Tidak | true/false | Hanya dipakai bila produk baru dibuat. Produk yang sudah ada tidak diubah. |
currency_code | Tidak | Teks | Kode mata uang perusahaan untuk produk baru (contoh IDR), bukan nomor internal. |
tax_included | Tidak | true/false | Hanya dipakai bila produk baru dibuat. |
tax_rate_percent | Tidak | Persen | Tulis 11 atau 11% (rentang 0–100). Hanya dipakai bila produk baru dibuat. |
Workbook tidak menerima ID database apa pun — tidak boleh ada product_id, uom_id, location_id, category_id, atau sejenisnya. Kolom seperti itu ditolak dengan error DATABASE_ID_FORBIDDEN. Produk selalu diidentifikasi lewat product_code, satuan lewat kode UoM, dan lokasi dipilih di aplikasi.
Kolom pengaturan produk (allow_negative_stock, currency_code, tax_included, tax_rate_percent) hanya berlaku untuk produk yang baru dibuat. Untuk produk yang sudah ada, kolom ini hanya dibandingkan sebagai peringatan; master produk tidak pernah diubah diam-diam oleh Saldo Awal Stok.
6. Aturan Validasi yang Perlu Diketahui
| Aturan | Perilaku Sistem |
|---|---|
| Batas baris | Maksimum 10.000 baris per file (ROW_LIMIT_EXCEEDED). |
| Format file | Hanya .xlsx; sheet OpeningStockInput wajib ada (SHEET_REQUIRED, FILE_TYPE_UNSUPPORTED). |
| Baris ganda | Kombinasi product_code + uom_code yang sama dalam satu file ditolak (DUPLICATE_LINE). |
| Produk baru ganda | Satu product_code baru hanya boleh muncul sekali dalam batch (DUPLICATE_PRODUCT_CREATE). |
| Kode produk bekas | Kode produk yang pernah dipakai lalu dihapus dianggap konflik (PRODUCT_CODE_CONFLICT) — gunakan kode baru. |
| Produk nonaktif | Ditolak dengan PRODUCT_INACTIVE; sistem tidak membuat produk kedua dengan kode yang sama. |
| Isolasi data | Produk milik perusahaan lain dianggap tidak ditemukan; datanya tidak pernah dibocorkan. |
| Satuan tidak dikenal | UOM_NOT_FOUND; satuan baru tidak pernah dibuat otomatis. |
| Satuan beda kategori | UOM_CATEGORY_MISMATCH; konversi tidak diizinkan. |
| HPP kosong | OPENING_COST_REQUIRED bila unit_cost kosong dan HPP master produk juga nol/kosong. |
| Pelacakan lot/serial | Produk berpelacakan lot/serial ditolak (TRACKING_NOT_SUPPORTED_IN_OPENING_STOCK). |
| Batch ganda | Kombinasi perusahaan + lokasi + tanggal opening yang sama ditolak (OPENING_STOCK_DUPLICATE). |
| Sifat posting | Satu batch = satu transaksi. Satu baris gagal berarti seluruh batch dibatalkan; tidak ada posting sebagian. |
7. Dampak Setelah Batch Diposting
-
Pergerakan stok — terbit satu dokumen barang masuk (
StockPickingtipeINCOMING) dengan penanda sumberOPENING_STOCK, langsung berstatus selesai. Barang bergerak dari lokasi virtualVIRTUAL-OPENING-<kode perusahaan>ke lokasi tujuan pilihan Anda. -
Saldo bertambah — kuantitas pada Kartu Stok dan saldo on-hand bertambah sesuai isi batch pada tanggal opening, bukan tanggal unggah file.
-
Jurnal saldo awal — satu jurnal terbentuk per batch:
Akun Posisi Nilai 1300 — Persediaan BarangDebit total kuantitas dasar × unit_cost3900 — Saldo Awal / Opening Balance EquityKredit total kuantitas dasar × unit_costNilai
unit_costdisimpan sebagai snapshot per baris, sehingga perubahan HPP master produk di kemudian hari tidak mengubah jurnal yang sudah diposting. -
Produk/kategori baru — bila template memuat produk yang belum ada, produk tersebut dibuat melalui jalur master produk yang sama (lengkap dengan validasi perusahaan dan satuan) sebagai bagian dari transaksi yang sama. Perbedaan pada produk yang sudah ada hanya dilaporkan sebagai peringatan, bukan perubahan.
-
Dokumen terkunci — dokumen pergerakan yang sudah selesai tidak dapat diubah atau dihapus, sesuai prinsip audit trail sistem.
8. Memantau Batch: Menu Riwayat
Tombol Riwayat membuka halaman /inventory/opening-stock/history yang menampilkan semua batch yang sudah diposting pada perusahaan aktif:
| Kolom | Isi |
|---|---|
| Tanggal | Tanggal opening batch. |
| Picking | Nomor dokumen barang masuk — dapat diklik untuk membuka detail pergerakan stok. |
| Lokasi | Gudang/rak tujuan batch. |
| Jurnal | Nomor jurnal saldo awal batch tersebut (nomor rujukan untuk bagian keuangan). |
| Nilai | Total nilai persediaan batch. |
Gunakan halaman ini sebagai bukti serah-terima ke bagian keuangan: setiap batch punya satu dokumen barang dan satu nomor jurnal.
9. Batasan Versi Ini
- Tidak mendukung produk berpelacakan lot atau serial.
- Tidak menerima produk bertipe
servicedanrecipe. - Tidak ada formulir input manual di halaman ini — seluruh input melalui template Excel.
- Tidak ada unduhan laporan error terpisah; daftar error tampil di panel Review hasil setelah Dry-run.
- Satu file hanya untuk satu lokasi; beberapa gudang berarti beberapa batch.
- Tidak ada alur persetujuan (approval) pada batch saldo awal.
- Penilaian persediaan memakai
unit_costyang Anda berikan (bukan FIFO/AVCO), dan akun persediaan belum dipecah per kategori produk. - Tidak mengubah produk yang sudah ada, termasuk harga, kategori, satuan dasar, dan pengaturan pajaknya.
10. Penanganan Kendala Umum
| Yang Anda lihat | Artinya | Tindakan |
|---|---|---|
OPENING_STOCK_DUPLICATE | Batch untuk lokasi dan tanggal tersebut sudah pernah diposting | Buka Riwayat untuk memastikan. Satu batch hanya berlaku untuk satu lokasi + satu tanggal; koordinasikan sisa pencatatannya agar stok tidak terhitung dua kali. |
OPENING_STOCK_VALIDATION_FAILED saat klik Proses | Hasil validasi ulang menolak file (misalnya master produk berubah setelah Dry-run) | Jalankan Dry-run sekali lagi, perbaiki baris yang error, lalu Proses kembali. |
PRODUCT_TYPE_NOT_SUPPORTED | Baris memakai produk service atau recipe, atau product_type di luar daftar yang diizinkan | Ganti produknya atau isi storable, consu, atau bundle. |
TRACKING_NOT_SUPPORTED_IN_OPENING_STOCK | Ada isi lot_code, atau produk master berpelacakan lot/serial | Kosongkan lot_code; untuk produk berpelacakan, catat stoknya di luar alur saldo awal. |
OPENING_COST_REQUIRED | unit_cost kosong sementara HPP master produk juga nol/kosong | Isi unit_cost, atau lengkapi HPP produk di Master Produk lebih dahulu. |
UOM_NOT_FOUND | Kode satuan tidak ada di perusahaan Anda | Buat satuan tersebut di Kategori, Multi-Satuan (UoM) & Kemasan, lalu perbarui file. |
UOM_CATEGORY_MISMATCH | uom_code berbeda kategori dengan satuan dasar produk | Samakan kategori satuan atau biarkan uom_code kosong. |
LOCATION_VIRTUAL | Lokasi tujuan bukan lokasi fisik | Pilih gudang/rak fisik; lihat Hierarki Lokasi & Kartu Stok. |
DATABASE_ID_FORBIDDEN | Ada kolom berisi ID internal di file | Hapus kolom tersebut; gunakan kode produk, kode satuan, dan nama kategori. |
ACCOUNT_MAPPING_INVALID | Akun 1300/3900 atau pemetaannya hilang/nonaktif | Minta Administrator Perusahaan memeriksa Bagan Akun (COA), Kas/Bank & Pemetaan Akun. |
| File ditolak tanpa pesan baris | Format bukan .xlsx, sheet input tidak ada, atau baris melebihi 10.000 | Unduh template baru, isi, lalu ulangi Dry-run. |
Lanjutkan ke Penerimaan Purchase Order untuk barang yang akan dibeli, lalu Operasional Kasir Toko (POS) atau Pemesanan Penjualan (Sales Order v2) untuk mulai menjual. Bila di kemudian hari ditemukan selisih fisik, gunakan Stock Opname — bukan Saldo Awal Stok lagi.