Versi 1
| Field | Isi |
|---|---|
| Dokumen ID | VBS-LAP-007 |
| Deskripsi | Laporan neraca (aktiva dan pasiva) dengan empat mode: bulanan, multi periode, perbandingan periode, dan neraca lajur, termasuk pengaturan tampilan akun, hitung ulang saldo, penelusuran ke buku besar, dan ekspor Excel |
| Nomor Revisi | 1 |
| Tanggal | 2026-10-04 |
| Keterangan | Dokumentasi baseline dari dokumentasi fitur demo dan kode FE |
1. Ringkasan
a. In scope
- User membuka laporan neraca dari hub laporan akuntansi
- User memilih mode laporan: Bulanan, Multi Periode (default), Perbandingan Periode, atau Neraca Lajur
- User memilih periode sesuai mode: satu bulan, rentang bulan maksimal 12 bulan, atau dua bulan pembanding dengan selisih maksimal 24 bulan
- User mengatur parameter tampilan: tampilkan nomor akun, tampilkan jenis rekening, atau tampilkan rincian rekening
- User melihat neraca bertingkat kelompok, sub kelompok, jenis rekening, dan rekening untuk aktiva dan pasiva
- User menghitung ulang saldo neraca bila data dirasa belum terbaru
- User membuka rincian buku besar sebuah akun langsung dari nilai bulan di mode multi periode dan perbandingan periode
- User yang berhak mengekspor neraca ke Excel sesuai mode yang sedang aktif
- User mereset filter
b. Catatan
c. Kesimpulan
- [FE] -
- [BE] -
2. Functional Requirement
| Kode | Deskripsi |
|---|---|
| FR-01 | Sistem menampilkan neraca mode bulanan untuk satu bulan |
| FR-02 | Sistem menampilkan neraca mode multi periode untuk rentang maksimal 12 bulan |
| FR-03 | Sistem menampilkan neraca mode perbandingan periode untuk dua bulan dengan selisih maksimal 24 bulan |
| FR-04 | Sistem menampilkan neraca lajur untuk rentang maksimal 12 bulan |
| FR-05 | User dapat mengatur parameter tampilan nomor akun, jenis rekening, dan rincian rekening |
| FR-06 | Sistem menghitung saldo neraca per tahun hanya bila belum tersedia, dan user dapat memaksa hitung ulang |
| FR-07 | User dapat membuka rincian buku besar akun dari nilai bulan tertentu |
| FR-08 | User dengan hak akses Excel dapat mengekspor neraca sesuai mode aktif |
| FR-09 | User dapat mereset filter |
3. Use Case List
| Kode | Deskripsi |
|---|---|
| UC-01 | Menampilkan neraca bulanan |
| UC-02 | Menampilkan neraca multi periode |
| UC-03 | Membandingkan neraca dua periode |
| UC-04 | Menampilkan neraca lajur |
| UC-05 | Mengatur parameter tampilan akun |
| UC-06 | Menghitung ulang saldo neraca |
| UC-07 | Membuka buku besar akun dari neraca |
| UC-08 | Mengekspor neraca ke Excel |
| UC-09 | Mereset filter neraca |
4. Use Case Scenario
UC-01 : Menampilkan neraca bulanan
| Aktor | User brand dengan akses laporan neraca |
| Deskripsi | User melihat posisi aktiva dan pasiva pada satu bulan |
| Prekondisi | User sudah login dan berada di konteks brand |
| Alur utama | 1. User memilih mode Bulanan. 2. User memilih satu bulan. 3. User menekan Lihat Laporan. 4. Sistem memastikan saldo tahun tersebut sudah dihitung. 5. Sistem menampilkan aktiva dan pasiva bulan terpilih. |
| Alur negatif | - Jika bulan belum dipilih, muncul alert "Periode Harus dipilih!". - Jika data tidak ditemukan, tampil pesan "Data yg anda cari tidak ditemukan silahkan ganti filter anda ke yg lain!". |
| Bisnis rule | - Mode bulanan hanya menyediakan parameter tampilkan jenis rekening. - Berganti mode mengosongkan periode yang dipilih. - Laporan selalu untuk semua cabang dan semua cluster. |
| Postkondisi | Neraca bulanan tampil |
| Trigger | User menekan Lihat Laporan |
| Kode FR | FR-01 FR-06 |
UC-02 : Menampilkan neraca multi periode
| Aktor | User brand dengan akses laporan neraca |
| Deskripsi | User melihat neraca beberapa bulan berdampingan |
| Prekondisi | Halaman laporan neraca terbuka |
| Alur utama | 1. User memilih mode Multi Periode (default). 2. User memilih rentang bulan. 3. User menekan Lihat Laporan. 4. Sistem memastikan saldo tahun awal dan tahun akhir rentang sudah dihitung. 5. Sistem menampilkan nilai per bulan untuk setiap kelompok, sub kelompok, jenis rekening, dan rekening. |
| Alur negatif | - Jika rentang belum dipilih, muncul alert "Periode Harus dipilih!". - Jika rentang lebih dari 12 bulan, muncul alert "Maksimal Periode 12 Bulan!". |
| Bisnis rule | - Jika rentang melewati dua tahun, perhitungan dilakukan untuk masing-masing tahun. |
| Postkondisi | Neraca multi periode tampil |
| Trigger | User menekan Lihat Laporan |
| Kode FR | FR-02 FR-06 |
UC-03 : Membandingkan neraca dua periode
| Aktor | User brand dengan akses laporan neraca |
| Deskripsi | User membandingkan neraca dua bulan |
| Prekondisi | Halaman laporan neraca terbuka |
| Alur utama | 1. User memilih mode Perbandingan Periode. 2. User memilih bulan pertama dan bulan kedua. 3. User menekan Lihat Laporan. 4. Sistem menampilkan nilai kedua bulan berdampingan. |
| Alur negatif | - Jika salah satu bulan kosong, muncul alert "Periode Harus dipilih!". - Jika selisih bulan lebih dari 24 bulan, muncul alert "Laporan Neraca Perbandingan Periode hanya di bisa dilakukan di selama 24 bulan". |
| Bisnis rule | - Saldo dihitung untuk tahun bulan pertama dan tahun bulan kedua bila berbeda. |
| Postkondisi | Neraca perbandingan tampil |
| Trigger | User menekan Lihat Laporan |
| Kode FR | FR-03 FR-06 |
UC-04 : Menampilkan neraca lajur
| Aktor | User brand dengan akses laporan neraca |
| Deskripsi | User melihat neraca lajur dalam rentang bulan |
| Prekondisi | Halaman laporan neraca terbuka |
| Alur utama | 1. User memilih mode Neraca Lajur. 2. User memilih rentang bulan. 3. User menekan Lihat Laporan. 4. Sistem menampilkan neraca lajur. |
| Alur negatif | - Jika rentang belum dipilih, muncul alert "Periode Harus dipilih!". - Jika rentang lebih dari 12 bulan, muncul alert "Maksimal Periode 12 Bulan!". |
| Bisnis rule | - Validasi rentang sama dengan mode multi periode. |
| Postkondisi | Neraca lajur tampil |
| Trigger | User menekan Lihat Laporan |
| Kode FR | FR-04 FR-06 |
UC-05 : Mengatur parameter tampilan akun
| Aktor | User brand dengan akses laporan neraca |
| Deskripsi | User memilih tingkat detail akun yang ditampilkan |
| Prekondisi | Halaman laporan neraca terbuka |
| Alur utama | 1. User membuka dropdown Parameter Tampilkan. 2. User mencentang tampilkan nomor akun, tampilkan jenis rekening, atau tampilkan rincian rekening. 3. User menekan Lihat Laporan. 4. Sistem menampilkan neraca sesuai parameter. |
| Alur negatif | - Jika user mencentang jenis rekening saat rincian rekening aktif (atau sebaliknya), pilihan lama otomatis dilepas. |
| Bisnis rule | - Tampilkan jenis rekening dan tampilkan rincian rekening tidak dapat aktif bersamaan. - Mode bulanan tidak menyediakan opsi nomor akun dan rincian rekening. - Saat berganti ke mode selain bulanan, parameter diatur ulang ke nomor akun dan jenis rekening. |
| Postkondisi | Tampilan neraca mengikuti parameter |
| Trigger | User mengubah parameter |
| Kode FR | FR-05 |
UC-06 : Menghitung ulang saldo neraca
| Aktor | User brand dengan akses laporan neraca |
| Deskripsi | User memaksa sistem menghitung ulang saldo neraca |
| Prekondisi | Periode sudah dipilih |
| Alur utama | 1. User menekan tombol Kalkulasi Ulang. 2. Sistem menghapus hasil hitung tersimpan di aplikasi. 3. Sistem meminta server menghitung ulang saldo neraca termasuk akun bernilai nol. 4. Sistem menampilkan neraca terbaru. |
| Alur negatif | - Validasi periode sama dengan Lihat Laporan sesuai mode. - Jika perhitungan gagal, laporan tidak diperbarui. |
| Bisnis rule | - Tanpa kalkulasi ulang, sistem memakai hasil hitung tahun yang sudah tersimpan di aplikasi. - Kalkulasi ulang dijalankan per tahun yang tercakup periode. |
| Postkondisi | Neraca dihitung ulang dan tampil |
| Trigger | User menekan Kalkulasi Ulang |
| Kode FR | FR-06 |
UC-07 : Membuka buku besar akun dari neraca
| Aktor | User brand dengan akses laporan neraca |
| Deskripsi | User menelusuri asal nilai akun pada bulan tertentu |
| Prekondisi | Neraca mode multi periode atau perbandingan periode tampil dengan rincian rekening |
| Alur utama | 1. User menekan nilai akun pada kolom bulan tertentu. 2. Sistem membuka rincian buku besar akun tersebut untuk awal sampai akhir bulan itu di tab baru. |
| Alur negatif | - Jika baris tidak memiliki id akun, tidak ada halaman yang dibuka. |
| Bisnis rule | - Penelusuran tersedia pada mode multi periode dan perbandingan periode. |
| Postkondisi | Rincian buku besar akun terbuka |
| Trigger | User menekan nilai akun |
| Kode FR | FR-07 |
UC-08 : Mengekspor neraca ke Excel
| Aktor | User brand dengan hak akses Excel laporan neraca |
| Deskripsi | User mengunduh neraca sesuai mode aktif |
| Prekondisi | Laporan neraca sudah tampil |
| Alur utama | 1. User menekan Export sebagai Excel. 2. Sistem mengambil data dari tampilan mode aktif. 3. Sistem menyusun workbook sesuai mode dan parameter tampilan. 4. Browser mengunduh file Excel. |
| Alur negatif | - Jika filter kosong atau data tidak ditemukan, muncul alert "Gagal Print, Filter yang anda pilih tidak ditemukan!". - Pada format khusus bahasa CN, jika data kosong muncul notifikasi "Data tidak ditemukan". |
| Bisnis rule | - Tombol ekspor hanya tampil untuk user dengan permission Excel laporan neraca. - Mode bulanan memiliki format khusus berbahasa CN bila halaman dibuka dengan parameter bahasa cn. |
| Postkondisi | File Excel terunduh |
| Trigger | User menekan Export sebagai Excel |
| Kode FR | FR-08 |
UC-09 : Mereset filter neraca
| Aktor | User brand dengan akses laporan neraca |
| Deskripsi | User mengosongkan periode dan mengembalikan parameter |
| Prekondisi | Halaman laporan neraca terbuka |
| Alur utama | 1. User menekan Reset Filter. 2. Sistem mengosongkan periode dan mengatur parameter ke nomor akun dan jenis rekening. 3. Laporan kosong dengan pesan "Lengkapi filter untuk menampilkan data". |
| Alur negatif | - |
| Bisnis rule | - Mode laporan tidak berubah saat reset. |
| Postkondisi | Filter kembali default |
| Trigger | User menekan Reset Filter |
| Kode FR | FR-09 |
5. Data Flow Diagram
DFD-01 — Laporan neraca
6. Sequence Diagram
SD-01 — UC-01 : Menampilkan neraca bulanan
SD-02 — UC-02 : Menampilkan neraca multi periode
SD-03 — UC-03 : Membandingkan neraca dua periode
SD-04 — UC-04 : Menampilkan neraca lajur
SD-05 — UC-05 : Mengatur parameter tampilan akun
SD-06 — UC-06 : Menghitung ulang saldo neraca
SD-07 — UC-07 : Membuka buku besar akun dari neraca
SD-08 — UC-08 : Mengekspor neraca ke Excel
SD-09 — UC-09 : Mereset filter neraca
7. Table Schema
8. API Schema
| Endpoint | Status | Perubahan |
|---|---|---|
GET /kelompok/with-includes | existing | - |
POST /calculation-request/hitung | existing | - |