BAL PERDIVISINilai stok per cabang × divisi

Panduan

Cara memakai BAL PERDIVISI, format file master, arti opsi qty minus, dan cara pasang di VPS.

1. Cara pakai

  1. Export Laporan Nilai Stok untuk semua lokasi (KAN, OL, SBP-…), lalu gabungkan dalam satu file (.ods / .xlsx). Boleh juga upload beberapa file sekaligus, nanti digabung otomatis.
  2. Buka menu Proses, klik kotak upload atau seret file ke sana.
  3. Atur sakelar Qty minus (lihat bagian 3). Pilihan terakhir diingat browser.
  4. Klik Proses. File ±30.000 baris selesai dalam beberapa detik.
  5. Periksa pivot dan Kontrol per cabang, lalu klik Unduh Excel.
Hasil disimpan sementara dan bisa dibuka lagi dari Riwayat di halaman Proses. Setelah 24 jam terhapus otomatis.

2. Format file master

Isinya laporan nilai stok per lokasi yang ditumpuk ke bawah. Tiap blok lokasi berisi judul, header, data, lalu baris TOTAL:

LAPORAN NILAI STOK: 31/08/2026 di KAN
KODEPRODUKKATEGORILOKASISTOK… RATA2 BELI · SUBTOTAL · H.BELI · ORDER · DIVISI
1002015INDOK PRG 9 M GSPiring Keramik 9 & 8KAN28… 596.477 · Keramik & Kaca
…
TOTAL:2.172.929.478,92
LAPORAN NILAI STOK: 31/08/2026 di OL … (blok berikutnya)
  • Kolom wajib: LOKASI, STOK, H.BELI, DIVISI. Posisi kolom dibaca dari header, jadi urutan boleh berbeda.
  • Baris judul, header berulang, baris kosong, dan baris TOTAL: otomatis dilewati.
  • Tanggal di judul (mis. 31/08/2026) dipakai untuk nama file hasil: BAL_PERDIVISI_AGUSTUS_26.xlsx.
  • Baris tanpa DIVISI masuk kolom (Tanpa Divisi) supaya tetap kelihatan.

3. Opsi qty minus

ON: Qty minus TIDAK dihitung (bawaan)
Baris dengan STOK < 0 dibuang dari pivot. Hasilnya sama persis dengan TOTAL di laporan sistem dan dengan contoh BAL PERDIVISI Agustus 2026. Nama file: BAL_PERDIVISI_AGUSTUS_26.xlsx.
OFF: Qty minus IKUT dihitung
Nilai H.BELI minus ikut menjumlah, sehingga total per cabang berkurang sebesar nilai minusnya. Nama file diberi akhiran _DENGAN_MINUS.
Contoh Agustus 2026: ada 1.124 baris qty minus senilai −87.544.617,85. Dengan opsi ON grand total = 11.011.259.058,99; dengan opsi OFF = 10.923.714.441,14.

Apa pun pilihannya, semua baris minus tetap dicantumkan di sheet QTY MINUS untuk dicek.

4. Isi file hasil (Excel)

BAL PERDIVISI
Pivot jumlah H.BELI: baris = CABANG (LOKASI), kolom = DIVISI, plus Grand Total kanan & bawah.
DATA
Seluruh baris data gabungan (KODE s/d DIVISI) tanpa judul/TOTAL, dengan filter.
QTY MINUS
Daftar baris dengan STOK minus beserta nilainya.
KONTROL
Jumlah baris, baris minus, total hasil vs TOTAL master per cabang.

5. Tabel kontrol

Aplikasi membaca baris TOTAL: tiap lokasi dari file master lalu membandingkannya dengan total hasil pivot.

  • Opsi ON → semua cabang harus berstatus cocok. Kalau ada yang tidak cocok, kemungkinan ada baris yang terpotong/berubah saat menggabung file.
  • Opsi OFF → selisih per cabang = nilai minus cabang itu (normal).

6. Jika ada masalah

“Kolom wajib tidak ditemukan”
Header bukan KODE … LOKASI, STOK, H.BELI, DIVISI. Pastikan kolom DIVISI sudah ditambahkan di file master.
“Tidak ada baris data yang dikenali”
Baris header harus diawali sel KODE di kolom A.
“File terlalu besar”
Batas 80 MB. Bisa diubah lewat BAL_MAX_MB di file service.
Ada kolom divisi baru / aneh
Nama divisi diambil apa adanya dari master; perbedaan ejaan/spasi akan jadi kolom terpisah. Perbaiki di master.

7. Pasang / update di VPS

  1. Upload folder BAL_PERDIVISI lewat WinSCP ke /root/upload/BAL_PERDIVISI.
  2. SSH ke VPS (PowerShell), lalu jalankan: 
    cd /root/upload/BAL_PERDIVISI
sudo bash install.sh
  3. Di panel Helipod tambahkan port forwarding 23089 → 5400 (deskripsi “BAL PERDIVISI”).
  4. Buka http://173.212.201.15:23089. Kartu BAL Per Divisi otomatis ditambahkan ke homepage Cockpit oleh install.sh (backup index.html.bak-*).

Untuk update: timpa file di /root/upload/BAL_PERDIVISI, lalu jalankan sudo bash install.sh lagi. Perintah berguna:

systemctl status bal-perdivisi      # cek status
journalctl -u bal-perdivisi -n 50   # lihat log
systemctl restart bal-perdivisi     # restart