Keunggulan: Hutang Pemegang Saham

Halaman ini menyoroti hal-hal unik di menu Hutang Pemegang Saham Booku — pinjaman dari pemegang saham ke perusahaan dengan filter mitra otomatis, reconciliation saldo, dan posting jurnal atomic.

Aspek	Keterangan
Nama Menu	Hutang Pemegang Saham
Lokasi (Tahun NORMAL)	Sidebar → Buku Pengawasan → Hutang → Hutang Pemegang Saham
Lokasi (Tahun LAMPAU)	Sidebar → Data Awal → Hutang → Hutang Pemegang Saham
Deskripsi User-Facing	`hutang-pemegang-saham.md`

2. Ringkasan Keunggulan

#	Keunggulan	Tagline Singkat	Tier 2 Terkait
1	Filter Pemegang Saham otomatis	Picker hanya menampilkan mitra dengan flag Pemegang Saham = Ya & Lembaga Keuangan = Tidak	#08
2	Bar Saldo dengan reconciliation List vs COA realtime	Saldo (List) vs Saldo (COA + AJP) vs Selisih langsung di atas tabel	#01
3	Pembebanan Biaya Admin 3 opsi dengan jurnal otomatis	Diganti / Dipotong / Ditambahkan saat transfer via Bank — jurnal balance otomatis	#02
4	Cross-Modul Atomic Posting	Master + Bukti Penerimaan + Jurnal disimpan dalam 1 transaction — tidak ada data menggantung	#01, #02
5	UI Dinamis Kontekstual	Sarana Pencairan & Group Box Bank muncul/sembunyi otomatis sesuai pilihan user	#10
6	Konsisten dengan modul Buku Pengawasan lainnya	Pola sama dengan Hutang Karyawan/Afiliasi/Pihak Ketiga — kuasai satu, paham semua	#08

3. Detail per Keunggulan

3.1 Filter Pemegang Saham Otomatis

Masalah di aplikasi lain: User harus memilih kreditur pemegang saham dari daftar semua Lawan Transaksi (customer + supplier + karyawan + afiliasi + pemegang saham tercampur). Risiko salah pilih tinggi — kalau yang dipilih adalah supplier biasa, transaksi tidak ter-track sebagai hutang ke pemilik.

Solusi Booku: Picker Lawan Transaksi di form Input Hutang Pemegang Saham otomatis pasang filter Pemegang Saham = Ya DAN Lembaga Keuangan = Tidak — hanya menampilkan mitra yang sudah ditandai sebagai pemegang saham (dan bukan lembaga keuangan). Filter ini implicit — user tidak perlu klik filter manual setiap buka picker.

📄 Cross-ref: #08 Simple for User

3.2 Bar Saldo dengan Reconciliation List vs COA Realtime

Bar Saldo di atas tabel menampilkan 3 angle:

Saldo (List) — agregasi dari record yang tampil di tabel
Saldo (COA + AJP) — saldo COA Hutang Pemegang Saham (kode 24100) ditambah Adjusment Saldo Awal (AJP)
Selisih — List − COA+AJP, warna merah jika ≠ 0

Membantu user audit konsistensi tracking hutang pemilik vs entry jurnal manual. Selisih merah = ada record yang belum di-Posting, atau jurnal manual yang tidak match dengan master.

Implementation memakai helper terpusat _coaService.GetCoaSaldoAsync — single source of truth lintas modul Buku Pengawasan.

📄 Cross-ref: #01 Realtime Financial Accuracy

3.3 Pembebanan Biaya Admin 3 Opsi dengan Jurnal Otomatis

Saat pemegang saham transfer pinjaman via Bank, sering ada biaya administrasi (mis. Rp 5.000). Siapa yang menanggung dan bagaimana dicatat?

Booku menyediakan 3 opsi Pembebanan saat Sarana Pencairan = Bank dan biaya ditanggung Perusahaan:

Opsi	Behavior	Contoh (pinjaman 1.000.000, biaya 5.000)
Diganti	Biaya dicatat sebagai hutang umum terpisah	Saldo Hutang PS = 1.000.000; Jurnal kredit COA Hutang umum 5.000
Dipotong	Jumlah Transfer berkurang sebesar biaya	Saldo Hutang PS = 1.000.000; Bank masuk 995.000
Ditambahkan	Biaya ditambahkan ke saldo hutang pemilik	Saldo Hutang PS = 1.005.000; Bank masuk 1.000.000

Helper perhitunganValueBank otomatis hitung Saldo Awal, Jumlah Transfer, dan Total Bank sesuai pilihan. Jurnal yang dibuat saat Posting selalu balance.

📄 Cross-ref: #02 Automatic Everything

3.4 Cross-Modul Atomic Posting

Tombol Posting (klik kanan record yang belum diposting) membuka modal Bukti Penerimaan dengan preset lengkap:

Kategori: Penerimaan Tunai
Peruntukan: Hutang Pemegang Saham
Lawan Transaksi: dari hutang terpilih
Sarana Pencairan + Biaya Admin + Pembebanan: dari master

Saat user klik Simpan, backend menjalankan 1 atomic transaction:

Generate NomorJV baru
Insert Bukti Penerimaan + lines
Insert jurnal (Debet Bank/Kas, Kredit Hutang Pemegang Saham)
Update Nomor_JV di master Hutang PS

Semua disimpan bersama atau dibatalkan total. Jika 2 user concurrent klik Posting record yang sama, salah satunya otomatis ditolak — tidak ada double-posting silent.

📄 Cross-ref: #01 Realtime Accuracy, #02 Automatic Everything

3.5 UI Dinamis Kontekstual

Form Input adaptif sesuai konteks:

Konteks	Yang Muncul
Tahun Buku NORMAL	Sarana Pencairan visible — wajib pilih Bank/Cash
Tahun Buku LAMPAU	Sarana Pencairan hidden — hanya input Saldo Akhir manual
Sarana = Bank	Group Box Bank muncul (Biaya Admin + Ditanggung Oleh + Pembebanan)
Sarana = Cash	Group Box Bank tetap hidden
Ditanggung = Perusahaan	Pembebanan visible (Diganti/Dipotong/Ditambahkan)
Ditanggung = Lawan Transaksi	Pembebanan hidden (tidak relevan)
Mode Edit	Field Nomor BPHPS muncul read-only

User tidak perlu skip atau scroll field yang tidak relevan — UI hanya menampilkan apa yang perlu.

📄 Cross-ref: #10 UI Dinamis Kontekstual

3.6 Konsisten dengan Modul Buku Pengawasan Lainnya

User yang sudah paham cara pakai Hutang Karyawan, Hutang Afiliasi, atau Hutang Pihak Ketiga langsung paham cara pakai Hutang Pemegang Saham — tata letak form, perilaku tombol, dan dinamisasi field identik. Yang berbeda hanya filter mitra (PS=Ya), awalan Nomor Bukti (BPHPS), dan COA Hutang yang dipakai.

Konsistensi ini bukan kebetulan — Booku sengaja menggunakan pola yang sama untuk modul-modul Buku Pengawasan dengan struktur mirip.

Manfaat untuk user:

Kurva belajar pendek — kuasai 1 modul, paham semua
Training staf baru lebih cepat
Tidak ada “modul spesial” yang perlu manual khusus

📄 Cross-ref: #08 Simple for User

4. Nilai Tambah untuk User

“Catat pinjaman dari pemilik perusahaan secara terpisah dari hutang reguler — siap untuk audit, pajak, dan pelaporan internal kepada pemegang saham, tanpa risiko tercampur transaksi bisnis biasa.”

Modul Hutang Pemegang Saham memungkinkan pemisahan transaksi pemilik vs bisnis secara jelas. Pinjaman pribadi pemegang saham ke perusahaan (suntikan modal kerja, talangan emergency, dll.) ter-segregasi dari hutang ke supplier reguler — penting untuk transparansi laporan keuangan, pelaporan pajak, dan keputusan corporate (dividen, buy-back saham, dll.). Dipasangkan dengan Bar Saldo reconciliation, user bisa audit konsistensi tracking pinjaman pemilik setiap saat.

5. Dokumentasi Terkait

Dokumen	Relevansi
`Hutang Pemegang Saham (Deskripsi)`	Panduan operasional user-facing
`Piutang Pemegang Saham (Keunggulan)`	Modul mirror — perusahaan memberi pinjaman ke pemegang saham
`Hutang Afiliasi (Keunggulan)`	Modul sejenis untuk counterparty perusahaan afiliasi
`Hutang Pihak Ketiga (Keunggulan)`	Pattern referensi dasar untuk semua modul Hutang non-bisnis

Terakhir diperbarui: 08-05-2026