Versi 1

Field	Isi
Dokumen ID	VBS-LAP-002
Deskripsi	Laporan jurnal transaksi: menampilkan jurnal debit dan kredit per nomor invoice dalam periode tertentu, dengan filter kategori akun, nomor invoice, cluster, dan nominal, konfirmasi jurnal yang belum final, serta unduh 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 jurnal transaksi dari hub laporan akuntansi
• User mengisi periode tanggal (default bulan berjalan) dan kategori akun (modul transaksi) lalu menampilkan laporan
• User mempersempit hasil dengan filter tambahan: nomor invoice, cluster, dan nominal
• User mengurutkan hasil berdasarkan tanggal transaksi atau tanggal diupdate
• User melihat jurnal per invoice: cabang, cluster, baris akun debit dan kredit, keterangan, serta total debit dan kredit
• User memuat data berikutnya dengan menggulir halaman
• User mengonfirmasi (finalisasi) jurnal yang belum final langsung dari laporan
• User mereset filter ke kondisi awal
• User yang berhak mengunduh laporan dalam format Excel

b. Catatan

c. Kesimpulan

• [FE] -
• [BE] -

2. Functional Requirement

Kode	Deskripsi
FR-01	Sistem menampilkan laporan jurnal transaksi berdasarkan periode dan kategori akun
FR-02	User dapat memfilter berdasarkan nomor invoice, cluster, dan nominal, serta mengurutkan berdasarkan tanggal transaksi atau tanggal diupdate
FR-03	Sistem menampilkan setiap jurnal sebagai grup per nomor invoice berisi baris debit, kredit, dan total
FR-04	Sistem memuat halaman data berikutnya saat user menggulir sampai bawah
FR-05	User dapat mengonfirmasi jurnal yang belum final
FR-06	User dengan hak akses Excel dapat mengunduh laporan jurnal transaksi
FR-07	User dapat mereset seluruh filter dan mengosongkan laporan

3. Use Case List

Kode	Deskripsi
UC-01	Menampilkan laporan jurnal transaksi per periode
UC-02	Memfilter dan mengurutkan jurnal transaksi
UC-03	Memuat jurnal berikutnya dengan menggulir
UC-04	Mengonfirmasi jurnal yang belum final
UC-05	Mereset filter laporan
UC-06	Mengunduh laporan jurnal transaksi ke Excel

4. Use Case Scenario

UC-01 : Menampilkan laporan jurnal transaksi per periode

Aktor	User brand dengan akses laporan jurnal transaksi
Deskripsi	User melihat daftar jurnal debit dan kredit pada periode yang dipilih
Prekondisi	User sudah login dan berada di konteks brand
Alur utama	1. User membuka laporan jurnal transaksi. 2. Sistem memuat daftar cabang dan cluster untuk label. 3. User memilih periode tanggal dan kategori akun. 4. User menekan Lihat Laporan. 5. Sistem menampilkan jurnal per nomor invoice beserta cabang, cluster, baris akun, keterangan, debit, kredit, dan total.
Alur negatif	- Jika form tidak valid, muncul alert "Cek Kembali Form Isian Anda". - Jika periode kosong, muncul alert "Periode Tidak Boleh Kosong". - Jika filter belum diisi, tampil pesan "Lengkapi filter untuk menampilkan data". - Jika data tidak ditemukan atau gagal dimuat, muncul notifikasi "Data yang anda filter tidak ditemukan silahkan ganti filter".
Bisnis rule	- Periode default adalah awal sampai akhir bulan berjalan. - Jurnal tanpa baris debit dan kredit tidak ditampilkan. - Keterangan baris adalah gabungan keterangan jurnal dan keterangan baris akun. - Data dimuat 50 jurnal per halaman.
Postkondisi	Laporan jurnal transaksi tampil
Trigger	User menekan Lihat Laporan
Kode FR	FR-01 FR-03

UC-02 : Memfilter dan mengurutkan jurnal transaksi

Aktor	User brand dengan akses laporan jurnal transaksi
Deskripsi	User mempersempit dan mengurutkan hasil laporan
Prekondisi	Halaman laporan jurnal transaksi terbuka
Alur utama	1. User membuka panel Filter. 2. User memilih nomor invoice, cluster, dan atau mengisi nominal. 3. User memilih urutan tanggal transaksi atau tanggal diupdate. 4. User menekan Lihat Laporan. 5. Sistem memuat ulang laporan dari halaman pertama sesuai filter.
Alur negatif	- Jika hasil filter kosong, tampil pesan "Data yg anda filter tidak ditemukan silahkan ganti filter". - Tombol Reset di panel hanya mengosongkan filter tambahan.
Bisnis rule	- Jika memilih lebih dari satu nomor invoice, filter periode diabaikan karena nomor invoice lebih spesifik. - Filter nominal mencari nilai yang sama persis.
Postkondisi	Laporan tampil sesuai filter
Trigger	User menekan Lihat Laporan setelah mengubah filter
Kode FR	FR-02

UC-03 : Memuat jurnal berikutnya dengan menggulir

Aktor	User brand dengan akses laporan jurnal transaksi
Deskripsi	User melihat jurnal lanjutan tanpa pindah halaman
Prekondisi	Laporan sudah tampil dan masih ada halaman berikutnya
Alur utama	1. User menggulir sampai bawah tabel. 2. Sistem memuat halaman berikutnya dan menambahkannya ke tabel. 3. User dapat menekan tombol panah atas untuk kembali ke atas.
Alur negatif	- Jika tidak ada halaman berikutnya, sistem tidak memuat data lagi.
Bisnis rule	- Halaman berikutnya hanya dimuat jika pagination masih memiliki halaman selanjutnya.
Postkondisi	Jurnal tambahan tampil di bawah tabel
Trigger	User menggulir ke bawah
Kode FR	FR-04

UC-04 : Mengonfirmasi jurnal yang belum final

Aktor	User brand dengan akses laporan jurnal transaksi
Deskripsi	User memfinalkan jurnal yang masih berstatus belum final
Prekondisi	Ada jurnal belum final di laporan
Alur utama	1. User menekan tombol Konfirmasi pada baris nomor invoice. 2. Sistem menyimpan status jurnal menjadi final. 3. Tombol Konfirmasi hilang dan muncul notifikasi "Jurnal Umum Berhasil di Finalize".
Alur negatif	- Jika gagal menyimpan, muncul notifikasi error berisi pesan dari server.
Bisnis rule	- Tombol Konfirmasi hanya muncul untuk jurnal yang belum final. - Konfirmasi hanya mengubah status final, tidak mengubah nominal jurnal.
Postkondisi	Jurnal berstatus final
Trigger	User menekan Konfirmasi
Kode FR	FR-05

UC-05 : Mereset filter laporan

Aktor	User brand dengan akses laporan jurnal transaksi
Deskripsi	User mengembalikan filter ke kondisi awal
Prekondisi	Halaman laporan jurnal transaksi terbuka
Alur utama	1. User menekan tombol reset utama. 2. Sistem mengembalikan periode ke bulan berjalan dan mengosongkan kategori akun serta filter tambahan. 3. Laporan dikosongkan dan tampil pesan untuk melengkapi filter.
Alur negatif	-
Bisnis rule	- Reset utama juga mengosongkan hasil laporan, berbeda dengan Reset di panel Filter.
Postkondisi	Filter kembali default dan laporan kosong
Trigger	User menekan tombol reset
Kode FR	FR-07

UC-06 : Mengunduh laporan jurnal transaksi ke Excel

Aktor	User brand dengan hak akses Excel laporan jurnal transaksi
Deskripsi	User mengunduh hasil laporan sesuai filter dalam bentuk file Excel
Prekondisi	Laporan sudah ditampilkan
Alur utama	1. User menekan Unduh File. 2. Jika masih ada halaman yang belum dimuat, sistem mengambil seluruh data tanpa pagination. 3. Sistem menyusun file berkolom nomor invoice atau tanggal, akun, keterangan, debit, dan kredit beserta total per jurnal. 4. Browser mengunduh file "Laporan Jurnal Transaksi.xlsx".
Alur negatif	- Jika periode kosong, muncul alert "Periode Tidak Boleh Kosong". - Jika filter belum diterapkan, muncul alert "Silahkan Filter Terlebih dahulu data yang ingin ditampilkan". - Jika data kosong, muncul notifikasi "Data tidak ditemukan".
Bisnis rule	- Tombol Unduh File hanya tampil untuk user dengan permission Excel laporan jurnal transaksi. - File dibuat di browser, bukan oleh server.
Postkondisi	File Excel terunduh
Trigger	User menekan Unduh File
Kode FR	FR-06

5. Data Flow Diagram

DFD-01 — Laporan jurnal transaksi

6. Sequence Diagram

SD-01 — UC-01 : Menampilkan laporan jurnal transaksi per periode

SD-02 — UC-02 : Memfilter dan mengurutkan jurnal transaksi

SD-03 — UC-03 : Memuat jurnal berikutnya dengan menggulir

SD-04 — UC-04 : Mengonfirmasi jurnal yang belum final

SD-05 — UC-05 : Mereset filter laporan

SD-06 — UC-06 : Mengunduh laporan jurnal transaksi ke Excel

7. Table Schema

8. API Schema

Endpoint	Status	Perubahan
GET /gudang	existing	-
GET /cluster	existing	-
GET /jurnal-umum/modul	existing	-
GET /jurnal-umum	existing	-
PUT /jurnal-umum/invoice-only/:id	existing	-