Pemasok
- Code: PUR-SUP
- Module: Purchasing
- Type: Master Data
1. Overview
Pemasok adalah pihak yang memasok barang ke toko, beserta alamat dan kontak orang yang bisa dihubungi saat bertransaksi. Setiap pemasok melekat pada satu entitas — data induk orang atau badan usaha yang dipakai bersama di seluruh sistem — sehingga satu entitas yang sudah terdaftar sebagai karyawan atau pengguna bisa sekaligus dijadikan pemasok tanpa mengetik ulang datanya. Pemasok menjadi lawan transaksi pada Purchase Order, Goods Receipt, dan Bill.
Hasil yang diharapkan: setiap pembelian punya lawan transaksi yang jelas beserta alamat dan kontaknya, sehingga dokumen pesanan, penerimaan, dan tagihan terisi otomatis dengan data yang benar.
2. Problem
Tanpa data pemasok yang terpusat, kontak dan alamat supplier hanya tersimpan di catatan pribadi staf dan disalin ulang setiap kali membuat dokumen. Akibatnya:
- Nomor kontak dan alamat berbeda-beda antar dokumen, sehingga konfirmasi kiriman dan tagihan sering tersendat.
- Satu supplier tercatat berkali-kali dengan penulisan berbeda, sehingga riwayat pembelian ke supplier itu tidak bisa dijumlahkan.
- Supplier yang sudah tidak dipakai tetap muncul saat membuat dokumen baru dan berisiko terpilih.
- Data orang yang sudah terdaftar sebagai karyawan atau pengguna diketik ulang saat menjadi pemasok, sehingga mudah berbeda satu sama lain.
3. Goals & Non-goals
3.1 Goals
- Setiap supplier punya satu catatan induk yang dipakai seluruh dokumen pembelian.
- Alamat dan kontak supplier tersedia langsung saat dokumen dibuat, tanpa diketik ulang.
- Entitas yang sudah ada di sistem bisa diangkat menjadi pemasok tanpa penulisan ulang data.
- Supplier yang tidak dipakai lagi bisa dikunci dari transaksi baru tanpa menghapus riwayatnya.
3.2 Non-goals
- Penilaian dan peringkat supplier, misalnya ketepatan kirim atau kualitas barang.
- Termin pembayaran dan plafon kredit khusus per supplier; termin ditetapkan per dokumen pembelian.
- Katalog harga supplier; harga ditetapkan saat menyusun pesanan.
- Portal supplier dan pengiriman dokumen langsung dari sistem.
- Data pajak dan rekening bank supplier.
4. Business Rules
Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk Pemasok 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 pemasok melekat pada tepat satu entitas. Pemasok dibuat dari awal, yang sekaligus membentuk entitas baru, atau dari entitas yang sudah ada dan belum menjadi pemasok.
- BR-02 Satu entitas hanya boleh menjadi satu pemasok; entitas yang sudah menjadi pemasok tidak muncul lagi sebagai pilihan saat membuat pemasok dari entitas.
- BR-03 Kode pemasok ditetapkan sistem saat pemasok disimpan dan tidak bisa diubah.
- BR-04 Kategori entitas dipilih dari Perorangan, Perusahaan, atau Organisasi. Jenis kelamin hanya berlaku dan wajib diisi bila kategorinya Perorangan.
- BR-05 Nama, email, dan nomor telepon pemasok wajib diisi, dan email harus berformat alamat email yang valid.
- BR-06 Setiap pemasok wajib memiliki sedikitnya satu alamat sejak dibuat.
- BR-07 Peran alamat utama, penagihan, dan pengiriman masing-masing dipegang tepat satu alamat per pemasok. Menetapkan peran itu ke alamat lain otomatis memindahkannya dari alamat sebelumnya.
- BR-08 Alamat pertama yang dibuat otomatis memegang ketiga peran sekaligus.
- BR-09 Kontak boleh lebih dari satu dan boleh kosong. Nama dan nomor telepon kontak wajib diisi, sedangkan email opsional tetapi harus valid bila diisi.
- BR-10 Pemasok yang tidak aktif tetap tampil pada pencarian pemasok, tetapi tidak bisa dipilih saat membuat Goods Receipt tanpa PO. Data transaksi lamanya tetap bisa dilihat. Perlu dikonfirmasi: apakah pembatasan yang sama berlaku saat memilih pemasok pada Purchase Order.
- BR-11 Setiap perubahan data pemasok, alamat, dan kontaknya tercatat beserta pelaku dan waktunya.
5. Flow
5.1 Main Flowchart
- Sumber Pembuatan — Staf memilih membuat pemasok dari awal, atau dari entitas yang sudah terdaftar dan belum menjadi pemasok (BR-01, BR-02).
- Data Umum — Status, nama, kategori entitas, jenis kelamin bila perorangan, email, dan nomor telepon. Bila dibuat dari entitas, isian ini terisi dari data entitas tersebut.
- Alamat — Pemasok dilengkapi sedikitnya satu alamat. Alamat pertama otomatis menjadi alamat utama, penagihan, dan pengiriman sekaligus (BR-08).
- Kontak — Orang yang bisa dihubungi di pihak pemasok, boleh lebih dari satu dan boleh dilewati (BR-09).
- Tinjauan — Seluruh isian ditinjau ulang sebelum disimpan.
- Validasi — Isian diperiksa sebelum pemasok tersimpan. Pemasok yang melanggar aturan tidak bisa disimpan, dan kesalahannya ditunjukkan pada langkah yang bersangkutan.
- Pemasok Tersimpan — Kode pemasok terbit dan pemasok bisa dipakai pada dokumen pembelian sesuai statusnya.
- 7a. Ubah Data Umum — Status, nama, kategori, jenis kelamin, email, dan nomor telepon diperbarui sekaligus.
- 7b. Tambah/Ubah/Hapus Alamat & Kontak — Alamat dan kontak dikelola per baris dan tersimpan seketika, termasuk memindahkan peran alamat.
- Dipakai di Dokumen Pembelian — Pemasok beserta kontak dan alamatnya dirujuk oleh Purchase Order, Goods Receipt, dan Bill.
5.2 Status Lifecycle
| Status | Keterangan | Selanjutnya |
|---|---|---|
Aktifis_active: true | Pemasok bisa dipilih pada dokumen pembelian baru | Tidak Aktif, atau dihapus |
Tidak Aktifis_active: false | Pemasok tampil tetapi tidak bisa dipilih pada penerimaan barang tanpa PO | Aktif, atau dihapus |
6. Document Structure
Bagian ini mendefinisikan isi data Pemasok itu sendiri: field apa saja yang dimilikinya, tipenya, mana yang wajib, nilai awalnya, dan aturan nilainya. Ketentuan di sini berlaku di mana pun pemasok dibuat atau diubah dan ditegakkan saat penyimpanan, terlepas dari bagaimana field itu ditampilkan.
6.1 General
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Kode | Teks | — | Dibuat saat disimpan | Ditetapkan sistem, tidak bisa diubah (BR-03) |
| Entitas | Ref. Entitas | — | Entitas baru, atau entitas terpilih saat dibuat dari entitas | Ditetapkan saat pembuatan, satu entitas satu pemasok (BR-01, BR-02) |
| Status | Enum | Ya | Belum dipilih | Aktif atau Tidak Aktif |
| Nama Pemasok | Teks | Ya | Nama entitas, bila dibuat dari entitas | (BR-05) |
| Kategori | Enum | Ya | — | Perorangan, Perusahaan, atau Organisasi (BR-04) |
| Jenis Kelamin | Enum | Ya, bila kategori Perorangan | — | Laki-laki atau Perempuan (BR-04) |
| Teks | Ya | — | Harus berformat email yang valid (BR-05) | |
| Nomor Telepon | Teks | Ya | — | (BR-05) |
6.2 Address
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Nama | Teks | Ya | — | Label alamat, maksimal 50 karakter |
| Nomor Telepon | Teks | Ya | — | Maksimal 15 karakter |
| Alamat Lengkap | Teks | Ya | — | Maksimal 255 karakter |
| Alamat Utama | Boolean | — | Melekat pada alamat pertama | Ditetapkan sistem; tepat satu per pemasok (BR-07, BR-08) |
| Alamat Penagihan | Boolean | — | Melekat pada alamat pertama | Ditetapkan sistem; tepat satu per pemasok (BR-07, BR-08) |
| Alamat Pengiriman | Boolean | — | Melekat pada alamat pertama | Ditetapkan sistem; tepat satu per pemasok (BR-07, BR-08) |
6.3 Contact
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Nama | Teks | Ya | — | (BR-09) |
| Nomor Telepon | Teks | Ya | — | (BR-09) |
| Teks | Tidak | — | Harus berformat email yang valid bila diisi (BR-09) |
7. UI Structure
Bagian ini mendefinisikan cara Pemasok ditampilkan dan dioperasikan: kolom pada daftar, filter, dan kontrol form beserta sumber pilihannya. Log Aktivitas tersedia sebagai drawer dari halaman daftar (seluruh pemasok) dan dari halaman detail (per pemasok). 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 |
| No | — | 1 | Number |
| Kode | Ya | SUP-0007 | Text |
| Nama Pemasok | Ya | PT Sumber Rejeki | Text |
| Kategori | — | Perusahaan | Text |
| Sebagai Pengguna | — | Ya | Badge |
| Sebagai Karyawan | — | Tidak | Badge |
| Status | — | Aktif | Badge |
| Aksi | — | Lihat · Ubah · Hapus | Action Menu |
7.2 Advance Filter
| Field | Kontrol | Sumber Pilihan | Default |
|---|---|---|---|
| Status | Single Select | Aktif, Tidak Aktif | Kosong |
| Kategori | Single Select | Perorangan, Perusahaan, Organisasi | Kosong |
| Jenis Kelamin | Single Select | Laki-laki, Perempuan | Kosong |
7.3 Form & Details
Buat — Diawali dialog pemilihan sumber: Buat dari Awal atau Buat dari Entitas. Pada pilihan kedua, dialog menampilkan daftar entitas yang belum menjadi pemasok, bisa dicari dan diurutkan, lalu entitas terpilih mengisi data umum. Setelah itu wizard empat langkah: Umum, Alamat, Kontak, lalu Tinjauan. Tombol Selanjutnya memvalidasi langkah yang sedang aktif sebelum berpindah. Aksi: Sebelumnya, Selanjutnya, Simpan.
Ubah — Tiga tab, Umum, Alamat, dan Kontak. Tab Umum disimpan sekaligus; alamat dan kontak dikelola per baris (tambah, ubah, hapus, tetapkan peran alamat), masing-masing tersimpan seketika.
Detail — Tiga tab, Umum, Alamat, dan Kontak, yang hanya bisa dibaca. Aksi: Ubah Data dan Log Aktivitas.
Umum
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Status | Single Select | Aktif atau Tidak Aktif | Pilihan yang sedang terpilih bisa dibatalkan, dan status menjadi kosong |
| Nama Pemasok | Text Input | — | Terisi dari entitas bila dibuat dari entitas |
| Kategori | Single Select | Perorangan, Perusahaan, Organisasi | Diganti ke selain Perorangan → Jenis Kelamin tidak berlaku |
| Jenis Kelamin | Single Select | Laki-laki, Perempuan | Hanya tampil dan wajib saat kategori Perorangan |
| Text Input | — | — | |
| Nomor Telepon | Text Input | — | — |
Alamat
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Nama | Text Input | — | — |
| Nomor Telepon | Text Input | — | — |
| Alamat Lengkap | Textarea | — | — |
| Peran Alamat | Action Menu (“Jadikan sebagai”) | Utama, Penagihan, Pengiriman | Hanya menampilkan peran yang belum dimiliki alamat itu; menetapkan peran mencabutnya dari alamat lain |
Kontak
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Nama | Text Input | — | — |
| Nomor Telepon | Text Input | — | — |
| Text Input | — | Opsional; divalidasi hanya bila diisi |
8. User Stories
US-01 - Membuat pemasok dari awal
Sebagai staf purchasing, saya ingin mendaftarkan pemasok baru beserta alamat dan kontaknya, agar bisa langsung dipakai membuat pesanan pembelian.
| ID | Kriteria penerimaan |
|---|---|
| AC-01.1 | Saat pengguna dengan izin create membuka Tambah Baru, dialog sumber pembuatan tampil dengan pilihan Buat dari Awal dan Buat dari Entitas. |
| AC-01.2 | Wizard terdiri dari Umum → Alamat → Kontak → Tinjauan; pengguna tidak bisa lanjut bila field wajib di langkah itu belum valid. |
| AC-01.3 | Status, nama, kategori, email, dan nomor telepon wajib diisi; email harus berformat valid (BR-05). |
| AC-01.4 | Jenis kelamin hanya wajib saat kategori Perorangan (BR-04). |
| AC-01.5 | Minimal satu alamat wajib ditambahkan sebelum lanjut dari langkah Alamat (BR-06). |
| AC-01.6 | Alamat pertama otomatis bertanda Utama, Penagihan, dan Pengiriman (BR-08). |
| AC-01.7 | Langkah Kontak boleh dilewati tanpa menambahkan kontak (BR-09). |
| AC-01.8 | Saat Simpan berhasil, kode pemasok terbit, toast sukses tampil, dan pengguna diarahkan ke daftar pemasok (BR-03). |
| 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. |
US-02 - Membuat pemasok dari entitas
Sebagai staf purchasing, saya ingin mengangkat entitas yang sudah terdaftar menjadi pemasok, agar datanya tidak perlu diketik ulang.
| ID | Kriteria penerimaan |
|---|---|
| AC-02.1 | Dialog Buat dari Entitas menampilkan daftar entitas yang belum menjadi pemasok, dengan pencarian, pengurutan, dan paginasi (BR-02). |
| AC-02.2 | Setelah entitas dipilih, langkah Umum terisi data entitas tersebut dan masih bisa disesuaikan. |
| AC-02.3 | Pemasok yang tersimpan tetap melekat pada entitas yang dipilih, bukan entitas baru (BR-01). |
US-03 - Mengelola alamat pemasok
Sebagai staf purchasing, saya ingin menambah, mengubah, menghapus, dan menetapkan peran alamat pemasok, agar dokumen memakai alamat yang benar.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Alamat terdiri dari nama (maks 50), nomor telepon (maks 15), dan alamat lengkap (maks 255); semuanya wajib. |
| AC-03.2 | Menu “Jadikan sebagai” hanya menampilkan peran yang belum dimiliki alamat tersebut (BR-07). |
| AC-03.3 | Menetapkan peran ke satu alamat mencabut peran yang sama dari alamat lain (BR-07). |
| AC-03.4 | Di mode ubah, setiap aksi alamat langsung tersimpan dan hasilnya tampil tanpa memuat ulang halaman. |
| AC-03.5 | Setiap alamat menampilkan badge perannya (Utama / Penagihan / Pengiriman). |
| AC-03.6 | Menghapus alamat terakhir pemasok — tidak dicegah di layar. Perlu dikonfirmasi: harus ditolak saat disimpan agar BR-06 terjaga. |
US-04 - Mengelola kontak pemasok
Sebagai staf purchasing, saya ingin mencatat orang yang bisa dihubungi di pihak pemasok, agar pesanan bisa dikonfirmasi ke orang yang tepat.
| ID | Kriteria penerimaan |
|---|---|
| AC-04.1 | Kontak terdiri dari nama dan nomor telepon yang wajib, serta email yang opsional dan divalidasi hanya bila diisi (BR-09). |
| AC-04.2 | Kontak bisa ditambah, diubah, dan dihapus per baris di mode ubah, masing-masing langsung tersimpan. |
| AC-04.3 | Kontak pemasok menjadi pilihan field Kontak pada Purchase Order. |
US-05 - Mengubah data pemasok
Sebagai staf purchasing, saya ingin mengubah data umum pemasok, agar informasinya tetap akurat.
| ID | Kriteria penerimaan |
|---|---|
| AC-05.1 | Tombol Ubah Data hanya tampil untuk pengguna dengan izin update. |
| AC-05.2 | Validasi tab Umum sama dengan langkah Umum saat pembuatan (AC-01.3, AC-01.4). |
| AC-05.3 | Tab yang sedang dibuka dipertahankan di URL saat berpindah antara detail dan ubah. |
| AC-05.4 | Kode pemasok dan keterkaitannya dengan entitas tidak bisa diubah (BR-01, BR-03). |
US-06 - Daftar dan pencarian pemasok
Sebagai owner, saya ingin melihat dan menyaring pemasok, agar cepat menemukan supplier tertentu.
| ID | Kriteria penerimaan |
|---|---|
| AC-06.1 | Kolom: kode, nama pemasok, kategori, penanda sebagai pengguna, penanda sebagai karyawan, dan status. |
| AC-06.2 | Pencarian kata kunci, filter status, kategori, dan jenis kelamin, paginasi, serta urutan default nama A–Z. |
| AC-06.3 | Kolom yang bisa diurutkan: kode dan nama pemasok. |
| AC-06.4 | Aksi baris: Lihat, Ubah, Hapus sesuai izin. |
US-07 - Menghapus pemasok
Sebagai staf purchasing, saya ingin menghapus pemasok yang salah dibuat, agar daftar tetap bersih.
| ID | Kriteria penerimaan |
|---|---|
| AC-07.1 | Hapus satuan dan hapus massal memerlukan konfirmasi dan izin delete. |
| AC-07.2 | Bila penghapusan ditolak, pesan error tampil sebagai toast. |
| AC-07.3 | Menghapus pemasok yang sudah dipakai di dokumen pembelian — Perlu dikonfirmasi: apakah ditolak, atau pemasok cukup dinonaktifkan (BR-10). |
US-08 - Riwayat aktivitas
Sebagai owner, saya ingin melihat log aktivitas pemasok, agar perubahan data, alamat, dan kontak bisa ditelusuri.
| ID | Kriteria penerimaan |
|---|---|
| AC-08.1 | Log aktivitas tersedia untuk seluruh pemasok (di daftar) dan per pemasok (di detail) (BR-11). |
9. User Scenarios
| Role | Scenario |
|---|---|
| Staf Purchasing | Mendaftarkan distributor baru beserta alamat gudang dan dua kontak sales, lalu langsung membuat pesanan pembelian pertama ke pemasok tersebut |
| Staf Purchasing | Mengangkat entitas yang selama ini terdaftar sebagai karyawan menjadi pemasok, karena yang bersangkutan juga memasok barang ke toko |
| Admin | Memperbarui alamat penagihan pemasok setelah kantornya pindah, lalu memastikan tagihan berikutnya memakai alamat baru |
| Owner | Menonaktifkan pemasok yang sudah tidak dipakai agar tidak terpilih di penerimaan barang baru, tanpa menghapus riwayat pembeliannya |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
| Lihat List Pemasok | purchase:supplier:list:any | — |
| Lihat Log Aktivitas | purchase:supplier:list:any | — |
| Lihat Detail Pemasok | purchase:supplier:view:any | — |
| Buat Pemasok | purchase:supplier:create:any | — |
| Ubah Pemasok (Data Umum) | purchase:supplier:update:any | — |
| Hapus Pemasok | purchase:supplier:delete:any | — |
| Tambah Alamat | purchase:supplier:create:any | Dari halaman ubah pemasok |
| Ubah Alamat | purchase:supplier:update:any | Dari halaman ubah pemasok |
| Hapus Alamat | purchase:supplier:delete:any | Dari halaman ubah pemasok |
| Tetapkan Peran Alamat | purchase:supplier:update:any | Dari halaman ubah pemasok |
| Tambah Kontak | purchase:supplier:create:any | Dari halaman ubah pemasok |
| Ubah Kontak | purchase:supplier:update:any | Dari halaman ubah pemasok |
| Hapus Kontak | purchase:supplier:delete:any | Dari halaman ubah pemasok |
10.2 Action by Status
| Action | Aktif | Tidak Aktif |
|---|---|---|
| Lihat Detail Pemasok | ✓ | ✓ |
| Ubah Pemasok (Data Umum) | ✓ | ✓ |
| Kelola Alamat & Kontak | ✓ | ✓ |
| Hapus Pemasok | ✓ | ✓ |
| Dipilih pada Purchase Order | ✓ | ✓ |
| Dipilih pada Goods Receipt tanpa PO | ✓ | — |
11. Notifications
Fitur ini tidak memicu notifikasi.
12. Dependencies
PRD terkait
- Purchase Order — memilih pemasok beserta kontaknya sebagai lawan transaksi.
- Goods Receipt — memilih pemasok aktif saat penerimaan tanpa PO (BR-10).
- Bill — tagihan yang ditujukan ke pemasok.
- Entities — entitas induk tiap pemasok (BR-01, BR-02).
Efek ke modul lain
- Nama dan alamat pemasok tampil pada dokumen PDF Purchase Order dan Goods Receipt.
- Status tidak aktif mengunci pemilihan pemasok pada penerimaan barang tanpa PO (BR-10).
- Setiap perubahan tercatat di log aktivitas (BR-11).