Pengembalian Dana
- Code: PUR-RF
- Module: Purchasing
- Type: Transaction
1. Overview
Refund (Pengembalian Dana) adalah catatan uang yang benar-benar dikembalikan supplier kepada toko atas sebuah Nota Kredit. Refund berdiri terhadap Nota Kredit persis seperti pembayaran berdiri terhadap tagihan: bila pembayaran mencatat uang keluar dari toko ke supplier, Refund mencatat uang masuk dari supplier ke toko. Setiap Refund mencantumkan penanggung jawab yang menerima uangnya dan boleh disertai bukti. Refund tidak punya halaman sendiri — ia dicatat dan dibaca dari dalam detail Nota Kredit yang menjadi induknya.
Hasil yang diharapkan: “supplier mengakui kredit” dan “supplier sudah mengembalikan uangnya” menjadi dua fakta yang terpisah dan sama-sama terlihat, sehingga sisa kredit yang masih menggantung di supplier selalu berupa angka, bukan perkiraan.
2. Problem
Tanpa pencatatan Refund, sebuah Nota Kredit hanya bisa menyatakan bahwa supplier mengakui kredit, tanpa bisa menyatakan apakah uangnya sudah kembali. Kedua hal itu tercampur menjadi satu, padahal dalam praktik sering berjarak berminggu-minggu dan kerap dibayar bertahap. Akibatnya:
- Kredit yang sudah cair dan yang masih menggantung terbaca sama, sehingga staf finance menagih ulang supplier yang sebenarnya sudah membayar.
- Pengembalian bertahap tidak bisa dicatat, sehingga staf mencatatnya di luar sistem dan angkanya tidak pernah cocok.
- Tidak ada batas yang menjaga jumlah uang yang dicatat masuk agar tidak melebihi kredit yang diakui supplier.
- Tidak jelas siapa yang menerima uang dari supplier dan apa buktinya, sehingga selisih kas sulit ditelusuri.
3. Goals & Non-goals
3.1 Goals
- Uang yang dikembalikan supplier tercatat sebagai peristiwa tersendiri, bisa penuh maupun bertahap, dan boleh lebih dari satu kali untuk satu Nota Kredit.
- Sisa kredit selalu dihitung dari selisih nilai Nota Kredit dan uang yang sudah masuk, sehingga tidak pernah ada dua angka yang saling bertentangan.
- Jumlah uang yang tercatat masuk tidak pernah melebihi kredit yang diakui supplier.
- Setiap Refund jelas penanggung jawabnya, dan buktinya tersimpan menempel pada catatannya.
- Kesalahan ketik bisa dibersihkan tanpa meninggalkan angka palsu di sisa kredit maupun status Nota Kredit.
3.2 Non-goals
- Barang pengganti dari supplier; itu masuk lewat alur Purchase Order dan Goods Receipt, bukan Refund.
- Pemotongan sisa kredit ke tagihan berikutnya; itu urusan Nota Kredit dan belum dibangun.
- Rekonsiliasi otomatis dengan mutasi rekening bank.
- Aturan kedaluwarsa kredit yang tidak pernah dikembalikan.
- Koreksi jumlah Refund yang sudah tercatat; yang salah dihapus, bukan diubah.
4. Business Rules
Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk Refund di seluruh aplikasi, pada semua layar dan aksi yang melibatkannya, siapa pun yang melakukannya. Aturan ini menjadi sumber kebenaran tunggal: bila bagian lain di PRD ini tampak berbeda, aturan di sinilah yang berlaku.
- BR-01 Refund hanya bisa dicatat pada Nota Kredit berstatus Diajukan atau Dikembalikan Sebagian. Nota Kredit Draf ditolak karena kreditnya belum diakui, dan Nota Kredit Lunas ditolak karena kreditnya sudah dikembalikan seluruhnya.
- BR-02 Jumlah setiap Refund harus lebih dari nol dengan paling banyak 2 angka desimal, dan jumlah seluruh Refund atas satu Nota Kredit tidak boleh melebihi Total Nota Kredit. Batas ini diperiksa terhadap Total Nota Kredit yang tidak dibulatkan, sebelum Refund baru diterima.
- BR-03 Sisa Kredit diturunkan dari Total Nota Kredit dikurangi jumlah seluruh Refund. Bila disimpan, nilainya hanya salinan yang dihitung ulang dari seluruh Refund yang tersisa oleh satu-satunya penulis, tidak pernah ditambah atau dikurangi sebagian. Setiap kali Refund dicatat, status Nota Kredit menjadi Dikembalikan Sebagian bila Sisa Kredit masih lebih dari nol, atau Lunas bila Sisa Kredit nol. Total Nota Kredit dengan lebih dari 2 angka desimal tidak bisa mencapai Sisa Kredit nol melalui Refund 2 desimal, sehingga sisa di bawah Rp 0,01 membuat Nota Kredit tetap Dikembalikan Sebagian; cara menuntaskannya Perlu dikonfirmasi.
- BR-04 Refund sebagian diperbolehkan, dan satu Nota Kredit boleh punya lebih dari satu Refund, dibatasi hanya oleh BR-02.
- BR-05 Nota Kredit yang tidak pernah menerima Refund adalah keadaan yang sah dan tidak dianggap salah; artinya supplier masih menahan kreditnya.
- BR-06 Refund langsung berstatus Diajukan sejak dicatat, dan isinya tidak bisa diubah sesudahnya, kecuali Penanggung Jawab. Jumlah, metode, waktu, catatan, dan bukti tetap; Penanggung Jawab boleh dikoreksi oleh pemegang izin assign pada status Nota Kredit apa pun, karena mengoreksi siapa yang mengurus uang bukanlah pergerakan uang. Mencatat Refund adalah menyatakan uang sudah masuk, bukan mengajukan usulan untuk disetujui.
- BR-07 Refund yang salah dicatat dihapus, bukan dikoreksi, termasuk pada Nota Kredit yang sudah Lunas. Penghapusan wajib menyertakan alasan, dan Refund yang dihapus tetap tersimpan sebagai jejak yang tidak dihitung dan tidak tampil, bukan hilang. Menghapus berarti uangnya memang tidak pernah masuk: Sisa Kredit dihitung ulang, lalu status Nota Kredit menjadi Dikembalikan Sebagian bila masih ada Refund tersisa, atau kembali Diajukan bila tidak ada lagi.
- BR-08 Setiap pencatatan, penghapusan, dan perubahan Penanggung Jawab Refund tercatat di log aktivitas Nota Kredit induknya beserta pelaku, waktu, dan alasan penghapusannya.
- BR-09 Batas jumlah Refund diperiksa terhadap keadaan Nota Kredit saat penyimpanan, bukan terhadap angka yang tampil di layar. Pencatatan dan penghapusan Refund pada Nota Kredit yang sama diproses satu per satu, sehingga dua pencatatan bersamaan tidak bisa sama-sama lolos bila jumlah keduanya melebihi Total Nota Kredit, dan status serta Sisa Kredit selalu dihitung dari Refund yang benar-benar tersisa. Menghapus Refund yang sudah terhapus tidak mengubah apa pun.
- BR-10 Setiap Refund wajib mencantumkan sedikitnya satu penanggung jawab dari karyawan toko Nota Kredit, yaitu orang yang menerima atau mengurus uang dari supplier.
- BR-11 Refund boleh melampirkan bukti pengembalian berupa lebih dari satu berkas, dan boleh tidak melampirkan apa pun; lampiran hanya menjadi bukti dan tidak mempengaruhi Sisa Kredit maupun status. Paling banyak 10 berkas, masing-masing paling besar 2 MB, bertipe PDF, JPG, JPEG, PNG, atau WEBP.
- BR-12 Pengiriman ulang pencatatan Refund yang sama, karena klik ganda atau koneksi terputus, tidak pernah menghasilkan Refund kedua. Setiap pengiriman form membawa penanda unik, dan penanda yang sudah pernah diterima untuk Nota Kredit yang sama mengembalikan Refund yang sudah tercatat.
5. Flow
5.1 Main Flowchart
- Credit Note berstatus Diajukan atau Dikembalikan Sebagian — Refund hanya bisa dicatat pada Nota Kredit yang kreditnya sudah diakui dan belum lunas (BR-01). Rinciannya dijelaskan di PRD tersendiri.
- Catat Refund — Staf finance mengisi tanggal, metode, jumlah uang yang diterima dari supplier, dan penanggung jawabnya, serta boleh melampirkan bukti (BR-10, BR-11).
- Validasi Jumlah — Jumlah baru ditambah seluruh Refund sebelumnya diperiksa terhadap Total Nota Kredit. Yang melebihi batas ditolak sebelum tersimpan (BR-02, BR-09).
- Diajukan — Satu-satunya status Refund, ditetapkan sejak pencatatan. Isinya tidak bisa diubah lagi (BR-06).
- Hitung Ulang Sisa Kredit dan Status Credit Note — Setiap kali Refund dicatat maupun dihapus, Sisa Kredit pada Nota Kredit dihitung ulang dari selisih totalnya dan seluruh Refund yang masih tercatat, lalu status Nota Kredit ditetapkan ulang (BR-03, BR-07).
- Sisa Kredit? — Hasil perhitungan menentukan status Nota Kredit berikutnya.
- Credit Note Diajukan — Tidak ada lagi Refund yang tercatat karena seluruhnya sudah dihapus; Nota Kredit kembali seperti saat baru diajukan (BR-07).
- Credit Note Dikembalikan Sebagian — Sisa kredit masih ada, dan Refund berikutnya masih bisa dicatat (BR-04).
- Credit Note Lunas — Sisa kredit habis, sehingga Nota Kredit berhenti menerima Refund baru.
- Terhapus — Refund yang salah dicatat dihapus beserta alasannya, dari Nota Kredit berstatus Dikembalikan Sebagian maupun Lunas, lalu Sisa Kredit dan status Nota Kredit dihitung ulang seperti langkah 5 (BR-07).
5.2 Status Lifecycle
| Status | Keterangan | Selanjutnya |
|---|---|---|
Diajukansubmitted | Uang sudah diterima dari supplier dan dihitung sebagai pengurang Sisa Kredit | — |
Refund tidak punya status Draf maupun Dibatalkan: yang salah dicatat dihapus, bukan dipindahkan statusnya (BR-06, BR-07).
6. Document Structure
Bagian ini mendefinisikan isi dokumen Refund itu sendiri: field apa saja yang dimilikinya, tipenya, mana yang wajib, nilai awalnya, dan aturan nilainya. Ketentuan di sini berlaku di mana pun Refund dicatat dan ditegakkan saat penyimpanan, terlepas dari bagaimana field itu ditampilkan. Refund tidak punya baris produk dan tidak punya perhitungan sendiri; angka turunannya adalah Sisa Kredit yang dihitung di Nota Kredit.
6.1 General
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Nomor Refund | Teks | — | Dibuat saat disimpan | Ditetapkan sistem dengan format RFD/{Kode Toko}/{Tahun}/{000000}, tidak bisa diubah |
| Nota Kredit | Ref. Nota Kredit | — | Nota Kredit tempat Refund dicatat | Ditetapkan sistem; harus berstatus Diajukan atau Dikembalikan Sebagian (BR-01) |
| Toko | Ref. Toko | — | Toko Nota Kredit | Ditetapkan sistem, tidak bisa diubah |
| Tanggal & Waktu Refund | Tanggal & Waktu | Ya | Saat ini | — |
| Metode Refund | Enum | Ya | — | Tunai, Transfer Bank, Giro, Kartu Kredit, atau Lainnya |
| Jumlah Refund | Mata Uang | Ya | Sisa Kredit Nota Kredit | Lebih dari 0, paling banyak 2 angka desimal, dan tidak melebihi Sisa Kredit (BR-02) |
| Penanggung Jawab | Ref. Karyawan, banyak | Ya | Karyawan pengguna yang login, bila ia karyawan toko Nota Kredit | Minimal satu karyawan toko Nota Kredit (BR-10) |
| Bukti Refund | Berkas, banyak | Tidak | — | Gambar atau dokumen, misalnya bukti transfer; paling banyak 10 berkas, masing-masing 2 MB, PDF/JPG/JPEG/PNG/WEBP (BR-11) |
| Catatan | Teks | Tidak | — | — |
| Alasan Penghapusan | Teks | Ya, saat dihapus | — | Wajib diisi pada aksi Hapus (BR-07) |
| Status | Enum | — | Diajukan | Ditetapkan sistem; lihat Status Lifecycle |
7. UI Structure
Bagian ini mendefinisikan cara Refund ditampilkan dan dioperasikan. Refund tidak punya halaman daftar, filter, maupun PDF sendiri: seluruh permukaannya berada di dalam tab Pengembalian Dana pada detail Nota Kredit, dan pembacaannya mengikuti izin lihat detail Nota Kredit. Bagian ini hanya mengatur tampilan dan interaksi; aturan isi dan nilainya tetap mengikuti Document Structure.
7.1 Kartu Refund
| Kolom | Contoh Nilai | Komponen |
|---|---|---|
| Judul | Refund 1 | Text |
| Nomor Refund | RFD/CBI/2026/000031 | Text |
| Tanggal & Waktu Refund | 24 Sep 2026, 10.15 | Date |
| Metode Refund | Transfer Bank | Badge |
| Jumlah Refund | Rp 200.000 | Currency |
| Penanggung Jawab | Andi, Sari | Text |
| Bukti Refund | bukti-transfer.jpg | Thumbnail, Link |
| Catatan | Masuk rekening bank toko | Text |
| Aksi | Hapus | Action Menu |
7.2 Form
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Tanggal & Waktu Refund | Date Time Picker | — | Default saat ini |
| Metode Refund | Single Select | Enum metode refund | — |
| Jumlah Refund | Currency Input | — | Default Sisa Kredit; melebihi Sisa Kredit → error di field |
| Penanggung Jawab | Multi Select | Karyawan toko Nota Kredit | Default karyawan pengguna yang login, bila ia karyawan toko tersebut |
| Bukti Refund | File Uploader, banyak | — | Opsional |
| Catatan | Textarea | — | — |
Form dibuka sebagai dialog dari tombol Tambah Pengembalian Dana di tab Pengembalian Dana, dan tombol itu hanya tampil selama Nota Kredit berstatus Diajukan atau Dikembalikan Sebagian. Tombol Simpan nonaktif selama penyimpanan berlangsung.
7.3 Dialog Hapus
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Alasan Penghapusan | Textarea | — | Kosong → tombol konfirmasi nonaktif |
8. User Stories
US-01 - Mencatat refund penuh
Sebagai staf finance, saya ingin mencatat pengembalian uang sebesar seluruh nilai nota kredit, agar kredit itu tertutup dan berhenti tampil sebagai tagihan ke supplier.
| ID | Kriteria penerimaan |
|---|---|
| AC-01.1 | Tombol Tambah Pengembalian Dana hanya tampil pada Nota Kredit berstatus Diajukan atau Dikembalikan Sebagian untuk pengguna dengan izin create di toko aktif (BR-01). |
| AC-01.2 | Jumlah Refund terisi default sebesar Sisa Kredit yang dipotong menjadi 2 angka desimal, dan bisa diubah ke nilai yang lebih kecil (BR-02). |
| AC-01.3 | Form mewajibkan tanggal & waktu, metode, jumlah, dan minimal satu penanggung jawab (default pengguna yang login); bukti refund dan catatan opsional (BR-10, BR-11). |
| AC-01.4 | Setelah disimpan, Refund langsung berstatus Diajukan dan Sisa Kredit menjadi Rp 0 (BR-03, BR-06). |
| AC-01.5 | Nota Kredit berpindah ke status Lunas tanpa aksi terpisah, dan tombol Tambah Pengembalian Dana hilang (BR-03). |
US-02 - Mencatat refund sebagian
Sebagai staf finance, saya ingin mencatat pengembalian bertahap, agar uang yang sudah masuk terlihat tanpa menunggu supplier melunasi seluruhnya.
| ID | Kriteria penerimaan |
|---|---|
| AC-02.1 | Setelah Refund tersimpan, Sisa Kredit sama dengan Total Nota Kredit dikurangi jumlah seluruh Refund (BR-03). |
| AC-02.2 | Nota Kredit berpindah ke status Dikembalikan Sebagian tanpa aksi terpisah selama Sisa Kredit masih lebih dari nol (BR-03). |
| AC-02.3 | Refund kedua, ketiga, dan seterusnya tetap bisa dicatat selama jumlah keseluruhannya masih dalam batas (BR-02, BR-04). |
| AC-02.4 | Setiap Refund tampil sebagai kartu tersendiri berurutan sesuai waktu pencatatannya, beserta penanggung jawab dan pratinjau buktinya. |
US-03 - Menolak refund melebihi sisa kredit
Sebagai sistem, saya ingin menolak Refund yang jumlahnya melebihi sisa kredit, agar uang yang tercatat masuk tidak pernah lebih besar dari kredit yang diakui supplier.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Refund ditolak saat jumlah barunya ditambah seluruh Refund sebelumnya melebihi Total Nota Kredit, sebelum tersimpan (BR-02). |
| AC-03.2 | Pesan kesalahan tampil di field Jumlah Refund, bukan sebagai kesalahan umum halaman. |
| AC-03.3 | Refund pada Nota Kredit berstatus Draf atau Lunas ditolak (BR-01). |
| AC-03.4 | Jumlah Refund nol atau negatif ditolak (BR-02). |
| AC-03.5 | Refund tanpa penanggung jawab ditolak (BR-10). |
| AC-03.6 | Dua Refund dicatat pada Nota Kredit yang sama pada saat bersamaan — hanya satu yang lolos bila jumlah keduanya melebihi Total Nota Kredit (BR-09). |
| AC-03.7 | Form yang sama terkirim dua kali karena klik ganda atau koneksi terputus — hanya satu Refund yang tercatat, dan pengiriman kedua menampilkan Refund yang sudah ada (BR-12). |
| AC-03.8 | Refund dicatat bersamaan dengan penghapusan Refund lain pada Nota Kredit yang sama — keduanya diproses berurutan, dan Sisa Kredit serta status akhirnya sesuai Refund yang benar-benar tersisa (BR-03, BR-09). |
US-04 - Membiarkan kredit tanpa refund
Sebagai staf finance, saya ingin Nota Kredit tanpa Refund tetap dianggap normal, agar kredit yang sengaja ditahan supplier tidak terbaca sebagai kesalahan data.
| ID | Kriteria penerimaan |
|---|---|
| AC-04.1 | Nota Kredit dengan Sisa Kredit penuh dan tanpa Refund tetap valid dan berstatus Diajukan tanpa batas waktu (BR-05). |
| AC-04.2 | Tab Pengembalian Dana tampil kosong dengan ringkasan Sisa Kredit yang tetap terisi. |
US-05 - Menghapus refund yang salah dicatat
Sebagai staf finance, saya ingin menghapus Refund yang salah ketik, agar sisa kredit dan status Nota Kredit kembali ke keadaan yang benar.
| ID | Kriteria penerimaan |
|---|---|
| AC-05.1 | Aksi Hapus tersedia pada setiap kartu Refund untuk pengguna dengan izin delete di toko aktif, termasuk pada Nota Kredit berstatus Lunas; dialog konfirmasi mewajibkan alasan penghapusan (BR-07). |
| AC-05.2 | Setelah dihapus, Sisa Kredit dihitung ulang tanpa Refund tersebut (BR-03, BR-07). |
| AC-05.3 | Masih ada Refund lain yang tercatat — Nota Kredit berstatus Dikembalikan Sebagian dan bisa menerima Refund lagi (BR-07). |
| AC-05.4 | Tidak ada Refund lain yang tercatat — Nota Kredit kembali berstatus Diajukan (BR-07). |
| AC-05.5 | Jumlah, metode, waktu, catatan, dan bukti Refund tidak bisa diubah; satu-satunya koreksi adalah hapus lalu catat ulang (BR-06). |
| AC-05.6 | Penghapusan, alasannya, dan perpindahan status Nota Kredit tercatat di log aktivitas Nota Kredit beserta pelaku dan waktunya (BR-08). |
| AC-05.7 | Refund yang sama dihapus dua kali, misalnya karena klik ganda — penghapusan kedua tidak mengubah Sisa Kredit maupun status (BR-09). |
| AC-05.8 | Refund yang dihapus tidak lagi tampil sebagai kartu dan tidak dihitung, tetapi tetap bisa ditelusuri lewat log aktivitas Nota Kredit (BR-07). |
| AC-05.9 | Pengguna dengan izin assign di toko aktif bisa mengubah Penanggung Jawab sebuah Refund, termasuk pada Nota Kredit berstatus Lunas; pilihannya terbatas pada karyawan toko Nota Kredit, dan perubahannya tercatat di log aktivitas Nota Kredit (BR-06, BR-08, BR-10). |
9. User Scenarios
| Role | Scenario |
|---|---|
| Staf Finance | Menerima transfer dari supplier sebesar seluruh nilai Nota Kredit, mencatatnya sebagai satu Refund dengan bukti transfer terlampir, dan melihat Nota Kredit berpindah sendiri ke Lunas |
| Staf Finance | Mencatat dua kali pengembalian tunai dari sales supplier dalam dua kunjungan berbeda pada Nota Kredit yang sama, dengan penanggung jawab kasir yang menerima uangnya |
| Staf Finance | Salah mengetik nominal pada Refund pelunasan, menghapusnya sehingga Nota Kredit kembali ke Dikembalikan Sebagian, lalu mencatat ulang dengan angka yang benar |
| Owner | Melihat Nota Kredit yang sudah berumur dua bulan tanpa satu pun Refund, lalu meminta staf finance menagih supplier |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
| Lihat Refund | — | Mengikuti izin lihat detail Nota Kredit |
| Catat Refund | purchase:refund:create:store | Toko aktif |
| Ubah Penanggung Jawab | purchase:refund:assign:store | Toko aktif |
| Unduh Bukti Refund | — | Mengikuti izin lihat detail Nota Kredit |
| Hapus Refund | purchase:refund:delete:store | Toko aktif |
Tidak ada izin list dan view tersendiri: Refund dibaca lewat Nota Kredit induknya, bukan dari halaman daftar. Tidak ada izin submit maupun update: mencatat Refund sudah berarti mengajukannya (BR-06), dan isinya tidak bisa diubah selain Penanggung Jawab, yang memakai izin assign.
10.2 Action by Status
| Action | Diajukan |
|---|---|
| Lihat Refund | ✓ |
| Unduh Bukti Refund | ✓ |
| Ubah Penanggung Jawab | ✓ |
| Hapus Refund | ✓ |
Catat Refund tidak ada di matriks ini karena bergantung pada status Nota Kredit induknya, bukan status Refund; lihat Action by Status di Credit Note. Log aktivitas Refund dibaca dari log Nota Kredit induknya (BR-08).
11. Notifications
Fitur ini tidak memicu notifikasi.
12. Dependencies
PRD terkait
- Credit Note — induk yang wajib ada, penentu batas jumlah Refund, tempat Sisa Kredit dihitung, dan dokumen yang statusnya mengikuti Refund (BR-01, BR-02, BR-03, BR-07).
- Purchase Return — hubungan tidak langsung: Retur yang Nota Kreditnya sudah diajukan tidak bisa dibatalkan, sehingga Refund tidak pernah kehilangan induknya.
Master data
- Toko — toko aktif, status aktif, dan karyawan (penanggung jawab) (BR-10).
- File Manager — penyimpanan bukti refund yang dilampirkan (BR-11).
Efek ke modul lain
- Credit Note — Sisa Kredit berkurang saat Refund dicatat dan dihitung ulang saat dihapus; Nota Kredit berpindah antara Diajukan, Dikembalikan Sebagian, dan Lunas karenanya (BR-03, BR-07).
- Refund tidak mengubah stok, tidak mengubah Tagihan, dan tidak mengubah Retur.
- Finance — jumlah Refund menjadi dasar pencocokan uang masuk dari supplier.
- Setiap pencatatan dan penghapusan tercatat di log aktivitas Nota Kredit (BR-08).