Skip to Content

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

  1. Sumber Pembuatan — Staf memilih membuat pemasok dari awal, atau dari entitas yang sudah terdaftar dan belum menjadi pemasok (BR-01, BR-02).
  2. 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.
  3. Alamat — Pemasok dilengkapi sedikitnya satu alamat. Alamat pertama otomatis menjadi alamat utama, penagihan, dan pengiriman sekaligus (BR-08).
  4. Kontak — Orang yang bisa dihubungi di pihak pemasok, boleh lebih dari satu dan boleh dilewati (BR-09).
  5. Tinjauan — Seluruh isian ditinjau ulang sebelum disimpan.
  6. Validasi — Isian diperiksa sebelum pemasok tersimpan. Pemasok yang melanggar aturan tidak bisa disimpan, dan kesalahannya ditunjukkan pada langkah yang bersangkutan.
  7. 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.
  8. Dipakai di Dokumen Pembelian — Pemasok beserta kontak dan alamatnya dirujuk oleh Purchase Order, Goods Receipt, dan Bill.

5.2 Status Lifecycle

StatusKeteranganSelanjutnya
Aktif
is_active: true
Pemasok bisa dipilih pada dokumen pembelian baruTidak Aktif, atau dihapus
Tidak Aktif
is_active: false
Pemasok tampil tetapi tidak bisa dipilih pada penerimaan barang tanpa POAktif, 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

FieldTipeWajibDefaultAturan
KodeTeks—Dibuat saat disimpanDitetapkan sistem, tidak bisa diubah (BR-03)
EntitasRef. Entitas—Entitas baru, atau entitas terpilih saat dibuat dari entitasDitetapkan saat pembuatan, satu entitas satu pemasok (BR-01, BR-02)
StatusEnumYaBelum dipilihAktif atau Tidak Aktif
Nama PemasokTeksYaNama entitas, bila dibuat dari entitas(BR-05)
KategoriEnumYa—Perorangan, Perusahaan, atau Organisasi (BR-04)
Jenis KelaminEnumYa, bila kategori Perorangan—Laki-laki atau Perempuan (BR-04)
EmailTeksYa—Harus berformat email yang valid (BR-05)
Nomor TeleponTeksYa—(BR-05)

6.2 Address

FieldTipeWajibDefaultAturan
NamaTeksYa—Label alamat, maksimal 50 karakter
Nomor TeleponTeksYa—Maksimal 15 karakter
Alamat LengkapTeksYa—Maksimal 255 karakter
Alamat UtamaBoolean—Melekat pada alamat pertamaDitetapkan sistem; tepat satu per pemasok (BR-07, BR-08)
Alamat PenagihanBoolean—Melekat pada alamat pertamaDitetapkan sistem; tepat satu per pemasok (BR-07, BR-08)
Alamat PengirimanBoolean—Melekat pada alamat pertamaDitetapkan sistem; tepat satu per pemasok (BR-07, BR-08)

6.3 Contact

FieldTipeWajibDefaultAturan
NamaTeksYa—(BR-09)
Nomor TeleponTeksYa—(BR-09)
EmailTeksTidak—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

KolomSortableContoh NilaiKomponen
Pilih——Checkbox
No—1Number
KodeYaSUP-0007Text
Nama PemasokYaPT Sumber RejekiText
Kategori—PerusahaanText
Sebagai Pengguna—YaBadge
Sebagai Karyawan—TidakBadge
Status—AktifBadge
Aksi—Lihat · Ubah · HapusAction Menu

7.2 Advance Filter

FieldKontrolSumber PilihanDefault
StatusSingle SelectAktif, Tidak AktifKosong
KategoriSingle SelectPerorangan, Perusahaan, OrganisasiKosong
Jenis KelaminSingle SelectLaki-laki, PerempuanKosong

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

FieldKontrolSumber PilihanPerilaku
StatusSingle SelectAktif atau Tidak AktifPilihan yang sedang terpilih bisa dibatalkan, dan status menjadi kosong
Nama PemasokText Input—Terisi dari entitas bila dibuat dari entitas
KategoriSingle SelectPerorangan, Perusahaan, OrganisasiDiganti ke selain Perorangan → Jenis Kelamin tidak berlaku
Jenis KelaminSingle SelectLaki-laki, PerempuanHanya tampil dan wajib saat kategori Perorangan
EmailText Input——
Nomor TeleponText Input——

Alamat

FieldKontrolSumber PilihanPerilaku
NamaText Input——
Nomor TeleponText Input——
Alamat LengkapTextarea——
Peran AlamatAction Menu (“Jadikan sebagai”)Utama, Penagihan, PengirimanHanya menampilkan peran yang belum dimiliki alamat itu; menetapkan peran mencabutnya dari alamat lain

Kontak

FieldKontrolSumber PilihanPerilaku
NamaText Input——
Nomor TeleponText Input——
EmailText 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.

IDKriteria penerimaan
AC-01.1Saat pengguna dengan izin create membuka Tambah Baru, dialog sumber pembuatan tampil dengan pilihan Buat dari Awal dan Buat dari Entitas.
AC-01.2Wizard terdiri dari Umum → Alamat → Kontak → Tinjauan; pengguna tidak bisa lanjut bila field wajib di langkah itu belum valid.
AC-01.3Status, nama, kategori, email, dan nomor telepon wajib diisi; email harus berformat valid (BR-05).
AC-01.4Jenis kelamin hanya wajib saat kategori Perorangan (BR-04).
AC-01.5Minimal satu alamat wajib ditambahkan sebelum lanjut dari langkah Alamat (BR-06).
AC-01.6Alamat pertama otomatis bertanda Utama, Penagihan, dan Pengiriman (BR-08).
AC-01.7Langkah Kontak boleh dilewati tanpa menambahkan kontak (BR-09).
AC-01.8Saat Simpan berhasil, kode pemasok terbit, toast sukses tampil, dan pengguna diarahkan ke daftar pemasok (BR-03).
AC-01.9Saat penyimpanan ditolak, pesan error tampil di langkah Tinjauan dan pada field terkait.
AC-01.10Saat 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.

IDKriteria penerimaan
AC-02.1Dialog Buat dari Entitas menampilkan daftar entitas yang belum menjadi pemasok, dengan pencarian, pengurutan, dan paginasi (BR-02).
AC-02.2Setelah entitas dipilih, langkah Umum terisi data entitas tersebut dan masih bisa disesuaikan.
AC-02.3Pemasok 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.

IDKriteria penerimaan
AC-03.1Alamat terdiri dari nama (maks 50), nomor telepon (maks 15), dan alamat lengkap (maks 255); semuanya wajib.
AC-03.2Menu “Jadikan sebagai” hanya menampilkan peran yang belum dimiliki alamat tersebut (BR-07).
AC-03.3Menetapkan peran ke satu alamat mencabut peran yang sama dari alamat lain (BR-07).
AC-03.4Di mode ubah, setiap aksi alamat langsung tersimpan dan hasilnya tampil tanpa memuat ulang halaman.
AC-03.5Setiap alamat menampilkan badge perannya (Utama / Penagihan / Pengiriman).
AC-03.6Menghapus 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.

IDKriteria penerimaan
AC-04.1Kontak terdiri dari nama dan nomor telepon yang wajib, serta email yang opsional dan divalidasi hanya bila diisi (BR-09).
AC-04.2Kontak bisa ditambah, diubah, dan dihapus per baris di mode ubah, masing-masing langsung tersimpan.
AC-04.3Kontak 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.

IDKriteria penerimaan
AC-05.1Tombol Ubah Data hanya tampil untuk pengguna dengan izin update.
AC-05.2Validasi tab Umum sama dengan langkah Umum saat pembuatan (AC-01.3, AC-01.4).
AC-05.3Tab yang sedang dibuka dipertahankan di URL saat berpindah antara detail dan ubah.
AC-05.4Kode 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.

IDKriteria penerimaan
AC-06.1Kolom: kode, nama pemasok, kategori, penanda sebagai pengguna, penanda sebagai karyawan, dan status.
AC-06.2Pencarian kata kunci, filter status, kategori, dan jenis kelamin, paginasi, serta urutan default nama A–Z.
AC-06.3Kolom yang bisa diurutkan: kode dan nama pemasok.
AC-06.4Aksi baris: Lihat, Ubah, Hapus sesuai izin.

US-07 - Menghapus pemasok

Sebagai staf purchasing, saya ingin menghapus pemasok yang salah dibuat, agar daftar tetap bersih.

IDKriteria penerimaan
AC-07.1Hapus satuan dan hapus massal memerlukan konfirmasi dan izin delete.
AC-07.2Bila penghapusan ditolak, pesan error tampil sebagai toast.
AC-07.3Menghapus 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.

IDKriteria penerimaan
AC-08.1Log aktivitas tersedia untuk seluruh pemasok (di daftar) dan per pemasok (di detail) (BR-11).

9. User Scenarios

RoleScenario
Staf PurchasingMendaftarkan distributor baru beserta alamat gudang dan dua kontak sales, lalu langsung membuat pesanan pembelian pertama ke pemasok tersebut
Staf PurchasingMengangkat entitas yang selama ini terdaftar sebagai karyawan menjadi pemasok, karena yang bersangkutan juga memasok barang ke toko
AdminMemperbarui alamat penagihan pemasok setelah kantornya pindah, lalu memastikan tagihan berikutnya memakai alamat baru
OwnerMenonaktifkan pemasok yang sudah tidak dipakai agar tidak terpilih di penerimaan barang baru, tanpa menghapus riwayat pembeliannya

10. Permissions & Actions

10.1 Permission by Action

ActionPermissionKondisi
Lihat List Pemasokpurchase:supplier:list:any—
Lihat Log Aktivitaspurchase:supplier:list:any—
Lihat Detail Pemasokpurchase:supplier:view:any—
Buat Pemasokpurchase:supplier:create:any—
Ubah Pemasok
(Data Umum)
purchase:supplier:update:any—
Hapus Pemasokpurchase:supplier:delete:any—
Tambah Alamatpurchase:supplier:create:anyDari halaman ubah pemasok
Ubah Alamatpurchase:supplier:update:anyDari halaman ubah pemasok
Hapus Alamatpurchase:supplier:delete:anyDari halaman ubah pemasok
Tetapkan Peran Alamatpurchase:supplier:update:anyDari halaman ubah pemasok
Tambah Kontakpurchase:supplier:create:anyDari halaman ubah pemasok
Ubah Kontakpurchase:supplier:update:anyDari halaman ubah pemasok
Hapus Kontakpurchase:supplier:delete:anyDari halaman ubah pemasok

10.2 Action by Status

ActionAktifTidak 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).
Terakhir diperbarui