Item Pembelian
- Code: PUR-POL
- Module: Purchasing
- Type: System Record
1. Overview
Item Pembelian adalah rekap lintas-PO yang menyandingkan kuantitas dipesan pada tiap item Purchase Order (PO) dengan kuantitas yang benar-benar diterima, diakumulasi dari seluruh Goods Receipt (GR) yang merujuknya. Barang yang diterima lewat GR tanpa PO ikut muncul di rekap yang sama, tanpa pembanding kuantitas pesanan. Seluruh isinya dihasilkan sistem dari data PO dan GR; tidak ada data yang dibuat, diubah, atau dihapus langsung dari sini.
Hasil yang diharapkan: progres penerimaan tiap produk yang dipesan terlihat di satu tempat lintas PO dan toko, sisa yang masih ditunggu ketahuan tanpa membuka satu-satu PO, dan kelebihan kirim langsung terlihat.
2. Problem
Tanpa rekap ini, mengetahui sisa kuantitas sebuah produk berarti membuka PO-nya satu per satu lalu menjumlahkan manual seluruh GR yang sudah menerimanya. Akibatnya:
- Sisa pesanan per produk tidak terlihat lintas PO, sehingga staf purchasing harus membuka tiap PO untuk memastikan apa yang masih ditunggu.
- Kelebihan kirim dari supplier tidak mudah terdeteksi karena tidak ada tempat yang membandingkan langsung kuantitas dipesan dan diterima.
- Barang yang diterima tanpa PO tidak tercatat di rekap manapun, sehingga terpisah dari gambaran penerimaan barang secara keseluruhan.
3. Goals & Non-goals
3.1 Goals
- Kuantitas dipesan, diterima, dan sisa tiap item terlihat di satu tempat, bisa disaring per toko, supplier, PO, produk, dan status.
- Kelebihan penerimaan (over-received) ketahuan tanpa menghitung manual.
- Barang yang diterima tanpa PO tetap tercatat di rekap yang sama, terpisah jelas dari item yang berasal dari PO.
3.2 Non-goals
- Membuat, mengubah, atau menghapus data dari sini; seluruh perubahan dilakukan lewat Purchase Order dan Goods Receipt.
- Menjadi dokumen tersendiri dengan status dan alur sendiri; modul ini murni tampilan turunan dari data PO dan GR.
4. Business Rules
Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk Item Pembelian 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 Satu baris Item Pembelian mewakili satu item PO, atau satu item GR yang diterima tanpa merujuk PO manapun.
- BR-02 Pada baris yang berasal dari item GR tanpa PO, seluruh field sisi pesanan — kuantitas dipesan, kuantitas sisa, harga dipesan, dan status order — kosong, karena tidak ada pesanan sebagai pembanding.
- BR-03 Kuantitas diterima adalah akumulasi kuantitas diterima dari seluruh GR berstatus Diajukan atau Selesai yang merujuk item tersebut. GR berstatus Draf dan Dibatalkan tidak dihitung.
- BR-04 Kuantitas sisa dihitung sebagai kuantitas dipesan dikurangi kuantitas diterima, minimal 0. Kuantitas diterima yang melebihi kuantitas dipesan ditandai kelebihan terima, bukan sisa bernilai negatif.
- BR-05 Status penerimaan ditentukan dari perbandingan kuantitas diterima dengan kuantitas dipesan: Belum Diterima bila belum ada yang diterima, Diterima Sebagian bila kurang dari kuantitas dipesan, Diterima Penuh bila sama dengan atau melebihi kuantitas dipesan pada baris yang berasal dari item PO, atau Diterima pada baris yang berasal dari item GR tanpa pesanan pembanding.
- BR-06 Status order mengikuti status PO yang menaungi item tersebut, dan kosong pada baris yang berasal dari item GR tanpa PO.
- BR-07 Data pada modul ini tidak bisa dibuat, diubah, atau dihapus secara langsung; seluruh isinya ditentukan oleh perubahan pada Purchase Order dan Goods Receipt.
5. Flow
5.1 Main Flowchart
- PO Diajukan — Sejak PO diajukan, tiap item PO-nya tersedia sebagai baris Item Pembelian dengan kuantitas dipesan terisi dan kuantitas diterima 0.
- Baris Terbentuk — Baris juga terbentuk untuk tiap item GR yang diterima tanpa merujuk PO, tanpa kuantitas dipesan sebagai pembanding (BR-02).
- Kuantitas Diperbarui — Setiap kali GR yang merujuk baris ini diajukan atau dibatalkan, kuantitas diterima, kuantitas sisa, dan status penerimaan dihitung ulang (BR-03, BR-04, BR-05).
Fitur ini tidak memiliki status sendiri; status yang tampil mengikuti status PO dan status penerimaan yang diturunkan darinya, sehingga tidak ada Status Lifecycle tersendiri.
6. Document Structure
Bagian ini mendefinisikan isi tiap baris Item Pembelian: field apa saja yang dimilikinya dan dari mana asalnya. Seluruh field ditetapkan sistem dan diturunkan dari data PO dan GR, bukan diisi pengguna.
6.1 General
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Toko | Ref. Toko | — | — | Ditetapkan sistem, mengikuti toko PO atau toko GR |
| Supplier | Ref. Supplier | — | — | Ditetapkan sistem, mengikuti supplier PO atau supplier GR |
| Nomor PO | Ref. PO | — | — | Ditetapkan sistem; kosong pada item GR tanpa PO (BR-02) |
| Tanggal Pemesanan | Tanggal | — | — | Ditetapkan sistem; kosong pada item GR tanpa PO (BR-02) |
| Produk (Kemasan) | Ref. Inventaris Produk Toko | — | — | Ditetapkan sistem |
| Satuan Ukuran | Teks | — | — | Ditetapkan sistem, mengikuti kemasan |
| Kuantitas Dipesan | Desimal | — | — | Ditetapkan sistem, dari item PO; kosong pada item GR tanpa PO (BR-02) |
| Kuantitas Diterima | Desimal | — | 0 | Ditetapkan sistem, akumulasi dari GR (BR-03) |
| Kuantitas Sisa | Desimal | — | — | Ditetapkan sistem (BR-04); kosong pada item GR tanpa PO (BR-02) |
| Harga Dipesan | Mata Uang | — | — | Ditetapkan sistem, dari item PO; kosong pada item GR tanpa PO (BR-02) |
| Status Order | Enum | — | — | Ditetapkan sistem (BR-06); kosong pada item GR tanpa PO (BR-02) |
| Status Penerimaan | Enum | — | Belum Diterima | Ditetapkan sistem (BR-05) |
| Progres Penerimaan | Persen | — | — | Ditetapkan sistem, kuantitas diterima dibagi kuantitas dipesan; kosong pada item GR tanpa PO (BR-02) |
| Tanggal Penerimaan Pertama | Tanggal | — | — | Ditetapkan sistem, dari GR pertama yang diajukan; kosong bila belum ada penerimaan |
| Goods Receipt | Objek, banyak | — | — | Ditetapkan sistem; daftar GR yang merujuk item ini beserta kuantitas dikirim, ditolak, diterima, dan statusnya |
7. UI Structure
Bagian ini mendefinisikan cara Item Pembelian ditampilkan: kolom pada daftar dan filter. Bagian ini hanya mengatur tampilan; aturan isi dan nilainya tetap mengikuti Document Structure.
7.1 Datatable
| Kolom | Sortable | Contoh Nilai | Komponen |
|---|---|---|---|
| Expand Toggle | — | — | Expand Toggle |
| No | — | 1 | Number |
| Toko | — | Toko Cianjur | Text |
| Supplier | — | PT Sumber Rejeki | Text |
| Nomor PO | — | PO/CBI/2026/000042 | Link, kosong bila tanpa PO |
| Tanggal PO | — | 20 Sep 2026 | Date, kosong bila tanpa PO |
| Kode Produk | — | SKU-0012 | Text |
| Produk (Kemasan) | — | Minyak Goreng 2L (Karton) | Thumbnail, Text |
| Satuan Ukuran | — | Karton | Text |
| Kuantitas Dipesan | — | 10 | Number, kosong bila tanpa PO |
| Kuantitas Diterima | — | 9 | Number |
| Kuantitas Sisa | — | 1 | Number, kosong bila tanpa PO |
| Harga Dipesan | — | Rp 250.000 | Currency, kosong bila tanpa PO |
| Status Order | — | Diajukan | Badge, kosong bila tanpa PO |
| Status Penerimaan | — | Diterima Sebagian | Badge |
| Progres Penerimaan | — | 90% | Progress Bar, kosong bila tanpa PO |
Tidak ada kolom Pilih maupun Aksi — baris tidak bisa dipilih massal dan tidak punya aksi apa pun (BR-07).
Expanded Row
Daftar Goods Receipt yang merujuk item ini.
| Kolom | Contoh Nilai | Komponen |
|---|---|---|
| Nomor GR | GR/CBI/2026/000042 | Link |
| Tanggal GR | 23 Sep 2026 | Date |
| Kuantitas Dikirim | 10 | Number |
| Kuantitas Ditolak | 1 | Number |
| Kuantitas Diterima | 9 | Number |
| Status | Diajukan | Badge |
Kosong dengan pesan belum ada penerimaan barang untuk item ini, bila belum ada GR yang merujuk item tersebut.
7.2 Advance Filter
| Field | Kontrol | Sumber Pilihan | Default |
|---|---|---|---|
| Toko | Multi Select | Toko yang ditugaskan ke pengguna | Toko aktif |
| Supplier | Multi Select | Master Supplier, bisa dicari | Kosong |
| Pesanan Pembelian | Multi Select | PO toko terpilih berstatus selain Draf, bisa dicari | Kosong |
| Produk | Multi Select | Master Produk, bisa dicari | Kosong |
| Rentang Tanggal PO | Date Range Picker | — | Kosong |
| Rentang Tanggal Penerimaan Pertama | Date Range Picker | — | Kosong |
| Status Order | Multi Select | Enum status order | Kosong |
| Status Penerimaan | Multi Select | Enum status penerimaan | Kosong |
8. User Stories
US-01 - Melihat progres penerimaan lintas PO
Sebagai staf purchasing, saya ingin melihat kuantitas dipesan, diterima, dan sisa tiap item pembelian, agar tahu apa yang masih ditunggu tanpa membuka tiap PO.
| ID | Kriteria penerimaan |
|---|---|
| AC-01.1 | Default menampilkan item toko aktif; filter lanjutan: toko, supplier, PO, produk, rentang tanggal PO, rentang tanggal penerimaan pertama, status order, dan status penerimaan; pencarian dengan kata kunci. |
| AC-01.2 | Kolom: toko, supplier, nomor PO, tanggal PO, kode produk, produk, satuan ukuran, kuantitas dipesan, kuantitas diterima, kuantitas sisa, harga dipesan, status order, status penerimaan, dan progres penerimaan. |
| AC-01.3 | Item yang berasal dari GR tanpa PO menampilkan kolom nomor PO, tanggal PO, kuantitas dipesan, kuantitas sisa, harga dipesan, status order, dan progres penerimaan sebagai kosong (BR-02). |
US-02 - Menelusuri penerimaan sebuah item
Sebagai staf purchasing, saya ingin melihat seluruh GR yang membentuk kuantitas diterima sebuah item, agar bisa menelusuri asal tiap penerimaan.
| ID | Kriteria penerimaan |
|---|---|
| AC-02.1 | Baris bisa diperluas untuk menampilkan daftar GR yang merujuk item tersebut, beserta kuantitas dikirim, ditolak, diterima, dan statusnya (BR-03). |
| AC-02.2 | Item yang belum punya penerimaan menampilkan keterangan belum ada penerimaan barang saat baris diperluas. |
US-03 - Mendeteksi kelebihan penerimaan
Sebagai staf purchasing, saya ingin item yang diterima melebihi kuantitas pesanan terlihat jelas, agar bisa ditindaklanjuti ke supplier.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Item dengan kuantitas diterima melebihi kuantitas dipesan menampilkan progres penerimaan di atas 100% dan kuantitas sisa 0, bukan nilai negatif (BR-04). |
US-04 - Melihat barang diterima tanpa PO
Sebagai staf purchasing, saya ingin barang yang diterima tanpa pesanan tetap tercatat di rekap yang sama, agar seluruh penerimaan barang terlihat lengkap.
| ID | Kriteria penerimaan |
|---|---|
| AC-04.1 | Item yang berasal dari GR tanpa PO tampil dengan status penerimaan Diterima, tanpa status order (BR-02, BR-05). |
9. User Scenarios
| Role | Scenario |
|---|---|
| Staf Purchasing | Menyaring per PO untuk memeriksa sisa kuantitas sebelum membuat GR susulan bagi supplier yang mengirim bertahap |
| Owner | Menyaring status Diterima Sebagian lintas toko untuk memantau supplier yang sering mengirim kurang dari pesanan |
| Staf Purchasing | Menemukan item dengan progres di atas 100% untuk mengonfirmasi kelebihan kirim ke supplier |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
| Lihat List Item Pembelian (Semua Toko) | purchase:purchase-order-line:list:any | — |
| Lihat List Item Pembelian (Toko Ditugaskan) | purchase:purchase-order-line:list:store | — |
11. Notifications
Fitur ini tidak memicu notifikasi.
12. Dependencies
PRD terkait
- Purchase Order — sumber kuantitas dan harga dipesan tiap item (BR-02, BR-06).
- Goods Receipt — sumber kuantitas diterima, diakumulasi per item (BR-03).
Master data
- Toko — toko aktif dan toko yang ditugaskan ke pengguna.
- Supplier — data supplier tiap item.
- Produk & Inventaris Produk — kemasan, satuan ukuran, dan barcode.