📐 Dokumentasi Formula Template

Struktur Dasar

Formula template terdiri dari satu atau lebih baris expression. Setiap baris memiliki format:

result_key = expression

Contoh Sederhana

nilai_akhir = pokok * (1 + bunga / 100)
total = pokok + setoran

Pemisah Antar Formula

Pemisah antar formula mendukung dua cara (bisa dicampur):

Penulisan Variabel {{ }}

Semua variable wajib menggunakan {{ }}. Backend otomatis men-strip {{ dan }} sebelum evaluasi.

{{nilai_akhir}} = {{pokok}} * pow(1 + {{bunga}}/100, {{periode}})   // ✅ standard
{{total}} = {{pokok}} + {{setoran}}                                  // ✅ standard

Chaining (Variabel Berantai)

Hasil dari baris sebelumnya bisa digunakan di baris berikutnya:

{{pkp_tahunan}} = {{penghasilan}} * 12 - ptkp({{status_ptkp}})
{{pph_terutang}} = {{pkp_tahunan}} * 0.05
{{pph_periode}} = {{pph_terutang}} / 12

Variabel & Input Field

Variable dari Input

Variable input berasal dari name di inputFields. Semua variable input otomatis tersedia di environment formula.

// inputFields — CMS admin panel
[
  { "name": "pokok",   "type": "currency",    "label": "Jumlah Awal" },
  { "name": "bunga",   "type": "percentage",  "label": "Suku Bunga" },
  { "name": "periode", "type": "number",      "label": "Jangka Waktu" }
]

// Di formula, langsung pakai nama field:
{{nilai_akhir}} = {{pokok}} * pow(1 + {{bunga}}/100, {{periode}})

Tipe Input Field

Select Field & Opsi

Field select punya options — array { value, label }. Value yang dikirim ke formula:

{
  "name": "mode",
  "type": "select",
  "label": "Mode Perhitungan",
  "options": [
    { "value": "1", "label": "PPh 21 Karyawan" },
    { "value": "2", "label": "PPh 21 Freelance" },
    { "value": "3", "label": "Karyawan+Freelance" }
  ]
}

Field Hasil (Output)

Key di sisi kiri (LHS) harus cocok dengan key di resultFields:

// resultFields
[
  { "key": "nilai_akhir",  "label": "Nilai Akhir",  "format": "currency" },
  { "key": "total_bunga",  "label": "Total Bunga",  "format": "currency" }
]

{{nilai_akhir}} = {{pokok}} * pow(1 + {{bunga}}/100, {{periode}})    // ✅
{{total_bunga}} = {{nilai_akhir}} - {{pokok}}                        // ✅

Input Kondisional

Field input bisa punya condition — field hanya muncul jika kondisi terpenuhi.

Syntax Condition

{
  "name": "penghasilan",
  "type": "currency",
  "label": "Gaji Karyawan/Bulan",
  "condition": "mode==1||mode==3"    // muncul hanya di mode 1 dan 3
}

Perilaku di Frontend

• • Field dengan condition false → hidden ( opacity-0, max-h-0)
• • Field dengan condition true atau tanpa condition → selalu visible
• • Transisi smooth antar mode

Konversi Otomatis

: → / (Indonesian Division)

Karena banyak pengguna Indonesia mengetik : untuk pembagian, backend otomatis mengkonversi : menjadi /.

{{nilai_akhir}} = {{pokok}} * (1 + {{bunga}} : 100)    // ditulis pakai :
{{nilai_akhir}} = {{pokok}} * (1 + {{bunga}} / 100)    // dievaluasi sebagai /

^ → pow() (Power Operator)

{{nilai_akhir}} = {{pokok}} * (1 + {{bunga}}/100) ^ {{periode}}
// Dikonversi menjadi:
{{nilai_akhir}} = {{pokok}} * pow(1 + {{bunga}}/100, {{periode}})

Fungsi Bawaan

Semua fungsi berikut tersedia di dalam formula:

ProFungsi Lanjutan (Pro)

Pengguna tier Kreator Pro dan Tim Keuangan memiliki akses ke logika kompleks dan fungsi finansial tingkat lanjut:

Variabel Bawaan

multiplier

Nilai pengali untuk Dana Darurat, diturunkan dari status_pekerjaan:

Contoh penggunaan:

{{dana_darurat}} = {{pengeluaran_bulanan}} * multiplier

Built-in Function: ptkp(kode)

Mengembalikan nilai PTKP (Penghasilan Tidak Kena Pajak) tahunan berdasarkan kode numerik. Input status_ptkp di CMS harus pakai value angka (1-8):

{{pkp}} = max(0, {{penghasilan}} * 12 - ptkp({{status_ptkp}}))

Formula Multi-Mode

Untuk kalkulator dengan beberapa mode, gunakan:

1. Input field mode — type: "select" dengan options numerik
2. Conditional fields — tampilkan field berdasarkan mode
3. Ternary di formula — branching berdasarkan nilai mode

Contoh: PPh 21 (3 Mode)

// ═══ Mode 1: Karyawan ═══
{{pkp_karyawan}} = round(max(0, {{penghasilan}} * 12 - ptkp({{status_ptkp}}) - {{iuran_pensiun}} * 12))

// ═══ Mode 2: Freelance (tahunan) ═══
{{neto_freelance}} = round({{penghasilan_bruto_tahunan}} * {{persentase_nppn}} / 100)
{{pkp_freelance}} = round(max(0, {{neto_freelance}} - ptkp(1)))

// ═══ Mode 3: Kombinasi ═══
{{biaya_jabatan}} = min(round({{penghasilan}} * 12 * 0.05), 6000000)
{{net_employment}} = round(max(0, {{penghasilan}} * 12 - {{biaya_jabatan}} - {{iuran_pensiun}} * 12))
{{net_freelance}} = round({{penghasilan_bruto_tahunan}} * {{persentase_nppn}} / 100)
{{total_net}} = {{net_employment}} + {{net_freelance}}
{{pkp_combined}} = round(max(0, {{total_net}} - ptkp({{status_ptkp}})))

// ═══ Switch Mode ═══
{{pkp_tahunan}} = round({{mode}} == 1 ? {{pkp_karyawan}} : ({{mode}} == 2 ? {{pkp_freelance}} : {{pkp_combined}}))

// ═══ Tarif Progresif ═══
{{pph_terutang}} = round({{pkp_tahunan}} <= 60000000 ? {{pkp_tahunan}} * 0.05 : ({{pkp_tahunan}} <= 250000000 ? 3000000 + ({{pkp_tahunan}} - 60000000) * 0.15 : ({{pkp_tahunan}} <= 500000000 ? 3000000 + 28500000 + ({{pkp_tahunan}} - 250000000) * 0.25 : ({{pkp_tahunan}} <= 5000000000 ? 3000000 + 28500000 + 62500000 + ({{pkp_tahunan}} - 500000000) * 0.30 : 3000000 + 28500000 + 62500000 + 1350000000 + ({{pkp_tahunan}} - 5000000000) * 0.35))))

// ═══ Hasil: Mode 1 & 3 bulanan, Mode 2 tahunan ═══
{{pph_periode}} = round({{mode}} == 2 ? {{pph_terutang}} : {{pph_terutang}} / 12)
{{take_home_pay}} = round({{mode}} == 1 ? {{penghasilan}} - {{pph_periode}} - {{iuran_pensiun}} : ({{mode}} == 2 ? {{penghasilan_bruto_tahunan}} - {{pph_periode}} : {{penghasilan}} + {{penghasilan_bruto_tahunan}} / 12 - {{pph_periode}} - {{iuran_pensiun}}))
{{tarif_efektif}} = {{pkp_tahunan}} > 0 ? round({{pph_terutang}} / {{pkp_tahunan}} * 100 * 100) / 100 : 0.0

Penanganan Error

Contoh Lengkap

1. Bunga Majemuk

{{nilai_akhir}} = round({{pokok}} * pow(1 + {{bunga}}/100/12, {{periode}}*12) + {{setoran}} * ((pow(1 + {{bunga}}/100/12, {{periode}}*12) - 1) / max({{bunga}}/100/12, 0.000001)))
{{total_investasi}} = round({{pokok}} + {{setoran}} * 12 * {{periode}})
{{total_bunga}} = round({{nilai_akhir}} - {{total_investasi}})
{{roi_persen}} = round(({{nilai_akhir}} - {{total_investasi}}) / {{total_investasi}} * 100 * 100) / 100

2. Dana Darurat

{{dana}} = round({{pengeluaran_bulanan}} * multiplier); {{bulan_cadangan}} = multiplier

3. KPR Syariah

{{pembiayaan}} = {{harga_rumah}} - {{uang_muka}}
{{cicilan_bulanan}} = round(({{pembiayaan}} + {{pembiayaan}} * {{margin_persen}}/100 * {{tenor_tahun}}) / ({{tenor_tahun}} * 12))
{{total_pembayaran}} = round({{cicilan_bulanan}} * {{tenor_tahun}} * 12)
{{total_margin}} = round({{total_pembayaran}} - {{pembiayaan}})

Perhitungan Saya (Immutable)

Hasil kalkulasi yang disimpan di Perhitungan Saya bersifat immutable — tidak berubah meskipun formula atau aturan diperbarui di kemudian hari.

Panduan Singkat (Cheat Sheet)