Penerimaan Barang
- Code: PUR-GR
- Module: Purchasing
- Type: Transaction
1. Overview
Goods Receipt (GR) adalah dokumen resmi yang mencatat barang yang benar-benar diterima satu toko dari satu supplier, baik yang berasal dari Purchase Order (PO) maupun barang yang datang tanpa pesanan formal. GR menjadi penghubung antara pesanan dan tagihan: mengonfirmasi status PO saat barang datang, dan menjadi acuan bagi Bill saat tagihan dibuat. Setiap GR punya satu penanggung jawab (PIC), yang berwenang mengajukan dan membatalkan penerimaan tersebut.
Hasil yang diharapkan: setiap barang yang masuk ke toko tercatat sesuai jumlah yang sebenarnya diterima, selisih dengan pesanan terlihat, dan supplier hanya ditagihkan untuk barang yang layak diterima.
2. Problem
Tanpa pencatatan resmi saat barang diterima, pemeriksaan hanya dilakukan sekilas dan buktinya sekadar disimpan, tidak pernah dicocokkan lebih lanjut. Akibatnya:
- Barang yang kurang kirim, rusak, atau salah kirim tidak tercatat, sehingga baru ketahuan saat stock opname atau saat tagihan dibayar.
- Tidak ada hubungan yang jelas antara pesanan, barang yang datang, dan tagihan; staf harus mencocokkannya secara manual.
- Tidak jelas siapa yang menerima barang dan kapan, sehingga selisih sulit ditelusuri.
- Toko membayar sesuai jumlah yang dikirim supplier, bukan jumlah yang benar-benar diterima.
3. Goals & Non-goals
3.1 Goals
- Barang yang benar-benar diterima tercatat terpisah dari yang dikirim supplier, sehingga kekurangan kiriman tidak ikut ditagihkan.
- Kondisi barang saat datang terdokumentasi sejak awal, bukan baru ketahuan saat stock opname.
- Setiap penerimaan punya penanggung jawab dan waktu yang tercatat, sehingga selisih bisa ditelusuri kembali.
- Pesanan yang belum terpenuhi terlihat langsung dari status PO, tanpa menghitung ulang tiap kiriman.
- Stok toko bertambah hanya sebesar barang yang layak diterima.
3.2 Non-goals
- Inspeksi kualitas bertingkat atau per batch; cukup mencatat kuantitas yang ditolak.
- Pencatatan nomor batch, tanggal kedaluwarsa, dan nomor seri.
- Retur barang ke supplier setelah penerimaan.
- Penerimaan dari sumber selain supplier, misalnya transfer antar toko atau retur pelanggan.
- Batas toleransi kelebihan penerimaan; kelebihan tetap diterima dan terlihat apa adanya.
- Revisi GR yang sudah diajukan; GR yang salah dibatalkan lalu dibuat ulang.
4. Business Rules
Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk GR 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 GR milik satu toko dan satu supplier. GR hanya bisa dibuat dan diubah oleh pengguna yang sedang bekerja pada toko tersebut.
- BR-02 Setiap GR harus memiliki penanggung jawab (PIC) sebelum bisa diajukan. Mengajukan dan membatalkan GR hanya boleh dilakukan oleh PIC yang ditetapkan pada GR itu dan memiliki izin untuk aksi tersebut; membuat GR saja tidak memberi kewenangan ini.
- BR-03 Isi GR, termasuk penetapan PIC, hanya bisa diubah selama berstatus Draf. GR yang sudah diajukan terkunci permanen, dan hanya GR Draf yang bisa dihapus.
- BR-04 GR yang dibuat dari PO hanya bisa merujuk PO milik toko yang sama dan berstatus Diajukan, Diterima Sebagian, atau Diterima. Toko dan supplier GR mengikuti PO tersebut.
- BR-05 GR tanpa PO wajib memilih supplier yang berstatus aktif.
- BR-06 Toko dan supplier tidak bisa diubah setelah GR dibuat. Tautan ke PO masih bisa diganti atau dilepas selama GR berstatus Draf.
- BR-07 Kuantitas dikirim minimal 0,01 dan kuantitas ditolak minimal 0. Kuantitas yang dianggap diterima adalah selisih keduanya, dan tidak pernah bernilai negatif.
- BR-08 Produk yang juga ada di PO otomatis ditautkan ke item PO tersebut beserta kuantitas pesanannya. Produk di luar PO tetap boleh diterima, tanpa tautan ke item PO manapun.
- BR-09 Stok toko bertambah sebesar kuantitas diterima pada saat GR diajukan. GR yang masih Draf tidak mengubah stok.
- BR-10 Saat GR yang merujuk PO diajukan, status PO diperbarui otomatis berdasarkan akumulasi kuantitas diterima dari seluruh GR yang sudah diajukan: sebagian terpenuhi menjadi Diterima Sebagian, seluruhnya terpenuhi menjadi Diterima.
- BR-11 Kuantitas dikirim tidak dibatasi oleh kuantitas pesanan maupun sisa yang belum diterima. Kelebihan penerimaan tetap diizinkan dan terlihat di modul Item Pembelian, karena belum ada batas toleransi.
- BR-12 GR hanya bisa dibatalkan saat berstatus Diajukan, dan pembatalan wajib menyertakan alasan. GR yang sudah Selesai tidak bisa dibatalkan.
- BR-13 Hanya GR berstatus Diajukan yang bisa ditagihkan. Satu GR hanya boleh dirujuk oleh satu Bill, dan statusnya menjadi Selesai begitu Bill dibuat.
- BR-14 Setiap perubahan data dan perpindahan status GR tercatat beserta pelaku dan waktunya.
5. Flow
5.1 Main Flowchart
- Buat GR — Staf mencatat penerimaan: sumbernya dari PO yang sudah diajukan atau tanpa PO, waktu dan alamat penerimaan, identitas pengirim, bukti penerimaan, serta kuantitas dikirim dan ditolak per produk. Bila dibuat dari PO, daftar produknya terisi otomatis dan tinggal disesuaikan dengan barang yang benar-benar datang.
- Validasi — Isian diperiksa sebelum GR tersimpan. GR yang melanggar aturan tidak bisa disimpan, dan kesalahannya ditunjukkan pada bagian yang bersangkutan.
- Draf — Status awal setelah GR tersimpan. Stok toko belum berubah. Selama berstatus Draf, isinya masih bisa diubah dan PIC-nya ditetapkan tanpa mengubah status; dari sini GR bisa diajukan atau dihapus.
- 3a. Ubah Data GR — Data umum maupun daftar produk bisa diperbarui, kecuali toko dan supplier yang terkunci sejak GR dibuat. Status tetap Draf.
- 3b. Tetapkan PIC — Satu atau lebih karyawan toko ditetapkan sebagai penanggung jawab. GR tetap berstatus Draf, dan penetapan ini syarat sebelum GR bisa diajukan.
- Diajukan — Dilakukan oleh PIC. GR terkunci permanen, stok toko bertambah sebesar kuantitas diterima, dan sejak titik ini GR bisa ditagihkan lewat Bill.
- Pembaruan Status PO — Berlaku bila GR merujuk PO. Kuantitas diterima dari seluruh GR yang sudah diajukan diakumulasi dan dibandingkan dengan kuantitas pesanan, lalu status PO diperbarui menjadi Diterima Sebagian atau Diterima. Rinciannya dijelaskan di PRD Purchase Order.
- Bill — Tagihan dibuat dengan merujuk GR ini. Rinciannya dijelaskan di PRD Bill.
- Selesai — GR sudah ditagihkan lewat Bill. GR tidak bisa dipilih lagi untuk Bill lain maupun dibatalkan.
- Dibatalkan — Dilakukan oleh PIC atas GR yang sudah diajukan tetapi tidak jadi dilanjutkan, dengan alasan yang wajib diisi.
5.2 Status Lifecycle
| Status | Keterangan | Selanjutnya |
|---|---|---|
Drafdraft | Sedang disusun, stok toko belum berubah | Diajukan, atau dihapus |
Diajukansubmitted | Berlaku dan terkunci, stok sudah bertambah, siap ditagihkan | Selesai, Dibatalkan |
Selesaiclosed | Sudah ditagihkan lewat Bill | — |
Dibatalkancancelled | Dibatalkan sebelum sempat ditagihkan | — |
6. Document Structure
Bagian ini mendefinisikan isi dokumen GR itu sendiri: field apa saja yang dimiliki sebuah GR, tipenya, mana yang wajib, nilai awalnya, dan aturan nilainya. Ketentuan di sini berlaku di mana pun GR dibuat atau diubah dan ditegakkan saat penyimpanan, terlepas dari bagaimana field itu ditampilkan.
6.1 General
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Nomor Penerimaan | Teks | — | Dibuat saat disimpan | Ditetapkan sistem dengan format GR/{Kode Toko}/{Tahun}/{000000}, tidak bisa diubah |
| Toko | Ref. Toko | Ya | Toko tempat pengguna sedang bekerja, atau toko PO | Tidak bisa diubah setelah dibuat (BR-04, BR-06) |
| Pesanan Pembelian | Ref. PO | Tidak | — | Kosong berarti GR tanpa PO. Dipilih dari PO toko yang sama berstatus Diajukan, Diterima Sebagian, atau Diterima (BR-04); masih bisa diganti atau dilepas selama Draf (BR-06) |
| Supplier | Ref. Supplier | Ya, bila tanpa PO | Supplier PO | Dipilih dari master Supplier yang berstatus aktif (BR-05); tidak bisa diubah setelah dibuat (BR-06) |
| Alamat Penerimaan | Ref. Alamat Toko | Ya | Alamat pengiriman default toko, atau alamat pertamanya | Dipilih dari alamat milik toko |
| Tanggal & Waktu Penerimaan | Tanggal & Waktu | Ya | Saat ini | — |
| Penanggung Jawab (PIC) | Ref. Karyawan, banyak | Ya, sebelum diajukan | Karyawan pengguna yang login, bila ada | Karyawan toko; hanya bisa diisi pemegang izin assign (BR-02) |
| Penanggung Jawab Pengirim | Teks | Tidak | — | Nama sopir atau kurir supplier |
| Nomor Polisi Kendaraan Pengirim | Teks | Tidak | — | — |
| Bukti Penerimaan | Berkas, banyak | Tidak | — | Gambar atau dokumen, misalnya foto surat jalan |
| Catatan | Teks | Tidak | — | — |
| 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 PO, bila dibuat dari PO | Dipilih dari inventaris produk toko; tiap kemasan dicatat sebagai baris terpisah |
| Item PO | Ref. Item PO | — | Item PO dengan produk yang sama | Ditetapkan sistem; kosong bila tanpa PO atau produknya tidak ada di PO (BR-08) |
| Satuan Ukuran | Teks | — | Mengikuti kemasan terpilih | Ditetapkan sistem |
| Kuantitas Pesanan | Desimal | — | Kuantitas item PO | Diambil dari item PO tertaut; kosong bila tidak tertaut PO |
| Kuantitas Dikirim | Desimal | Ya | Kuantitas Pesanan bila dari PO, selain itu 1 | Minimal 0,01 (BR-07) |
| Kuantitas Ditolak | Desimal | Tidak | 0 | Minimal 0 (BR-07) |
| Kuantitas Diterima | Desimal | — | — | Dihitung sistem: Kuantitas Dikirim dikurangi Kuantitas Ditolak, minimal 0 (BR-07) |
7. UI Structure
Bagian ini mendefinisikan cara GR 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 Penerimaan | Ya | GR/CBI/2026/000042 | Link |
| Toko | — | Toko Cianjur | Text |
| Nomor Pemesanan | — | PO/CBI/2026/000042 | Link, kosong bila tanpa PO |
| Tanggal Pemesanan | — | 20 Sep 2026 | Date, kosong bila tanpa PO |
| Tanggal & Waktu Penerimaan | Ya | 23 Sep 2026, 14.00 | Date |
| Penanggung Jawab | — | Andi, Sari | Accordion, Add Button |
| Supplier | — | PT Sumber Rejeki | Text |
| 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 |
| Satuan Ukuran | Karton | Text |
| Kuantitas Pesanan | 10 | Number |
| Kuantitas Dikirim | 10 | Number |
| Kuantitas Ditolak | 1 | Number |
| Kuantitas Diterima | 9 | Number |
7.2 Advance Filter
| Field | Kontrol | Sumber Pilihan | Default |
|---|---|---|---|
| Toko | Multi Select | Toko yang ditugaskan ke pengguna | Toko aktif |
| Rentang Tanggal Penerimaan | Date Range Picker | — | Kosong |
| Supplier | Multi Select | Master Supplier, bisa dicari | Kosong |
| Status | Multi Select | Enum status | Kosong |
7.3 Form & Details
Buat — Wizard tiga langkah: Umum, Produk, lalu Tinjauan. 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. Hanya tersedia selama GR berstatus Draf. Aksi: Simpan, tambah/ubah/hapus produk, Pratinjau PDF.
Detail — Nomor Penerimaan, badge status, dan stepper status di bagian atas, diikuti tab Umum dan Produk yang hanya bisa dibaca. Aksi: Ubah Data, Ajukan, Batalkan, Cetak, dan Log Aktivitas, masing-masing muncul sesuai status GR. Tombol aksi status tetap tampil bagi pengguna yang bukan PIC, tetapi dalam keadaan nonaktif.
Umum
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Toko | Read-only | Toko tempat pengguna sedang bekerja | — |
| Sumber Penerimaan Barang | Toggle | — | Aktif berarti dari Pesanan Pembelian; nonaktif berarti tanpa PO. Diubah → Pesanan Pembelian dan Supplier dikosongkan |
| Pesanan Pembelian | Single Select | PO toko aktif berstatus Diajukan, Diterima Sebagian, atau Diterima | Nonaktif bila sumber bukan dari PO; dipilih → Supplier dan produk terisi otomatis |
| Alamat Penerimaan | Single Select | Alamat milik toko | — |
| Supplier | Single Select | Master Supplier yang berstatus aktif, bisa dicari | Read-only bila sumber dari PO |
| Tanggal Estimasi Diterima | Read-only | Tanggal estimasi PO, atau hari ini bila tanpa PO | Hanya tampilan, tidak disimpan |
| Tanggal & Waktu Penerimaan | Date Time Picker | — | — |
| Penanggung Jawab (PIC) | Multi Select | Karyawan toko | Hanya bisa diisi pemegang izin assign; default karyawan pengguna yang login |
| Penanggung Jawab Pengirim | Text Input | — | — |
| Nomor Polisi Kendaraan Pengirim | Text Input | — | — |
| Bukti Penerimaan | File Uploader, banyak | — | — |
| Catatan | Textarea | — | — |
Produk — Tabel
| Kolom | Contoh Nilai | Komponen |
|---|---|---|
| Produk (Kemasan) | Minyak Goreng 2L (Karton) | Thumbnail, Text |
| Satuan Ukuran | Karton | Text |
| Kuantitas Pesanan | 10 | Number |
| Kuantitas Dikirim | 10 | Number |
| Kuantitas Ditolak | 1 | Number |
| Kuantitas Diterima | 9 | Number |
| Aksi | Ubah, Hapus, Lihat | Action Menu |
Produk — Form
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Produk (Kemasan) | Single Select | Inventaris produk toko, satu opsi per kemasan, dicari dengan nama atau barcode | Mengisi Satuan Ukuran; bila produk ada di PO terpilih, mengisi Kuantitas Pesanan (read-only) |
| Satuan Ukuran | Read-only | Kemasan terpilih | — |
| Kuantitas Pesanan | Read-only | Item PO tertaut | Kosong bila tidak tertaut PO |
| Kuantitas Dikirim | Number Input | — | — |
| Kuantitas Ditolak | Number Input | — | — |
| Kuantitas Diterima | Read-only | — | Dihitung dari Kuantitas Dikirim dikurangi Kuantitas Ditolak |
7.4 PDF Format
| Bagian | Isi |
|---|---|
| Tanda Air | Status GR, hanya pada GR Draf dan GR Dibatalkan |
| Kop | - Perusahaan: Nama, Kontak, Alamat - Dokumen: Judul Goods Receipt, Nomor Penerimaan, Nomor Pemesanan, Tanggal & Waktu Penerimaan |
| Para Pihak | - Supplier: Nama, Alamat - Pengirim: Penanggung Jawab Pengirim, Nomor Polisi Kendaraan Pengirim - Diterima Di: Nama Toko, Alamat Penerimaan |
| Tabel Produk | No | Produk | Satuan Ukuran | Kuantitas Pesanan | Kuantitas Dikirim | Kuantitas Ditolak | Kuantitas Diterima |
| Ringkasan | - Keterangan: Tanggal Pemesanan, Tanggal Estimasi Diterima, Tanggal & Waktu Penerimaan - Catatan: Isi field Catatan |
| Tanda Tangan | Kolom Penanggung Jawab beserta namanya, hanya pada GR yang sudah keluar dari status Draf |
8. User Stories
US-01 - Membuat GR dari PO
Sebagai staf gudang, saya ingin membuat penerimaan barang dari PO, agar barang yang datang langsung dicocokkan dengan pesanan.
| 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), tanggal & waktu penerimaan saat ini, dan penanggung jawab berisi pengguna yang login (jika terdaftar sebagai karyawan). |
| AC-01.2 | Alamat penerimaan terisi otomatis dengan alamat pengiriman default toko; jika tidak ada, alamat pertama toko. |
| AC-01.3 | Switch Buat dari Pesanan Pembelian aktif secara default. Pilihan PO hanya berisi PO toko aktif berstatus Diajukan, Diterima Sebagian, atau Diterima (BR-04), dengan label nomor PO dan keterangan tanggal pesanan. |
| AC-01.4 | Saat PO dipilih, supplier terisi otomatis dari PO (read-only) dan tanggal estimasi diterima tampil dari PO (BR-04). |
| AC-01.5 | Saat PO dipilih dan daftar produk masih kosong, daftar produk terisi otomatis dari semua item PO: produk dan kemasan, kuantitas pesanan, kuantitas dikirim sama dengan kuantitas pesanan, dan kuantitas ditolak 0. Produk yang sudah ada tidak ditimpa (BR-08). |
| AC-01.6 | Saat switch diubah, pilihan PO dan supplier dikosongkan. |
| AC-01.7 | Saat Selanjutnya diklik dan field wajib di langkah itu kosong, pengguna tidak bisa pindah langkah dan error tampil di field terkait. |
| AC-01.8 | Saat Simpan berhasil, GR tersimpan berstatus Draf, toast sukses tampil, dan pengguna diarahkan ke daftar GR. |
| AC-01.9 | Saat penyimpanan ditolak, pesan error tampil di langkah Tinjauan dan pada field terkait. |
| AC-01.10 | Saat pengguna meninggalkan wizard dengan isian yang belum disimpan, muncul konfirmasi perubahan belum disimpan. |
| AC-01.11 | Toko aktif berstatus tidak aktif — halaman Tambah menampilkan halaman toko tidak aktif. |
| AC-01.12 | Pengguna tidak ditugaskan ke toko mana pun — halaman GR menampilkan halaman toko belum ditetapkan. |
| AC-01.13 | GR kedua untuk PO Diterima Sebagian — daftar produk terisi dengan kuantitas dikirim sebesar kuantitas pesanan penuh, bukan sisa kuantitas; staf menyesuaikan sesuai barang yang datang. Sisa kuantitas per produk bisa dilihat di modul Item Pembelian. |
US-02 - Membuat GR tanpa PO
Sebagai staf gudang, saya ingin mencatat barang yang datang tanpa PO, agar semua barang masuk tetap tercatat.
| ID | Kriteria penerimaan |
|---|---|
| AC-02.1 | Saat switch Buat dari Pesanan Pembelian dinonaktifkan, pilihan PO nonaktif dan supplier wajib dipilih dari master Supplier yang berstatus aktif (BR-05). Supplier nonaktif tampil tetapi tidak bisa dipilih. |
| AC-02.2 | Produk ditambahkan manual lewat dialog; produk tidak tertaut ke PO dan kuantitas pesanan kosong (BR-08). |
| AC-02.3 | Tanggal estimasi diterima menampilkan tanggal hari ini sebagai informasi (tidak disimpan). |
| AC-02.4 | Switch sumber penerimaan diubah saat membuat GR — PO dan supplier dikosongkan; produk yang sudah ada tidak ikut dihapus. |
US-03 - Mencatat kuantitas per produk
Sebagai staf gudang, saya ingin mencatat kuantitas dikirim dan kuantitas ditolak per produk, agar hanya barang yang layak yang dianggap diterima.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Dialog produk menyediakan pencarian berdasarkan nama atau barcode (pilihan mode pencarian). Setiap kemasan produk tampil sebagai pilihan terpisah dengan label [Satuan Ukuran] nama produk dan keterangan [SKU] Barcode: .... Produk nonaktif tampil tetapi tidak bisa dipilih. |
| AC-03.2 | Saat produk dipilih, satuan ukuran terisi dari kemasan terpilih. Jika produk tersebut ada di PO yang dipilih, produk ditautkan ke item PO dan kuantitas pesanan tampil (read-only) (BR-08). |
| AC-03.3 | Kuantitas dikirim wajib diisi, minimal 0,01, dengan default 1. Kuantitas ditolak minimal 0, dengan default 0 (BR-07). |
| AC-03.4 | Kuantitas diterima dihitung otomatis sebagai kuantitas dikirim dikurangi kuantitas ditolak, tidak pernah negatif, dan read-only (BR-07). |
| AC-03.5 | Tombol simpan pada dialog nonaktif sampai ada perubahan isian. |
| AC-03.6 | Barang diterima melebihi kuantitas pesanan — diizinkan (BR-11); item PO ditandai over-received di modul Item Pembelian. |
| AC-03.7 | Kuantitas ditolak lebih besar dari kuantitas dikirim — kuantitas diterima ditampilkan 0. Perlu dikonfirmasi: data seperti ini sebaiknya ditolak. |
| AC-03.8 | Produk yang tidak ada di PO ditambahkan ke GR dari PO — diizinkan; produk tidak tertaut ke PO dan kuantitas pesanan kosong (BR-08). |
| AC-03.9 | Produk yang sama dengan kemasan berbeda — tiap kemasan dicatat sebagai produk terpisah. Tautan ke item PO dicocokkan berdasarkan produk, sehingga kemasan lain dari produk yang sama ikut tertaut ke item PO pertama dengan produk tersebut. |
US-04 - Mengubah GR Draf
Sebagai staf gudang, saya ingin mengubah GR yang masih Draf, agar kesalahan bisa diperbaiki sebelum diajukan.
| ID | Kriteria penerimaan |
|---|---|
| AC-04.1 | Tombol Ubah Data hanya tampil pada GR Draf untuk pengguna dengan izin update di toko aktif (BR-03). |
| AC-04.2 | Tab Umum disimpan sekaligus: alamat penerimaan, sumber penerimaan dan PO, tanggal & waktu penerimaan, penanggung jawab, penanggung jawab pengirim, nomor polisi kendaraan, bukti penerimaan, dan catatan. Toko dan supplier tampil read-only (BR-06). |
| AC-04.3 | Saat switch Buat dari Pesanan Pembelian dinonaktifkan dan disimpan, tautan GR ke PO dilepas (BR-06). |
| AC-04.4 | Produk di tab Produk ditambah, diubah, dan dihapus satu per satu, dan langsung tersimpan. |
| AC-04.5 | Saat URL edit dibuka pada GR yang bukan Draf, halaman kembali ke tampilan detail read-only (BR-03). |
| AC-04.6 | Tab yang sedang dibuka tetap sama saat berpindah dari detail ke edit. |
| AC-04.7 | Tautan PO diganti saat mengubah Draf — produk yang sudah ada tidak ikut diganti. Produk baru yang ditambahkan dari tab Produk tidak otomatis ditautkan ke item PO; staf perlu memeriksa ulang daftar produk. |
| AC-04.8 | GR disimpan sebagai Draf tanpa produk — diizinkan saat simpan Draf. Perlu dikonfirmasi: Ajukan sebaiknya ditolak jika GR belum punya produk. |
US-05 - Menetapkan penanggung jawab
Sebagai kepala toko, saya ingin menetapkan PIC pada GR, agar jelas siapa yang berwenang mengajukan dan membatalkan GR.
| ID | Kriteria penerimaan |
|---|---|
| AC-05.1 | PIC bisa dipilih lebih dari satu dari daftar karyawan toko, saat membuat GR, saat mengubah Draf, atau lewat tombol tambah di kolom Penanggung Jawab pada daftar (BR-03). |
| AC-05.2 | Tombol tambah PIC di daftar hanya tampil pada GR Draf untuk pengguna dengan izin assign di toko aktif. Dialog tetapkan PIC mewajibkan minimal satu karyawan (BR-03). |
US-06 - Mengajukan GR
Sebagai PIC, saya ingin mengajukan GR, agar penerimaan barang berlaku, stok bertambah, dan status PO diperbarui.
| ID | Kriteria penerimaan |
|---|---|
| AC-06.1 | Tombol Ajukan Penerimaan tampil pada GR Draf untuk pengguna dengan izin submit, dan hanya aktif jika pengguna adalah PIC GR tersebut (BR-02). |
| AC-06.2 | Setelah konfirmasi, status menjadi Diajukan, serta tercatat siapa dan kapan mengajukan. |
| AC-06.3 | Jika GR merujuk PO, status PO diperbarui otomatis sesuai BR-10. |
| AC-06.4 | Pada GR Diajukan, tombol Ubah Data dan aksi produk tidak tampil (BR-03). |
| AC-06.5 | GR belum punya PIC — tombol Ajukan nonaktif untuk semua pengguna sampai PIC ditetapkan (BR-02). |
| AC-06.6 | Pengguna bukan PIC membuka GR — tombol Ajukan dan Batalkan tampil tetapi nonaktif (BR-02). |
US-07 - Membatalkan GR
Sebagai PIC, saya ingin membatalkan GR yang salah catat, agar penerimaan tersebut tidak dihitung.
| ID | Kriteria penerimaan |
|---|---|
| AC-07.1 | Tombol Batalkan Penerimaan tampil pada GR Diajukan untuk pengguna dengan izin cancel, dan hanya aktif jika pengguna adalah PIC (BR-02, BR-12). |
| AC-07.2 | Dialog pembatalan mewajibkan alasan; tombol konfirmasi nonaktif selama alasan kosong (BR-12). |
| AC-07.3 | Setelah dibatalkan, status menjadi Dibatalkan; alasan, siapa, dan kapan tersimpan. Stepper status menampilkan jalur Draf → Diajukan → Dibatalkan. |
| AC-07.4 | GR Diajukan dibatalkan — Perlu dikonfirmasi: penambahan stok dibalik dan status PO dihitung ulang tanpa GR ini. |
| AC-07.5 | Bill Draf yang merujuk GR dihapus — Perlu dikonfirmasi: GR kembali berstatus Diajukan agar bisa ditagihkan lagi. |
US-08 - Daftar dan pencarian GR
Sebagai owner, saya ingin melihat dan menyaring GR, agar cepat menemukan penerimaan barang tertentu.
| ID | Kriteria penerimaan |
|---|---|
| AC-08.1 | Default menampilkan GR toko aktif; filter lanjutan: toko, rentang tanggal penerimaan, supplier, dan status; pencarian dengan kata kunci. |
| AC-08.2 | Kolom: nomor penerimaan, toko, nomor pemesanan, tanggal pemesanan, tanggal & waktu penerimaan, penanggung jawab, supplier, dibuat oleh, dan status. |
| AC-08.3 | Urutan default tanggal & waktu penerimaan terbaru di atas, dengan paginasi. Kolom yang bisa diurutkan: nomor penerimaan dan tanggal & waktu penerimaan. |
| AC-08.4 | Baris bisa diperluas untuk melihat daftar produk GR tanpa membuka detail. |
| AC-08.5 | Aksi baris: Cetak, Lihat, Ubah (hanya Draf), Hapus (hanya Draf), sesuai izin (BR-03). |
US-09 - Menghapus GR Draf
Sebagai staf gudang, saya ingin menghapus Draf yang tidak jadi dipakai, agar daftar tetap bersih.
| ID | Kriteria penerimaan |
|---|---|
| AC-09.1 | Aksi Hapus hanya tersedia pada GR Draf untuk pengguna dengan izin delete di toko aktif, setelah konfirmasi (BR-03). |
| AC-09.2 | Hapus massal tersedia dari baris yang dipilih di daftar. |
US-10 - Mencetak GR
Sebagai staf gudang, saya ingin mencetak GR sebagai PDF, agar bisa ditandatangani sebagai bukti serah terima barang.
| ID | Kriteria penerimaan |
|---|---|
| AC-10.1 | Pratinjau PDF tersedia dari wizard buat GR, halaman detail/edit, dan aksi Cetak di daftar, pada status apa pun. |
| AC-10.2 | Saat mengedit Draf, pratinjau PDF memakai isian tab Umum terbaru yang belum disimpan. |
| AC-10.3 | Sebelum GR disimpan, nomor GR di PDF tampil kosong (”-”). |
| AC-10.4 | PDF GR berstatus Draf dan Dibatalkan diberi watermark status. |
| AC-10.5 | PDF memuat kolom tanda tangan penanggung jawab (PIC pertama). |
| AC-10.6 | PDF memuat catatan GR. |
US-11 - Riwayat aktivitas
Sebagai owner, saya ingin melihat log aktivitas GR, agar tahu siapa mengubah apa dan kapan.
| ID | Kriteria penerimaan |
|---|---|
| AC-11.1 | Log aktivitas tersedia per GR (di detail) dan untuk seluruh GR (di daftar) (BR-14). |
9. User Scenarios
| Role | Scenario |
|---|---|
| Staf Gudang | Truk supplier datang membawa pesanan; membuat GR dari PO, memeriksa barang, mencatat kuantitas ditolak untuk barang yang rusak, lalu mengajukan GR |
| Staf Gudang | Supplier mengirim barang yang dipesan lewat telepon tanpa PO; membuat GR tanpa PO dengan memilih supplier secara manual |
| Staf Purchasing | Supplier hanya mengirim sebagian; GR pertama diajukan sehingga PO menjadi Diterima Sebagian, GR berikutnya dibuat saat sisa barang datang, lalu tagihan dibuat dari kedua GR tersebut (lihat PRD Bill) |
| PIC | GR yang sudah diajukan ternyata salah catat kuantitas; membatalkan GR dengan alasan, lalu membuat GR baru untuk mencatat ulang |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
| Lihat List GR (Semua Toko) | purchase:goods-receipt:list:any | — |
| Lihat List GR (Toko Ditugaskan) | purchase:goods-receipt:list:store | — |
| Lihat Detail GR (Semua Toko) | purchase:goods-receipt:view:any | — |
| Lihat Detail GR (Toko Ditugaskan) | purchase:goods-receipt:view:store | — |
| Buat GR | purchase:goods-receipt:create:store | Toko aktif |
| Ubah GR (Data Umum) | purchase:goods-receipt:update:store | Toko aktif |
| Hapus GR | purchase:goods-receipt:delete:store | Toko aktif |
| Lihat Detail Produk | — | Mengikuti izin lihat detail GR |
| Tambah Produk | purchase:goods-receipt:update:storepurchase:goods-receipt:create:store | Toko aktif |
| Ubah Produk | purchase:goods-receipt:update:store | Toko aktif |
| Hapus Produk | purchase:goods-receipt:update:storepurchase:goods-receipt:delete:store | Toko aktif |
| Tetapkan PIC | purchase:goods-receipt:assign:store | Toko aktif, dari daftar GR |
| Ajukan | purchase:goods-receipt:submit:store | Toko aktif, pengguna adalah PIC |
| Batalkan | purchase:goods-receipt:cancel:store | Toko aktif, pengguna adalah PIC |
10.2 Action by Status
| Action | Draf | Diajukan | Selesai | Dibatalkan |
|---|---|---|---|---|
| Ubah GR (Data Umum) | ✓ | — | — | — |
| Hapus GR | ✓ | — | — | — |
| Lihat Detail Produk | ✓ | ✓ | ✓ | ✓ |
| Tambah Produk | ✓ | — | — | — |
| Ubah Produk | ✓ | — | — | — |
| Hapus Produk | ✓ | — | — | — |
| Tetapkan PIC | ✓ | — | — | — |
| Ajukan | ✓ | — | — | — |
| Batalkan | — | ✓ | — | — |
| Dirujuk Bill | — | ✓ | — | — |
| Pratinjau dan Cetak PDF | ✓ | ✓ | ✓ | ✓ |
| Lihat Log Aktivitas | ✓ | ✓ | ✓ | ✓ |
11. Notifications
Fitur ini tidak memicu notifikasi.
12. Dependencies
PRD terkait
- Purchase Order — PO yang dirujuk GR; status PO berubah saat GR diajukan (BR-10).
- Bill — tagihan yang dibuat dari GR Diajukan; GR menjadi Selesai saat dirujuk (BR-13).
- Purchase Return — retur barang ke supplier yang mengacu pada GR; Kuantitas Diterima menjadi batas kuantitas yang bisa diretur.
- Purchase Order Line — kuantitas dipesan, diterima, sisa, dan over-received per item PO (lihat US-01, US-03).
Master data
- Stores — toko aktif, status aktif, alamat, dan karyawan (PIC).
- Suppliers — supplier untuk GR tanpa PO, beserta status aktifnya.
- Products & Product Inventory — kemasan/satuan ukuran, barcode, dan status aktif per toko.
Efek ke modul lain
- Inventory — stok toko bertambah sebesar kuantitas diterima saat GR diajukan (BR-09).
- Purchase Order — status Diterima Sebagian / Diterima ditetapkan dari GR yang diajukan (BR-10).
- Bill — hanya GR Diajukan yang muncul sebagai pilihan di form Bill (BR-13).
- Setiap perubahan tercatat di log aktivitas (BR-14).