Keunggulan: Piutang Pemegang Saham
Halaman ini menyoroti hal-hal unik di menu Piutang Pemegang Saham Booku — pinjaman perusahaan kepada pemegang saham dengan tracking terpisah, sarana pembayaran ditentukan saat posting, dan pencairan dengan jurnal otomatis.
1. Identitas Menu
| Aspek | Keterangan |
|---|---|
| Nama Menu | Piutang Pemegang Saham |
| Lokasi (Tahun NORMAL) | Sidebar → Buku Pengawasan → Piutang → Piutang Pemegang Saham |
| Lokasi (Tahun LAMPAU) | Sidebar → Data Awal → Piutang → Piutang Pemegang Saham |
| Deskripsi User-Facing | piutang-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 | Form input minimal — Sarana di-defer ke Posting | Form input ringkas tanpa Sarana Pembayaran; sarana dipilih saat Pencairan jurnal | #10 |
| 3 | Bar Saldo dengan reconciliation List vs COA realtime | Saldo (List) vs Saldo (COA + AJP) vs Selisih langsung di atas tabel | #01 |
| 4 | Cross-Modul Atomic Posting | Master + Bukti Pengeluaran + Jurnal + sync field Bank dalam 1 transaction | #01, #02 |
| 5 | Tombol Cair dengan auto-load tagihan | Klik Cair → modal Bukti Penerimaan otomatis berisi baris piutang dengan sisa | #02 |
| 6 | Konsisten dengan modul Buku Pengawasan lainnya | Pola sama dengan Piutang Karyawan/Afiliasi/Pihak Ketiga — kuasai satu, paham semua | #08 |
3. Detail per Keunggulan
3.1 Filter Pemegang Saham Otomatis
Sama dengan modul Hutang Pemegang Saham: picker Lawan Transaksi di form Input Piutang otomatis pasang filter Pemegang Saham = Ya DAN Lembaga Keuangan = Tidak — hanya menampilkan mitra yang sudah ditandai sebagai pemegang saham.
Filter ini implicit — user tidak perlu klik filter manual. Mencegah salah pilih: kalau debitur sebenarnya customer biasa, transaksi tidak ter-track sebagai piutang ke pemilik (yang konteksnya berbeda secara akuntansi & perpajakan).
📄 Cross-ref: #08 Simple for User
3.2 Form Input Minimal — Sarana di-Defer ke Posting
Berbeda dengan Hutang Pemegang Saham: form Input Piutang TIDAK menampilkan Sarana Pembayaran dan Group Box Bank. Hanya field dasar:
- Tanggal
- Pemegang Saham (picker filter)
- Jumlah Pinjaman
- Nomor Kontrak (opsional)
- Saldo Awal (computed di NORMAL, manual di LAMPAU)
- Keterangan (opsional)
Info banner muncul: “Sarana Pembayaran piutang ditentukan saat posting via menu Bukti Pengeluaran”.
Mengapa begitu? Saat user input piutang, transaksi pencairan belum tentu terjadi langsung — bisa beda hari, beda sarana. Memaksa user pilih Sarana di form input akan menambah field yang sering tidak akurat. Booku ikuti pola sistem internal yang sudah teruji 3+ tahun: input dulu data piutang, sarana pembayaran ditentukan saat eksekusi pencairan via Posting.
📄 Cross-ref: #10 UI Dinamis Kontekstual
3.3 Bar Saldo dengan Reconciliation List vs COA Realtime
Sama persis dengan modul Hutang Pemegang Saham — Bar Saldo menampilkan 3 angle (List, COA+AJP, Selisih) menggunakan helper terpusat _coaService.GetCoaSaldoAsync dengan KodeTautanCOA_PiutangPemegangSaham (11505).
Membantu user audit konsistensi tracking pinjaman ke pemilik vs entry jurnal manual. Selisih merah = ada record yang belum di-Posting, atau jurnal manual yang tidak match dengan master.
📄 Cross-ref: #01 Realtime Financial Accuracy
3.4 Cross-Modul Atomic Posting
Tombol Posting (klik kanan record yang belum diposting) membuka modal Bukti Pengeluaran (uang keluar dari perusahaan ke pemegang saham) dengan preset lengkap. Saat user pilih Sarana Pembayaran + klik Simpan, backend menjalankan 1 atomic transaction:
- Generate NomorJV baru
- Insert Bukti Pengeluaran + lines
- Insert jurnal (Debet Piutang Pemegang Saham, Kredit Bank/Kas)
- Update master Piutang PS:
Nomor_JV+ sync 4 field section Bank (COA_Kredit/Biaya_Administrasi_Bank/Ditanggung_Oleh/Pembebanan) dari modal ke master — karena master Piutang tidak simpan field-field ini saat form input
Semua disimpan bersama atau dibatalkan total. Guard double-posting otomatis (multi-user safe).
📄 Cross-ref: #01 Realtime Accuracy, #02 Automatic Everything
3.5 Tombol Cair dengan Auto-Load Tagihan
Saat pemegang saham mengembalikan pinjaman (sebagian atau seluruhnya), klik Cair di drawer detail Piutang. Modal Bukti Penerimaan terbuka dengan tabel Daftar Tagihan otomatis berisi baris piutang ybs:
| Kolom | Isi |
|---|---|
| Nomor Invoice/Kontrak | Diambil dari master |
| Tanggal Invoice | Tanggal piutang awal |
| Uraian | Keterangan dari master |
| Jumlah Tagihan | Saldo Awal piutang |
| Sudah Dibayar | Akumulasi pencairan sebelumnya |
| Sisa Tagihan | Yang masih harus dikembalikan |
| Jumlah Bayar | Default ke Sisa Tagihan (bisa diubah jika cicil) |
User tinggal isi Tanggal + Sarana Pembayaran + klik Simpan. Tidak perlu input ulang nominal piutang.
📄 Cross-ref: #02 Automatic Everything
3.6 Konsisten dengan Modul Buku Pengawasan Lainnya
User yang sudah paham cara pakai Piutang Karyawan, Piutang Afiliasi, atau Piutang Pihak Ketiga langsung paham cara pakai Piutang Pemegang Saham — tata letak form, perilaku tombol, dan dinamisasi field identik. Yang berbeda hanya filter mitra (PS=Ya), awalan Nomor Bukti (BPPPS), dan COA Piutang yang dipakai.
📄 Cross-ref: #08 Simple for User
4. Nilai Tambah untuk User
“Pantau pinjaman perusahaan ke pemilik secara terpisah dari piutang reguler — siap untuk audit, pertanggungjawaban corporate, dan refleksi keuangan pemegang saham yang akurat.”
Modul Piutang Pemegang Saham memungkinkan pemisahan pinjaman ke pemilik vs piutang bisnis secara jelas. Pemberian pinjaman ke pemegang saham (untuk keperluan pribadi, advance dividen, dll.) ter-segregasi dari piutang dari customer — penting untuk transparansi laporan keuangan, audit oleh KAP, pertanggungjawaban corporate ke RUPS, dan implikasi pajak (PPh 23/4(2) jika pinjaman dianggap dividen terselubung). Dipasangkan dengan Bar Saldo reconciliation, user bisa audit konsistensi tracking pinjaman ke pemilik setiap saat.
5. Dokumentasi Terkait
| Dokumen | Relevansi |
|---|---|
Piutang Pemegang Saham (Deskripsi) | Panduan operasional user-facing |
Hutang Pemegang Saham (Keunggulan) | Modul mirror — pemegang saham memberi pinjaman ke perusahaan |
Piutang Afiliasi (Keunggulan) | Modul sejenis untuk counterparty perusahaan afiliasi |
Piutang Pihak Ketiga (Keunggulan) | Pattern referensi dasar untuk semua modul Piutang non-bisnis |
Terakhir diperbarui: 08-05-2026