Versi 1
| Field | Isi |
|---|---|
| Dokumen ID | VBS-LAP-026 |
| Deskripsi | Laporan retur pembelian per supplier: daftar retur dalam periode, barang yang diretur, kuantitas order dan retur, serta nominal retur |
| 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 Retur Pembelian dari daftar Laporan Pembelian.
- User mengisi periode dan memilih supplier.
- User melihat retur per supplier: nomor invoice retur, invoice pembelian asal, nama barang dan varian, total order, kuantitas retur, dan total nominal retur.
- User membuka invoice retur atau invoice pembelian asal di tab baru.
- User mengekspor laporan ke Excel jika memiliki hak akses.
b. Catatan
c. Kesimpulan
- [FE] -
- [BE] -
2. Functional Requirement
| Kode | Deskripsi |
|---|---|
| FR-01 | Sistem menampilkan retur pembelian dalam periode, dikelompokkan per supplier |
| FR-02 | User dapat memfilter supplier |
| FR-03 | User dapat membuka invoice retur dan invoice pembelian asal |
| FR-04 | User dengan izin Excel dapat mengekspor laporan retur pembelian |
3. Use Case List
| Kode | Deskripsi |
|---|---|
| UC-01 | Melihat retur pembelian per supplier dalam periode |
| UC-02 | Membuka invoice retur atau invoice pembelian asal |
| UC-03 | Mengekspor laporan retur pembelian ke Excel |
4. Use Case Scenario
UC-01 : Melihat retur pembelian per supplier dalam periode
| Aktor | User pembelian / akuntansi |
| Deskripsi | User melihat seluruh retur pembelian dan barang yang diretur |
| Prekondisi | User memiliki izin #lap-retur-pembelian |
| Alur utama | 1. User membuka Laporan Pembelian lalu Laporan Retur Pembelian. 2. User mengisi periode. 3. User dapat memilih satu atau beberapa supplier. 4. User menekan tombol tampilkan. 5. Sistem menampilkan retur per supplier beserta barang, total order, kuantitas retur, dan total nominal retur. |
| Alur negatif | - Jika periode kosong, muncul alert "Periode Tidak Boleh Kosong". - Jika data kosong atau gagal dimuat, muncul notifikasi "Data yang anda filter tidak ditemukan silahkan ganti filter". |
| Bisnis rule | - Laporan mencakup semua metode retur, baik potong hutang maupun pengembalian dana. - Periode memakai tanggal invoice retur dan diurutkan dari tanggal terlama. - Nama supplier dan barang dilengkapi dari master. |
| Postkondisi | Laporan retur pembelian tampil |
| Trigger | User menekan tombol tampilkan |
| Kode FR | FR-01 FR-02 |
UC-02 : Membuka invoice retur atau invoice pembelian asal
| Aktor | User pembelian / akuntansi |
| Deskripsi | User menelusuri dokumen retur atau pembelian asal |
| Prekondisi | Laporan sudah tampil |
| Alur utama | 1. User mengklik nomor invoice retur atau nomor invoice pembelian. 2. Sistem membuka halaman lihat dokumen tersebut di tab baru. |
| Alur negatif | - Jika dokumen sudah dihapus, halaman lihat menampilkan pesan dokumen tidak ditemukan. |
| Bisnis rule | - Nomor retur membuka halaman lihat retur pembelian, nomor pembelian membuka halaman lihat pembelian. |
| Postkondisi | Dokumen terbuka di tab baru |
| Trigger | User mengklik nomor invoice |
| Kode FR | FR-03 |
UC-03 : Mengekspor laporan retur pembelian ke Excel
| Aktor | User dengan izin Excel retur pembelian |
| Deskripsi | User mengunduh laporan retur pembelian |
| Prekondisi | Laporan sudah tampil |
| Alur utama | 1. User menekan tombol export Excel. 2. Sistem menyusun baris dari data tabel. 3. Browser mengunduh "Daftar Retur Pembelian per Supplier.xlsx". |
| Alur negatif | - Jika filter belum diterapkan, muncul notifikasi "Periode Tidak Boleh Kosong". - Jika data kosong, muncul notifikasi "Data tidak ditemukan". |
| Bisnis rule | - Tombol tampil bila user memiliki izin excel pada #lap-retur-pembelian. |
| Postkondisi | File Excel terunduh |
| Trigger | User menekan tombol export Excel |
| Kode FR | FR-04 |
5. Data Flow Diagram
DFD-01 — Alur data retur pembelian
6. Sequence Diagram
SD-01 — UC-01 : Melihat retur pembelian per supplier dalam periode
SD-02 — UC-02 : Membuka invoice retur atau invoice pembelian asal
SD-03 — UC-03 : Mengekspor laporan retur pembelian ke Excel
7. Table Schema
8. API Schema
| Endpoint | Status | Perubahan |
|---|---|---|
POST /laporan-pembelian/invoice-return-pembelian-report | existing | - |
POST /supplier/get-supplier | existing | - |
POST /sku/get-bulk-sku | existing | - |