Retur Pembelian

Retur Pembelian adalah dokumen pengembalian barang dari gudang pusat ke supplier, dibuat berdasarkan Penerimaan Barang (GRN) yang sebelumnya diterima. Retur dipakai ketika barang yang sudah diterima ternyata cacat, salah kirim, kelebihan, atau rusak. Retur dibuat sebagai Draft terlebih dahulu; baru saat dikirim, stok gudang pusat berkurang dan hutang ke supplier dikoreksi lewat debit note di Akunting.

Path menu: Pengadaan → Retur Pembelian (/purchase-returns)

---

Daftar Retur

Halaman utama menampilkan retur dalam bentuk tabel. Setiap baris dapat diklik untuk membuka detail.

Kolom	Keterangan
No	Nomor urut baris
Nomor RTN	Nomor retur (format mono)
GRN Asal	Nomor penerimaan sumber retur
Supplier	Nama supplier tujuan retur
Alasan	Alasan retur
Total	Total nilai retur dalam Rupiah
Status	Badge status retur

Tersedia kolom pencarian dengan placeholder "Cari nomor RTN / GRN / supplier..." dan tombol Buat Retur (aktif bila punya izin tulis).

---

Status Retur

Status	Label	Warna
draft	Draft	Abu-abu
sent	Terkirim	Hijau
failed	Gagal	Merah
cancelled	Dibatalkan	Merah

---

Alasan Retur

Nilai	Label
DEFECTIVE	Barang cacat
WRONG_ITEM	Salah kirim
EXCESS	Kelebihan kirim
DAMAGED	Rusak saat terima
OTHER	Lainnya

---

Alur Retur

(Pilih GRN) → Draft → (Kirim Retur) → Terkirim
                 │                        │
        (Batalkan) → Dibatalkan    stok pusat berkurang + debit note di Akunting

---

Membuat Retur

Halaman Buat Retur Pembelian (/purchase-returns/create) berjalan dua langkah:

Langkah 1 — Pilih Penerimaan (GRN) Cari GRN yang akan diretur lewat kolom pencarian (nomor GRN / supplier), lalu tekan Pilih pada baris yang sesuai. Supplier dan barang retur otomatis mengikuti GRN yang dipilih.

Langkah 2 — Isi form retur

Bagian	Keterangan
Alasan retur	Pilih dari daftar alasan (default: Barang cacat)
Tanggal retur	Kalender Flatpickr; bila kosong dianggap hari ini
Catatan	Catatan bebas (opsional)
Qty Retur per barang	Untuk tiap item GRN: Barang, Diterima (qty pada GRN), Modal (harga satuan), Qty Retur (0 sampai maksimal jumlah yang diterima), dan Subtotal

Total retur dihitung otomatis. Menekan Simpan Draft membuat retur berstatus Draft dan mengarahkan ke halaman detail retur.

WARNING

Retur harus mengisi qty > 0 untuk minimal satu barang. Qty retur tiap barang dibatasi maksimal sebesar jumlah yang diterima pada GRN. Menyimpan hanya membuat Draft — stok dan jurnal belum berubah.

---

Detail & Aksi

Halaman detail (/purchase-returns/[id]) menampilkan:

• Header — nomor RTN dan badge status.
• Informasi — GRN Asal, Supplier, Alasan, Tanggal, Total Nilai, dan status Akunting (badge hijau berisi nomor debit note bila sudah terkirim, atau "-").
• Catatan bila ada; dan pesan Gagal (last_error) bila status Gagal.
• Tabel barang — Barang, Qty, Modal, Subtotal.

Aksi menyesuaikan status:

Status	Aksi tersedia
Draft	Batalkan (izin hapus) dan Kirim Retur (izin tulis, dengan dialog konfirmasi)
Terkirim	Cetak Surat Jalan — membuka halaman cetak (/rtn-print/<id>) di tab baru

---

Mengirim Retur

Menekan Kirim Retur pada retur Draft menampilkan dialog konfirmasi. Mengirim retur akan:

• Mengurangi stok gudang pusat sebesar qty yang diretur.
• Membukukan debit note (koreksi hutang) ke supplier di Akunting.

Tindakan tidak bisa dibatalkan

Setelah retur dikirim, prosesnya tidak dapat dibatalkan. Pastikan barang, qty, dan alasan sudah benar sebelum menekan Ya, Kirim.

---

Hak Akses

• Buat Retur dan Kirim Retur membutuhkan izin tulis (write).
• Batalkan retur draft membutuhkan izin hapus (delete).

---

Hubungan dengan Modul Lain

Modul	Hubungan
Penerimaan Barang (GRN)	Sumber retur; barang & qty retur berasal dari GRN
Master Barang / Stok	Pengiriman retur mengurangi stok gudang pusat
Akunting	Pengiriman retur membukukan debit note (koreksi hutang) ke supplier