# 10 - Settlement, Klaim Supplier, dan Kasir

Dokumen sintesis cluster `ev-settlement` (5 berkas sumber) ditambah dua berkas overlap dari
cluster `ev-infra` (`implementation_plan_termin.md` dan `DRAFT_SESI_PENERIMAAN_KASIR_360.md`)
karena isinya menjadi bagian dari tema settlement/kasir. Cakupan: UAT Settlement 758, UAT Petty
Cash 1671, checkpoint sesi settlement, fitur checkbox klaim supplier, rencana tool audit klaim,
implementasi termin, dan sesi penerimaan kasir 360. Detail yang tidak tersedia pada sumber
ditandai "tidak dispesifikasikan di sumber".

---

## 1. Ringkasan Eksekutif

- Dua modul finansial diuji secara terstruktur melalui UAT: `settlement` (kode 758) dan
  `pettycast` (kode 1671). Keduanya memakai pola nomor dokumen induk -> dokumen revisi
  (`758r`, `1671r`) dan relasi silang dengan dokumen operasional.
- Terdapat satu checkpoint sesi tanggal 11 September 2026 terkait `bankReconItemsBySlug`,
  `is_bank_checked`, dan helper `my_cabang_nama()`.
- Fitur checkbox klaim supplier menambahkan mekanisme seleksi multi-item pada transaksi 3333
  (`kompensasiharga`) dengan antrean sesi `$_SESSION['klaim_queue']`.
- Rencana tool Audit Klaim Supplier menyiapkan controller `AuditKlaimSupplier.php` dengan view
  `viewKlaimSupplierIndex` dan keterkaitan GRN/transaksi 467.
- Implementasi termin (modul `penerimaanprojek`) memperbaiki bug pembulatan Rp 1 dan indikator
  status WO, sekaligus menegakkan norma PPN 12% UU HPP.

---

## 2. UAT Settlement 758

Sumber: CHECKLIST_UAT_SETTLEMENT_758.md.

### 2.1 Identitas pengujian

| Item | Nilai |
| :--- | :--- |
| Nama UAT | `UAT-EVEREST-SETTLEMENT-758` |
| Modul | `settlement` |
| Kode transaksi inti | `758` |
| Kode revisi | `758r` |
| Alur terkait | `759`, `756`, `582` |
| Peran penguji | `o_finance`, `c_holding`, `c_finance` |

### 2.2 Alur terkait

- `759`: dokumen/alur yang menjadi bagian dari siklus settlement (dirujuk checklist).
- `756`: alur pasangan sebelum/setelah settlement.
- `582`: modul penjualan (referensi silang ke alur penjualan FG, lihat dokumen 09 bagian 10.3).

### 2.3 Peran dan otorisasi

- `o_finance`: operator finance cabang, pelaksana settlement.
- `c_holding`: otorisator level holding.
- `c_finance`: otorisator level finance pusat/central.

Catatan: kombinasi `o_finance` -> `c_holding`/`c_finance` mencerminkan pemisahan tugas
(segregation of duties) antara pembuat dan penyetuju.

---

## 3. UAT Petty Cash 1671

Sumber: CHECKLIST_UAT_PETTYCASH_1671.md.

### 3.1 Identitas pengujian

| Item | Nilai |
| :--- | :--- |
| Nama UAT | `UAT-EVEREST-PETTYCAST-1671` |
| Modul | `pettycast` |
| Kode transaksi inti | `1671` |
| Kode revisi | `1671r` |
| Alur/dokumen terkait | `1672`, `1671re`, `1671rrj` |
| Model terkait | `MdlPettycashAccount` |

### 3.2 Dokumen terkait

- `1672`: dokumen pasangan pengisian/penggunaan petty cash.
- `1671re`: varian dokumen terkait (pengisian kembali/reimburse, mengacu pola `re` = reimbursement).
- `1671rrj`: varian dokumen terkait (mengacu pola `rrj` = reimburse/reject pada konvensi modul).

Catatan: sumber tidak menguraikan secara eksplisit arti sufiks `re` dan `rrj`; label di atas
merupakan pembacaan konvensi kode yang tidak dispesifikasikan lebih lanjut.

### 3.3 Model `MdlPettycashAccount`

Model ini menangani akun petty cash; dipakai oleh modul `pettycast` (ejaan sesuai nama modul
pada sumber, bukan "pettycash"). Verifikasi nama tabel/kolom detail tidak dispesifikasikan di
sumber.

---

## 4. Checkpoint Sesi Settlement (11 September 2026)

Sumber: CHECKPOINT_SESSION_SETTLEMENT.md.

### 4.1 Konteks

Checkpoint mencatat status pekerjaan sesi pada tanggal 11 September 2026 terkait modul/alur
`759` dan komponen rekonsiliasi bank.

### 4.2 Komponen teknis yang disebut

- `759`: alur/dokumen settlement yang dibahas pada sesi.
- `bankReconItemsBySlug`: fungsi/method terkait pengambilan item rekonsiliasi bank berdasarkan
  slug. Fungsinya menyediakan item rekonsiliasi untuk ditandai.
- `is_bank_checked`: penanda (flag) status apakah suatu item bank sudah dicentang/diverifikasi.
- `my_cabang_nama()`: helper untuk mendapatkan nama cabang aktif milik pengguna (menyaring data
  per cabang).

### 4.3 Keterkaitan

Checkpoint ini menjadi jembatan antara tema settlement dan tema rekonsiliasi bank/AR (lihat
dokumen 11). Catatan penting: berkas `ADVANCE_BANK_GRUP_RECONSILE.md` yang dirujuk pada beberapa
struktur dokumen TIDAK termasuk dalam daftar 5 berkas cluster settlement; keterkaitan advance
bank dan rekonsiliasi GRUP hanya tersirat dari checkpoint ini. Tandai sebagai keterbatasan
sumber (lihat bagian 8).

---

## 5. Fitur Checkbox Klaim Supplier

Sumber: KONTEKS_FITUR_CHECKBOX_KLAIM_SUPPLIER.md.

### 5.1 Konteks transaksi

| Item | Nilai |
| :--- | :--- |
| Kode transaksi | `3333` |
| Modul | `kompensasiharga` |
| Tema | Klaim/kompensasi harga ke supplier |

### 5.2 Berkas terdampak

- `Create.php`: controller pembuat data.
- `_processPihakMain.php`: pemroses pihak utama (main).
- `_selectorPihak.php`: selector pemilihan pihak.
- `_selectorPihakMain.php`: selector pihak utama.

### 5.3 Mekanisme antrean sesi

- `$_SESSION['klaim_queue']`: antrean (queue) klaim disimpan di sesi, memungkinkan pengguna
  memilih beberapa item klaim (checkbox multi-pilih) sebelum diproses.
- Tujuan: mencegah kehilangan pilihan saat perpindahan halaman/selector, dan mengumpulkan
  item klaim dalam satu batch.

### 5.4 Alur

1. Pengguna membuka selector pihak.
2. Pengguna mencentang (checkbox) satu atau banyak item; item masuk ke `klaim_queue`.
3. Pemrosesan dilakukan oleh `_processPihakMain.php` terhadap item pada antrean.
4. Data disimpan melalui `Create.php`.

Detail kolom tabel dan nama field tidak dispesifikasikan lebih rinci di sumber.

---

## 6. Plan Tool Audit Klaim Supplier

Sumber: PLAN_TOOL_AUDIT_KLAIM_SUPPLIER.md.

### 6.1 Komponen

| Komponen | Nama |
| :--- | :--- |
| Controller | `AuditKlaimSupplier.php` |
| View index | `viewKlaimSupplierIndex` |
| Referensi dokumen | GRN, transaksi `467` |

- GRN (Good Receipt Note): dokumen penerimaan barang yang menjadi salah satu sumber audit klaim.
- Transaksi `467`: referensi item yang diaudit (pada dokumen lain, `467` = Return Pembelian
  Produk @Pusat; lihat KONTEKS_ANALISA_SELECTOR_967 di dokumen 09 bagian 15).

### 6.2 Tujuan tool

Tool audit memungkinkan penelusuran klaim supplier berdasarkan GRN dan transaksi `467`, untuk
memastikan klaim tidak duplikat, sesuai kuantitas, dan tersambung ke dokumen asal.

Detail struktur output, filter, dan izin akses tidak dispesifikasikan di sumber.

---

## 7. Implementasi Termin (modul penerimaanprojek)

Sumber: implementation_plan_termin.md (berkas overlap dari cluster ev-infra).

### 7.1 Berkas dan posisi baris

| Berkas | Baris | Masalah |
| :--- | :--- | :--- |
| `views/shoppingCart.php` | 440-448 | Pembulatan DP melebihi sisa plafon `$sisaDpp` |
| `controllers/_shoppingCart.php` | 531-542 | Indikator status WO memakai `$debetNominal > 0` |
| `config/coTransaksiCore.php` | 1514-1517 | Norma PPN 12% UU HPP (DPP nilai lain) |

### 7.2 Bug pembulatan Rp 1 (Residual Plug Pattern)

- Kasus: Termin 70% dibayar Rp `5.546.959`; sisa plafon riil `$sisaDpp` = Rp `2.377.267`.
- DP 30% murni dari nilai `7.924.226` = `2.377.267,8`, dibulatkan menjadi `2.377.268`
  (selisih Rp 1 dari sisa plafon `2.377.267`).
- Solusi di `views/shoppingCart.php` baris 440-448:
  `if ($dpReadyToBill > $sisaDpp) { $dpReadyToBill = $sisaDpp; }`
  sehingga DP yang ditagih tidak pernah melebihi sisa plafon.

### 7.3 Bug indikator status WO

- Kode lama: `else if ($debetNominal > 0)`; salah karena `debetTermin` `5.546.959 > 0` sehingga
  status WO keliru.
- Solusi: memeriksa `dp_terpakai`/`debet_dp` secara spesifik, bukan nominal debet umum.
- Variabel kunci: `$dpReadyToBill`, `$sisaDpp`, `$debetNominal`, `$debetTermin`.

### 7.4 Norma PPN 12% UU HPP (DPP nilai lain)

Di `config/coTransaksiCore.php` baris 1514-1517:
- `dpp_pengganti = dpp_ppn * (11/12)`
- `dpp_pengganti_factor = 11/12`
- `ppn = (12/100) * dpp_pengganti`

Efek: tarif efektif 11%, ditampilkan sebagai PPN 12% atas DPP nilai lain, sesuai UU HPP.

### 7.5 Referensi akademik

- Romney & Steinbart (2018), ISBN `978-0134472010`.
- Resmi (2024), ISBN `978-623-181-042-4`.
- Gunadi & Rahayu (2022), DOI `10.31092/jips.v4i2.1645`.

---

## 8. Sesi Penerimaan Kasir 360

Sumber: DRAFT_SESI_PENERIMAAN_KASIR_360.md (berkas overlap dari cluster ev-infra).

### 8.1 Identitas sesi

| Item | Nilai |
| :--- | :--- |
| Modul | `749` |
| Tanggal sesi | 25-26 Agustus 2026 |
| Model utama | `MdlMother.php` |
| Stack | PHP 5.6 / CodeIgniter 3.1.8 / MariaDB 10 |
| Referensi angka | `4467` |

Catatan: `4467` pada sumber muncul sebagai referensi nilai/akun (pada dokumen rekonsiliasi AR,
`4467` juga muncul sebagai referensi rekening; lihat dokumen 11). Konteks persis `4467` di sesi
ini tidak dispesifikasikan lebih rinci.

### 8.2 Model `MdlMother.php`

- `MdlMother` adalah base model induk tempat model lain melakukan extends (lihat
  DEVELOPMENT_CONTEXT di dokumen 09 bagian 13.1, model rak gudang extends `MdlMother`).
- Menyediakan fungsi umum lintas modul.

### 8.3 Cakupan "Kasir 360"

Kerangka "360" mengacu pada pandangan menyeluruh atas penerimaan kasir: dokumen penerimaan,
alokasi pembayaran, dan keterkaitan dengan dokumen penjualan/settlement. Pada sumber, detail
tabel/kolom spesifik sesi ini tidak diuraikan; yang tersedia adalah identitas sesi, modul, model,
stack, tanggal, dan angka referensi.

### 8.4 Keterkaitan

Sesi ini bersinggungan dengan checkpoint settlement (bagian 4) karena penerimaan kasir memasok
data ke rekonsiliasi bank dan settlement. Hubungan ini dicatat sebagai keterkaitan tematis;
integrasi teknis detail tidak dispesifikasikan di sumber.

---

## 9. Temuan Lintas-Dokumen & Kontradiksi

1. Ejaan modul tidak konsisten: `pettycast` (pada nama UAT dan modul) vs konsep lazim
   "petty cash". Gunakan ejaan sumber `pettycast` saat merujuk kode.
2. Tanggal sesi tidak seragam: checkpoint settlement 11 September 2026, sesi penerimaan kasir
   25-26 Agustus 2026. Keduanya berbeda fase dan tidak bertentangan, tetapi perlu penjadwalan
   ulang bila dianggap satu rangkaian.
3. `implementation_plan_termin.md` dan `DRAFT_SESI_PENERIMAAN_KASIR_360.md` berada di cluster
   `ev-infra`, namun secara tema termasuk settlement/kasir. Bila ada pembaruan, kedua berkas
   harus diperbarui di dua tempat (risiko dokumentasi ganda).
4. PPN tidak seragam antar-dokumen: implementation_plan_termin menulis 12% (DPP nilai lain),
   sedangkan dokumen lain (ALUR UI, RAB, UAT) menyebut 11%. Perlu penyeragaman label.
5. Berkas `ADVANCE_BANK_GRUP_RECONSILE.md` dirujuk struktur dokumen tetapi tidak ada pada daftar
   sumber cluster settlement; advance bank & rekonsiliasi GRUP hanya tersirat dari
   CHECKPOINT_SESSION_SETTLEMENT.md.
6. Fitur checkbox klaim (`$_SESSION['klaim_queue']`) dan tool audit klaim (`AuditKlaimSupplier`)
   membahas domain yang sama (klaim supplier) namun tidak saling merujuk di sumber; perlu
   penyelarasan agar antrean klaim dapat diaudit.
7. `4467` muncul di sesi kasir 360 dan di dokumen rekonsiliasi AR dengan konteks berbeda;
   pastikan tidak tertukar antara kode modul dan nomor rekening.
8. Peran otorisasi UAT settlement (`o_finance`, `c_holding`, `c_finance`) tidak disebut pada
   modul pettycash; belum jelas apakah pola otorisasi sama.

---

## 10. Lampiran Daftar File Sumber

| No | Berkas | Cluster | Fokus |
| --- | --- | --- | --- |
| 1 | CHECKLIST_UAT_SETTLEMENT_758.md | ev-settlement | UAT settlement 758/758r |
| 2 | CHECKLIST_UAT_PETTYCASH_1671.md | ev-settlement | UAT petty cash 1671/1671r |
| 3 | CHECKPOINT_SESSION_SETTLEMENT.md | ev-settlement | Checkpoint 11 Sep 2026, 759, rekonsiliasi bank |
| 4 | KONTEKS_FITUR_CHECKBOX_KLAIM_SUPPLIER.md | ev-settlement | Checkbox klaim 3333/kompensasiharga |
| 5 | PLAN_TOOL_AUDIT_KLAIM_SUPPLIER.md | ev-settlement | Tool audit klaim supplier |
| 6 | implementation_plan_termin.md | ev-infra (overlap) | Bug termin DP & PPN 12% |
| 7 | DRAFT_SESI_PENERIMAAN_KASIR_360.md | ev-infra (overlap) | Sesi penerimaan kasir 749 |
