# 📘 Panduan Modul: API (Integrasi Web Service API)

## 1. Peran & Fungsi Utama
Modul ini bertindak sebagai pintu gerbang (Gateway) penyedia REST API untuk integrasi aplikasi pihak ketiga (seperti e-commerce mobile, POS offline, atau sinkronisasi data kurir eksternal):
- Menyediakan endpoint data master produk, data harga, data pelanggan, dan pengiriman transaksi penjualan secara asinkron.
- **APIntegration.php**: Controller utama yang menangani antarmuka setup integrasi Whatsapp sender pihak ketiga (`whatsapp_unik_id`, `whatsapp_secret_id`, `whatsapp_status`) untuk pengiriman otomatis pesan invoice WhatsApp.

---

## 2. Aliran Finansial & Mutasi Persediaan
- **Log Perubahan Pengaturan**: Setiap kali admin mengubah token atau setting unik WhatsApp, perubahan dicatat secara audit-trail ke tabel `history_perubahan_setting`.
- **Integrasi Transaksional**: Modul ini membaca data dari tabel `settings` untuk mengambil token autentikasi integrasi sebelum melakukan request eksternal ke CDN WASender.
- **Tidak Memengaruhi Stok Secara Langsung**: Tidak memanggil locker stok persediaan secara internal, melainkan melayani integrasi pesan atau sinkronisasi asinkron.

---

## 3. Skema Data & Parameter Tabel
- **`settings`**:
  - `jenis` (e.g. `whatsapp_unik_id`, `whatsapp_secret_id`, `whatsapp_status`)
  - `untuk` (e.g. `whatsapp`)
  - `nilai` (nilai config token / status)
- **`history_perubahan_setting`**:
  - `jenis`
  - `nilai_lama`
  - `nilai_baru`
  - `admin_id`