Bab 7 — Laporan & Tagihan Gabungan (TAG)
Laporan umum membutuhkan modul Laporan (reports).
Piutang Customer / TAG membutuhkan modul Tagihan Gabungan (customer-billing) — terpisah agar Finance bisa akses piutang tanpa semua laporan.
7.1 Ringkasan laporan
Laporan → Ringkasan (/admin/reports) — kartu navigasi ke tiap jenis laporan.
7.2 Pembayaran harian (uang masuk)
Laporan → Pembayaran Harian
| Fitur | Keterangan |
|---|---|
| Filter tanggal | Default hari ini (zona Jakarta) |
| Filter entity | EITO / Albatross / semua |
| Ringkasan | Total diterima, transaksi, invoice unik |
| Detail | Waktu, invoice, customer, metode, jumlah |
Sumber: pembayaran SO (paidAt).
Kapan dipakai: Rekonsiliasi kas harian.
7.3 Pengeluaran harian (uang keluar)
Laporan → Pengeluaran Harian
| Fitur | Keterangan |
|---|---|
| Filter | Tanggal & entity |
| Ringkasan | Total ke vendor, transaksi, PO unik |
| Detail | Nomor PO, vendor, metode, jumlah |
Prasyarat: Pembayaran PO sudah dicatat di detail Purchase Order.
7.4 Piutang Customer & TAG
Laporan → Piutang Customer (/admin/reports/customer-receivables)
Pusat monitoring piutang dan pengelolaan Tagihan Gabungan (TAG).
Filter & tampilan
| Kontrol | Fungsi |
|---|---|
| Tampilan | Piutang belum lunas atau TAG sudah lunas |
| Dari / Sampai tanggal | Periode transaksi atau periode TAG |
| Entity | EITO / ALBATROSS / semua |
| Cari | Nama/kode customer (tampilan piutang) |
| Bulan ini | Reset rentang ke bulan berjalan |
| Pagination | Daftar customer / TAG dipaginasi (25 baris per halaman); ringkasan total tetap dihitung dari seluruh data |
Tampilan: Piutang belum lunas
- Ringkasan: total piutang umum, asuransi, jumlah customer & SO.
- Daftar customer (per kartu): subtotal piutang, segment Umum/Asuransi, badge Siap ditagih (asuransi).
- Klik customer → halaman detail (
/customers/[customerId]) berisi daftar SO outstanding.
Dari detail customer atau dialog:
- Buat Tagihan Gabungan (TAG) — gabung beberapa SO dalam periode filter.
- SO yang sudah PAID / sisa 0 dikecualikan otomatis.
Tampilan: TAG sudah lunas
- Daftar TAG status PAID dalam periode filter.
- Klik nomor TAG → halaman detail statement (
/statements/[statementId]). - Berguna audit & riwayat penagihan yang sudah selesai.
7.5 Alur Tagihan Gabungan (TAG) — langkah demi langkah
Dialog Tagihan Gabungan dibuka dari detail customer piutang.
| Langkah | Tombol / aksi | Hasil |
|---|---|---|
| 1 | Buat TAG | Draft statement + nomor TAG; SO eligible masuk item |
| 2 | Preview TAG | Tampilan surat tagihan di layar |
| 3 | Unduh PDF | Cetak / kirim ke customer |
| 4 | Terbitkan invoice semua SO (opsional) | Invoice formal: customer umum → per TTB yang belum punya invoice; asuransi → per SO |
| 5 | Catat pelunasan | Pembayaran TAG (transfer/cash/dll.) |
| 6 | Riwayat pembayaran | Panel riwayat di dialog / halaman detail |
Status TAG
| Status | Arti |
|---|---|
| Draft | Baru dibuat |
| Diterbitkan | Aktif menunggu bayar |
| Bayar sebagian | Sudah ada pembayaran TAG |
| Lunas | TAG selesai |
Reconcile (penyelarasan)
Sistem menghitung ulang:
- Sisa tagihan TAG (bukan hanya total piutang customer di master).
- SO yang lunas lewat halaman SO → item TAG disesuaikan / TAG bisa otomatis lunas.
- Pembayaran TAG dialokasikan ke item SO / invoice terkait; nominal dibulatkan ke rupiah utuh agar selaras dengan tampilan UI.
Jika sisa TAG = 0, tombol pelunasan dinonaktifkan (tidak perlu bayar dua kali).
Invoice parsial dalam TAG
Untuk customer umum dengan beberapa DO/TTB, satu SO bisa muncul lebih dari sekali di TAG — satu baris per segmen invoice (mis. TTB pertama sudah ditagih, TTB kedua belum). Surat TAG dan dialog menampilkan rincian per invoice/TTB, bukan hanya total per SO.
Tombol Terbitkan invoice semua SO memproses semua item TAG dalam satu transaksi; nomor invoice (INV-YYYY-MM-###) dihasilkan berurutan tanpa duplikat.
SO yang dilewati saat buat TAG
Pesan sistem menampilkan SO yang tidak ikut (mis. sudah lunas) beserta nomor SO-nya.
7.6 Halaman detail piutang
Path: /admin/reports/customer-receivables/customers/[customerId]
- Daftar SO outstanding per segment (umum/asuransi).
- Tombol buka dialog TAG.
- Link ke detail SO di workflow.
7.7 Halaman detail TAG
Path: /admin/reports/customer-receivables/statements/[statementId]
- Nomor TAG, periode, customer, daftar SO.
- Total, sudah dibayar, sisa.
- Preview / PDF / riwayat pembayaran (sesuai hak akses).
7.8 Limit kredit
Laporan → Limit Kredit (/admin/reports/credit-limit)
| Konsep | Penjelasan |
|---|---|
| Limit | Dari master customer |
| Terpakai efektif | Max(credit used master, total piutang SO aktif) |
| Sisa limit | Limit − terpakai |
| Badge | Kritis (≥95%), Hampir habis |
Filter: min. pemakaian %, tipe Umum/Asuransi.
Kapan dipakai: Sebelum SO/DP baru dengan kredit.
7.9 Hak akses TAG
| Aksi RBAC | Yang bisa dilakukan |
|---|---|
| read | Lihat piutang, preview/PDF TAG, riwayat |
| create | Buat TAG draft |
| update | Terbitkan invoice massal, catat pelunasan TAG, batalkan TAG draft |
Default: FINANCE dan SUPERADMIN lengkap; OPERATIONS sering read-only piutang.
7.10 Mencetak / export
- TAG, TTB, Invoice, PO: tombol PDF di masing-masing halaman.
- Laporan tabel: print browser (
Ctrl+P) atau minta export ke developer jika perlu Excel.