title: “Financial Reports” description: “Empat laporan keuangan inti (Laba Rugi, Neraca, Neraca Saldo, Anggaran vs Aktual) dengan mesin dual-source, audit completeness, dan fitur cetak di SNISHOP ERP.”

Financial Reports

Halaman Financial Reports adalah pusat pelaporan keuangan SNISHOP ERP. Empat laporan inti dihasilkan secara otomatis dari data transaksi yang sudah tercatat, dengan mesin dual-source yang memprioritaskan Jurnal GL dan fallback ke Buku Kas jika data GL belum lengkap.

Arsitektur Pelaporan

Akses Halaman

URL: /finance → tab Laporan Empat tab laporan tersedia dalam grid layout (2 kolom di mobile, 4 kolom di desktop):

Tab	Label	Komponen	Fungsi
`profit_loss`	Laba Rugi	`ProfitLossReport`	Pendapatan, HPP, laba kotor, beban operasional, laba bersih
`balance_sheet`	Neraca	`BalanceSheetReport`	Aset, liabilitas, ekuitas dengan validasi persamaan akuntansi
`trial_balance`	Neraca Saldo	`TrialBalanceReport`	Semua akun GL dengan total debit/kredit dan status keseimbangan
`budget_vs_actual`	Anggaran vs Aktual	`BudgetVsActualReport`	Perbandingan anggaran vs realisasi dengan variansi dan chart

KPI Summary

Empat kartu ringkasan ditampilkan di bagian atas, dihitung secara real-time via useMemo:

KPI	Sumber	Perhitungan
Total Pendapatan	FinancialRecord	`SUM(amount)` dimana `type === 'income'`
Total Pengeluaran	FinancialRecord	`SUM(amount)` dimana `type === 'expense'`
Laba Bersih	Computed	`totalIncome - totalExpense`
Jurnal Posting	GLJournalEntry	`COUNT(*)` dimana `status === 'posted'`

Seleksi Periode

Lima preset periode plus opsi kustom:

Periode	Label	Rentang Tanggal
`this_month`	Bulan Ini	Tanggal 1 hari ini → hari ini
`last_month`	Bulan Lalu	Tanggal 1 bulan lalu → akhir bulan lalu
`last_3_months`	3 Bulan	3 bulan terakhir → hari ini
`this_year`	Tahun Ini	1 Januari tahun ini → hari ini
`custom`	Kustom	User memilih tanggal mulai dan selesai

Mode custom menampilkan dua field <input type="date"> (start/end) dengan tombol “Apply” untuk menerapkan filter.

Data Loading

Empat entity di-fetch secara paralel via cachedRequest:

GLAccount       → filter: company_id
GLJournalEntry  → filter: company_id, status: "posted"
Budget          → filter: company_id
FinancialRecord → filter: company_id

Cache layer (cachedRequest dari requestManager) memastikan data yang sama tidak di-fetch berulang dalam satu sesi. Tombol Refresh memanggil loadData() untuk memuat ulang seluruh data.

Laporan Laba Rugi (Profit & Loss)

Mesin Dual-Source

Laporan Laba Rugi menggunakan strategi dual-source untuk memastikan akurasi data: Prioritas sumber data:

Prioritas	Sumber	Kapan Digunakan	Badge
1 (Primary)	GL Journal Entry	Jika ada journal entry dengan akun revenue	”Jurnal GL”
2 (Fallback)	Financial Record	Jika belum ada data GL yang cukup	”Buku Kas”

Audit Completeness

Sistem menilai kualitas data menggunakan evaluateCompleteness() dari financeLogic:

Status	Ikon	Arti
Audited	`ShieldCheck`	Data lengkap dari jurnal GL yang sudah diposting
Provisional	`AlertCircle`	Data berdasarkan buku kas, belum diaudit penuh

Banner status ditampilkan di bagian atas laporan untuk transparansi.

Struktur Laporan

PENDAPATAN
├── Total Revenue (dari semua sumber income)
├── (-) Channel Fees / Marketplace MDR
└── = Net Settlement

HPP (Harga Pokok Penjualan)
├── Total HPP (kategori HPP)
└── = Gross Profit (Laba Kotor)

BEBAN OPERASIONAL
├── Beban Gaji
├── Beban Bahan Baku
├── Beban Operasional
├── Beban Produksi
├── Beban Perjalanan
├── Beban Makan
├── Beban Akomodasi
├── Beban Peralatan
├── Beban Perlengkapan Kantor
├── Beban Pelatihan
└── Beban Lainnya

= LABA BERSIH (Net Profit/Loss)

Utilitas yang Digunakan

Fungsi	Sumber	Peran
`isRevenueRecord()`	`financeLogic`	Identifikasi record pendapatan
`isCashInflowRecord()`	`financeLogic`	Identifikasi arus kas masuk
`isExpenseRecord()`	`financeLogic`	Identifikasi record beban
`isHppCategory()`	`financeHelper`	Identifikasi kategori HPP
`evaluateCompleteness()`	`financeLogic`	Menilai kelengkapan data (audited/provisional)

Metrik yang Dilacak

Metrik	Perhitungan
`totalRevenue`	SUM semua record pendapatan
`totalChannelFees`	SUM marketplace MDR / channel fees
`netSettlement`	`totalRevenue - totalChannelFees`
`totalExpense`	SUM semua record beban
`totalCashInflow`	SUM semua arus kas masuk
`grossProfit`	`netSettlement - totalHPP`

Laporan Neraca (Balance Sheet)

Persamaan Akuntansi

Neraca disusun berdasarkan persamaan akuntansi fundamental:

ASET = LIABILITAS + EKUITAS

Sistem memvalidasi persamaan ini secara otomatis. Jika totalAssets !== totalLiabilities + totalEquity (toleransi < Rp 1), banner peringatan ditampilkan.

Struktur Neraca

Perhitungan dari GL

Neraca dihitung dari saldo GL Account dan journal entries yang sudah diposting:

Bagian	Sumber GL	Perhitungan
Aset	Akun bertipe `asset`	SUM(debit) - SUM(credit)
Liabilitas	Akun bertipe `liability`	SUM(credit) - SUM(debit)
Ekuitas	Akun bertipe `equity`	SUM(credit) - SUM(debit)

Laporan Neraca Saldo (Trial Balance)

Fungsi

Neraca Saldo列出 seluruh akun GL dengan total debit dan kredit masing-masing. Laporan ini digunakan untuk memverifikasi bahwa pembukuan seimbang sebelum menghasilkan laporan keuangan lainnya.

Tampilan

Kolom	Deskripsi
Kode Akun	Kode COA (misal 1-1100)
Nama Akun	Nama akun sesuai COA
Tipe	asset / liability / equity / revenue / expense
Total Debit	SUM semua debit di jurnal
Total Kredit	SUM semua kredit di jurnal
Status	Badge “Seimbang” atau “Tidak Seimbang”

Color Coding

Setiap tipe akun memiliki warna yang berbeda untuk memudahkan identifikasi:

Tipe	Warna
Asset	Biru
Liability	Merah
Equity	Hijau
Revenue	Emerald
Expense	Amber

Validasi

Di bagian bawah laporan, total debit dan kredit dijumlahkan dan dibandingkan. Jika selisih > Rp 1, status “Tidak Seimbang” ditampilkan sebagai peringatan bahwa ada ketidaksesuaian dalam pembukuan.

Laporan Anggaran vs Aktual

Arsitektur Pencocokan

Laporan ini membandingkan anggaran yang sudah dibuat dengan realisasi aktual. Sistem menggunakan CATEGORY_ALIASES untuk fuzzy matching antara kategori budget dan kategori expense aktual:

Contoh Alias

Kategori Budget	Alias yang Dicocokkan
`salary`	`gaji`, `upah`, dll
`raw_material`	`bahan baku`, `material`, dll
`operational`	`operasional`, `listrik`, `air`, dll
`production_cost`	`produksi`, `manufacturing`, dll
`travel`	`perjalanan`, `transport`, dll

Metrik Per Item

Metrik	Perhitungan	Keterangan
Anggaran	`budget.amount`	Nominal anggaran
Aktual	SUM expense yang match	Realisasi berdasarkan transaksi
Variansi	`anggaran - aktual`	Selisih (positif = hemat)
Usage %	`(aktual / anggaran) × 100%`	Persentase pemakaian

Status Badge

Status	Kondisi	Warna
Aman (ok)	Usage < 80%	Hijau
Perhatian (warning)	80% ≤ Usage ≤ 100%	Kuning
Melebihi (over)	Usage > 100%	Merah

Visualisasi Chart

Laporan ini menampilkan Recharts <BarChart> dengan grouped bars:

Bar	Warna	Data Key
Anggaran	Biru	`budget`
Aktual	Orange	`actual`

Progress bar juga ditampilkan per item untuk visualisasi persentase pemakaian secara cepat.

Fitur Cetak & Export

Print Support

Setiap laporan mendukung cetak langsung via window.print():

Tombol “Cetak” di toolbar laporan
Header print-only menampilkan nama perusahaan dan rentang periode
Elemen non-esensial disembunyikan via atribut data-print-hide
Wrapper print-report mengontrol layout saat print
CSS @media print memastikan hasil cetak rapi tanpa elemen UI

Format Export

Format	Kegunaan
PDF	Arsip dan presentasi manajemen
Excel	Analisis lanjutan dan manipulasi data
CSV	Integrasi dengan sistem lain
Print	Cetak langsung dari browser

Integrasi Cross-Module

Laporan keuangan mengonsumsi data dari seluruh modul keuangan. Jurnal GL dari manufacturing dan expense, Financial Record dari POS dan invoice, serta Budget dari Budget Planner — semuanya mengalir ke mesin pelaporan untuk dihasilkan sebagai laporan terpadu.

Best Practices

Tutup Buku Bulanan

Pastikan seluruh transaksi sudah tercatat dan diposting
Rekonsiliasi semua rekening bank
Review Neraca Saldo — pastikan status “Seimbang”
Generate Laporan Laba Rugi dan Neraca
Analisis variansi dari Anggaran vs Aktual

Analisis Keuangan

Bandingkan laporan dengan anggaran untuk identifikasi penyimpangan
Bandingkan antar periode untuk melihat tren
Perhatikan status completeness (Audited vs Provisional)
Gunakan data Laba Rugi untuk evaluasi profitabilitas

Kepatuhan

Simpan laporan dalam arsip untuk audit
Pastikan persamaan akuntansi di Neraca selalu seimbang
Prepare laporan pajak dari data yang sudah diaudit
Review Trial Balance sebelum closing periode

Entity Relationship Diagram

Tabel Schema