Retur Pembelian
- Code: PUR-PR
- Module: Purchasing
- Type: Transaction
1. Overview
Purchase Return (Retur) adalah dokumen yang mencatat barang yang dikembalikan toko kepada supplier, beserta alasannya. Setiap Retur punya satu atau lebih penanggung jawab (PIC), yang berwenang mengajukan dan membatalkannya. Retur adalah kaki balik dari alur pembelian: bila Goods Receipt (GR) mencatat barang masuk, Retur mencatat barang keluar kembali ke supplier. Retur berdiri sendiri dari urusan uang — ia mencatat peristiwa fisiknya, yaitu produk dan kuantitas yang keluar, sedangkan padanan finansialnya baru muncul sebagai Nota Kredit ketika barang yang diretur sudah pernah ditagihkan.
Hasil yang diharapkan: setiap barang yang kembali ke supplier punya catatan resmi berisi apa, berapa, dari penerimaan mana, dan karena apa, sehingga stok toko langsung menyesuaikan, barang yang sudah dikembalikan tidak ikut tertagih, dan kredit dari supplier bisa ditagih balik dengan dasar yang jelas.
2. Problem
Tanpa dokumen retur, barang rusak, kedaluwarsa, atau salah kirim yang dikembalikan ke supplier hanya hidup di percakapan dan catatan pribadi staf gudang. Stok di sistem tetap menghitung barang yang fisiknya sudah tidak ada, dan tagihan tetap dihitung dari kuantitas penerimaan awal. Akibatnya:
- Stok sistem tidak cocok dengan stok fisik, dan selisihnya baru ketahuan saat stock opname, ketika penyebabnya sudah sulit ditelusuri.
- Barang yang sudah dikembalikan tetap ikut ditagih supplier, sehingga toko membayar barang yang tidak dimilikinya.
- Kredit dari supplier atas barang yang sudah dibayar tidak punya dasar dokumen, sehingga penagihannya bergantung pada ingatan dan negosiasi ulang.
- Tidak ada rekam alasan pengembalian per supplier, sehingga kualitas supplier tidak bisa dievaluasi dengan angka.
3. Goals & Non-goals
3.1 Goals
- Setiap pengembalian barang ke supplier tercatat sebagai transaksi tersendiri, termasuk ketika penerimaan asalnya sudah tidak bisa ditelusuri karena barang sudah tercampur di stok toko.
- Stok toko berkurang tepat pada saat barang dinyatakan keluar, bukan menunggu proses administrasi lain selesai.
- Barang yang sudah dikembalikan sebelum ditagih tidak pernah ikut masuk ke tagihan supplier.
- Barang yang dikembalikan setelah ditagih menghasilkan kredit yang bisa ditagih balik, tanpa pernah mengubah tagihan yang sudah berlaku.
- Alasan pengembalian tercatat per transaksi sehingga volume dan sebab retur per supplier bisa dibaca sebagai angka.
- Bukti pendukung pengembalian tersimpan menempel pada dokumennya, bukan tersebar di perangkat masing-masing staf.
3.2 Non-goals
- Penghitungan nilai finansial retur; harga, diskon, dan pajak atas barang yang diretur adalah urusan Nota Kredit, bukan Retur (BR-13).
- Rujukan ke Tagihan dari sisi Retur; nomor tagihan berada di luar scope gudang dan penautannya dikerjakan Nota Kredit (BR-22).
- Alur persetujuan retur oleh supplier di dalam sistem; kesepakatan dengan supplier terjadi di luar aplikasi, dan retur dicatat setelah kesepakatan itu ada.
- Pencatatan barang pengganti dari supplier; barang pengganti masuk lewat alur Purchase Order dan Goods Receipt seperti pembelian biasa.
- Koreksi retur yang sudah Selesai; retur yang salah tidak diubah, melainkan ditangani lewat mekanisme koreksi finansial tersendiri yang belum dibangun.
- Pembuangan stok, yaitu barang rusak yang tidak diambil kembali oleh supplier; itu bukan retur karena barangnya tidak pernah keluar ke supplier dan tidak menghasilkan kredit. Belum ada fitur untuk itu.
- Kartu stok atau riwayat pergerakan stok per produk; retur hanya mengubah kuantitas stok, tanpa membentuk buku pergerakan tersendiri.
4. Business Rules
Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk Retur 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 Setiap Retur milik satu toko dan satu supplier, serta mengacu pada paling banyak satu Penerimaan Barang. Bila Retur menyebut Penerimaan Barang, seluruh produk yang diretur harus berasal dari penerimaan itu dan setiap barisnya wajib menunjuk item penerimaan tersebut; bila tidak menyebut, tidak satu pun barisnya boleh menunjuk item penerimaan mana pun.
- BR-02 Retur tanpa Penerimaan Barang adalah satu-satunya pengecualian BR-01, dipakai ketika barang sudah tercampur di stok toko dan penerimaan asalnya tidak bisa ditentukan. Sebuah Retur seluruhnya merujuk satu penerimaan atau seluruhnya tanpa penerimaan; keadaan campuran tidak berlaku.
- BR-03 Retur tidak pernah mengubah isi Penerimaan Barang. Kuantitas dikirim, ditolak, dan diterima pada GR tetap seperti saat dicatat, berapa pun yang kemudian diretur.
- BR-04 Tagihan yang sudah keluar dari status Draf tidak pernah diubah oleh Retur. Nilai dan kuantitasnya tetap seperti saat ditagihkan, dan padanan finansial returnya adalah Nota Kredit (BR-09). Tagihan yang masih Draf belum berlaku dan justru dihitung ulang (BR-18).
- BR-05 Kuantitas yang masih bisa ditagihkan dari sebuah penerimaan dihitung saat Tagihan dibuat, yaitu Kuantitas Diterima dikurangi kuantitas retur aktif atas item penerimaan tersebut. Angka ini tidak pernah disimpan sebagai field pada Tagihan.
- BR-06 Kuantitas retur kumulatif atas satu item penerimaan tidak boleh melebihi Kuantitas Diterima item tersebut. Retur berstatus Dibatalkan tidak ikut dihitung. Beberapa Retur sebagian atas item yang sama diperbolehkan selama jumlah keseluruhannya masih dalam batas.
- BR-07 Saat Retur diajukan, stok toko berkurang sebesar kuantitas retur setiap barisnya. Pengurangan terjadi sekali, pada saat pengajuan, bukan saat Retur dibuat.
- BR-08 Retur atas barang yang belum pernah ditagihkan langsung berstatus Selesai pada saat diajukan, tanpa Nota Kredit. Penutupan ini ditetapkan sistem dan bukan aksi pengguna.
- BR-09 Retur atas barang yang sudah ditagihkan membuat tepat satu Nota Kredit berstatus Draf pada saat diajukan, dan baru berstatus Selesai ketika Nota Kredit tersebut diajukan. Penutupan ini juga ditetapkan sistem.
- BR-10 Retur berstatus Draf hanya bisa diajukan atau dihapus. Draf belum menimbulkan akibat apa pun, sehingga Retur yang ternyata tidak dipakai dihapus, bukan dibatalkan. Pembatalan hanya berlaku pada Retur berstatus Diajukan, dilakukan oleh PIC (BR-23): stok dikembalikan sebesar yang tadi dikurangkan, dan alasan pembatalan wajib diisi.
- BR-11 Retur yang sudah menerbitkan Nota Kredit hanya bisa dibatalkan selama Nota Kredit itu masih Draf. Pembatalan tersebut menghapus Nota Kredit — bukan membatalkannya — karena Nota Kredit Draf belum pernah mengakui kredit apa pun, sekaligus mengembalikan stok.
- BR-12 Retur yang Nota Kreditnya sudah diajukan tidak bisa dibatalkan. Pada saat Nota Kredit diajukan, sistem otomatis menutup Retur menjadi Selesai (BR-09), dan sejak itu Retur menjadi catatan historis.
- BR-13 Retur tidak menghitung dan tidak menyimpan nilai finansial. Scope Retur adalah area gudang yang hanya mengetahui stok dan kuantitas, sehingga pada penambahan maupun perubahan Retur tidak ada input harga, diskon, atau pajak, dan ringkasan di tingkat dokumen hanya berisi kuantitas. Seluruh nilai uang atas barang yang diretur ditangani Nota Kredit.
- BR-14 Setiap Retur wajib menyertakan alasan retur. Alasan bersifat catatan dan bahan laporan; ia tidak menentukan status Retur dan tidak menentukan ada atau tidaknya Nota Kredit. Retur juga boleh melampirkan dokumen pendukung berupa lebih dari satu berkas, dan boleh tidak melampirkan apa pun; lampiran hanya menjadi bukti dan tidak mempengaruhi status Retur. Batas jumlah, ukuran, dan tipe berkas Perlu dikonfirmasi.
- BR-15 Retur hanya mengubah kuantitas stok. Harga pokok rata-rata produk tidak dihitung ulang oleh Retur, sama seperti penerimaan barang yang juga tidak mengubahnya.
- BR-16 Penerimaan Barang yang dirujuk harus milik toko dan supplier yang sama dengan Retur.
- BR-17 Status penagihan barang yang diretur ditentukan sistem, bukan diisi pengguna. Retur yang merujuk Penerimaan Barang dihitung belum ditagihkan bila penerimaan itu belum dirujuk Tagihan mana pun atau Tagihannya masih Draf, dan dihitung sudah ditagihkan bila Tagihannya sudah keluar dari Draf. Retur tanpa Penerimaan Barang selalu dihitung sudah ditagihkan (BR-21).
- BR-18 Bila penerimaan yang diretur sudah dirujuk Tagihan berstatus Draf, pengajuan Retur mengurangi kuantitas baris Tagihan tersebut sebesar kuantitas retur, lalu seluruh totalnya dihitung ulang. Penyesuaian hanya bisa ke bawah; baris yang kuantitasnya habis tetap ada dengan kuantitas 0 agar rujukan penerimaannya tidak lepas. Perubahan ini tercatat di log aktivitas Tagihan.
- BR-19 Setiap perubahan data dan perpindahan status Retur tercatat beserta pelaku dan waktunya.
- BR-20 Satu Penerimaan Barang bisa menjadi sumber banyak Retur, karena barang bermasalah sering ditemukan bertahap; setiap pengajuan dievaluasi terhadap kuota terbaru (BR-06). Pengajuan Retur dievaluasi sebagai satu kesatuan yang tidak bisa disela: pemeriksaan kuota retur, pengurangan stok, penentuan status penagihan, penyesuaian Tagihan Draf, dan penerbitan Nota Kredit terjadi bersama atau tidak sama sekali. Bila Tagihan atas penerimaan yang sama sedang dibuat pada saat bersamaan, hanya satu yang berhasil; yang lain gagal dan harus diulang di atas angka terbaru.
- BR-21 Retur tanpa Penerimaan Barang tidak mengurangi kuantitas yang bisa ditagihkan pada Tagihan mana pun, karena penagihan selalu berdasar penerimaan. Barang yang penerimaan asalnya tidak diketahui ditangani sepenuhnya lewat Nota Kredit (BR-09, BR-17).
- BR-22 Retur hanya merujuk Penerimaan Barang atau tidak merujuk apa pun. Retur tidak menyimpan dan tidak menampilkan rujukan Tagihan, baik di tingkat dokumen maupun di barisnya, karena nomor tagihan berada di luar scope gudang. Penautan ke Tagihan adalah urusan Nota Kredit.
- BR-23 Setiap Retur harus memiliki penanggung jawab (PIC) sebelum bisa diajukan. Mengajukan dan membatalkan Retur hanya boleh dilakukan oleh PIC yang ditetapkan pada Retur itu dan memiliki izin untuk aksi tersebut; membuat Retur saja tidak memberi kewenangan ini. Penetapan PIC hanya bisa diubah selama Retur berstatus Draf.
5. Flow
5.1 Main Flowchart
- Buat Retur — Staf memilih penerimaan barang yang diretur, lalu menandai produk dan kuantitas yang dikembalikan beserta alasannya. Bila penerimaan asalnya tidak diketahui, penerimaan dikosongkan dan produk dipilih langsung dari inventaris toko (BR-02). Dokumen pendukung boleh dilampirkan, boleh juga tidak (BR-14).
- Validasi — Isian diperiksa sebelum Retur tersimpan: asal item, batas kuantitas retur, serta kecocokan toko dan supplier. Retur yang melanggar aturan tidak bisa disimpan, dan kesalahannya ditunjukkan pada bagian yang bersangkutan.
- Draf — Status awal setelah Retur tersimpan. Stok belum berubah dan belum ada akibat apa pun di modul lain. Selama berstatus Draf, isinya masih bisa diubah dan PIC-nya ditetapkan tanpa mengubah status; dari sini Retur bisa diajukan atau dihapus, dan Retur yang tidak dipakai dihapus, bukan dibatalkan (BR-10).
- 3a. Ubah Data Retur — Data umum maupun daftar produk bisa diperbarui, dan Retur tetap berstatus Draf.
- 3b. Tetapkan PIC — Satu atau lebih karyawan toko ditetapkan sebagai penanggung jawab. Retur tetap berstatus Draf, dan penetapan ini syarat sebelum Retur bisa diajukan (BR-23).
- Diajukan — Dilakukan oleh PIC. Retur dinyatakan berlaku dan isinya terkunci. Sejak titik ini kuantitas barisnya tidak bisa diubah lagi.
- Kurangi Stok — Stok toko berkurang sebesar kuantitas retur setiap baris (BR-07).
- Cek Status Penagihan — Sistem membaca penerimaan yang dirujuk untuk menentukan apakah barang yang diretur sudah pernah ditagihkan (BR-17). Retur tanpa penerimaan selalu masuk jalur sudah ditagihkan (BR-21).
- Sesuaikan Kuantitas Tertagih — Untuk barang yang belum ditagihkan, kuantitas yang masih bisa ditagihkan berkurang: bila belum ada Tagihan, pengurangan diterapkan saat Tagihan dibuat nanti (BR-05); bila sudah ada Tagihan berstatus Draf, kuantitas dan total Tagihan itu dihitung ulang saat itu juga (BR-18).
- Credit Note — Untuk barang yang sudah ditagihkan, satu Nota Kredit berstatus Draf dibuat sistem sebagai padanan finansial Retur, dan di sanalah seluruh nilai uangnya ditentukan (BR-13). Rinciannya dijelaskan di PRD tersendiri.
- Selesai — Retur selesai diproses. Untuk retur yang belum ditagihkan, status ini tercapai pada saat pengajuan; untuk retur yang sudah ditagihkan, saat Nota Kreditnya diajukan (BR-08, BR-09, BR-12).
- Dibatalkan — Dilakukan oleh PIC atas Retur yang sudah diajukan, dengan alasan yang wajib diisi (BR-10, BR-23).
- 10a. Pengembalian Stok — Stok toko bertambah kembali sebesar yang tadi dikurangkan, dan bila ada Nota Kredit berstatus Draf, Nota Kredit itu dihapus (BR-10, BR-11).
5.2 Status Lifecycle
| Status | Keterangan | Selanjutnya |
|---|---|---|
Drafdraft | Sedang disusun, stok toko belum berubah | Diajukan, atau dihapus |
Diajukansubmitted | Berlaku dan terkunci, stok sudah berkurang | Selesai, Dibatalkan |
Selesaiclosed | Retur tuntas diproses; bila sudah ditagihkan, Nota Kreditnya sudah diajukan | — |
Dibatalkancancelled | Ditarik kembali, stok sudah dipulihkan | — |
6. Document Structure
Bagian ini mendefinisikan isi dokumen Retur itu sendiri: field apa saja yang dimiliki sebuah Retur, tipenya, mana yang wajib, nilai awalnya, aturan nilainya, dan rumus perhitungannya. Ketentuan di sini berlaku di mana pun Retur dibuat atau diubah dan ditegakkan saat penyimpanan, terlepas dari bagaimana field itu ditampilkan.
6.1 General
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Nomor Retur | Teks | — | Dibuat saat disimpan | Ditetapkan sistem dengan format PR/{Kode Toko}/{Tahun}/{000000}, tidak bisa diubah |
| Toko | Ref. Toko | Ya | Toko tempat pengguna sedang bekerja | Tidak bisa diubah (BR-01) |
| Penerimaan Barang | Ref. GR | Tidak | — | Kosong berarti Retur tanpa penerimaan (BR-02). Dipilih dari GR toko yang sama berstatus Diajukan atau Selesai; tidak bisa diubah setelah Retur diajukan |
| Supplier | Ref. Supplier | Ya | Supplier penerimaan terpilih | Dipilih manual hanya pada Retur tanpa penerimaan; harus sama dengan supplier penerimaan bila ada (BR-16) |
| Tanggal Retur | Tanggal & Waktu | Ya | Sekarang | Menyimpan tanggal beserta jam keluarnya barang |
| Alamat Pengiriman | Ref. Alamat Toko | Ya | Alamat pengiriman default toko, atau alamat pertamanya | Dipilih dari alamat milik toko Retur; tempat barang dikirim keluar |
| Alamat Penerima | Ref. Alamat Supplier | Ya | Alamat default supplier, atau alamat pertamanya | Dipilih dari alamat milik supplier Retur; harus dipilih ulang bila supplier berganti |
| Nomor Plat Pengiriman | Teks | Tidak | — | Nomor kendaraan yang mengangkut barang retur, maksimal 255 karakter |
| Penanggung Jawab Pengiriman | Teks | Tidak | — | Nama pengemudi atau kurir yang membawa barang retur, maksimal 255 karakter |
| Penanggung Jawab (PIC) | Ref. Karyawan, banyak | Ya, sebelum diajukan | Karyawan pengguna yang login, bila ada | Karyawan toko; hanya bisa diisi pemegang izin assign (BR-23) |
| Alasan Retur | Enum | Ya | — | Rusak, Kedaluwarsa, Salah Kirim, Kelebihan Stok, Gagal Uji Mutu, atau Lainnya (BR-14) |
| Referensi Retur Supplier | Teks | Tidak | — | Nomor otorisasi retur dari supplier, bila supplier menerbitkannya |
| Dokumen Pendukung | Berkas, banyak | Tidak | — | Boleh lebih dari satu berkas dan boleh tidak diisi; batas jumlah, ukuran, dan tipe berkas Perlu dikonfirmasi (BR-14) |
| Catatan | Teks | Tidak | — | — |
| Alasan Pembatalan | Teks | Ya, saat dibatalkan | — | Wajib diisi pada aksi Batalkan, yang hanya tersedia pada Retur Diajukan (BR-10) |
| Status | Enum | — | Draf | Ditetapkan sistem; lihat Status Lifecycle |
6.2 Line Items
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Urutan | Angka | — | Mengikuti urutan penambahan | Ditetapkan sistem |
| Produk (Kemasan) | Ref. Inventaris Produk Toko | Ya | Mengikuti item penerimaan terpilih | Satu baris per kemasan; pada Retur dengan penerimaan hanya kemasan yang ada di penerimaan itu (BR-01) |
| Item GR | Ref. Item GR | — | Item penerimaan dengan kemasan yang sama | Ditetapkan sistem; harus milik penerimaan pada header (BR-01), dan kosong pada Retur tanpa penerimaan (BR-02). Menjadi satu-satunya jejak yang dipakai Nota Kredit untuk menemukan item Tagihan (BR-22) |
| Satuan Ukuran | Teks | — | Mengikuti kemasan terpilih | Ditetapkan sistem |
| Kuantitas Bisa Diretur | Desimal | — | Dihitung saat item dipilih | Kuantitas Diterima item penerimaan dikurangi retur aktif sebelumnya (BR-06); kosong pada Retur tanpa penerimaan |
| Kuantitas Retur | Desimal | Ya | 1 | Minimal 0,01 dan tidak melebihi Kuantitas Bisa Diretur (BR-06) |
Baris Retur tidak memuat harga, diskon, maupun pajak; seluruh nilai finansial berada di Nota Kredit (BR-13).
6.3 Calculations
| Field | Rumus |
|---|---|
| Total Kuantitas Retur | Jumlah Kuantitas Retur seluruh baris |
| Jumlah Item | Banyaknya baris produk pada Retur |
7. UI Structure
Bagian ini mendefinisikan cara Retur ditampilkan dan dioperasikan: kolom pada daftar, filter, kontrol form beserta sumber pilihannya, dan susunan PDF. Bagian ini hanya mengatur tampilan dan interaksi; aturan isi dan nilainya tetap mengikuti Document Structure.
7.1 Datatable
| Kolom | Sortable | Contoh Nilai | Komponen |
|---|---|---|---|
| Pilih | — | — | Checkbox, Expand Toggle |
| No | — | 1 | Number |
| Nomor Retur | Ya | PR/CBI/2026/000042 | Link |
| Toko | — | Toko Cianjur | Text |
| Nomor Penerimaan | — | GR/CBI/2026/000042 | Link, kosong bila tanpa penerimaan |
| Supplier | — | PT Sumber Rejeki | Text |
| Tanggal Retur | Ya | 23 Sep 2026 14:30 | DateTime |
| Penanggung Jawab | — | Andi, Sari | Accordion, Add Button |
| Alasan Retur | — | Rusak | Badge |
| Total Kuantitas Retur | Ya | 12 | Number |
| Nomor Nota Kredit | — | CN/CBI/2026/000007 | Link, kosong bila belum ditagihkan |
| Dibuat Oleh | — | Budi Santoso | Text |
| Status | — | Diajukan | Badge |
| Aksi | — | Cetak · Lihat · Ubah · Hapus | Action Menu |
Expanded Row
| Kolom | Contoh Nilai | Komponen |
|---|---|---|
| Produk (Kemasan) | Minyak Goreng 2L (Karton) | Thumbnail, Text |
| Kuantitas Retur | 2 | Number |
| Satuan Ukuran | Karton | Text |
7.2 Advance Filter
| Field | Kontrol | Sumber Pilihan | Default |
|---|---|---|---|
| Toko | Multi Select | Toko yang ditugaskan ke pengguna | Kosong |
| Rentang Tanggal Retur | Date Range Picker | — | Kosong |
| Supplier | Multi Select | Master Supplier, bisa dicari | Kosong |
| Alasan Retur | Multi Select | Enum alasan retur | Kosong |
| Status | Multi Select | Enum status | Kosong |
7.3 Form & Details
Buat — Wizard tiga langkah: Umum, Produk, lalu Tinjauan. Langkah Umum menentukan penerimaan barang yang diretur atau menandainya tanpa penerimaan, dan langkah Produk baru bisa dibuka setelah pilihan itu ditetapkan. Tombol Selanjutnya memvalidasi langkah yang sedang aktif sebelum berpindah, dan langkah Tinjauan menampilkan ringkasan seluruh isian yang tidak bisa diubah. Aksi: Selanjutnya, Simpan, Pratinjau PDF.
Ubah — Dua tab, Umum dan Produk, dengan seluruh field aktif kecuali Penerimaan Barang, termasuk penetapan PIC. Hanya tersedia selama Retur berstatus Draf. Aksi: Simpan, tetapkan PIC, tambah/ubah/hapus produk, unggah dan hapus dokumen pendukung, Pratinjau PDF.
Detail — Nomor Retur, badge status, dan stepper status di bagian atas, diikuti tab Umum dan Produk yang hanya bisa dibaca. Dokumen pendukung tampil sebagai daftar berkas yang bisa diunduh. Bila Retur menghasilkan Nota Kredit, nomor Nota Kredit beserta statusnya tampil sebagai tautan di bagian atas. Aksi: Ubah Data, Ajukan, Hapus, Batalkan, Cetak, dan Log Aktivitas, masing-masing muncul sesuai status Retur — Hapus hanya pada Draf dan Batalkan hanya pada Diajukan (BR-10). Tombol aksi status tetap tampil bagi pengguna yang bukan PIC, tetapi dalam keadaan nonaktif (BR-23).
Umum
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Toko | Read-only | Toko tempat pengguna sedang bekerja | — |
| Penerimaan Barang | Single Select | GR toko aktif berstatus Diajukan atau Selesai, bisa dicari dengan nomor penerimaan | Opsi Tanpa Penerimaan Barang selalu tampil paling atas; dipilih → Supplier terisi dan daftar produk dibatasi pada item penerimaan itu |
| Supplier | Single Select | Master Supplier, bisa dicari | Nonaktif dan terisi otomatis bila Penerimaan Barang dipilih |
| Tanggal Retur | DateTime Picker | — | Terisi tanggal dan jam saat form dibuka |
| Alamat Pengiriman | Single Select | Alamat toko aktif | Terisi alamat pengiriman default toko, atau alamat pertamanya |
| Alamat Penerima | Single Select | Alamat supplier terpilih | Terisi alamat default supplier, atau alamat pertamanya; dikosongkan dan diisi ulang saat Supplier berganti |
| Nomor Plat Pengiriman | Text Input | — | — |
| Penanggung Jawab Pengiriman | Text Input | — | — |
| Penanggung Jawab (PIC) | Multi Select | Karyawan toko | Hanya bisa diisi pemegang izin assign; default karyawan pengguna yang login |
| Alasan Retur | Single Select | Enum alasan retur | — |
| Referensi Retur Supplier | Text Input | — | — |
| Dokumen Pendukung | File Upload, bisa lebih dari satu | — | Opsional; berkas yang sudah terunggah tampil sebagai daftar yang bisa dihapus selagi Draf |
| Catatan | Textarea | — | — |
Produk — Tabel
| Kolom | Contoh Nilai | Komponen |
|---|---|---|
| Produk (Kemasan) | Minyak Goreng 2L (Karton) | Thumbnail, Text |
| Kuantitas Bisa Diretur | 10 | Number |
| Kuantitas Retur | 2 | Number |
| Satuan Ukuran | Karton | Text |
| Aksi | Ubah, Hapus, Lihat | Action Menu |
Produk — Form
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Produk (Kemasan) | Single Select | Item penerimaan terpilih; pada Retur tanpa penerimaan, inventaris produk toko yang dicari dengan nama atau barcode | Mengisi Satuan Ukuran dan Kuantitas Bisa Diretur |
| Satuan Ukuran | Read-only | Kemasan terpilih | — |
| Kuantitas Bisa Diretur | Read-only | Perhitungan sisa kuota retur | Kosong pada Retur tanpa penerimaan |
| Kuantitas Retur | Number Input | — | Melebihi Kuantitas Bisa Diretur → error di field |
Produk — Calculations
| Field | Contoh Nilai | Komponen |
|---|---|---|
| Total Kuantitas Retur | 12 | Number, read-only |
| Jumlah Item | 3 | Number, read-only |
7.4 PDF Format
| Bagian | Isi |
|---|---|
| Tanda Air | Status Retur, hanya pada Retur Draf dan Retur Dibatalkan |
| Kop | - Perusahaan: Nama, Kontak, Alamat - Dokumen: Judul Purchase Return, Nomor Retur, Tanggal Retur |
| Para Pihak | - Supplier: Nama, Alamat Penerima - Dikembalikan Dari: Nama Toko, Alamat Pengiriman - Pengiriman: Nomor Plat Pengiriman, Penanggung Jawab Pengiriman |
| Tabel Produk | No | Produk | Kuantitas Retur | Satuan Ukuran |
| Ringkasan | - Keterangan: Nomor Penerimaan, Alasan Retur, Referensi Retur Supplier - Catatan: Isi field Catatan - Lampiran: Daftar nama dokumen pendukung, bila ada - Calculations: Total Kuantitas Retur, Jumlah Item |
| Tanda Tangan | Kolom penyerah barang dari toko atas nama PIC pertama dan penerima dari pihak supplier, hanya pada Retur yang sudah keluar dari status Draf |
8. User Stories
US-01 - Membuat retur dari penerimaan barang
Sebagai staf gudang, saya ingin membuat retur yang merujuk penerimaan barang tertentu, agar asal barang yang dikembalikan jelas dan kuotanya terjaga.
| ID | Kriteria penerimaan |
|---|---|
| AC-01.1 | Saat pengguna dengan izin create membuka Tambah Baru di toko aktif, wizard Umum → Produk → Tinjauan tampil dengan toko aktif terisi (read-only) dan tanggal retur berisi tanggal beserta jam saat ini. |
| AC-01.2 | Pilihan Penerimaan Barang berisi GR toko aktif berstatus Diajukan atau Selesai, dicari dengan nomor penerimaan, dengan opsi Tanpa Penerimaan Barang selalu di urutan teratas. |
| AC-01.3 | Saat penerimaan dipilih, supplier terisi otomatis dan tidak bisa diubah, dan pilihan produk dibatasi pada item penerimaan tersebut (BR-01, BR-16). |
| AC-01.4 | Saat produk dipilih, satuan ukuran dan kuantitas bisa diretur terisi dari sumbernya sesuai Document Structure; tidak ada field harga, diskon, atau pajak di layar mana pun (BR-13). |
| AC-01.5 | Saat kuantitas retur berubah atau baris ditambah dan dihapus, Total Kuantitas Retur dan Jumlah Item diperbarui tanpa reload (BR-13). |
| AC-01.6 | Saat Simpan berhasil, Retur tersimpan berstatus Draf, toast sukses tampil, dan pengguna diarahkan ke daftar Retur. |
| AC-01.7 | Penerimaan sudah pernah diretur habis — penerimaan tetap bisa dipilih, tetapi seluruh produknya menampilkan kuantitas bisa diretur 0 dan tidak bisa ditambahkan (BR-06). |
| AC-01.8 | Toko aktif berstatus tidak aktif — halaman Tambah menampilkan halaman toko tidak aktif. |
| AC-01.9 | Pengguna bisa mengunggah lebih dari satu dokumen pendukung dan bisa menyimpan Retur tanpa mengunggah satu berkas pun; berkas yang sudah terunggah bisa dihapus selagi Retur berstatus Draf (BR-14). |
| AC-01.10 | Satu penerimaan yang sama bisa diretur berulang kali lewat Retur yang berbeda, masing-masing dengan alasan dan dokumen pendukungnya sendiri (BR-20). |
| AC-01.11 | Alamat pengiriman terisi otomatis dengan alamat pengiriman default toko; alamat penerima terisi dengan alamat default supplier terpilih. Jika tidak ada default, dipakai alamat pertama. |
US-02 - Membuat retur tanpa penerimaan barang
Sebagai staf gudang, saya ingin membuat retur tanpa merujuk penerimaan, agar barang yang sudah tercampur di stok toko tetap bisa dikembalikan dan tercatat.
| ID | Kriteria penerimaan |
|---|---|
| AC-02.1 | Saat opsi Tanpa Penerimaan Barang dipilih, field Supplier menjadi aktif dan ditentukan pengguna; tidak ada isian Tagihan di layar mana pun (BR-02, BR-22). |
| AC-02.2 | Produk dipilih langsung dari inventaris produk toko dengan pencarian nama atau barcode, dan kolom Kuantitas Bisa Diretur tampil kosong (BR-02). |
| AC-02.3 | Baris retur tanpa penerimaan tidak pernah tertaut ke item penerimaan mana pun, dan sebuah Retur tidak bisa memuat campuran baris bertaut dan tidak bertaut (BR-02). |
| AC-02.4 | Retur tanpa penerimaan tidak memotong kuota retur item penerimaan mana pun, sehingga tidak ada kuota yang perlu dialokasikan (BR-21). |
| AC-02.5 | Baris retur tanpa penerimaan tidak memuat nilai finansial apa pun; nilainya baru diisi staf finance di Nota Kredit (BR-13). |
| AC-02.6 | Pengajuan retur tanpa penerimaan selalu menerbitkan Nota Kredit dan tidak mengubah kuantitas yang masih bisa ditagihkan atas produk tersebut (BR-17, BR-21). |
US-03 - Mengajukan retur
Sebagai PIC, saya ingin mengajukan retur, agar stok toko langsung menyesuaikan dan isinya tidak berubah lagi.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Tombol Ajukan Retur tampil pada Retur Draf untuk pengguna dengan izin submit di toko aktif, dan hanya aktif jika pengguna adalah PIC Retur tersebut (BR-23). |
| AC-03.2 | Setelah konfirmasi, status menjadi Diajukan, stok toko berkurang sebesar kuantitas retur setiap baris, serta tercatat siapa dan kapan mengajukan (BR-07). |
| AC-03.3 | Pada Retur Diajukan, tombol Ubah Data dan aksi produk tidak tampil sehingga kuantitasnya terkunci (BR-06, BR-17). |
| AC-03.4 | Barang yang diretur belum pernah ditagihkan dan belum ada Tagihan yang merujuk penerimaannya — Retur langsung berstatus Selesai pada aksi yang sama, tanpa Nota Kredit (BR-08). |
| AC-03.5 | Isi penerimaan barang yang dirujuk tidak berubah sama sekali setelah pengajuan (BR-03). |
| AC-03.6 | Retur belum punya PIC — tombol Ajukan nonaktif untuk semua pengguna sampai PIC ditetapkan (BR-23). |
US-04 - Meretur barang yang Tagihannya masih Draf
Sebagai staf gudang, saya ingin tetap bisa mengajukan retur meski staf finance sedang menyusun tagihan atas penerimaan itu, agar pencatatan barang keluar tidak menunggu proses administrasi.
| ID | Kriteria penerimaan |
|---|---|
| AC-04.1 | Pengajuan retur tidak ditolak oleh adanya Tagihan berstatus Draf yang merujuk penerimaan tersebut (BR-18). |
| AC-04.2 | Kuantitas baris Tagihan Draf yang bersangkutan berkurang sebesar kuantitas retur, dan seluruh total Tagihan dihitung ulang (BR-18). |
| AC-04.3 | Baris Tagihan yang kuantitasnya habis diretur tetap ada dengan kuantitas 0 dan rujukan penerimaannya tidak dilepas (BR-18). |
| AC-04.4 | Tagihan yang sudah keluar dari status Draf tidak pernah disesuaikan dengan cara ini; kasus itu mengikuti jalur Nota Kredit (BR-04). |
| AC-04.5 | Penyesuaian tersebut muncul di log aktivitas Tagihan sehingga penyusun tagihan bisa melihat apa yang berubah (BR-18). |
| AC-04.6 | Tagihan yang dibaca dan disesuaikan ditemukan sistem dari penerimaan yang dirujuk, tanpa pengguna gudang perlu mengetahui atau memilih nomor tagihannya (BR-17, BR-22). |
US-05 - Meretur barang yang sudah ditagihkan
Sebagai staf gudang, saya ingin retur atas barang yang sudah ditagihkan menghasilkan nota kredit, agar kredit dari supplier punya dasar dokumen tanpa mengubah tagihan yang sudah berlaku.
| ID | Kriteria penerimaan |
|---|---|
| AC-05.1 | Total dan kuantitas Tagihan yang menagih barang itu tidak berubah setelah retur diajukan (BR-04). |
| AC-05.2 | Tepat satu Nota Kredit berstatus Draf terbentuk, dengan kuantitas tiap barisnya sama persis dengan baris retur (BR-09). |
| AC-05.3 | Retur tetap berstatus Diajukan selama Nota Kreditnya masih Draf, dan berpindah sendiri ke Selesai saat Nota Kredit itu diajukan tanpa aksi terpisah dari pengguna (BR-09, BR-12). |
| AC-05.4 | Nomor Nota Kredit tampil sebagai tautan di detail Retur dan di kolom daftar. |
| AC-05.5 | Pengajuan Retur yang terulang, baik karena kegagalan maupun klik ganda, tidak pernah menerbitkan Nota Kredit kedua (BR-20). |
| AC-05.6 | Seluruh harga, diskon, dan pajak atas barang yang diretur diisi dan disesuaikan di Nota Kredit, bukan di Retur (BR-13). |
US-06 - Menolak retur melebihi kuota
Sebagai sistem, saya ingin menolak retur yang jumlahnya melebihi kuantitas yang benar-benar diterima, agar stok dan angka tagihan tetap konsisten.
| ID | Kriteria penerimaan |
|---|---|
| AC-06.1 | Retur ditolak saat jumlah kuantitas retur aktif atas satu item penerimaan melebihi Kuantitas Diterima item tersebut, sebelum stok berubah dan sebelum Nota Kredit dibuat (BR-06). |
| AC-06.2 | Retur kedua, ketiga, dan seterusnya atas item penerimaan yang sama tetap diterima selama jumlah keseluruhannya masih dalam batas (BR-06, BR-20). |
| AC-06.3 | Retur yang sudah Dibatalkan tidak ikut dihitung sebagai pemakai kuota (BR-06). |
| AC-06.4 | Kuantitas yang ditolak saat penerimaan tidak pernah bisa diretur karena tidak pernah masuk sebagai Kuantitas Diterima (BR-06). |
| AC-06.5 | Dua pengajuan Retur atas item penerimaan yang sama terjadi bersamaan — hanya satu yang lolos, dan yang lain ditolak sebelum stok berubah (BR-20). |
US-07 - Membatalkan retur
Sebagai PIC, saya ingin membatalkan retur yang salah dicatat, agar stok kembali seperti semula dan tidak ada kredit yang terlanjur diakui.
| ID | Kriteria penerimaan |
|---|---|
| AC-07.1 | Tombol Batalkan Retur hanya tampil pada Retur berstatus Diajukan untuk pengguna dengan izin cancel di toko aktif, dan hanya aktif jika pengguna adalah PIC (BR-10, BR-23). |
| AC-07.2 | Dialog pembatalan mewajibkan alasan; tombol konfirmasi nonaktif selama alasan kosong (BR-10). |
| AC-07.3 | Setelah dibatalkan, stok toko kembali bertambah sebesar yang tadi dikurangkan, dan alasan, pelaku, serta waktunya tersimpan (BR-10). |
| AC-07.4 | Retur yang sudah ditagihkan dan Nota Kreditnya masih Draf — pembatalan menghapus Nota Kredit itu dan memulihkan stok dalam satu aksi (BR-11). |
| AC-07.5 | Retur yang Nota Kreditnya sudah diajukan — tombol Batalkan tidak tersedia karena Retur sudah berstatus Selesai (BR-12). |
| AC-07.6 | Retur berstatus Draf tidak punya aksi Batalkan; yang tidak dipakai dihapus lewat aksi Hapus (BR-10). |
| AC-07.7 | Retur berstatus Selesai tidak bisa dibatalkan. |
| AC-07.8 | Pengguna bukan PIC membuka Retur — tombol Ajukan dan Batalkan tampil tetapi nonaktif (BR-23). |
US-08 - Daftar dan pencarian retur
Sebagai owner, saya ingin melihat dan menyaring retur, agar volume dan sebab pengembalian per supplier terlihat.
| ID | Kriteria penerimaan |
|---|---|
| AC-08.1 | Default menampilkan Retur toko aktif; filter lanjutan: toko, supplier, rentang tanggal retur, alasan retur, dan status; pencarian dengan kata kunci. |
| AC-08.2 | Kolom: nomor retur, toko, nomor penerimaan, supplier, tanggal retur, penanggung jawab, alasan retur, total kuantitas retur, nomor nota kredit, dibuat oleh, dan status. |
| AC-08.3 | Urutan default tanggal retur terbaru di atas, dengan paginasi. Kolom yang bisa diurutkan: nomor retur, tanggal retur, dan total kuantitas retur. |
| AC-08.4 | Baris bisa diperluas untuk melihat daftar produk retur tanpa membuka detail. |
| AC-08.5 | Aksi baris: Cetak, Lihat, Ubah (hanya Draf), Hapus (hanya Draf), sesuai izin. |
US-09 - Mencetak retur
Sebagai staf gudang, saya ingin mencetak retur sebagai PDF, agar bisa ikut dibawa bersama barang yang dikembalikan ke supplier.
| ID | Kriteria penerimaan |
|---|---|
| AC-09.1 | Pratinjau PDF tersedia dari wizard buat Retur, halaman detail/edit, dan aksi Cetak di daftar, pada status apa pun. |
| AC-09.2 | Sebelum Retur disimpan, nomor retur di PDF tampil kosong (”-”). |
| AC-09.3 | PDF memuat alasan retur, referensi retur supplier, catatan, dan daftar nama dokumen pendukung bila ada, tanpa nilai finansial apa pun (BR-13, BR-14). |
| AC-09.4 | PDF memuat kolom tanda tangan penanggung jawab (PIC pertama). |
US-10 - Riwayat aktivitas
Sebagai owner, saya ingin melihat log aktivitas retur, agar tahu siapa mengubah apa dan kapan.
| ID | Kriteria penerimaan |
|---|---|
| AC-10.1 | Log aktivitas tersedia per Retur (di detail) dan untuk seluruh Retur (di daftar) (BR-19). |
US-11 - Menetapkan penanggung jawab
Sebagai kepala toko, saya ingin menetapkan PIC pada Retur, agar jelas siapa yang berwenang mengajukan dan membatalkan retur.
| ID | Kriteria penerimaan |
|---|---|
| AC-11.1 | PIC bisa dipilih lebih dari satu dari daftar karyawan toko, saat membuat Retur, saat mengubah Draf, atau lewat tombol tambah di kolom Penanggung Jawab pada daftar (BR-23). |
| AC-11.2 | Tombol tambah PIC di daftar hanya tampil pada Retur Draf untuk pengguna dengan izin assign di toko aktif. Dialog tetapkan PIC mewajibkan minimal satu karyawan (BR-23). |
| AC-11.3 | Penetapan PIC tidak bisa diubah setelah Retur diajukan (BR-23). |
9. User Scenarios
| Role | Scenario |
|---|---|
| Staf Gudang | Menemukan 2 karton minyak goreng penyok saat menata barang dari penerimaan kemarin, membuat retur yang merujuk penerimaan itu, melampirkan foto kemasan yang rusak, lalu mengajukannya sebelum tagihan dibuat sehingga jumlah yang ditagihkan otomatis berkurang |
| Staf Gudang | Menemukan sisa barang bermasalah dari penerimaan yang sama seminggu kemudian dan membuat retur kedua atas penerimaan itu, karena kuotanya masih tersisa |
| Staf Gudang | Menemukan produk kedaluwarsa yang sudah tercampur di rak dari beberapa kali kiriman, membuat retur tanpa penerimaan barang, dan menyerahkan urusan nilainya ke staf finance |
| Staf Finance | Meninjau Nota Kredit berstatus Draf yang terbit dari retur pasca-tagih, mengisi dan mencocokkan nilainya dengan nota kredit dari supplier, lalu mengajukannya sehingga returnya tertutup sendiri |
| PIC | Retur yang sudah diajukan ternyata salah kuantitas; membatalkannya dengan alasan sehingga stok pulih dan Nota Kredit Draf-nya terhapus, lalu membuat retur baru |
| Owner | Menyaring retur lintas toko berdasarkan supplier dan alasan retur untuk menilai supplier mana yang paling sering mengirim barang bermasalah |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
| Lihat List Retur (Semua Toko) | purchase:purchase-return:list:any | — |
| Lihat List Retur (Toko Ditugaskan) | purchase:purchase-return:list:store | — |
| Lihat Detail Retur (Semua Toko) | purchase:purchase-return:view:any | — |
| Lihat Detail Retur (Toko Ditugaskan) | purchase:purchase-return:view:store | — |
| Buat Retur | purchase:purchase-return:create:store | Toko aktif |
| Ubah Retur (Data Umum) | purchase:purchase-return:update:store | Toko aktif |
| Hapus Retur | purchase:purchase-return:delete:store | Toko aktif |
| Lihat Detail Produk | — | Mengikuti izin lihat detail Retur |
| Tambah Produk | purchase:purchase-return:update:storepurchase:purchase-return:create:store | Toko aktif |
| Ubah Produk | purchase:purchase-return:update:store | Toko aktif |
| Hapus Produk | purchase:purchase-return:update:storepurchase:purchase-return:delete:store | Toko aktif |
| Unggah Dokumen Pendukung | purchase:purchase-return:update:store | Toko aktif |
| Hapus Dokumen Pendukung | purchase:purchase-return:update:storepurchase:purchase-return:delete:store | Toko aktif |
| Tetapkan PIC | purchase:purchase-return:assign:store | Toko aktif, dari daftar Retur |
| Ajukan | purchase:purchase-return:submit:store | Toko aktif, pengguna adalah PIC |
| Batalkan | purchase:purchase-return:cancel:store | Toko aktif, pengguna adalah PIC |
Tidak ada izin untuk menutup Retur: perpindahan ke Selesai ditetapkan sistem (BR-08, BR-09, BR-12), bukan aksi yang dipanggil pengguna.
10.2 Action by Status
| Action | Draf | Diajukan | Selesai | Dibatalkan |
|---|---|---|---|---|
| Ubah Retur (Data Umum) | ✓ | — | — | — |
| Hapus Retur | ✓ | — | — | — |
| Lihat Detail Produk | ✓ | ✓ | ✓ | ✓ |
| Tambah Produk | ✓ | — | — | — |
| Ubah Produk | ✓ | — | — | — |
| Hapus Produk | ✓ | — | — | — |
| Unggah Dokumen Pendukung | ✓ | — | — | — |
| Hapus Dokumen Pendukung | ✓ | — | — | — |
| Unduh Dokumen Pendukung | ✓ | ✓ | ✓ | ✓ |
| Tetapkan PIC | ✓ | — | — | — |
| Ajukan | ✓ | — | — | — |
| Batalkan | — | ✓ | — | — |
| Menerbitkan Nota Kredit | — | ✓ | — | — |
| Pratinjau dan Cetak PDF | ✓ | ✓ | ✓ | ✓ |
| Lihat Log Aktivitas | ✓ | ✓ | ✓ | ✓ |
11. Notifications
Fitur ini tidak memicu notifikasi.
12. Dependencies
PRD terkait
- Goods Receipt — satu-satunya dokumen yang bisa dirujuk Retur, sumber item yang bisa diretur beserta Kuantitas Diterima yang membatasi kuotanya (BR-01, BR-06, BR-22).
- Bill — dibaca sistem sebagai penentu barang sudah ditagihkan atau belum (BR-17) dan sasaran penyesuaian kuantitas saat masih Draf (BR-18); tidak pernah dirujuk langsung oleh Retur (BR-22).
- Credit Note — padanan finansial retur pasca-tagih yang memegang seluruh nilai uangnya (BR-13), pengajuannya menutup Retur (BR-09, BR-12), dan dokumennya terhapus bila Retur dibatalkan (BR-11).
Master data
- Toko — toko aktif, kode toko untuk penomoran, dan status aktifnya.
- Supplier — supplier tujuan pengembalian barang.
- Karyawan — kandidat penanggung jawab (PIC) Retur (BR-23).
- Produk & Inventaris Produk — kemasan, satuan ukuran, barcode, dan stok per toko.
- File Manager — penyimpanan dokumen pendukung yang dilampirkan pada Retur (BR-14).
Efek ke modul lain
- Inventaris Produk — stok berkurang saat Retur diajukan dan bertambah kembali saat dibatalkan (BR-07, BR-10).
- Bill — kuantitas yang masih bisa ditagihkan berkurang untuk retur yang merujuk penerimaan (BR-05, BR-21), dan Tagihan berstatus Draf dihitung ulang (BR-18).
- Credit Note — Nota Kredit berstatus Draf terbit otomatis untuk retur pasca-tagih dan untuk seluruh retur tanpa penerimaan (BR-09, BR-17).
- Retur menyimpan identitas transaksi yang stabil sebagai sumber pengurangan stok, agar bisa menjadi asal pergerakan stok bila kartu stok dibangun nanti (BR-07).
- Retur tidak mengubah harga pokok rata-rata produk (BR-15).
- Setiap perubahan tercatat di log aktivitas (BR-19).