Lewati ke konten utama

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 AndaJalur yang BenarAlasan
Barang fisik sudah ada di gudang sebelum sistem dipakai, jumlahnya banyakSaldo Awal Stok (halaman ini)Mengisi saldo pembukaan sekaligus, lengkap dengan nilai HPP dan jurnal saldo awalnya
Barang fisik belum ada, harus dibeli dari pemasokPurchase Order → Terima BarangBarang baru masuk lewat penerimaan pembelian, bukan lewat saldo awal
Saldo sistem sudah berjalan, lalu ditemukan selisih saat hitung fisikStock OpnameOpname adalah alat koreksi selisih, bukan alat input saldo pembukaan
Jangan mencatat barang yang sama dua kali

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.

Prinsip desain

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):

  1. Lokasi tujuan sudah dibuat — gudang/rak fisik tempat barang benar-benar disimpan. Saldo awal tidak boleh diarahkan ke lokasi virtual.
  2. Satuan Ukur (UoM) sudah tersedia — khususnya satuan dasar produk. Saldo Awal Stok tidak membuat UoM baru; kode UoM yang belum ada akan ditolak.
  3. Produk sudah ada atau siap dibuat dari template — produk yang belum ada boleh dibuat otomatis saat posting, asalkan kolom product_name, base_uom_code, dan unit_cost diisi.
  4. HPP (harga pokok) diketahui — untuk produk yang sudah ada, nilai HPP master produk boleh dipakai; untuk produk baru, unit_cost wajib diisi.
  5. Akun akuntansi saldo awal tersedia — akun 1300 Persediaan Barang dan 3900 Saldo Awal / Opening Balance Equity beserta pemetaannya sudah disiapkan otomatis saat perusahaan dibuat. Bila salah satu akun dihapus/dinonaktifkan, posting akan ditolak oleh validasi akun (error ACCOUNT_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:

KolomWajibKeterangan
Tanggal openingYaTerisi otomatis dengan tanggal hari ini. Tanggal ini menjadi tanggal dokumen, tanggal pergerakan stok, dan tanggal jurnal.
Lokasi tujuanYaDipilih dari daftar lokasi (lokasi fisik gudang/rak). Satu batch hanya boleh menuju satu lokasi.
Workbook XLSXYaFile .xlsx hasil pengisian template. Format selain .xlsx ditolak.
CatatanTidakKeterangan bebas, ikut tersimpan pada dokumen batch.
Satu file = satu lokasi

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 (existing atau will_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:

SheetFungsi
OpeningStockInputSatu-satunya sheet yang Anda isi. Baris pertama adalah judul kolom dan tidak boleh diubah.
RulesPenjelasan aturan setiap kolom (wajib/opsional, tipe data, contoh, kode error). Hanya baca.
ReferenceDaftar 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.
Reference hanyalah potret sesaat

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​

KolomWajibTipeAturan
product_codeYaTeksKode produk. Kode yang belum ada direncanakan sebagai produk baru.
product_nameKondisionalTeksWajib untuk produk baru. Untuk produk yang sudah ada hanya dicocokkan sebagai peringatan; master tidak diubah.
product_typeTidakTeksHanya menerima storable, consu, atau bundle (default storable untuk produk baru). service dan recipe ditolak.
category_nameTidakTeksNama kategori produk perusahaan Anda. Kategori baru dibuat saat Proses, tidak saat Dry-run.
base_uom_codeKondisionalTeksWajib untuk produk baru dan harus menunjuk UoM yang sudah ada.
quantityYaAngkaHarus lebih besar dari nol. Dikonversi otomatis ke satuan dasar produk.
uom_codeTidakTeksSatuan transaksi. Kosong berarti satuan dasar. Bila diisi, harus berada pada kategori UoM yang sama.
unit_costKondisionalAngkaWajib untuk produk baru. Untuk produk yang sudah ada, boleh dikosongkan dan sistem memakai HPP master produk.
lot_codeTidakTeksWajib dibiarkan kosong. Produk berlacak lot/serial belum didukung pada versi ini.
allow_negative_stockTidaktrue/falseHanya dipakai bila produk baru dibuat. Produk yang sudah ada tidak diubah.
currency_codeTidakTeksKode mata uang perusahaan untuk produk baru (contoh IDR), bukan nomor internal.
tax_includedTidaktrue/falseHanya dipakai bila produk baru dibuat.
tax_rate_percentTidakPersenTulis 11 atau 11% (rentang 0–100). Hanya dipakai bila produk baru dibuat.
Kolom Dilarang

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​

AturanPerilaku Sistem
Batas barisMaksimum 10.000 baris per file (ROW_LIMIT_EXCEEDED).
Format fileHanya .xlsx; sheet OpeningStockInput wajib ada (SHEET_REQUIRED, FILE_TYPE_UNSUPPORTED).
Baris gandaKombinasi product_code + uom_code yang sama dalam satu file ditolak (DUPLICATE_LINE).
Produk baru gandaSatu product_code baru hanya boleh muncul sekali dalam batch (DUPLICATE_PRODUCT_CREATE).
Kode produk bekasKode produk yang pernah dipakai lalu dihapus dianggap konflik (PRODUCT_CODE_CONFLICT) — gunakan kode baru.
Produk nonaktifDitolak dengan PRODUCT_INACTIVE; sistem tidak membuat produk kedua dengan kode yang sama.
Isolasi dataProduk milik perusahaan lain dianggap tidak ditemukan; datanya tidak pernah dibocorkan.
Satuan tidak dikenalUOM_NOT_FOUND; satuan baru tidak pernah dibuat otomatis.
Satuan beda kategoriUOM_CATEGORY_MISMATCH; konversi tidak diizinkan.
HPP kosongOPENING_COST_REQUIRED bila unit_cost kosong dan HPP master produk juga nol/kosong.
Pelacakan lot/serialProduk berpelacakan lot/serial ditolak (TRACKING_NOT_SUPPORTED_IN_OPENING_STOCK).
Batch gandaKombinasi perusahaan + lokasi + tanggal opening yang sama ditolak (OPENING_STOCK_DUPLICATE).
Sifat postingSatu batch = satu transaksi. Satu baris gagal berarti seluruh batch dibatalkan; tidak ada posting sebagian.

7. Dampak Setelah Batch Diposting​

  1. Pergerakan stok — terbit satu dokumen barang masuk (StockPicking tipe INCOMING) dengan penanda sumber OPENING_STOCK, langsung berstatus selesai. Barang bergerak dari lokasi virtual VIRTUAL-OPENING-<kode perusahaan> ke lokasi tujuan pilihan Anda.

  2. Saldo bertambah — kuantitas pada Kartu Stok dan saldo on-hand bertambah sesuai isi batch pada tanggal opening, bukan tanggal unggah file.

  3. Jurnal saldo awal — satu jurnal terbentuk per batch:

    AkunPosisiNilai
    1300 — Persediaan BarangDebittotal kuantitas dasar × unit_cost
    3900 — Saldo Awal / Opening Balance EquityKredittotal kuantitas dasar × unit_cost

    Nilai unit_cost disimpan sebagai snapshot per baris, sehingga perubahan HPP master produk di kemudian hari tidak mengubah jurnal yang sudah diposting.

  4. 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.

  5. 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:

KolomIsi
TanggalTanggal opening batch.
PickingNomor dokumen barang masuk — dapat diklik untuk membuka detail pergerakan stok.
LokasiGudang/rak tujuan batch.
JurnalNomor jurnal saldo awal batch tersebut (nomor rujukan untuk bagian keuangan).
NilaiTotal 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 service dan recipe.
  • 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_cost yang 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 lihatArtinyaTindakan
OPENING_STOCK_DUPLICATEBatch untuk lokasi dan tanggal tersebut sudah pernah dipostingBuka 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 ProsesHasil 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_SUPPORTEDBaris memakai produk service atau recipe, atau product_type di luar daftar yang diizinkanGanti produknya atau isi storable, consu, atau bundle.
TRACKING_NOT_SUPPORTED_IN_OPENING_STOCKAda isi lot_code, atau produk master berpelacakan lot/serialKosongkan lot_code; untuk produk berpelacakan, catat stoknya di luar alur saldo awal.
OPENING_COST_REQUIREDunit_cost kosong sementara HPP master produk juga nol/kosongIsi unit_cost, atau lengkapi HPP produk di Master Produk lebih dahulu.
UOM_NOT_FOUNDKode satuan tidak ada di perusahaan AndaBuat satuan tersebut di Kategori, Multi-Satuan (UoM) & Kemasan, lalu perbarui file.
UOM_CATEGORY_MISMATCHuom_code berbeda kategori dengan satuan dasar produkSamakan kategori satuan atau biarkan uom_code kosong.
LOCATION_VIRTUALLokasi tujuan bukan lokasi fisikPilih gudang/rak fisik; lihat Hierarki Lokasi & Kartu Stok.
DATABASE_ID_FORBIDDENAda kolom berisi ID internal di fileHapus kolom tersebut; gunakan kode produk, kode satuan, dan nama kategori.
ACCOUNT_MAPPING_INVALIDAkun 1300/3900 atau pemetaannya hilang/nonaktifMinta Administrator Perusahaan memeriksa Bagan Akun (COA), Kas/Bank & Pemetaan Akun.
File ditolak tanpa pesan barisFormat bukan .xlsx, sheet input tidak ada, atau baris melebihi 10.000Unduh template baru, isi, lalu ulangi Dry-run.

Setelah saldo awal diposting

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.