# 12 - Modul Pembelian dan Multi Cabang

Dokumen sintesis cluster `ev-pembelian` (1 berkas sumber utama:
`dokumentasi_workflow_pembelian.md`), diperkaya dengan referensi silang dari
`KONTEKS_ANALISA_SELECTOR_967.md` (cluster `ev-infra`) yang menyangkut return pembelian.
Detail yang tidak tersedia pada sumber ditandai "tidak dispesifikasikan di sumber".
Cluster ini berisi satu berkas, sehingga dokumen ini relatif ringkas dan dicatat sebagai
keterbatasan cakupan.

---

## 1. Ringkasan Eksekutif

- Workflow pembelian ERP Everest berpusat pada dokumen FG Purchasing dengan kode transaksi `466`.
- Alur terdiri atas empat tahap utama: PRE PURCHASE ORDER, PURCHASE ORDER, PRE GRN, dan GRN.
- Tahap PRE dan dokumen nyata berpasangan: `PRE PURCHASE ORDER -> PURCHASE ORDER` dan
  `PRE GRN -> GRN`, mencerminkan pola sistem bahwa `PRE` adalah dokumen draf/persiapan
  sebelum dokumen final yang mengikat.
- Terdapat keterkaitan dengan alur return pembelian (transaksi `967`) yang dipakai pada modul
  pembelian produk @Pusat.

---

## 2. Workflow Pembelian

Sumber: dokumentasi_workflow_pembelian.md.

### 2.1 Identitas

| Item | Nilai |
| :--- | :--- |
| Dokumen | FG Purchasing |
| Kode transaksi | `466` |
| Jumlah tahap | 4 |

### 2.2 Tahapan

| Step | Nama Tahap | Deskripsi |
| :--- | :--- | :--- |
| 1 | PRE PURCHASE ORDER | Dokumen persiapan/draf sebelum PO resmi diterbitkan |
| 2 | PURCHASE ORDER | Purchase Order resmi ke supplier |
| 3 | PRE GRN | Dokumen persiapan penerimaan barang sebelum GRN final |
| 4 | GRN | Good Receipt Note final (penerimaan barang) |

### 2.3 Pola PRE -> final

- `PRE PURCHASE ORDER` (step 1) mendahului `PURCHASE ORDER` (step 2). Artinya kebutuhan pembelian
  disiapkan dulu, lalu difinalkan menjadi PO.
- `PRE GRN` (step 3) mendahului `GRN` (step 4). Barang diterima secara fisik, disiapkan pada
  PRE GRN, lalu difinalkan pada GRN yang mengikat ke persediaan/utang.

### 2.4 Keterkaitan ke persediaan

GRN adalah titik masuk persediaan dan pemicu utang usaha ke supplier. Kode `466` selaras dengan
kode dokumen pembelian yang juga dirujuk pada dokumen lain; lihat keterkaitan return pembelian
(bagian 3).

Detail tabel, kolom, controller, dan view untuk empat tahap ini tidak dispesifikasikan lebih
rinci pada berkas sumber.

---

## 3. Return Pembelian & Keterkaitan (referensi silang)

Sumber: KONTEKS_ANALISA_SELECTOR_967.md (cluster ev-infra, ditampilkan di sini sebagai
keterkaitan modul pembelian).

### 3.1 Konteks transaksi 967

| Item | Nilai |
| :--- | :--- |
| Transaksi | `967` |
| Jenis | `467` |
| suppliers_id | `345` |
| Tabel/model | `MdlNotaItem.php` |
| View selector | `_selectorItem.php` baris 244-295 |
| Filter data | `returned = '0'` |
| Error terkait | memory `10485760000 bytes` |

### 3.2 Konteks modul

- Transaksi `967` adalah Return Pembelian Produk @Pusat, dengan jenis `467`.
- `suppliers_id = '345'` menjadi filter supplier pada selector.
- Selector `_selectorItem.php` baris 244-295 mengambil item nota yang belum diretur
  (`returned = '0'`).
- Model `MdlNotaItem.php` menyediakan data item nota.
- Error kehabisan memori (`10485760000 bytes`) mengindikasikan query menarik data terlalu besar
  (tidak terpaginasi / tidak terbatas), sehingga perlu `LIMIT`/paginasi dan penggunaan indeks.

### 3.3 Keterkaitan dengan GRN

Return pembelian terkait dengan GRN karena retur mengacu pada barang yang pernah diterima. Rencana
tool Audit Klaim Supplier (dokumen 10 bagian 6) juga merujuk GRN dan transaksi `467`, sehingga
`467`/`967` menjadi simpul penting lintas modul pembelian, settlement, dan klaim.

---

## 4. Multi Cabang dan Audit

Berdasarkan referensi silang lintas dokumen (tidak semua ada pada berkas pembelian tunggal):

- Isolasi data per cabang disediakan melalui `my_cabang_id` dan helper `my_cabang_nama()`
  (dokumen 10 bagian 4; dokumen 09 bagian 13.1 untuk `defaultValue => ".my_cabang_id"`).
- Filter selector/dropdown per cabang menggunakan `referenceFilter` berdasarkan `my_cabang_id`.
- Audit dan ketertelusuran mengikuti standar ISO 27001 (audit logging) dan ISA 500 (bukti audit);
  filter `trash = 0` dan kolom `cancel_dtime` dipakai untuk memisahkan dokumen aktif vs
  dibatalkan (dokumen 11 bagian 2.3).
- Tool Audit Klaim Supplier (`AuditKlaimSupplier.php`, view `viewKlaimSupplierIndex`)
  menautkan GRN dan transaksi `467` untuk memverifikasi klaim (dokumen 10 bagian 6).

Detail konfigurasi multi-cabang khusus modul pembelian (mis. pemisahan gudang per cabang,
nomor dokumen per cabang) TIDAK dispesifikasikan di berkas sumber tunggal cluster ini.

---

## 5. Catatan Keterbatasan Sumber

1. Cluster `ev-pembelian` hanya memuat 1 berkas (`dokumentasi_workflow_pembelian.md`); karena itu
   banyak detail teknis (controller, view, tabel, kolom, status enum) tidak tersedia dan
   ditandai "tidak dispesifikasikan di sumber".
2. Judul berkas menyiratkan cakupan "multi cabang", namun berkas sumber hanya menjelaskan empat
   tahap workflow pembelian. Bagian multi cabang pada dokumen ini disusun dari referensi silang
   lintas dokumen, bukan dari berkas pembelian itu sendiri.
3. Tidak ada informasi eksplisit mengenai kaitan `466` dengan alur Direct Shipping vs Regular
   (dokumen 09 bagian 9) meskipun keduanya menyangkut pembelian/penerimaan; keterkaitan ini
   belum terdokumentasi.
4. Tidak ada informasi mengenai integrasi PPN Masukan modul taxes (dokumen 09 bagian 11.3) ke
   proses GRN/pembelian, padahal PPN Masukan secara konsep berasal dari faktur pembelian.

---

## 6. Temuan Lintas-Dokumen & Kontradiksi

1. Kode dokumen pembelian `466` (FG Purchasing) dan return `967`/jenis `467` tidak dijelaskan
   hubungan hierarkisnya di berkas sumber; perlu pemetaan kode transaksi pembelian yang lengkap.
2. Berkas pembelian tidak menyebut modul `kompensasiharga` (3333) atau `settlement` (758),
   padahal keduanya bersinggungan dengan transaksi supplier; pemisahan dokumentasi berpotensi
   membuat alur end-to-end pembelian->klaim->settlement tidak utuh.
3. Error memori pada selector `967` (`10485760000 bytes`) menunjukkan pola serupa dengan masalah
   `viewGunggunganIndex()` tanpa `LIMIT` pada modul taxes (dokumen 09 bagian 11.3); keduanya
   menuntut perbaikan paginasi berbasis SQL.
4. Slot `suppliers_id = '345'` ditulis sebagai string pada sumber; perlu konfirmasi apakah kolom
   bertipe karakter atau numerik untuk mencegah perbedaan tipe saat join.

---

## 7. Lampiran Daftar File Sumber

| No | Berkas | Cluster | Fokus |
| --- | --- | --- | --- |
| 1 | dokumentasi_workflow_pembelian.md | ev-pembelian | Workflow 4 tahap FG Purchasing `466` |
| 2 | KONTEKS_ANALISA_SELECTOR_967.md | ev-infra (referensi silang) | Return pembelian 967/jenis 467, selector & memory leak |

Catatan: berkas kedua bukan milik cluster `ev-pembelian`; disertakan sebagai referensi silang
karena langsung menyangkut return pembelian.
