# 20. Lokalisasi & Kepatuhan Pasar Indonesia

Panduan khusus untuk memastikan Smart Order OS siap digunakan dan dipasarkan di Indonesia.

---

## 1. Bahasa & Konten

| Area | Implementasi |
|------|-------------|
| **UI default** | Bahasa Indonesia (label, pesan, notifikasi) |
| **Error messages** | Indonesia (e.g. "Pembayaran gagal", "Stok habis") |
| **Dokumentasi** | Indonesia (docs/) + English (opsional untuk investor/partner) |
| **Multi-bahasa** | Gunakan `lang/id.json` dan `lang/en.json` (Laravel localization) |

### Format Regional

```php
// config/app.php
'locale' => 'id',
'timezone' => 'Asia/Jakarta', // default, per-outlet bisa override

// Format angka
number_format($price, 0, ',', '.'); // 25.000
// Format tanggal
Carbon::now()->translatedFormat('l, d F Y'); // Senin, 17 Februari 2026
```

---

## 2. Mata Uang

- **Default:** IDR (Rupiah), `Rp` prefix.
- **Desimal:** 0 digit desimal (Rupiah tidak menggunakan sen untuk transaksi harian).
- **Format:** `Rp 25.000` (titik sebagai pemisah ribuan).
- **Per-outlet override:** Jika satu instance dipakai di negara lain, outlet bisa menyimpan `currency` di `outlet_settings`.

---

## 3. Pajak (PPN) & Service Charge

| Item | Default | Konfigurasi |
|------|---------|-------------|
| **PPN** | 11% (per UU HPP, efektif 2025) | `outlet_settings.tax_rate` |
| **Service Charge** | 5–10% (opsional, restoran) | `outlet_settings.service_charge_rate` |
| **Inklusi/Eksklusif** | Harga bisa sudah termasuk PPN atau belum | `outlet_settings.tax_inclusive` |

### Perhitungan di OrderService

```
Subtotal = Σ(item_price × qty) + modifiers
Tax = Subtotal × tax_rate (jika exclusive)
Service = Subtotal × service_charge_rate
Total = Subtotal + Tax + Service - Discount
```

---

## 4. Metode Pembayaran Indonesia

| Metode | Status | Provider |
|--------|--------|----------|
| **Tunai (Cash)** | ✅ Aktif | Built-in |
| **QRIS** | ✅ Aktif | Midtrans |
| **Transfer Bank** | ✅ Aktif | Manual / Midtrans VA |
| **GoPay** | 🔜 Via Midtrans | Midtrans Snap |
| **OVO** | 🔜 Via Midtrans | Midtrans Snap |
| **ShopeePay** | 🔜 Via Midtrans | Midtrans Snap |
| **Dana** | 🔜 Via Midtrans | Midtrans Snap |
| **Kartu Debit/Kredit** | 🔜 Via Midtrans | Midtrans Snap |

> **QRIS** adalah metode pembayaran digital paling populer di UMKM Indonesia. Semua e-wallet (GoPay, OVO, Dana, ShopeePay, LinkAja) bisa membayar via satu QR Code QRIS.

---

## 5. Integrasi Lokal (Roadmap)

| Integrasi | Fungsi | Status |
|-----------|--------|--------|
| **WhatsApp Business API** | Struk digital, notifikasi order, blast promo | Sebagian (blast ada) |
| **GoFood / GrabFood** | Sinkronisasi order dari marketplace | Roadmap Phase 3 |
| **Tokopedia / Shopee Food** | Sinkronisasi order | Roadmap Phase 4 |
| **Accurate / Jurnal.id** | Sinkronisasi laporan keuangan ke akuntansi | Roadmap Phase 4 |
| **KAI Access / Traveloka** | Integrasi untuk F&B di stasiun/bandara | Roadmap Phase 4 |

---

## 6. Regulasi & Compliance

### UU Perlindungan Data Pribadi (UU PDP - No. 27/2022)

- **Consent:** Pelanggan harus diberi tahu dan menyetujui penyimpanan data.
- **Hak akses:** Pelanggan bisa minta salinan datanya.
- **Hak hapus:** Pelanggan bisa minta penghapusan data (implementasi: soft delete + anonymize).
- **Penyimpanan:** Data disimpan di server Indonesia (jika SaaS publik).

### Pajak Digital

- Struk digital (e-receipt) sudah cukup; tidak wajib cetak kertas untuk UMKM.
- Jika terintegrasi ke e-Faktur DJP: export data invoice per periode.

### Standar QRIS (Bank Indonesia)

- QRIS mengikuti standar SNAP (Standar Nasional Pembayaran) dari Bank Indonesia.
- Merchant harus terdaftar resmi melalui PSP (Penyedia Jasa Pembayaran) yang berizin, seperti Midtrans.

---

## 7. Target Segmen Pasar Indonesia

| Segmen | Kebutuhan Utama | Fitur Andalan |
|--------|-----------------|---------------|
| **Warteg / UMKM** | POS sederhana, QRIS | Starter plan, mobile-friendly |
| **Café / Resto** | KDS, floor plan, loyalty | Pro plan |
| **Franchise** | Multi-outlet, reporting terpusat | Pro/Enterprise |
| **Food Court** | Multi-tenant, split billing | Enterprise |
| **Cloud Kitchen** | Integrasi marketplace, delivery tracking | Enterprise |

---

*Dokumen ini menjadi acuan untuk setiap keputusan lokalisasi dan kepatuhan regulasi saat memasarkan Smart Order OS di Indonesia.*
