Bagian ini ditujukan untuk administrator sistem yang bertanggung jawab menyiapkan aplikasi untuk pertama kali.

Tampilan Bare-Bones

Setelah instalasi, aplikasi menampilkan tampilan bare-bones dengan data minimal:

• User admin default (admin/admin)
• Tahun fiskal aktif
• Tidak ada COA, template, atau data master lainnya

Feature Overview

Setelah import seed data, fitur yang tersedia tergantung jenis industri:

Fitur Umum (Semua Industri)

Fitur	Menu	Deskripsi
Transaksi	Transaksi	Catat pendapatan dan pengeluaran
Laporan	Laporan	Neraca, Laba Rugi, Arus Kas
Pajak	Pajak	PPN, PPh, Kalender Pajak
Penggajian	Penggajian	Payroll, BPJS, PPh 21
Aset Tetap	Aset	Depresiasi, Kategori Aset

Fitur Industri Jasa

Fitur	Menu	Deskripsi
Client	Klien	Data klien dan kontak
Project	Proyek	Proyek dengan milestone
Invoice	Invoice	Penagihan ke klien
Profitabilitas	Laporan	Profit per klien/proyek

Fitur Industri Dagang

Fitur	Menu	Deskripsi
Produk	Inventori > Produk	Master produk dengan harga
Stok	Inventori > Stok	Saldo stok per lokasi
Transaksi Inventori	Inventori > Transaksi	Pembelian, Penjualan, Adjustment
Laporan Stok	Inventori > Laporan	Kartu stok, Valuasi

---

Master Data

Bagan Akun (Chart of Accounts)

Buka menu Akun untuk melihat daftar akun.

Struktur Kode Akun

Prefix	Kategori	Contoh
1.x.xx	Aset	Kas, Bank, Piutang, Peralatan
2.x.xx	Kewajiban	Hutang Usaha, Hutang Pajak
3.x.xx	Ekuitas	Modal, Laba Ditahan
4.x.xx	Pendapatan	Pendapatan Jasa, Penjualan
5.x.xx	Beban	Gaji, Sewa, Listrik

Tambah Akun Baru

1. Klik tombol Akun Baru
2. Isi form:

Field	Keterangan
Kode	Kode unik mengikuti struktur
Nama	Nama akun
Tipe	Aset/Kewajiban/Ekuitas/Pendapatan/Beban
Sub Tipe	Kategori detail
Saldo Normal	Debit/Kredit

3. Klik Simpan

Template Transaksi

Template menentukan akun-akun yang terlibat dalam suatu jenis transaksi.

Lihat Referensi Template untuk daftar lengkap template standar.

---

Periode Fiskal

Konsep

Periode fiskal adalah periode akuntansi perusahaan. Aplikasi menggunakan sistem 12 bulan per tahun fiskal.

Melihat Periode Fiskal

Buka menu Periode Fiskal di sidebar.

Status Periode

Status	Arti
OPEN	Periode aktif, transaksi dapat dicatat
CLOSED	Periode ditutup, transaksi tidak dapat dicatat

---

Backup Data

Manual Backup

1. Buka menu Pengaturan > Backup
2. Klik Buat Backup
3. File backup akan terunduh

Kapan Perlu Backup

• Sebelum import data baru
• Sebelum tutup buku tahunan
• Secara berkala (minimal bulanan)

---

Tips Setup

1. Mulai dari seed data - Jangan setup dari kosong, gunakan seed data industri yang sesuai
2. Review COA - Pastikan bagan akun sesuai kebutuhan bisnis
3. Test transaksi - Coba input beberapa transaksi untuk memastikan setup benar
4. Dokumentasi - Catat perubahan konfigurasi yang dilakukan

Lihat Juga

• Tutorial Dasar Akuntansi - Pahami konsep dan workflow
• Keamanan & Kepatuhan - Konfigurasi keamanan
• Referensi Akun - Daftar akun standar

Konsep Seed Data

Seed data adalah paket data awal yang berisi:

• Bagan Akun (Chart of Accounts) sesuai industri
• Template transaksi standar
• Komponen gaji (jika applicable)
• Deadline pajak
• Kategori aset tetap

Pilihan Industry Seed

Industry	Deskripsi	Fitur Utama
IT Services (PKP)	Perusahaan jasa IT dengan kewajiban PPN	Client, Project, Milestone, Invoice
Online Seller	Penjual online marketplace	Produk, Inventory FIFO, Multi-marketplace
Coffee Shop	Usaha kopi & pastry	BOM, Production Order, HPP
Campus	Institusi pendidikan	Mahasiswa, SPP, Beasiswa

Langkah Import

1. Buka menu Pengaturan di sidebar
2. Pilih tab Import Data
3. Klik Pilih File dan pilih file ZIP seed data
4. Review preview data yang akan diimpor
5. Klik Import

Catatan: Proses import akan menggantikan data existing. Pastikan tidak ada data penting sebelum import.

---

Melihat Daftar Pengguna

Buka menu Pengguna di sidebar.

Tambah Pengguna Baru

1. Klik tombol Pengguna Baru

2. Isi form:

Field	Keterangan
Username	Login ID (unik)
Nama Lengkap	Nama tampilan
Email	Alamat email
Password	Password minimal 12 karakter
Role	ADMIN/OWNER/ACCOUNTANT/STAFF/AUDITOR/EMPLOYEE

3. Klik Simpan

Sesi Perangkat (Device Sessions)

Di halaman detail pengguna, terdapat bagian Sesi Perangkat Aktif yang menampilkan daftar perangkat yang terhubung melalui OAuth Device Flow (misalnya Claude Code, Docker Desktop).

Informasi yang ditampilkan:

• Perangkat — nama perangkat yang didaftarkan
• Client ID — identifier aplikasi
• Status — Aktif atau Kedaluwarsa
• Dibuat — tanggal token dibuat
• Terakhir Digunakan — waktu terakhir token digunakan
• IP Terakhir — alamat IP terakhir

Untuk mencabut akses:

• Klik Cabut pada sesi individual
• Klik Cabut Semua untuk mencabut semua sesi sekaligus

Role dan Permission

Role	Deskripsi	Permission
ADMIN	Administrator sistem	Full access
OWNER	Pemilik bisnis	Full access kecuali user management
ACCOUNTANT	Akuntan	Transaksi, Laporan, Pajak
STAFF	Staff operasional	Transaksi, View laporan
AUDITOR	Auditor	View only
EMPLOYEE	Karyawan	Self-service saja

---

Untuk Administrator

1. Buat Bot di BotFather

1. Buka Telegram, cari @BotFather
2. Kirim /newbot
3. Ikuti instruksi untuk membuat bot
4. Catat Bot Token yang diberikan

2. Konfigurasi Environment

Tambahkan ke environment variables server:

TELEGRAM_BOT_TOKEN=your_bot_token_here
TELEGRAM_WEBHOOK_URL=https://your-domain.com/api/telegram/webhook

3. Daftarkan Webhook

curl -X POST "https://api.telegram.org/bot{your_token}/setWebhook" \
  -d "url=https://your-domain.com/api/telegram/webhook"

Untuk End User

1. Buka menu Pengaturan > Telegram
2. Klik Hubungkan Telegram
3. Salin kode verifikasi
4. Buka Telegram, cari bot yang dikonfigurasi
5. Kirim kode verifikasi ke bot

Setelah terhubung, Anda dapat mengirim foto struk via Telegram.

Lihat Tutorial Akuntansi bagian Telegram Receipt untuk panduan penggunaan.

---

Bagian ini adalah panduan utama untuk pemilik bisnis yang belum memiliki latar belakang akuntansi. Tujuannya: memahami akuntansi dengan bahasa sederhana agar dapat menggunakan aplikasi dengan benar.

Catatan: Konsep di sini bersifat universal - bisa diterapkan dengan aplikasi ini, Excel, atau bahkan pencatatan manual.

---

Apa Itu Akuntansi?

Akuntansi adalah proses mencatat, mengklasifikasi, dan melaporkan transaksi keuangan bisnis.

Tujuan akuntansi:

• Mengetahui kondisi keuangan bisnis
• Membuat keputusan bisnis yang tepat
• Memenuhi kewajiban pelaporan pajak

---

Persamaan Dasar Akuntansi

Aset = Kewajiban + Ekuitas

Komponen	Pengertian	Contoh
Aset	Apa yang dimiliki bisnis	Kas, piutang, peralatan
Kewajiban	Apa yang dihutang bisnis	Hutang vendor, hutang pajak
Ekuitas	Modal pemilik	Modal awal, laba ditahan

Setiap transaksi harus menjaga keseimbangan persamaan ini.

---

Debit dan Kredit

Setiap transaksi dicatat dalam dua sisi: debit dan kredit. Total debit harus sama dengan total kredit.

Jenis Akun	Bertambah	Berkurang
Aset	Debit	Kredit
Kewajiban	Kredit	Debit
Ekuitas	Kredit	Debit
Pendapatan	Kredit	Debit
Beban	Debit	Kredit

Contoh: Terima Pembayaran dari Klien

Anda menerima Rp 10.000.000 dari klien untuk jasa konsultasi.

Akun	Debit	Kredit
Kas/Bank	10.000.000
Pendapatan Jasa		10.000.000

• Kas (aset) bertambah → debit
• Pendapatan bertambah → kredit

Contoh: Bayar Listrik

Anda membayar tagihan listrik Rp 500.000.

Akun	Debit	Kredit
Beban Listrik	500.000
Kas/Bank		500.000

• Beban bertambah → debit
• Kas (aset) berkurang → kredit

---

Bagan Akun (Chart of Accounts)

Bagan akun adalah daftar semua akun yang digunakan untuk mencatat transaksi.

Struktur Kode Akun

Kode	Jenis	Contoh
1.x.xx	Aset	Kas, Bank, Piutang, Peralatan
2.x.xx	Kewajiban	Hutang Usaha, Hutang Pajak
3.x.xx	Ekuitas	Modal, Laba Ditahan
4.x.xx	Pendapatan	Pendapatan Jasa, Pendapatan Lain
5.x.xx	Beban	Gaji, Sewa, Listrik, Internet

---

Telegram Receipt

Fitur untuk mengirim foto struk via Telegram dan mencatat transaksi langsung.

Cara Penggunaan

1. Buka Telegram, cari bot yang dikonfigurasi
2. Kirim foto struk
3. Bot akan meminta konfirmasi:
   • Template transaksi
   • Jumlah
   • Keterangan
4. Konfirmasi, transaksi akan tercatat

Catatan: Fitur ini perlu dikonfigurasi dulu oleh administrator. Lihat Setup Awal.

---

Tips untuk Pemula

1. Catat segera - Catat transaksi sesegera mungkin setelah terjadi
2. Simpan bukti - Simpan struk, invoice, dan dokumen pendukung
3. Gunakan template - Aplikasi menyediakan template untuk transaksi umum
4. Review rutin - Periksa laporan minimal sekali seminggu
5. Posting langsung - Jangan tunda posting transaksi draft
6. Rekonsiliasi - Cocokkan saldo aplikasi dengan saldo bank secara berkala

---

Istilah Penting

Istilah	Artinya
Transaksi	Setiap kali uang masuk atau keluar
Posting	Menyimpan transaksi secara permanen
Draft	Transaksi yang masih bisa diedit
Akun	Kategori untuk mengelompokkan uang
Template	Format siap pakai untuk transaksi
Jurnal	Catatan debit/kredit dari transaksi
Debit	Kolom kiri (biasanya = bertambah untuk aset)
Kredit	Kolom kanan (biasanya = berkurang untuk aset)
Neraca	Laporan posisi keuangan
Laba Rugi	Laporan keuntungan/kerugian

Lihat Glosarium untuk daftar istilah lengkap.

---

Lihat Juga

• Setup Awal - Konfigurasi awal aplikasi
• Aset Tetap - Pencatatan dan depresiasi aset
• Perpajakan - Transaksi pajak
• Referensi Template - Daftar template transaksi

Siklus akuntansi adalah urutan langkah yang dilakukan berulang setiap periode:

1. Identifikasi Transaksi
       ↓
2. Catat di Jurnal
       ↓
3. Posting ke Buku Besar
       ↓
4. Susun Neraca Saldo
       ↓
5. Jurnal Penyesuaian
       ↓
6. Laporan Keuangan
       ↓
7. Jurnal Penutup
       ↓
8. Neraca Saldo Setelah Penutupan

Dalam aplikasi ini, langkah 2-3 dilakukan otomatis saat Anda mencatat transaksi.

---

Mencatat Pendapatan

Setiap kali Anda menerima uang:

1. Buka menu Transaksi

2. Klik Transaksi Baru
3. Pilih template yang sesuai (contoh: "Pendapatan Jasa")
4. Isi field:
   • Tanggal: Tanggal uang diterima
   • Jumlah: Nominal yang diterima
   • Keterangan: Catatan untuk referensi
5. Review preview jurnal
6. Klik Simpan & Posting

---

Contoh Lengkap: Setoran Modal

Mari kita catat setoran modal awal perusahaan sebesar Rp 500.000.000.

Langkah 1: Buka Form Transaksi

1. Klik menu Transaksi > Transaksi Baru
2. Pilih template Setoran Modal

Langkah 2: Isi Data Transaksi

• Tanggal: 1 Januari 2024
• Jumlah: Rp 500.000.000
• Keterangan: Setoran Modal Awal 2024
• Referensi: CAP-2024-001

Preview Jurnal:

Dr. 1.1.01 Kas/Bank           Rp 500.000.000
    Cr. 3.1.01 Modal Saham        Rp 500.000.000

Langkah 3: Simpan & Posting

Klik tombol Simpan & Posting. Sistem akan menampilkan detail transaksi.

Hasil:

• Status: Posted
• Jurnal otomatis dibuat
• Saldo Kas bertambah Rp 500.000.000
• Ekuitas bertambah Rp 500.000.000

---

Contoh Lengkap: Pendapatan dengan PPN

Mencatat pendapatan jasa konsultasi sebesar Rp 196.200.000 (termasuk PPN 11%).

Langkah 1: Pilih Template

Template: Pendapatan Jasa Konsultasi (dengan PPN)

Langkah 2: Isi Data

• Tanggal: 15 Januari 2024
• Jumlah Total: Rp 196.200.000
• Keterangan: Konsultasi Core Banking - Milestone 1
• Referensi: INV-2024-001

Perhitungan Otomatis:

DPP (Dasar Pengenaan Pajak) = 196.200.000 / 1.11 = Rp 176.756.757
PPN 11%                      = 176.756.757 × 11% = Rp 19.443.243
Total                        = Rp 196.200.000

Preview Jurnal:

Dr. 1.1.01 Kas/Bank           Rp 196.200.000
    Cr. 4.1.02 Pendapatan Jasa    Rp 176.756.757
    Cr. 2.2.01 Hutang PPN         Rp  19.443.243

Langkah 3: Simpan & Posting

Verifikasi:

• Kas bertambah Rp 196.200.000
• Pendapatan diakui Rp 176.756.757
• Hutang PPN Rp 19.443.243 (akan disetor ke Dirjen Pajak)

---

Contoh Lengkap: Bayar Beban Operasional

Mencatat pembayaran lisensi software JetBrains IntelliJ.

Langkah 1: Pilih Template

Template: Bayar Beban Software & Lisensi

Langkah 2: Isi Data

• Tanggal: 15 Januari 2024
• Jumlah: Rp 3.330.000
• Keterangan: JetBrains IntelliJ License 2024
• Referensi: JB-2024-001

Preview Jurnal:

Dr. 5.1.21 Beban Software & Lisensi  Rp 3.330.000
    Cr. 1.1.01 Kas/Bank                  Rp 3.330.000

Langkah 3: Simpan & Posting

Hasil:

• Beban bertambah Rp 3.330.000
• Kas berkurang Rp 3.330.000
• Mempengaruhi laba rugi (mengurangi laba)

---

Mencatat Pengeluaran

Setiap kali Anda mengeluarkan uang:

1. Buka menu Transaksi
2. Klik Transaksi Baru
3. Pilih template yang sesuai (contoh: "Beban Operasional")
4. Isi field:
   • Tanggal: Tanggal pembayaran
   • Jumlah: Nominal yang dibayar
   • Keterangan: Catatan (contoh: "Bayar listrik November")
5. Review preview jurnal
6. Klik Simpan & Posting

Transfer Antar Akun

Saat memindahkan uang antar rekening:

1. Buka menu Transaksi
2. Klik Transaksi Baru
3. Pilih template "Transfer Antar Akun"
4. Isi:
   • Dari Akun: Rekening sumber
   • Ke Akun: Rekening tujuan
   • Jumlah: Nominal transfer
5. Klik Simpan & Posting

---

Apa Itu Jurnal?

Jurnal adalah catatan debit/kredit yang dihasilkan dari transaksi.

Aplikasi ini menggunakan pendekatan transaction-centric - Anda mencatat transaksi, sistem otomatis membuat jurnal yang benar.

Status Transaksi

Status	Arti
Draft	Tersimpan tapi belum mempengaruhi saldo
Posted	Sudah diposting, mempengaruhi saldo
Void	Dibatalkan, jurnal reversal dibuat

---

Apa Itu Penyesuaian?

Penyesuaian adalah koreksi yang dilakukan di akhir periode untuk memastikan laporan keuangan akurat.

Jenis Penyesuaian

Jenis	Contoh	Akun yang Terlibat
Beban Dibayar Dimuka	Sewa dibayar setahun	Beban Sewa, Sewa Dibayar Dimuka
Beban Akrual	Gaji belum dibayar	Beban Gaji, Hutang Gaji
Penyusutan	Depresiasi peralatan	Beban Penyusutan, Akum. Penyusutan

Jadwal Amortisasi

Untuk beban yang dibayar dimuka (sewa tahunan, asuransi, dll):

1. Buka menu Amortisasi
2. Klik Amortisasi Baru

3. Isi:
   • Nama jadwal
   • Total nilai
   • Tanggal mulai dan selesai
   • Akun beban
4. Sistem akan membuat jurnal amortisasi otomatis setiap bulan

---

Untuk transaksi yang tidak cocok dengan template yang ada, gunakan fitur Jurnal Manual. Fitur ini memungkinkan input baris debit/kredit langsung tanpa template.

Kapan Menggunakan Jurnal Manual?

• Jurnal penutup (closing entries)
• Jurnal penyesuaian (adjusting entries)
• Jurnal pembuka (opening balances)
• Jurnal koreksi
• Transaksi non-standar lainnya

Cara Membuat Jurnal Manual

1. Buka menu Transaksi
2. Klik tombol Jurnal Manual di sebelah kolom pencarian template

3. Isi field:
   • Tanggal Transaksi: Tanggal jurnal
   • Kategori: Pilih jenis jurnal (Penutup, Penyesuaian, Pembuka, Koreksi) — opsional
   • Deskripsi: Keterangan jurnal
4. Tambahkan baris jurnal:
   • Pilih Akun dari dropdown
   • Isi nominal di kolom Debit atau Kredit
   • Klik Tambah Baris untuk menambah baris
5. Pastikan indikator menunjukkan Jurnal seimbang (total debit = total kredit)

6. Klik Simpan Draft atau Simpan & Posting

Contoh: Jurnal Penyesuaian Beban Dibayar Dimuka

Perusahaan membayar sewa kantor Rp 12.000.000 untuk 12 bulan. Setiap bulan perlu penyesuaian:

Dr. 5.1.03 Beban Sewa           Rp 1.000.000
    Cr. 1.3.01 Sewa Dibayar Dimuka  Rp 1.000.000

Langkah:

1. Klik Jurnal Manual
2. Pilih kategori Jurnal Penyesuaian
3. Isi deskripsi: "Penyesuaian sewa kantor bulan Januari"
4. Baris 1: Akun Beban Sewa, Debit 1.000.000
5. Baris 2: Akun Sewa Dibayar Dimuka, Kredit 1.000.000
6. Klik Simpan & Posting

---

Neraca Saldo (Trial Balance)

Daftar saldo semua akun. Total debit harus sama dengan total kredit.

Kapan digunakan: Untuk validasi bahwa pembukuan balance.

Laporan Laba Rugi (Income Statement)

Menampilkan pendapatan, beban, dan laba/rugi periode tertentu.

Struktur:

Pendapatan          Rp 50.000.000
Total Beban         Rp 30.000.000
─────────────────────────────────
LABA BERSIH         Rp 20.000.000

Neraca (Balance Sheet)

Menampilkan posisi keuangan pada tanggal tertentu.

Struktur:

ASET
  Aset Lancar           Rp 100.000.000
  Aset Tetap            Rp  50.000.000
Total Aset              Rp 150.000.000

KEWAJIBAN
  Hutang Usaha          Rp  20.000.000
Total Kewajiban         Rp  20.000.000

EKUITAS
  Modal                 Rp 100.000.000
  Laba Ditahan          Rp  30.000.000
Total Ekuitas           Rp 130.000.000

TOTAL KEWAJIBAN + EKUITAS Rp 150.000.000

Persamaan yang harus balance: Aset = Kewajiban + Ekuitas

---

Apa Itu Tutup Buku?

Proses akhir tahun untuk:

1. Menutup akun pendapatan dan beban (saldo menjadi nol)
2. Memindahkan laba/rugi ke akun Laba Ditahan

Langkah Tutup Buku

1. Buka menu Laporan > Penutupan Tahun Buku

2. Pilih tahun yang akan ditutup
3. Review preview jurnal penutup:
   • Tutup Pendapatan
   • Tutup Beban
   • Transfer ke Laba Ditahan
4. Klik Eksekusi Penutupan

Jurnal Penutup yang Dibuat

1. Tutup Pendapatan

Dr. Pendapatan Jasa          xxx
    Cr. Laba Berjalan            xxx

2. Tutup Beban

Dr. Laba Berjalan            xxx
    Cr. Beban Gaji               xxx
    Cr. Beban Sewa               xxx

3. Transfer ke Laba Ditahan

Dr. Laba Berjalan            xxx
    Cr. Laba Ditahan             xxx

Kapan Melakukan Tutup Buku?

Lakukan setelah:

• Semua transaksi tahun tersebut sudah dicatat
• Penyesuaian akhir tahun sudah dilakukan
• Penyusutan aset sudah dihitung
• Laporan keuangan sudah final

---

Apa Itu Depresiasi?

Depresiasi (penyusutan) adalah alokasi biaya perolehan aset tetap selama masa manfaatnya. Aset tetap seperti komputer, kendaraan, dan peralatan kehilangan nilai seiring waktu karena pemakaian.

Mengapa Depresiasi Penting?

1. Matching principle - Biaya aset dicocokkan dengan pendapatan yang dihasilkan
2. Pajak - Beban penyusutan mengurangi penghasilan kena pajak
3. Nilai aset akurat - Neraca menunjukkan nilai buku yang realistis

Metode Depresiasi

Metode	Rumus	Karakteristik
Garis Lurus	(Harga Perolehan - Nilai Residu) / Masa Manfaat	Beban sama setiap tahun
Saldo Menurun	Nilai Buku × Tarif	Beban besar di awal, mengecil

Regulasi Indonesia (PMK 96/PMK.03/2009):

• Kelompok 1 (4 tahun): 25% garis lurus, 50% saldo menurun
• Kelompok 2 (8 tahun): 12.5% garis lurus, 25% saldo menurun
• Kelompok 3 (16 tahun): 6.25% garis lurus, 12.5% saldo menurun
• Kelompok 4 (20 tahun): 5% garis lurus, 10% saldo menurun

---

Melihat Kategori Aset

Buka menu Aset Tetap > Kategori.

Kategori Standar (dari Seed Data)

Kategori	Kelompok	Masa Manfaat	Metode
Komputer & Laptop	1	4 tahun	Garis Lurus
Peralatan Kantor	1	4 tahun	Garis Lurus
Kendaraan Roda 2	1	4 tahun	Garis Lurus
Kendaraan Roda 4	2	8 tahun	Garis Lurus
Perabotan	2	8 tahun	Garis Lurus
Bangunan Permanen	4	20 tahun	Garis Lurus

Menambah Kategori Baru

1. Klik Kategori Baru
2. Isi:
   • Nama kategori
   • Kelompok pajak (1-4)
   • Masa manfaat (tahun)
   • Metode depresiasi
3. Klik Simpan

---

Melihat Daftar Aset

Buka menu Aset Tetap > Daftar Aset.

Kolom yang ditampilkan:

• Kode aset
• Nama aset
• Kategori
• Tanggal perolehan
• Harga perolehan
• Nilai buku saat ini
• Status

Menambah Aset Baru

1. Klik Aset Baru

2. Isi data aset:

Field	Keterangan
Kode Aset	Kode unik (contoh: AST-2025-001)
Nama Aset	Deskripsi aset
Kategori	Pilih dari dropdown
Tanggal Perolehan	Tanggal pembelian
Harga Perolehan	Nilai beli (termasuk biaya instalasi jika ada)
Nilai Residu	Estimasi nilai jual akhir (biasanya 0 untuk pajak)
Lokasi	Penempatan aset
Keterangan	Catatan tambahan (nomor seri, vendor, dll)

3. Klik Simpan

Jurnal yang Terbentuk (saat pembelian)

Dr. Aset Tetap - [Kategori]    xxx
    Cr. Kas/Bank                   xxx

---

Melihat Jadwal Depresiasi

Pada halaman detail aset, klik tab Depresiasi.

Tabel menampilkan:

• Bulan/tahun
• Beban penyusutan periode
• Akumulasi penyusutan
• Nilai buku akhir

Proses Depresiasi Bulanan

Sistem menghitung depresiasi secara otomatis setiap bulan. Jurnal yang dibuat:

Dr. Beban Penyusutan              xxx
    Cr. Akumulasi Penyusutan          xxx

Contoh Perhitungan (Garis Lurus)

Data	Nilai
Harga Perolehan	Rp 12.000.000
Nilai Residu	Rp 0
Masa Manfaat	4 tahun

Depresiasi per tahun: Rp 12.000.000 / 4 = Rp 3.000.000 Depresiasi per bulan: Rp 3.000.000 / 12 = Rp 250.000

---

Pajak yang Dikelola Aplikasi

Pajak	Tarif	Kewajiban
PPN	Nominal 12%, efektif 11% (DPP Nilai Lain)	PKP yang menyerahkan BKP/JKP
PPh 21	Progresif	Pemberi kerja (pemotongan gaji)
PPh 23	2% (jasa), 15% (dividen)	Pemberi penghasilan
PPh 25	Angsuran	Wajib pajak badan
PPh 4(2)	Final (varies)	Transaksi tertentu

---

Konsep PPN (DPP Nilai Lain — PMK 131/2024)

PPN Keluaran - PPN yang Anda pungut dari pembeli PPN Masukan - PPN yang Anda bayar ke penjual

Net PPN = PPN Keluaran - PPN Masukan

Sejak 1 Januari 2025, tarif PPN secara nominal naik menjadi 12%, namun menggunakan DPP Nilai Lain (PMK 131/2024) sehingga beban efektif tetap 11%:

• DPP = Harga Jual × 11/12 (DPP Nilai Lain)
• PPN = DPP × 12% = Harga Jual × 11/12 × 12% = Harga Jual × 11%
• Field amount di template = Harga Jual (sebelum PPN)
• Formula template: amount * 0.11 = PPN efektif 11% dari Harga Jual

Mengapa formula 0.11 (bukan 0.12)? Tarif resmi PPN adalah 12%, tetapi DPP dihitung dari 11/12 × Harga Jual (PMK 131/2024 Pasal 3). Hasil akhirnya: PPN = 11% × Harga Jual. Di Faktur Pajak Coretax, DPP dan PPN 12% ditampilkan terpisah, tetapi secara akuntansi cukup catat PPN = amount * 0.11.

Mencatat Pendapatan dengan PPN

1. Buka menu Transaksi > Transaksi Baru

2. Pilih template Pendapatan Jasa + PPN
3. Isi Harga Jual (sebelum PPN), contoh: Rp 10.000.000
4. Preview jurnal:

   Dr. Bank                    11.100.000  (amount * 1.11)
       Cr. Hutang PPN              1.100.000  (amount * 0.11)
       Cr. Pendapatan             10.000.000  (amount)
   

5. Klik Simpan & Posting

Mencatat Pembelian dengan PPN Masukan

1. Pilih template Pembelian dengan PPN
2. Isi Harga Jual (sebelum PPN), contoh: Rp 10.000.000
3. Preview jurnal:

   Dr. Beban/Aset             10.000.000  (amount)
   Dr. PPN Masukan             1.100.000  (amount * 0.11)
       Cr. Bank                   11.100.000  (amount * 1.11)
   

Pendapatan Jasa BUMN (FP 03)

Untuk klien BUMN/Pemerintah yang menggunakan Faktur Pajak kode 03 (PPN dipungut pembeli):

1. Pilih template Pendapatan Jasa BUMN (FP 03)
2. Isi Harga Jual, contoh: Rp 10.000.000
3. Preview jurnal:

   Dr. Bank                     9.800.000  (amount * 0.98)
   Dr. Kredit PPh 23              200.000  (amount * 0.02)
       Cr. Pendapatan            10.000.000  (amount)
   

4. PPN tidak masuk jurnal karena dipungut dan disetor oleh pembeli (BUMN)

Laporan Ringkasan PPN

Buka menu Laporan > Ringkasan PPN.

---

Konsep PPN (DPP Nilai Lain — PMK 131/2024)

PPN Keluaran - PPN yang Anda pungut dari pembeli PPN Masukan - PPN yang Anda bayar ke penjual

Net PPN = PPN Keluaran - PPN Masukan

Sejak 1 Januari 2025, tarif PPN secara nominal naik menjadi 12%, namun menggunakan DPP Nilai Lain (PMK 131/2024) sehingga beban efektif tetap 11%:

• DPP = Harga Jual × 11/12 (DPP Nilai Lain)
• PPN = DPP × 12% = Harga Jual × 11/12 × 12% = Harga Jual × 11%
• Field amount di template = Harga Jual (sebelum PPN)
• Formula template: amount * 0.11 = PPN efektif 11% dari Harga Jual

Mengapa formula 0.11 (bukan 0.12)? Tarif resmi PPN adalah 12%, tetapi DPP dihitung dari 11/12 × Harga Jual (PMK 131/2024 Pasal 3). Hasil akhirnya: PPN = 11% × Harga Jual. Di Faktur Pajak Coretax, DPP dan PPN 12% ditampilkan terpisah, tetapi secara akuntansi cukup catat PPN = amount * 0.11.

Mencatat Pendapatan dengan PPN

1. Buka menu Transaksi > Transaksi Baru

2. Pilih template Pendapatan Jasa + PPN
3. Isi Harga Jual (sebelum PPN), contoh: Rp 10.000.000
4. Preview jurnal:

   Dr. Bank                    11.100.000  (amount * 1.11)
       Cr. Hutang PPN              1.100.000  (amount * 0.11)
       Cr. Pendapatan             10.000.000  (amount)
   

5. Klik Simpan & Posting

Mencatat Pembelian dengan PPN Masukan

1. Pilih template Pembelian dengan PPN
2. Isi Harga Jual (sebelum PPN), contoh: Rp 10.000.000
3. Preview jurnal:

   Dr. Beban/Aset             10.000.000  (amount)
   Dr. PPN Masukan             1.100.000  (amount * 0.11)
       Cr. Bank                   11.100.000  (amount * 1.11)
   

Pendapatan Jasa BUMN (FP 03)

Untuk klien BUMN/Pemerintah yang menggunakan Faktur Pajak kode 03 (PPN dipungut pembeli):

1. Pilih template Pendapatan Jasa BUMN (FP 03)
2. Isi Harga Jual, contoh: Rp 10.000.000
3. Preview jurnal:

   Dr. Bank                     9.800.000  (amount * 0.98)
   Dr. Kredit PPh 23              200.000  (amount * 0.02)
       Cr. Pendapatan            10.000.000  (amount)
   

4. PPN tidak masuk jurnal karena dipungut dan disetor oleh pembeli (BUMN)

Laporan Ringkasan PPN

Buka menu Laporan > Ringkasan PPN.

---

Periode fiskal mengontrol kapan transaksi dapat diposting. Setiap bulan memiliki status yang menentukan apakah jurnal dapat dibuat di bulan tersebut.

Melihat Periode Fiskal

Buka menu Pengaturan > Periode Fiskal di sidebar.

Fitur daftar periode:

• Filter tahun — pilih tahun untuk melihat 12 periode
• Filter status — tampilkan semua atau filter berdasarkan status tertentu

Generate Periode Satu Tahun

Untuk membuat 12 periode sekaligus:

1. Isi tahun pada kolom Tahun di bagian atas halaman
2. Klik Generate
3. Sistem membuat periode Januari–Desember untuk tahun tersebut (periode yang sudah ada dilewati)

Atau buat periode satuan via Periode Baru (pilih tahun dan bulan manual).

Status Periode

Status	Label	Arti
OPEN	Terbuka	Transaksi dapat diposting ke periode ini
MONTH_CLOSED	Tutup Bulan	Transaksi tidak dapat diposting; periode masih bisa dibuka kembali
TAX_FILED	SPT Dilaporkan	SPT sudah dilaporkan ke DJP; periode tidak bisa dibuka kembali

Alur status:

OPEN → MONTH_CLOSED → TAX_FILED

Detail Periode

Klik periode di daftar untuk melihat detail:

• Tanggal mulai dan berakhir
• Siapa dan kapan menutup bulan
• Siapa dan kapan melaporkan SPT
• Visualisasi alur status (3 tahap)

Menutup Periode

1. Buka detail periode yang berstatus Terbuka
2. Klik Tutup Bulan
3. Konfirmasi pada dialog

Setelah ditutup, sistem memblokir posting transaksi ke periode tersebut. Jika ada transaksi draf yang belum diposting di periode tersebut, penutupan akan ditolak.

Melaporkan SPT

Setelah SPT Masa sudah dilaporkan ke DJP:

1. Buka detail periode yang berstatus Tutup Bulan
2. Klik Lapor SPT
3. Konfirmasi pada dialog

Periode dengan status SPT Dilaporkan tidak bisa dibuka kembali.

Membuka Kembali Periode

Periode dengan status Tutup Bulan dapat dibuka kembali:

1. Buka detail periode
2. Klik Buka Kembali
3. Konfirmasi pada dialog

Periode dengan status SPT Dilaporkan tidak bisa dibuka kembali.

Posting Guard

Saat pengguna mencoba memposting transaksi ke bulan yang sudah ditutup, sistem menampilkan pesan error dan transaksi tidak akan diposting. Pastikan periode dalam status Terbuka sebelum memposting transaksi.

---

Melihat Kalender Pajak

Buka menu Pajak > Kalender Pajak.

Deadline Pajak Standar

Pajak	Setor	Lapor
PPN	Akhir bulan berikutnya	Akhir bulan berikutnya
PPh 21	Tgl 15 bulan berikutnya	Tgl 20 bulan berikutnya
PPh 23	Tgl 15 bulan berikutnya	Tgl 20 bulan berikutnya
PPh 4(2)	Tgl 15 bulan berikutnya	Tgl 20 bulan berikutnya
PPh 25	Tgl 15 bulan berikutnya	Tgl 20 bulan berikutnya

Catatan: Deadline penyetoran PPh 21, PPh 23, dan PPh 4(2) berubah dari tanggal 10 menjadi tanggal 15 sesuai PMK 81/2024.

Kalender Tahunan

Menandai Selesai

1. Klik deadline yang sudah diselesaikan
2. Isi nomor bukti setor/lapor
3. Klik Selesai

---

Melihat Komponen Gaji

Buka menu Penggajian > Komponen Gaji.

Jenis Komponen

Tipe	Contoh	Pengaruh ke Gaji
Pendapatan	Gaji Pokok, Tunjangan	Menambah
Potongan	BPJS Karyawan, PPh 21	Mengurangi

Menambah Komponen

1. Klik Komponen Baru

2. Isi:
   • Nama komponen
   • Tipe (Pendapatan/Potongan)
   • Basis perhitungan (Fixed/Percentage)
   • Kena pajak (Ya/Tidak)
3. Klik Simpan

Komponen Standar (dari Seed)

Pendapatan:

• Gaji Pokok
• Tunjangan Jabatan
• Tunjangan Kehadiran
• Tunjangan Makan
• Tunjangan Transport

Potongan:

• BPJS Kesehatan (Karyawan)
• BPJS Ketenagakerjaan JHT (Karyawan)
• BPJS Ketenagakerjaan JP (Karyawan)
• PPh 21

---

Melihat Daftar Karyawan

Buka menu Penggajian > Karyawan.

Menambah Karyawan

1. Klik Karyawan Baru

2. Isi data:

Data Pribadi:

• NIK (Nomor Induk Karyawan)
• Nama lengkap
• Email, telepon, alamat

Data Pajak:

• NPWP
• Status PTKP

Data Kepegawaian:

• Jabatan, departemen
• Tanggal bergabung
• Tipe (Tetap/Kontrak)

Data Bank:

• Nama bank
• Nomor rekening

Data BPJS:

• No. BPJS Kesehatan
• No. BPJS Ketenagakerjaan

3. Klik Simpan

Assign Komponen Gaji ke Karyawan

1. Buka detail karyawan
2. Tab Komponen Gaji
3. Klik Tambah Komponen
4. Pilih komponen, isi nilai, tanggal efektif, dan tanggal berakhir (opsional)
5. Klik Simpan

Satu komponen bisa di-assign lebih dari satu kali ke karyawan yang sama, selama periode tidak tumpang tindih. Ini berguna untuk mencatat perubahan gaji:

• Gaji Pokok Rp 5.000.000 (1 Jan 2025 – 30 Apr 2025)
• Gaji Pokok Rp 6.000.000 (1 Mei 2025 – seterusnya)

Jika tanggal berakhir tidak diisi, assignment berlaku tanpa batas waktu. Sistem akan menolak assignment baru yang periodenya tumpang tindih dengan assignment yang sudah ada.

---

Tarif BPJS 2024

BPJS Kesehatan:

Pihak	Tarif	Batas UMR
Perusahaan	4%	Maks 12 juta
Karyawan	1%	Maks 12 juta

BPJS Ketenagakerjaan:

Program	Perusahaan	Karyawan
JHT	3.7%	2%
JKK	0.24-1.74%	-
JKM	0.3%	-
JP	2%	1%

Kalkulator BPJS

Buka menu Penggajian > Kalkulator BPJS.

1. Masukkan gaji pokok
2. Sistem menghitung:
   • BPJS Kes (perusahaan + karyawan)
   • BPJS TK (JHT, JKK, JKM, JP)
   • Total beban perusahaan
   • Total potongan karyawan

---

Melihat Daftar Karyawan

Buka menu Penggajian > Karyawan.

Menambah Karyawan

1. Klik Karyawan Baru

2. Isi data:

Data Pribadi:

• NIK (Nomor Induk Karyawan)
• Nama lengkap
• Email, telepon, alamat

Data Pajak:

• NPWP
• Status PTKP

Data Kepegawaian:

• Jabatan, departemen
• Tanggal bergabung
• Tipe (Tetap/Kontrak)

Data Bank:

• Nama bank
• Nomor rekening

Data BPJS:

• No. BPJS Kesehatan
• No. BPJS Ketenagakerjaan

3. Klik Simpan

Assign Komponen Gaji ke Karyawan

1. Buka detail karyawan
2. Tab Komponen Gaji
3. Klik Tambah Komponen
4. Pilih komponen, isi nilai, tanggal efektif, dan tanggal berakhir (opsional)
5. Klik Simpan

Satu komponen bisa di-assign lebih dari satu kali ke karyawan yang sama, selama periode tidak tumpang tindih. Ini berguna untuk mencatat perubahan gaji:

• Gaji Pokok Rp 5.000.000 (1 Jan 2025 – 30 Apr 2025)
• Gaji Pokok Rp 6.000.000 (1 Mei 2025 – seterusnya)

Jika tanggal berakhir tidak diisi, assignment berlaku tanpa batas waktu. Sistem akan menolak assignment baru yang periodenya tumpang tindih dengan assignment yang sudah ada.

---

Gunakan Fitur Payroll Untuk:

✅ Gaji karyawan tetap/kontrak dengan kewajiban BPJS ✅ Perusahaan wajib potong PPh 21 ✅ Butuh bukti potong 1721-A1 untuk karyawan ✅ Karyawan perlu akses slip gaji online ✅ Tracking komponen gaji detail (tunjangan, potongan)

Gunakan Transaksi "Bayar Beban Gaji" Untuk:

✅ Bayar kontraktor lepas (tanpa BPJS/PPh 21) ✅ Bonus di luar payroll reguler ✅ Penarikan dana pemilik (bukan gaji karyawan) ✅ Pembayaran ad-hoc yang tidak perlu slip gaji

Perbedaan Akuntansi

Aspek	Fitur Payroll	Transaksi Simple
Jurnal	5 baris (pisah hutang)	2 baris (langsung bayar)
Beban	Gaji bruto + BPJS perusahaan	Nominal transfer saja
Kewajiban	Hutang Gaji, BPJS, PPh 21	Tidak ada hutang
Kalkulasi	Otomatis BPJS + PPh 21	Manual
Tax compliance	Otomatis hitung & lapor	Tanggung jawab manual
Slip gaji	Generate otomatis	Tidak ada
Bukti potong	Generate 1721-A1	Tidak ada

Contoh Jurnal: Payroll vs Simple

Fitur Payroll (otomatis):

Dr. Beban Gaji              30.000.000
Dr. Beban BPJS Perusahaan    3.432.000
    Cr. Hutang Gaji             26.250.000
    Cr. Hutang BPJS              6.432.000
    Cr. Hutang PPh 21              750.000

Transaksi Simple:

Dr. Beban Gaji              10.000.000
    Cr. Bank                    10.000.000

Kesimpulan: Gunakan fitur payroll untuk karyawan tetap. Gunakan transaksi simple hanya untuk pembayaran ad-hoc yang tidak perlu tracking BPJS/PPh 21.

---

Melihat Daftar Payroll

Buka menu Penggajian > Payroll.

Membuat Payroll Baru

1. Klik Payroll Baru

2. Isi:
   • Periode (bulan/tahun)
   • Tanggal pembayaran
3. Klik Buat
4. Sistem generate slip gaji untuk semua karyawan aktif

Workflow Payroll

DRAFT → CALCULATED → APPROVED → POSTED

Status	Aksi
DRAFT	Edit komponen individual
CALCULATED	Review perhitungan
APPROVED	Siap bayar
POSTED	Jurnal gaji dibuat

Melihat Detail Payroll

Klik payroll untuk melihat detail:

Informasi per karyawan:

• Gaji pokok
• Tunjangan (jabatan, kehadiran, makan, transport)
• Total pendapatan (bruto)
• BPJS Karyawan
• PPh 21
• Total potongan
• Gaji bersih (take home pay)

Posting Payroll

1. Pastikan status APPROVED
2. Klik Posting
3. Sistem membuat jurnal:

   Dr. Beban Gaji              xxx
   Dr. Beban BPJS Perusahaan   xxx
       Cr. Hutang Gaji             xxx
       Cr. Hutang BPJS             xxx
       Cr. Hutang PPh 21           xxx  ← hanya jika PPh 21 > 0
   

Catatan: Baris jurnal dengan nilai nol otomatis dilewatkan. Untuk karyawan UMKM dengan gaji rendah (PPh 21 = 0), jurnal hanya berisi 4 baris tanpa Hutang PPh 21.

Membayar Gaji

Setelah transfer ke rekening karyawan:

1. Buka menu Transaksi > Transaksi Baru
2. Pilih template Bayar Gaji
3. Isi jumlah total gaji bersih
4. Posting

Jurnal:

Dr. Hutang Gaji             xxx
    Cr. Bank                    xxx

---

Setelah posting payroll, ada 3 kewajiban yang harus dibayar:

1. Bayar Gaji ke Karyawan

Kapan: 1-5 hari kerja setelah akhir bulan Template: Bayar Hutang Gaji

1. Buka menu Transaksi > Transaksi Baru
2. Pilih template Bayar Hutang Gaji
3. Isi:
   • Tanggal pembayaran
   • Jumlah: Total gaji bersih (dari payroll detail)
   • Deskripsi: "Transfer gaji [bulan] [tahun]"
   • Referensi: Nomor transaksi bank
4. Pilih akun bank
5. Klik Simpan & Posting

Jurnal:

Dr. Hutang Gaji             xxx
    Cr. Bank                    xxx

2. Bayar BPJS ke Institusi

Kapan: Maksimal tanggal 10 bulan berikutnya Template: Bayar Hutang BPJS

1. Buka menu Transaksi > Transaksi Baru
2. Pilih template Bayar Hutang BPJS
3. Isi:
   • Tanggal pembayaran (maks tgl 10)
   • Jumlah: Total BPJS (perusahaan + karyawan)
   • Deskripsi: "Pembayaran BPJS [bulan] [tahun]"
   • Referensi: Nomor billing BPJS
4. Pilih akun bank
5. Klik Simpan & Posting

Jurnal:

Dr. Hutang BPJS             xxx
    Cr. Bank                    xxx

Catatan: Bayar ke BPJS Kesehatan dan BPJS Ketenagakerjaan melalui e-DABU atau virtual account.

3. Setor PPh 21 ke Kas Negara

Catatan: Jika PPh 21 = 0 (semua karyawan di bawah threshold TER), tidak ada hutang PPh 21 yang perlu disetor. SPT Masa PPh 21 nihil tetap wajib dilaporkan.

Kapan: Maksimal tanggal 10 bulan berikutnya Template: Setor PPh 21

1. Buka menu Transaksi > Transaksi Baru
2. Pilih template Setor PPh 21
3. Isi:
   • Tanggal penyetoran (maks tgl 10)
   • Jumlah: Total PPh 21 yang dipotong
   • Deskripsi: "Penyetoran PPh 21 [bulan] [tahun]"
   • Referensi: Nomor bukti setor (BPN)
4. Pilih akun bank
5. Klik Simpan & Posting

Jurnal:

Dr. Hutang PPh 21           xxx
    Cr. Bank                    xxx

Catatan: Bayar melalui e-Billing DJP, lalu lapor SPT Masa PPh 21 maks tanggal 20.

Timeline Kewajiban Payroll

Tanggal	Aktivitas	Template	Deadline
25-31	Posting payroll (jurnal dibuat)	Post Gaji Bulanan	Akhir bulan
1-5	Transfer gaji ke rekening karyawan	Bayar Hutang Gaji	-
Maks 10	Bayar BPJS ke institusi	Bayar Hutang BPJS	Wajib
Maks 10	Setor PPh 21 ke kas negara	Setor PPh 21	Wajib
Maks 20	Lapor SPT Masa PPh 21	(Eksternal DJP)	Wajib

---

Metode Perhitungan: TER (PMK 168/2023)

Aplikasi menggunakan metode TER (Tarif Efektif Rata-rata) sesuai PMK 168/2023, berlaku mulai Januari 2024.

Januari–November: PPh 21 bulanan = Gaji Bruto × Tarif TER

Desember: Rekonsiliasi tahunan — PPh 21 Desember = PPh 21 terutang setahun (tarif progresif PP 58/2023) dikurangi total PPh 21 Jan–Nov (TER).

Kategori TER

Status PTKP menentukan kategori TER:

Kategori	Status PTKP
A	TK/0, TK/1, K/0
B	TK/2, TK/3, K/1, K/2
C	K/3, K/I/0, K/I/1, K/I/2, K/I/3

Tarif TER ditentukan berdasarkan bracket penghasilan bruto bulanan dalam kategori tersebut (lihat PMK 168/2023 Lampiran A/B/C).

PPh 21 = 0 untuk Gaji Rendah

Untuk karyawan dengan gaji bruto di bawah batas bracket TER terendah, tarif TER = 0% sehingga PPh 21 = Rp 0. Ini umum terjadi di UMKM dengan gaji karyawan di bawah Rp 5.400.000/bulan (Kategori A) atau Rp 6.200.000/bulan (Kategori B).

Saat posting payroll dengan PPh 21 = 0, sistem otomatis melewatkan baris jurnal Hutang PPh 21 karena jurnal dengan nilai nol tidak bermakna. Jurnal yang dihasilkan hanya berisi baris dengan nilai > 0.

Kewajiban setor PPh 21 dan lapor SPT Masa PPh 21 tetap berlaku meskipun nilainya nihil.

Contoh Perhitungan

Karyawan dengan status K/2, gaji bruto Rp 11.253.000:

• Kategori TER: B
• Tarif TER: 2,50%
• PPh 21 bulanan: Rp 11.253.000 × 2,50% = Rp 281.325

Kalkulator PPh 21

Buka menu Penggajian > Kalkulator PPh 21.

1. Masukkan:
   • Gaji bruto bulanan
   • Status PTKP
2. Sistem menghitung:
   • Kategori TER (A / B / C)
   • Tarif TER berdasarkan bracket penghasilan
   • PPh 21 bulanan (Bruto × Tarif TER)

Referensi

• PMK 168/2023 — Tarif Efektif Rata-rata PPh 21
• PP 58/2023 — Rekonsiliasi tahunan (tarif progresif)
• PTKP per status (lihat Perpajakan)

---

Generate Bukti Potong Tahunan (1721-A1)

1. Buka menu Penggajian > Bukti Potong
2. Pilih tahun pajak
3. Pilih karyawan (atau semua)
4. Klik Generate
5. Download PDF

Isi Bukti Potong

• Identitas pemotong (perusahaan)
• Identitas penerima (karyawan)
• Rincian penghasilan bruto
• BPJS dan biaya jabatan
• Penghasilan neto
• PTKP
• PKP
• PPh 21 terutang
• PPh 21 dipotong

---

Skenario

Perusahaan IT memiliki 3 karyawan:

• Budi Santoso - Developer, gaji Rp 10.000.000
• Dewi Lestari - Designer, gaji Rp 10.000.000
• Agus Wijaya - Project Manager, gaji Rp 10.000.000

Data Payroll

Item	Rumus	Jumlah
Gaji Bruto	3 × Rp 10.000.000	Rp 30.000.000
BPJS Perusahaan	Kes 4% + TK (JHT 3.7%, JKK 0.24%, JKM 0.3%, JP 2%)	Rp 3.432.000
BPJS Karyawan	Kes 1% + JHT 2% + JP 1%	Rp 3.000.000
PPh 21	Progresif setelah PTKP	Rp 750.000
Gaji Bersih	Bruto - BPJS Karyawan - PPh 21	Rp 26.250.000

Langkah 1: Posting Payroll (31 Januari 2025)

1. Buka Penggajian > Payroll
2. Klik payroll bulan Januari
3. Pastikan status APPROVED
4. Klik Posting

Jurnal Otomatis:

Dr. Beban Gaji                   30.000.000
Dr. Beban BPJS Perusahaan         3.432.000
    Cr. Hutang Gaji                  26.250.000
    Cr. Hutang BPJS                   6.432.000 (perusahaan + karyawan)
    Cr. Hutang PPh 21                   750.000

Penjelasan:

• Beban total perusahaan: Rp 33.432.000 (masuk P&L bulan Januari)
• Kewajiban total: Rp 33.432.000 (hutang di neraca)
• Uang belum keluar dari bank (masih status hutang)

Langkah 2: Bayar Gaji (1 Februari 2025)

1. Buka Transaksi > Transaksi Baru
2. Pilih template Bayar Hutang Gaji
3. Isi:
   • Jumlah: Rp 26.250.000
   • Deskripsi: "Transfer gaji Januari 2025"
   • Pilih Bank BCA
4. Klik Simpan & Posting

Jurnal:

Dr. Hutang Gaji                  26.250.000
    Cr. Bank BCA                     26.250.000

Efek:

• ✅ Hutang Gaji lunas
• ✅ Karyawan terima transfer
• ⏳ Hutang BPJS masih Rp 6.432.000
• ⏳ Hutang PPh 21 masih Rp 750.000

Langkah 3: Bayar BPJS (10 Februari 2025)

1. Buka Transaksi > Transaksi Baru
2. Pilih template Bayar Hutang BPJS
3. Isi:
   • Jumlah: Rp 6.432.000
   • Deskripsi: "Pembayaran BPJS Januari 2025"
   • Referensi: Nomor billing BPJS
   • Pilih Bank BCA
4. Klik Simpan & Posting

Jurnal:

Dr. Hutang BPJS                   6.432.000
    Cr. Bank BCA                      6.432.000

Efek:

• ✅ Hutang BPJS lunas
• ✅ Kewajiban BPJS selesai
• ⏳ Hutang PPh 21 masih Rp 750.000

Langkah 4: Setor PPh 21 (10 Februari 2025)

1. Buka Transaksi > Transaksi Baru
2. Pilih template Setor PPh 21
3. Isi:
   • Jumlah: Rp 750.000
   • Deskripsi: "Penyetoran PPh 21 Januari 2025"
   • Referensi: Nomor BPN dari e-Billing
   • Pilih Bank BCA
4. Klik Simpan & Posting

Jurnal:

Dr. Hutang PPh 21                   750.000
    Cr. Bank BCA                        750.000

Efek:

• ✅ Hutang PPh 21 lunas
• ✅ Semua kewajiban payroll selesai

Ringkasan Kas Keluar

Tanggal	Item	Bank BCA	Status
1 Feb	Transfer gaji	(Rp 26.250.000)	✅
10 Feb	Bayar BPJS	(Rp 6.432.000)	✅
10 Feb	Setor PPh 21	(Rp 750.000)	✅
Total	Kas Keluar	(Rp 33.432.000)	-

Validasi: Total kas keluar = Total beban payroll ✅ (akuntansi akrual benar!)

Langkah 5: Lapor SPT Masa PPh 21 (20 Februari 2025)

1. Login ke DJP Online (pajak.go.id)
2. Pilih e-Filing > SPT Masa PPh 21
3. Input data dari aplikasi:
   • Jumlah pegawai: 3 orang
   • PPh 21 dipotong: Rp 750.000
   • PPh 21 disetor: Rp 750.000 (lihat dari jurnal Setor PPh 21)
   • Nomor BPN: Dari referensi transaksi
4. Submit SPT

Catatan: Aplikasi belum generate SPT otomatis, input manual ke DJP Online.

---

REST API tersedia untuk integrasi penggajian dengan sistem eksternal.

Komponen Gaji

GET    /api/salary-components           — daftar komponen aktif
POST   /api/salary-components           — buat komponen baru
PUT    /api/salary-components/{id}       — update komponen
DELETE /api/salary-components/{id}       — nonaktifkan komponen

Karyawan

GET    /api/employees                    — daftar karyawan (filter: active, status)
POST   /api/employees                    — buat karyawan
GET    /api/employees/{id}               — detail dengan komponen gaji
PUT    /api/employees/{id}               — update data karyawan
POST   /api/employees/{id}/salary-components    — assign komponen gaji (endDate opsional)
PUT    /api/employees/{id}/salary-components/{componentId}  — update assignment

Payroll Run

GET    /api/payroll                      — daftar payroll (filter: year, status)
POST   /api/payroll                      — buat payroll baru (DRAFT)
GET    /api/payroll/{id}                 — detail dengan semua detail karyawan
POST   /api/payroll/{id}/calculate       — hitung PPh 21 (TER Jan-Nov / rekonsiliasi Des), set CALCULATED
POST   /api/payroll/{id}/approve         — set APPROVED
POST   /api/payroll/{id}/post            — posting ke jurnal
DELETE /api/payroll/{id}                 — hapus (hanya DRAFT)

1721-A1 dan Ringkasan PPh 21

GET /api/payroll/employees/{id}/1721-a1?year=2025  — data 1721-A1 per karyawan
GET /api/payroll/pph21/summary?year=2025           — ringkasan PPh 21 seluruh karyawan

Response 1721-A1 berisi:

• Data karyawan (NPWP, NIK, PTKP, masa kerja)
• Perhitungan (penghasilan bruto, biaya jabatan, neto, PTKP, PKP, PPh 21 terutang)
• Breakdown bulanan (gross salary dan PPh 21 per bulan)

Jadwal Payroll Otomatis

GET    /api/payroll/schedule             — lihat konfigurasi jadwal
POST   /api/payroll/schedule             — buat/update jadwal
DELETE /api/payroll/schedule             — hapus jadwal

Request body:

{
  "dayOfMonth": 28,
  "baseSalary": 5000000,
  "jkkRiskClass": 1,
  "autoCalculate": true,
  "autoApprove": false,
  "active": true
}

• dayOfMonth: Tanggal setiap bulan untuk auto-create payroll (1–28)
• baseSalary: Gaji pokok yang digunakan untuk kalkulasi
• jkkRiskClass: Kelas risiko JKK (1–5)
• autoCalculate: Otomatis hitung BPJS + PPh 21 setelah create
• autoApprove: Otomatis approve setelah kalkulasi
• Posting selalu manual — posting berarti pembayaran sudah dilakukan

Scheduler berjalan harian pukul 06:30. Saat startup, sistem juga memeriksa bulan sebelumnya dan bulan berjalan untuk mengejar ketinggalan jika server sempat mati.

Skenario: Retrofit Data Payroll 2025

1. Buat komponen gaji: POST /api/salary-components (GAJI_POKOK, EARNING, isTaxable=true)
2. Buat karyawan: POST /api/employees (nama, NPWP, NIK, PTKP, hireDate)
3. Assign komponen dengan dua periode:
   • POST /api/employees/{id}/salary-components (amount=11253000, effectiveDate=2025-01-01, endDate=2025-04-30)
   • POST /api/employees/{id}/salary-components (amount=5000000, effectiveDate=2025-05-01)
4. Buat 12 payroll run: POST /api/payroll (periode 2025-01 s/d 2025-12)
5. Hitung masing-masing: POST /api/payroll/{id}/calculate
6. Generate 1721-A1: GET /api/payroll/employees/{id}/1721-a1?year=2025

Autentikasi: Bearer token dengan scope tax-export:read.

---

Klasifikasi Industri

Kategori	Karakteristik	Contoh
Jasa	Menjual keahlian/waktu	Konsultan, Software House
Dagang	Beli-jual barang	Toko online, Retailer
Manufaktur	Produksi barang	Pabrik, F&B Production
Pendidikan	Layanan edukasi	Universitas, Kursus

Perbedaan Utama

Aspek	Jasa	Dagang	Manufaktur
Produk	Tidak berwujud	Barang jadi	Barang diproduksi
Inventory	Tidak ada	Ada (barang dagang)	Ada (bahan baku + WIP + barang jadi)
HPP	Tidak ada	Harga beli barang	Biaya produksi
Revenue recognition	Saat jasa selesai	Saat barang diserahkan	Saat barang diserahkan

---

1. Industri Jasa (IT Services PKP)

Karakteristik:

• Pendapatan berbasis proyek atau retainer
• Tidak ada persediaan barang
• Biaya utama: gaji karyawan
• Wajib PPN (PKP)

Fitur utama:

• Client Management
• Project Management dengan Milestone
• Invoice dan Penagihan
• Profitabilitas per Klien/Proyek

Seed pack: it-service

Lihat: Industri Jasa

2. Industri Dagang (Online Seller)

Karakteristik:

• Pendapatan dari penjualan barang
• Persediaan dengan metode FIFO atau Weighted Average
• HPP dihitung dari harga beli
• Multi-channel (Tokopedia, Shopee, dll)

Fitur utama:

• Product Management
• Inventory Transactions (Purchase, Sale, Adjustment)
• Stock Reports
• Profitabilitas Produk

Seed pack: online-seller

Lihat: Industri Dagang

3. Industri Manufaktur (Coffee Shop) [TBD]

Karakteristik:

• Produksi barang dari bahan baku
• Bill of Materials (BOM)
• Kalkulasi HPP produksi
• Persediaan multi-level (bahan baku, WIP, barang jadi)

Fitur utama:

• BOM (Bill of Materials)
• Production Orders
• Cost Calculation
• Inventory multi-level

Seed pack: coffee-shop

Lihat: Industri Manufaktur

4. Industri Pendidikan (Campus) [TBD]

Karakteristik:

• Pendapatan berbasis semester/tahun ajaran
• Tagihan ke mahasiswa (SPP, Uang Pangkal)
• Beasiswa dan potongan
• Piutang mahasiswa dengan cicilan

Fitur utama:

• Student Management
• Billing (SPP, Praktikum, Wisuda)
• Payment dan Installments
• Scholarship Management
• Receivables Aging per Student

Seed pack: campus

Lihat: Industri Pendidikan

---

Chart of Accounts

Setiap industri memiliki COA yang disesuaikan:

Industri	Akun Khusus
Jasa	WIP Proyek, Pendapatan Diterima Dimuka
Dagang	Persediaan Barang Dagang, HPP
Manufaktur	Bahan Baku, WIP, Barang Jadi, Overhead
Pendidikan	Piutang Mahasiswa, Pendapatan SPP

Template Transaksi

Template disesuaikan dengan alur bisnis industri:

Jasa:

• Pendapatan Jasa + PPN
• Terima DP Proyek
• Pengakuan Pendapatan Milestone

Dagang:

• Pembelian Barang Dagang
• Penjualan dengan HPP
• Retur Pembelian/Penjualan

Manufaktur:

• Pembelian Bahan Baku
• Production Order
• Barang Jadi Masuk Gudang

Pendidikan:

• Tagihan SPP
• Terima Pembayaran SPP
• Beasiswa

Laporan Khusus

Industri	Laporan Khusus
Jasa	Profitabilitas Proyek, Profitabilitas Klien
Dagang	Kartu Stok, Valuasi Persediaan, Profitabilitas Produk
Manufaktur	Production Cost Report, BOM Costing
Pendidikan	Receivables Aging per Student, Revenue per Program

---

Ciri Khas

• Produk tidak berwujud - Menjual keahlian dan waktu
• Project-based - Pendapatan dari proyek dengan milestone
• Time & Material - Biaya berdasarkan jam kerja
• Retainer - Pendapatan berulang bulanan
• Tidak ada inventory - Tidak ada persediaan barang

Alur Bisnis Tipikal

Klien → Proposal → Kontrak → Proyek → Milestone → Invoice → Pembayaran

---

Melihat Daftar Klien

Buka menu Proyek > Klien di sidebar.

Fitur daftar klien:

• Pencarian — cari berdasarkan nama atau kode klien
• Filter status — tampilkan semua, hanya Aktif, atau hanya Nonaktif
• Paginasi — navigasi halaman via HTMX (tanpa reload)

Menambah Klien Baru

1. Klik Klien Baru di halaman daftar klien
2. Isi data klien:

Field	Keterangan	Wajib
Kode	Kode unik klien, misal CLT-001	Ya
Nama	Nama perusahaan/perorangan	Ya
Kontak	Nama contact person	Tidak
Email	Alamat email	Tidak
Telepon	Nomor telepon	Tidak
Alamat	Alamat lengkap	Tidak
Catatan	Catatan tambahan	Tidak

3. Isi data pajak (bagian Informasi Pajak):

Field	Keterangan
Tipe Identitas	NPWP untuk PKP, NIK untuk non-PKP
NPWP	Format: XX.XXX.XXX.X-XXX.XXX (15-16 digit)
NITKU	Nomor Identitas Tempat Kegiatan Usaha (22 karakter: NPWP + 6 digit kode cabang)
NIK	Nomor Induk Kependudukan (16 digit), untuk pembeli non-PKP

4. Klik Simpan

Data pajak klien (NPWP, NITKU) diperlukan untuk ekspor e-Faktur dan e-Bupot ke Coretax. Saat transaksi dicatat menggunakan template PPN, data counterparty pada detail pajak otomatis terisi dari data klien yang terhubung via proyek.

Detail Klien

Klik nama klien di daftar untuk membuka halaman detail. Informasi yang ditampilkan:

• Informasi Klien — kontak, email, telepon, alamat, catatan, tanggal dibuat
• Informasi Pajak — tipe identitas (NPWP/NIK), NPWP, NITKU, NIK
• Proyek — daftar proyek yang terhubung dengan klien (link ke detail proyek)
• Invoice — daftar invoice klien (nomor, tanggal, jatuh tempo, jumlah, status)
• Ringkasan Pajak — jumlah e-Faktur, e-Bupot, total DPP, total PPN, total PPh

Dari halaman detail, Anda dapat:

• Lihat Laporan — buka laporan statement klien
• Edit — ubah data klien
• Nonaktifkan/Aktifkan — ubah status aktif klien

Mengaktifkan/Menonaktifkan Klien

Klien yang tidak aktif tetap tersimpan di database tetapi tidak muncul di dropdown pemilihan klien. Untuk mengubah status:

1. Buka halaman detail klien
2. Klik Nonaktifkan (untuk menonaktifkan) atau Aktifkan (untuk mengaktifkan kembali)

Hak Akses

Permission	Fungsi
CLIENT_VIEW	Melihat daftar dan detail klien
CLIENT_CREATE	Menambah klien baru
CLIENT_EDIT	Mengubah data klien
CLIENT_DELETE	Menghapus klien

---

Melihat Daftar Proyek

Buka menu Proyek > Daftar Proyek.

Detail Proyek

Klik pada proyek untuk melihat detail. Informasi yang ditampilkan:

• Status proyek
• Progress milestone
• Total nilai kontrak
• Pendapatan yang sudah diakui
• Invoice yang sudah diterbitkan

Menambah Proyek Baru

1. Klik Proyek Baru

2. Isi:

   • Kode proyek
   • Nama proyek
   • Klien (pilih dari dropdown)
   • Nilai kontrak
   • Tanggal mulai & target selesai
   • Deskripsi

3. Tab Milestone - Tambah milestone:

   • Nama milestone
   • Bobot (%)
   • Target tanggal

4. Klik Simpan

Workflow Proyek

DRAFT → ACTIVE → COMPLETED

Status	Arti
DRAFT	Proyek belum dimulai
ACTIVE	Proyek sedang berjalan
COMPLETED	Proyek selesai

Update Progress Milestone

1. Buka detail proyek
2. Klik milestone
3. Update status:
   • Tanggal aktual selesai
   • Catatan
4. Klik Simpan

Saat milestone selesai, pendapatan dapat diakui proporsional sesuai bobot.

---

Template Standar

Template	Fungsi
Pendapatan Jasa + PPN	Pendapatan dengan PPN 11%
Pendapatan Jasa tanpa PPN	Pendapatan tanpa PPN
Terima DP Proyek	DP masuk Pendapatan Diterima Dimuka
Pengakuan Pendapatan	Recognize revenue dari DDM
Beban Operasional	Pengeluaran operasional

Melihat Template

Buka menu Pengaturan > Template.

Detail Template

---

Melihat Daftar Invoice

Buka menu Invoice > Daftar Invoice untuk melihat semua invoice yang telah dibuat.

Membuat Invoice

1. Klik Invoice Baru
2. Pilih klien
3. Pilih proyek (opsional)
4. Isi item invoice:
   • Deskripsi
   • Quantity
   • Harga satuan
5. Sistem menghitung:
   • Subtotal
   • PPN (jika PKP)
   • Total
6. Klik Simpan

Workflow Invoice

DRAFT → SENT → PAID

Mencatat Pembayaran Invoice

Saat klien membayar:

1. Buka invoice
2. Klik Terima Pembayaran
3. Isi:
   • Tanggal terima
   • Jumlah (bisa partial)
   • Rekening penerima
4. Klik Simpan

Jurnal yang dibuat:

Dr. Bank                    xxx
    Cr. Piutang Usaha           xxx

---

Laporan Profitabilitas Proyek

Buka menu Laporan > Profitabilitas Proyek untuk melihat analisis margin per proyek.

Metrik yang ditampilkan:

• Total revenue proyek
• Total cost (gaji, vendor, dll)
• Gross profit
• Profit margin (%)

Laporan Profitabilitas Klien

Buka menu Laporan > Profitabilitas Klien untuk melihat analisis revenue dan margin per klien.

Agregasi per klien:

• Total revenue dari klien
• Total cost
• Profit
• Jumlah proyek

---

Ciri Khas

• Jual barang jadi - Tidak ada proses produksi
• Inventory management - Persediaan barang dagang
• HPP (Harga Pokok Penjualan) - Biaya barang yang dijual
• Multi-channel - Marketplace, toko fisik, website

Alur Bisnis Tipikal

Supplier → Purchase → Inventory → Sale → Customer

---

Melihat Daftar Produk

Buka menu Inventori > Produk.

Menambah Produk Baru

1. Klik Produk Baru

2. Isi:
   • SKU (Stock Keeping Unit)
   • Nama produk
   • Kategori
   • Harga jual
   • Metode costing (FIFO / Weighted Average)
   • Akun persediaan
   • Akun HPP
3. Klik Simpan

Kategori Produk

Buka menu Inventori > Kategori.

---

FIFO (First In First Out)

Barang yang masuk lebih dulu, keluar lebih dulu.

Contoh:

Tanggal	Transaksi	Qty	Harga/Unit	Total
1 Jan	Beli	10	Rp 100.000	Rp 1.000.000
5 Jan	Beli	10	Rp 110.000	Rp 1.100.000
10 Jan	Jual	15	-	-

Perhitungan HPP (10 Jan):

• 10 unit dari pembelian 1 Jan @ Rp 100.000 = Rp 1.000.000
• 5 unit dari pembelian 5 Jan @ Rp 110.000 = Rp 550.000
• Total HPP = Rp 1.550.000

Sisa Stok:

• 5 unit @ Rp 110.000 = Rp 550.000

Weighted Average

Harga rata-rata tertimbang.

Contoh:

Tanggal	Transaksi	Qty	Harga/Unit	Total	Avg Cost
1 Jan	Beli	10	Rp 100.000	Rp 1.000.000	Rp 100.000
5 Jan	Beli	10	Rp 110.000	Rp 1.100.000	Rp 105.000
10 Jan	Jual	15	-	-	-

Perhitungan Average Cost (5 Jan):

• Total nilai: Rp 1.000.000 + Rp 1.100.000 = Rp 2.100.000
• Total qty: 10 + 10 = 20 unit
• Average = Rp 2.100.000 / 20 = Rp 105.000/unit

Perhitungan HPP (10 Jan):

• 15 unit @ Rp 105.000 = Rp 1.575.000

Sisa Stok:

• 5 unit @ Rp 105.000 = Rp 525.000

---

Contoh 1: Pembelian iPhone 15 Pro

Konteks: Toko Gadget Murah membeli 10 unit iPhone 15 Pro dari distributor resmi Erajaya.

Langkah 1: Buka Form Pembelian

Menu Inventori > Transaksi > Pembelian Baru

Langkah 2: Isi Data

• Tanggal: 5 Januari 2024
• Supplier: Erajaya
• Produk: iPhone 15 Pro (IP15PRO)
• Quantity: 10 unit
• Harga Beli: Rp 15.000.000/unit
• Total: Rp 150.000.000
• Referensi: PO-001
• Rekening: Bank BCA

Langkah 3: Simpan & Posting

Jurnal Otomatis:

Dr. 1.1.20 Persediaan Barang Dagang  Rp 150.000.000
    Cr. 1.1.01 Bank BCA                  Rp 150.000.000

Impact:

• Stok iPhone 15 Pro: 0 → 10 unit
• Nilai persediaan: +Rp 150.000.000
• Kas: -Rp 150.000.000

---

Contoh 2: Pembelian Samsung S24

Konteks: Membeli 20 unit Samsung Galaxy S24 dari Samsung Indonesia.

Data:

• Produk: Samsung Galaxy S24 (SGS24)
• Quantity: 20 unit
• Harga: Rp 12.000.000/unit
• Total: Rp 240.000.000
• Referensi: PO-002

Impact:

• Stok Samsung S24: 0 → 20 unit
• Nilai persediaan: +Rp 240.000.000
• Total persediaan: Rp 390.000.000

---

Contoh 3: Pembelian Accessories (USB-C Cable & Phone Case)

Konteks: Melengkapi stok accessories untuk bundling dengan smartphone.

Pembelian 1: USB-C Cable

• Produk: USB-C Cable (USBC)
• Quantity: 100 unit
• Harga: Rp 25.000/unit
• Total: Rp 2.500.000
• Referensi: PO-003

Pembelian 2: Phone Case

• Produk: Phone Case (CASE)
• Quantity: 200 unit
• Harga: Rp 15.000/unit
• Total: Rp 3.000.000
• Referensi: PO-004

Total Investasi Persediaan: Rp 395.500.000

---

Contoh 1: Penjualan iPhone via Tokopedia

Konteks: Terjual 5 unit iPhone 15 Pro via Tokopedia, harga jual Rp 19 juta/unit.

Langkah 1: Buka Form Penjualan

Menu Inventori > Transaksi > Penjualan Baru

Langkah 2: Isi Data

• Tanggal: 15 Januari 2024
• Channel: Tokopedia
• Produk: iPhone 15 Pro (IP15PRO)
• Quantity: 5 unit
• Harga Jual: Rp 19.000.000/unit
• Total: Rp 95.000.000
• Referensi: TOPED-001

Langkah 3: Sistem Hitung HPP (FIFO)

Sistem otomatis ambil dari layer pembelian:

• Layer 1 (PO-001): 10 unit @ Rp 15.000.000
• Keluar: 5 unit @ Rp 15.000.000
• HPP: Rp 75.000.000

Langkah 4: Simpan & Posting

Jurnal Otomatis (2 entries):

Entry 1: Revenue Recognition

Dr. 1.1.01 Bank BCA                 Rp 95.000.000
    Cr. 4.1.01 Penjualan                Rp 95.000.000

Entry 2: COGS Recognition

Dr. 5.1.01 HPP                      Rp 75.000.000
    Cr. 1.1.20 Persediaan               Rp 75.000.000

Impact:

• Stok iPhone 15 Pro: 10 → 5 unit
• Revenue: Rp 95.000.000
• HPP: Rp 75.000.000
• Gross Profit: Rp 20.000.000
• Margin: 21.1%

---

Contoh 2: Penjualan Samsung via Shopee

Konteks: Terjual 8 unit Samsung S24 via Shopee, harga Rp 14 juta/unit.

Data:

• Channel: Shopee
• Produk: Samsung S24 (SGS24)
• Quantity: 8 unit
• Harga Jual: Rp 14.000.000/unit
• Total: Rp 112.000.000
• Referensi: SHOPEE-001

HPP Calculation (FIFO):

• Layer 1 (PO-002): 20 unit @ Rp 12.000.000
• Keluar: 8 unit @ Rp 12.000.000
• HPP: Rp 96.000.000

Jurnal:

Dr. Bank                        Rp 112.000.000
    Cr. Penjualan                   Rp 112.000.000

Dr. HPP                         Rp  96.000.000
    Cr. Persediaan                  Rp  96.000.000

Impact:

• Stok Samsung S24: 20 → 12 unit
• Revenue: Rp 112.000.000
• HPP: Rp 96.000.000
• Gross Profit: Rp 16.000.000
• Margin: 14.3%

---

Contoh 3: Penjualan Accessories

Penjualan USB-C Cable via Tokopedia:

• Quantity: 30 unit @ Rp 50.000 = Rp 1.500.000
• HPP: 30 × Rp 25.000 = Rp 750.000
• Gross Profit: Rp 750.000 (50% margin)

Penjualan Phone Case via Shopee:

• Quantity: 50 unit @ Rp 35.000 = Rp 1.750.000
• HPP: 50 × Rp 15.000 = Rp 750.000
• Gross Profit: Rp 1.000.000 (57.1% margin)

---

Stok Barang

Buka menu Inventori > Stok.

Transaksi Inventori

Buka menu Inventori > Transaksi.

Laporan Saldo Stok

Buka menu Inventori > Laporan > Saldo Stok.

Laporan Mutasi Stok

Buka menu Inventori > Laporan > Mutasi Stok.

Menampilkan kartu stok per produk:

• Tanggal transaksi
• Tipe (masuk/keluar)
• Qty
• Harga
• Saldo running

---

Laporan Profitabilitas

Buka menu Inventori > Laporan > Profitabilitas Produk.

Metrik per produk:

• Total penjualan (revenue)
• Total HPP (cost)
• Gross profit
• Margin (%)

---

Ciri Khas

• Proses Produksi - Mengolah bahan baku menjadi barang jadi
• Bill of Materials (BOM) - Resep/formula produksi
• Production Orders - Perintah produksi dengan tracking cost
• Multi-stage Inventory - Bahan baku, WIP, dan barang jadi
• COGM (Cost of Goods Manufactured) - Harga pokok produksi
• Component Consumption - Konsumsi komponen saat produksi

Alur Bisnis Tipikal

Supplier → Raw Materials → Production → Finished Goods → Customer

Contoh Kasus: Kedai Kopi Nusantara

Kedai kopi & pastry yang memproduksi:

• Roti & pastry (Croissant, Roti Bakar Coklat)
• Menggunakan bahan baku: Tepung, Butter, Telur, Coklat, dll
• Produksi batch sesuai BOM
• Jual hasil produksi ke konsumen

---

Konsep BOM

BOM adalah resep/formula produksi yang mendefinisikan:

• Barang jadi yang dihasilkan
• Komponen (bahan baku) yang dibutuhkan
• Kuantitas setiap komponen
• Output quantity per batch

Contoh: BOM Croissant

Output: 24 pcs Croissant

Komponen:

• Tepung Terigu: 3.00 kg
• Butter: 1.20 kg
• Telur: 24.00 butir
• Ragi: 50.00 gram
• Garam: 30.00 gram

Melihat Daftar BOM

Buka menu Inventori > Bill of Materials.

Detail BOM

Klik pada BOM untuk melihat detail:

Informasi yang ditampilkan:

• Kode BOM: BOM-CRS
• Produk Output: Croissant
• Output Quantity: 24 pcs per batch
• Daftar Komponen: Tabel dengan nama komponen, quantity, dan satuan

Menambah BOM Baru

1. Klik BOM Baru

2. Tab Informasi Dasar:

   • Kode BOM (unik)
   • Nama BOM (deskriptif)
   • Produk Jadi (pilih dari dropdown)
   • Output Quantity (berapa unit yang dihasilkan per batch)
   • Status (Aktif/Nonaktif)

3. Tab Komponen:

   • Klik Tambah Komponen
   • Pilih produk (bahan baku)
   • Isi quantity yang dibutuhkan
   • Ulangi untuk semua komponen

4. Klik Simpan

Contoh: BOM Roti Bakar Coklat

Output: 20 pcs

Komponen:

• Tepung Terigu: 2.50 kg
• Butter: 1.00 kg
• Telur: 20.00 butir
• Ragi: 40.00 gram
• Garam: 25.00 gram
• Coklat Blok: 0.80 kg

Detail BOM Croissant

Detail BOM Roti Bakar Coklat

---

Konsep Production Order

Production Order adalah perintah produksi untuk membuat barang jadi sesuai BOM.

Workflow:

DRAFT → IN_PROGRESS → COMPLETED

Status	Arti	Aksi
DRAFT	Order belum dimulai	Edit, Start, Delete
IN_PROGRESS	Produksi sedang berjalan	Complete, Cancel
COMPLETED	Produksi selesai	View only (sudah ada transaksi inventory)

Melihat Daftar Production Order

Buka menu Inventori > Production Orders.

Detail Production Order

Klik pada order untuk melihat detail:

Informasi yang ditampilkan:

• No. Order: PROD-001
• Tanggal Order: Kapan order dibuat
• BOM: BOM yang digunakan
• Produk Jadi: Croissant
• Jumlah Produksi: 24 pcs
• Status: COMPLETED
• Ringkasan Biaya: (tampil setelah COMPLETED)
  • Total Biaya Komponen: Rp 106.920
  • Jumlah Produksi: 24 pcs
  • Harga Pokok per Unit: Rp 4.455

Tabel Komponen yang Dibutuhkan:

• Menampilkan semua komponen dari BOM
• Kebutuhan per BOM
• Total kebutuhan (dikalikan quantity order)

Membuat Production Order Baru

1. Klik Production Order Baru

2. Isi data:

   • No. Order: Otomatis (PROD-XXX)
   • Tanggal Order: Tanggal pembuatan order
   • BOM: Pilih BOM yang akan diproduksi
   • Quantity: Berapa batch yang akan diproduksi
   • Target Selesai: (opsional) Target completion date
   • Catatan: (opsional) Informasi tambahan

3. Klik Simpan → Status: DRAFT

Workflow Produksi

1. Start Production

Dari halaman detail order (status DRAFT):

1. Klik Mulai Produksi
2. Konfirmasi: "Pastikan semua komponen tersedia"
3. Status berubah: DRAFT → IN_PROGRESS

Tidak ada transaksi inventory pada tahap ini.

2. Complete Production

Dari halaman detail order (status IN_PROGRESS):

1. Klik Selesaikan Produksi
2. Konfirmasi: "Komponen akan dikurangi dari stok dan produk jadi akan ditambahkan"
3. Status berubah: IN_PROGRESS → COMPLETED

Transaksi Inventory Otomatis:

a. PRODUCTION_OUT - Konsumsi komponen:

- Tepung Terigu: -3.00 kg @ Rp 12.000 = -Rp 36.000
- Butter: -1.20 kg @ Rp 45.000 = -Rp 54.000
- Telur: -24 butir @ Rp 1.500 = -Rp 36.000
- Ragi: -50 gram @ Rp 30 = -Rp 1.500
- Garam: -30 gram @ Rp 14 = -Rp 420
Total: Rp 127.920

b. PRODUCTION_IN - Penerimaan barang jadi:

+ Croissant: 24 pcs @ Rp 4.455 = Rp 106.920

Unit Cost Calculation:

Unit Cost = Total Component Cost / Output Quantity
Unit Cost = Rp 106.920 / 24 pcs = Rp 4.455/pcs

Jurnal Otomatis:

Dr. 1.1.21 Persediaan Barang Jadi - Roti    Rp 106.920
    Cr. 1.1.20 Persediaan Bahan Baku - Roti    Rp 106.920

---

Panduan lengkap untuk bisnis manufaktur sederhana (Home Industry, Bakery, Coffee Shop, Catering).

Manajemen Produk & Kategori

Kategori Produk

Buka menu Inventori > Kategori Produk.

Kategori Tipikal Manufaktur:

Kategori	Jenis	Contoh
Bahan Baku Kopi	Raw Material	Biji Kopi, Susu, Gula Aren
Bahan Baku Roti	Raw Material	Tepung, Butter, Telur
Produk Jadi - Roti	Finished Goods	Croissant, Roti Bakar

Daftar Produk

Buka menu Inventori > Produk.

Produk dibagi menjadi:

1. Bahan Baku - Input untuk produksi (Tepung, Butter, Telur, Coklat)
2. Barang Jadi - Output produksi (Croissant, Roti Bakar Coklat)

Menambah Produk Baru

1. Klik Produk Baru

2. Isi data produk:

   • Kode: SKU unik (contoh: TEPUNG-TERIGU)
   • Nama: Nama produk
   • Kategori: Pilih kategori (Bahan Baku / Produk Jadi)
   • Satuan: pcs, kg, liter, gram
   • Metode Costing:
     • FIFO (First In First Out)
     • WEIGHTED_AVERAGE (Rata-rata Tertimbang)
   • Track Inventory: ✓ (aktifkan untuk tracking stok)
   • Minimum Stock: Alert stok rendah
   • Harga Jual: Untuk barang jadi
   • Akun:
     • Inventory Account (1.1.20 - Persediaan Bahan Baku / 1.1.21 - Persediaan Barang Jadi)
     • COGS Account (5.1.01 - HPP Bahan Baku / 5.2.01 - HPP Barang Jadi)
     • Sales Account (4.1.02 - Pendapatan Penjualan)

3. Klik Simpan

Perbedaan Bahan Baku vs Barang Jadi:

Aspek	Bahan Baku	Barang Jadi
Inventory Account	1.1.20 Persediaan Bahan Baku	1.1.21 Persediaan Barang Jadi
COGS Account	5.1.01 HPP Bahan Baku	5.2.01 HPP Barang Jadi
Harga Jual	0 (tidak dijual langsung)	Sesuai harga pasar
Digunakan dalam	BOM sebagai komponen	BOM sebagai output

---

Transaksi Inventory

Daftar Transaksi

Buka menu Inventori > Transaksi.

Tipe Transaksi:

Tipe	Arti	Direction	Digunakan Untuk
PURCHASE	Pembelian	IN (+)	Beli bahan baku dari supplier
SALE	Penjualan	OUT (-)	Jual barang jadi ke customer
PRODUCTION_IN	Produksi Masuk	IN (+)	Terima barang jadi dari produksi
PRODUCTION_OUT	Produksi Keluar	OUT (-)	Konsumsi komponen untuk produksi
ADJUSTMENT_IN	Penyesuaian Masuk	IN (+)	Koreksi stok (selisih fisik)
ADJUSTMENT_OUT	Penyesuaian Keluar	OUT (-)	Koreksi stok (kerusakan, expired)

Filter Transaksi

Gunakan filter untuk mempersempit pencarian:

• Produk: Pilih produk tertentu
• Tipe Transaksi: Pilih tipe (PURCHASE, SALE, PRODUCTION_IN, dll)
• Periode: Tanggal mulai - tanggal akhir

Pembelian Bahan Baku

Contoh: Pembelian Tepung Terigu

Menu Inventori > Transaksi > Pembelian Baru

Data:

• Tanggal: 1 Januari 2024
• Supplier: Bogasari
• Produk: Tepung Terigu (TEPUNG-TERIGU)
• Quantity: 50 kg
• Harga Beli: Rp 12.000/kg
• Total: Rp 600.000
• Referensi: PO-001

Jurnal Otomatis:

Dr. 1.1.20 Persediaan Bahan Baku - Roti  Rp 600.000
    Cr. 1.1.01 Bank BCA                      Rp 600.000

Impact:

• Stok Tepung Terigu: 0 → 50 kg
• Nilai persediaan: +Rp 600.000
• Kas: -Rp 600.000

Penjualan Barang Jadi

Contoh: Penjualan Croissant

Menu Inventori > Transaksi > Penjualan Baru

Data:

• Tanggal: 10 Januari 2024
• Customer: Walk-in customer
• Produk: Croissant (CROISSANT)
• Quantity: 15 pcs
• Harga Jual: Rp 25.000/pcs
• Total: Rp 375.000
• Referensi: INV-001

Sistem hitung HPP otomatis (FIFO/Weighted Average):

• 15 pcs @ Rp 4.455 = Rp 66.825

Jurnal Otomatis:

Dr. 1.1.01 Bank BCA                          Rp 375.000
    Cr. 4.1.02 Pendapatan Penjualan Roti         Rp 375.000

Dr. 5.2.01 HPP Barang Jadi - Roti            Rp 66.825
    Cr. 1.1.21 Persediaan Barang Jadi - Roti    Rp 66.825

Margin Analysis:

• Revenue: Rp 375.000
• COGS: Rp 66.825
• Gross Profit: Rp 308.175
• Margin: 82.18%

---

Stok Barang

Melihat Saldo Stok

Buka menu Inventori > Stok Barang.

Informasi yang ditampilkan:

• Kode Produk: SKU
• Nama Produk: Nama produk
• Kategori: Kategori produk
• Stok: Quantity tersedia
• Biaya Rata-rata: Average cost per unit
• Total Nilai: Quantity × Average Cost
• Status: Normal / Stok Rendah (jika di bawah minimum)

Contoh Stok Setelah Produksi & Penjualan:

Produk	Stok	Avg Cost	Total Nilai
Croissant	9 pcs	Rp 4.455	Rp 40.095
Roti Bakar Coklat	8 pcs	Rp 5.123	Rp 40.984
Tepung Terigu	44.50 kg	Rp 12.000	Rp 534.000
Butter	46.60 kg	Rp 45.000	Rp 2.097.000

Detail Stok per Produk

Klik pada produk untuk melihat:

• Informasi produk
• Saldo stok saat ini
• History transaksi
• FIFO layers (jika menggunakan FIFO)

---

Contoh Skenario Lengkap: Produksi Croissant

Langkah 1: Pembelian Bahan Baku

Beli semua komponen yang dibutuhkan:

1. Tepung Terigu: 50 kg @ Rp 12.000 = Rp 600.000
2. Butter: 50 kg @ Rp 45.000 = Rp 2.250.000
3. Telur: 100 butir @ Rp 1.500 = Rp 150.000
4. Ragi: 500 gram @ Rp 30 = Rp 15.000
5. Garam: 1000 gram @ Rp 14 = Rp 14.000

Total Investasi: Rp 3.029.000

Langkah 2: Buat BOM

BOM: BOM-CRS - Croissant

Output: 24 pcs

Komponen:

• Tepung: 3.00 kg
• Butter: 1.20 kg
• Telur: 24 butir
• Ragi: 50 gram
• Garam: 30 gram

Langkah 3: Buat Production Order

Order: PROD-001

• BOM: BOM-CRS
• Quantity: 24 pcs (1 batch)
• Status: DRAFT

Langkah 4: Mulai Produksi

Klik Mulai Produksi → Status: IN_PROGRESS

(Tidak ada transaksi inventory pada tahap ini)

Langkah 5: Selesaikan Produksi

Klik Selesaikan Produksi → Status: COMPLETED

Transaksi Otomatis:

PRODUCTION_OUT (konsumsi):

• Tepung: -3.00 kg
• Butter: -1.20 kg
• Telur: -24 butir
• Ragi: -50 gram
• Garam: -30 gram

PRODUCTION_IN (hasil):

• Croissant: +24 pcs @ Rp 4.455

Biaya Produksi:

• Total Component Cost: Rp 106.920
• Unit Cost: Rp 4.455/pcs

Langkah 6: Jual Barang Jadi

Jual 15 pcs Croissant @ Rp 25.000 = Rp 375.000

Auto-COGS:

• HPP: 15 × Rp 4.455 = Rp 66.825
• Gross Profit: Rp 308.175
• Margin: 82.18%

Sisa Stok:

• Croissant: 24 - 15 = 9 pcs @ Rp 4.455

---

Best Practices Manufaktur

1. Setup BOM yang Akurat

• Ukur komponen dengan presisi - Pastikan quantity di BOM sesuai dengan realita produksi
• Update BOM jika ada perubahan resep - Jangan biarkan BOM kadaluarsa
• Dokumentasi - Tambahkan catatan/deskripsi untuk BOM yang kompleks

2. Production Order Workflow

• Pastikan stok cukup sebelum start production - Cek stok komponen terlebih dahulu
• Complete production tepat waktu - Jangan biarkan order IN_PROGRESS terlalu lama
• Track tanggal completion - Untuk analisis lead time produksi

3. Inventory Management

• Pembelian bahan baku - Beli dalam batch optimal (tidak terlalu banyak/sedikit)
• Monitor stok minimum - Set minimum stock untuk alert stok rendah
• Stock opname berkala - Lakukan adjustment untuk koreksi selisih fisik vs sistem
• FIFO untuk barang yang mudah rusak - Susu, telur, produk segar
• Weighted Average untuk barang tahan lama - Tepung, gula, garam

4. Costing & Profitability

• Review unit cost secara berkala - Cek apakah harga beli komponen naik
• Evaluasi margin - Pastikan margin cukup untuk cover overhead
• Analisis produk profitability - Fokus pada produk dengan margin tinggi
• Adjust harga jual jika perlu - Jika cost naik, pertimbangkan naikkan harga

5. Laporan & Monitoring

• Cek laporan stok - Weekly/monthly untuk monitor inventory value
• Laporan profitabilitas - Monthly untuk review product mix
• Track production volume - Berapa batch per bulan
• Monitor waste/scrap - Jika ada komponen terbuang, catat sebagai adjustment

---

Troubleshooting

Stok Komponen Tidak Cukup

Problem: Saat complete production, muncul error "Insufficient stock"

Solusi:

1. Cek stok komponen di Inventori > Stok Barang
2. Beli komponen yang kurang via Transaksi > Pembelian
3. Atau kurangi quantity production order

Unit Cost Tidak Sesuai Ekspektasi

Problem: Unit cost terlalu tinggi/rendah

Penyebab:

• Harga beli komponen berubah
• Ada waste/scrap yang tidak tercatat
• BOM quantity tidak akurat

Solusi:

1. Review harga beli komponen di transaksi pembelian
2. Update BOM jika ada perubahan resep
3. Catat waste sebagai adjustment (PRODUCTION_OUT tambahan)

FIFO vs Weighted Average

Kapan pakai FIFO:

• Barang yang mudah rusak (susu, telur, produk segar)
• Harga komponen sering berubah
• Perlu tracking detail per batch pembelian

Kapan pakai Weighted Average:

• Barang tahan lama (tepung, gula, garam)
• Harga relatif stabil
• Lebih simple untuk inventory management

---

Integrasi dengan Modul Lain

Perpajakan (Modul 4)

• PPN atas pembelian bahan baku - Jika supplier PKP
• PPN atas penjualan barang jadi - Jika bisnis sudah PKP
• PPh 23 atas jasa produksi - Jika menggunakan jasa maklon

Lihat 04-perpajakan.md untuk detail.

Penggajian (Modul 5)

• Gaji karyawan produksi - Baker, chef, operator
• Overhead cost - Alokasi gaji ke production cost (advanced)

Lihat 05-penggajian.md untuk detail.

Aset Tetap (Modul 3)

• Mesin produksi - Oven, mixer, dll
• Depresiasi - Alokasi ke production overhead (advanced)

Lihat 03-aset-tetap.md untuk detail.

---

Referensi

Akun COA untuk Manufaktur

Kode	Nama Akun	Fungsi
1.1.20	Persediaan Bahan Baku	Inventory bahan baku
1.1.21	Persediaan Barang Jadi	Inventory finished goods
1.1.22	Persediaan WIP	Work in Process (advanced)
4.1.02	Pendapatan Penjualan	Revenue dari penjualan
5.1.01	HPP Bahan Baku	COGS bahan baku
5.2.01	HPP Barang Jadi	COGS finished goods
5.3.01	Biaya Produksi	Direct labor & overhead

Lihat 12-lampiran-akun.md untuk daftar lengkap.

Template Transaksi

Template	Fungsi
Pembelian Bahan Baku	Purchase raw materials
Transfer Produksi	PRODUCTION_OUT & PRODUCTION_IN
Penjualan + COGS	Sale dengan auto-COGS
Stock Adjustment	Koreksi stok (kerusakan, selisih)

Lihat 12-lampiran-template.md untuk detail.

---

Kesimpulan

Modul manufaktur aplikasi ini cocok untuk:

• ✅ Home industry (kue, roti, katering)
• ✅ Bakery & coffee shop
• ✅ Small-scale manufacturing
• ✅ Simple BOM-based production

Fitur utama:

• Bill of Materials (BOM) management
• Production Order workflow dengan cost tracking
• Auto-COGS calculation
• FIFO & Weighted Average costing
• Production & profitability reports

Next Steps:

1. Setup kategori produk (bahan baku vs barang jadi)
2. Input master produk
3. Buat BOM untuk setiap produk jadi
4. Beli bahan baku
5. Mulai produksi via production order
6. Jual barang jadi dengan auto-COGS

Untuk pertanyaan lebih lanjut, lihat modul terkait di manual ini atau hubungi support.

Laporan Saldo Stok

Menu Inventori > Laporan > Saldo Stok

Menampilkan snapshot stok semua produk pada tanggal tertentu.

Kolom:

• Produk
• Kategori
• Quantity
• Unit Cost
• Total Value

Export: PDF / Excel

Laporan Penilaian Persediaan

Menu Inventori > Laporan > Penilaian Persediaan

Menampilkan valuasi persediaan:

• FIFO: Breakdown per layer dengan tanggal, quantity, unit cost
• Weighted Average: Breakdown per transaksi dengan running average

Filter:

• Periode tanggal
• Kategori produk
• Metode costing

Laporan Profitabilitas Produk

Menu Inventori > Laporan > Profitabilitas Produk

Analisis margin per produk:

Produk	Units Sold	Revenue	COGS	Gross Profit	Margin %
Croissant	15 pcs	Rp 375.000	Rp 66.825	Rp 308.175	82.18%
Roti Bakar Coklat	12 pcs	Rp 240.000	Rp 61.476	Rp 178.524	74.39%

Insight:

• Produk mana yang paling profitable
• Evaluasi harga jual vs cost
• Keputusan produk mix

---

Ciri Khas

• Revenue berbasis semester - Pendapatan SPP, Uang Pangkal, Biaya Praktikum
• Accounts Receivable Management - Piutang mahasiswa dengan cicilan
• Scholarship & Discounts - Beasiswa prestasi dan kurang mampu
• Program-based Revenue - Laporan pendapatan per program studi
• Academic Calendar - Periode fiskal mengikuti tahun ajaran (Juli-Juni)
• Payroll Kompleks - Gaji dosen tetap, honorarium dosen tidak tetap, gaji karyawan

Alur Bisnis Tipikal

Pendaftaran → Tagihan SPP → Pembayaran (Lunas/Cicilan) → Beasiswa → Laporan Piutang

Contoh Kasus: STMIK Tazkia

Sekolah Tinggi Manajemen Informatika & Komputer dengan:

• 3 Program studi: Teknik Informatika (S1), Sistem Informasi (S1), Manajemen Informatika (D3)
• Pendapatan: SPP, Uang Pangkal, Biaya Praktikum, Wisuda
• Beasiswa: Prestasi (50%), Tidak Mampu (75%)
• Tahun ajaran: Juli-Juni

---

Melihat Daftar Akun

Buka menu Akuntansi > Bagan Akun.

Akun Piutang Mahasiswa

Kode	Nama Akun	Normal Balance
1.1.10	Piutang SPP Mahasiswa	Debit
1.1.11	Piutang Uang Pangkal	Debit
1.1.12	Piutang Biaya Praktikum	Debit
1.1.13	Piutang Wisuda	Debit

Akun Pendapatan

Kode	Nama Akun	Normal Balance
4.1.01	Pendapatan SPP	Kredit
4.1.02	Pendapatan Uang Pangkal	Kredit
4.1.03	Pendapatan Biaya Praktikum	Kredit
4.1.04	Pendapatan Wisuda	Kredit
4.1.05	Pendapatan Ujian	Kredit
4.1.06	Pendapatan Sertifikasi	Kredit

Akun Beban Akademik

Kode	Nama Akun	Normal Balance
5.1.01	Beban Gaji Dosen Tetap	Debit
5.1.02	Beban Honorarium Dosen Tidak Tetap	Debit
5.1.10	Beban Bahan Praktikum	Debit
5.1.11	Beban Pemeliharaan Lab	Debit

Akun Beasiswa

Kode	Nama Akun	Normal Balance
5.3.01	Beban Beasiswa Prestasi	Debit
5.3.02	Beban Beasiswa Tidak Mampu	Debit

---

Melihat Template

Buka menu Pengaturan > Template.

Template Standar

Template	Kategori	Fungsi
Tagihan SPP Mahasiswa	INCOME	Membuat piutang SPP per semester
Pembayaran SPP	RECEIPT	Mencatat pembayaran SPP (lunas/cicilan)
Tagihan Uang Pangkal	INCOME	Membuat piutang uang pangkal mahasiswa baru
Pembayaran Uang Pangkal	RECEIPT	Mencatat pembayaran uang pangkal
Tagihan Biaya Praktikum	INCOME	Membuat piutang biaya praktikum
Pembayaran Biaya Praktikum	RECEIPT	Mencatat pembayaran biaya praktikum
Tagihan Wisuda	INCOME	Membuat piutang biaya wisuda
Pembayaran Wisuda	RECEIPT	Mencatat pembayaran wisuda
Beasiswa Prestasi	EXPENSE	Memberikan beasiswa (mengurangi piutang)
Beasiswa Tidak Mampu	EXPENSE	Memberikan beasiswa (mengurangi piutang)

Template Gaji & Operasional

Template	Kategori	Fungsi
Gaji Dosen Tetap	EXPENSE	Pembayaran gaji bulanan dosen tetap
Honorarium Dosen Tidak Tetap	EXPENSE	Honorarium per SKS dosen tidak tetap
Gaji Karyawan	EXPENSE	Pembayaran gaji karyawan administrasi
Bayar BPJS Dosen	EXPENSE	BPJS Kesehatan & Ketenagakerjaan dosen
Bayar BPJS Karyawan	EXPENSE	BPJS Kesehatan & Ketenagakerjaan karyawan
Setor PPh 21	PAYMENT	Penyetoran PPh 21 ke kas negara

---

Transaksi 1: Tagihan SPP Semester Ganjil

Konteks: Ahmad Fauzi (NIM 2201010001) mahasiswa Teknik Informatika semester 3, tagihan SPP semester ganjil 2024/2025.

Data Mahasiswa:

• NIM: 2201010001
• Nama: Ahmad Fauzi
• Program Studi: Teknik Informatika (S1)
• Semester: 3
• SPP per semester: Rp 7.500.000

Langkah:

Menu Transaksi > Buat Transaksi > Pilih template Tagihan SPP Mahasiswa

Isi Data:

• Tanggal: 1 Juli 2024
• Jumlah: Rp 7.500.000
• Keterangan: Tagihan SPP Semester Ganjil 2024/2025 - Ahmad Fauzi (2201010001)
• Referensi: INV-SPP-2024-001

Jurnal Otomatis:

Dr. 1.1.10 Piutang SPP Mahasiswa    Rp 7.500.000
    Cr. 4.1.01 Pendapatan SPP            Rp 7.500.000

Impact:

• Piutang SPP mahasiswa: +Rp 7.500.000
• Pendapatan SPP diakui: +Rp 7.500.000
• Outstanding receivable untuk Ahmad Fauzi: Rp 7.500.000

---

Transaksi 2: Pembayaran SPP (Lunas)

Konteks: Ahmad Fauzi membayar lunas SPP semester ganjil via transfer bank.

Langkah:

Menu Transaksi > Buat Transaksi > Pilih template Pembayaran SPP

Isi Data:

• Tanggal: 5 Juli 2024
• Jumlah: Rp 7.500.000
• Rekening: Bank BCA
• Keterangan: Pembayaran SPP Lunas - Ahmad Fauzi (2201010001)
• Referensi: PMT-SPP-2024-001

Jurnal Otomatis:

Dr. 1.1.02 Bank BCA                 Rp 7.500.000
    Cr. 1.1.10 Piutang SPP Mahasiswa    Rp 7.500.000

Impact:

• Kas bertambah: +Rp 7.500.000
• Piutang SPP berkurang: -Rp 7.500.000
• Outstanding receivable Ahmad Fauzi: Rp 0 (LUNAS)

---

Transaksi 3: Tagihan Uang Pangkal Mahasiswa Baru

Konteks: Siti Aminah (NIM 2401010001) mahasiswa baru Sistem Informasi, tagihan uang pangkal.

Data Mahasiswa:

• NIM: 2401010001
• Nama: Siti Aminah
• Program Studi: Sistem Informasi (S1)
• Semester: 1 (Mahasiswa Baru)
• Uang Pangkal: Rp 5.000.000

Langkah:

Menu Transaksi > Buat Transaksi > Pilih template Tagihan Uang Pangkal

Isi Data:

• Tanggal: 10 Juli 2024
• Jumlah: Rp 5.000.000
• Keterangan: Tagihan Uang Pangkal - Siti Aminah (2401010001) - Sistem Informasi
• Referensi: INV-UP-2024-001

Jurnal Otomatis:

Dr. 1.1.11 Piutang Uang Pangkal     Rp 5.000.000
    Cr. 4.1.02 Pendapatan Uang Pangkal   Rp 5.000.000

Impact:

• Piutang Uang Pangkal: +Rp 5.000.000
• Pendapatan Uang Pangkal: +Rp 5.000.000
• Outstanding receivable Siti Aminah: Rp 5.000.000

---

Transaksi 4: Pembayaran Uang Pangkal (Cicilan 1)

Konteks: Siti Aminah membayar cicilan pertama Rp 2.500.000 (50% dari total).

Langkah:

Menu Transaksi > Buat Transaksi > Pilih template Pembayaran Uang Pangkal

Isi Data:

• Tanggal: 15 Juli 2024
• Jumlah: Rp 2.500.000
• Rekening: Bank Mandiri
• Keterangan: Pembayaran UP Cicilan 1/2 - Siti Aminah (2401010001)
• Referensi: PMT-UP-2024-001-1

Jurnal Otomatis:

Dr. 1.1.03 Bank Mandiri             Rp 2.500.000
    Cr. 1.1.11 Piutang Uang Pangkal     Rp 2.500.000

Impact:

• Kas bertambah: +Rp 2.500.000
• Piutang berkurang: -Rp 2.500.000
• Outstanding receivable Siti Aminah: Rp 2.500.000 (masih kurang)

---

Transaksi 5: Beasiswa Prestasi

Konteks: Budi Hartono (NIM 2201020001) mahasiswa MI semester 5 mendapat beasiswa prestasi 50% karena IPK 3.8.

Data:

• NIM: 2201020001
• Nama: Budi Hartono
• Program: Manajemen Informatika (D3)
• Tagihan SPP: Rp 6.000.000
• Beasiswa: 50% = Rp 3.000.000

Langkah 1: Buat Tagihan SPP

Template Tagihan SPP Mahasiswa

• Jumlah: Rp 6.000.000
• Keterangan: Tagihan SPP Semester Ganjil - Budi Hartono (2201020001)

Langkah 2: Berikan Beasiswa

Menu Transaksi > Buat Transaksi > Pilih template Beasiswa Prestasi

Isi Data:

• Tanggal: 1 Juli 2024
• Jumlah: Rp 3.000.000
• Keterangan: Beasiswa Prestasi 50% IPK 3.8 - Budi Hartono (2201020001)
• Referensi: BEASISWA-PRESTASI-001

Jurnal Otomatis:

Dr. 5.3.01 Beban Beasiswa Prestasi  Rp 3.000.000
    Cr. 1.1.10 Piutang SPP Mahasiswa    Rp 3.000.000

Impact:

• Beban beasiswa: +Rp 3.000.000
• Piutang SPP berkurang: -Rp 3.000.000
• Outstanding receivable Budi: Rp 3.000.000 (setelah beasiswa)

---

Transaksi 6: Beasiswa Tidak Mampu

Konteks: Agus Wijaya (NIM 2301010003) mahasiswa SI semester 3 mendapat beasiswa kurang mampu 75%.

Data:

• NIM: 2301010003
• Nama: Agus Wijaya
• Program: Sistem Informasi (S1)
• Tagihan SPP: Rp 7.500.000
• Beasiswa: 75% = Rp 5.625.000

Langkah 1: Buat Tagihan SPP

Template Tagihan SPP Mahasiswa

• Jumlah: Rp 7.500.000
• Keterangan: Tagihan SPP Semester Ganjil - Agus Wijaya (2301010003)

Langkah 2: Berikan Beasiswa

Menu Transaksi > Buat Transaksi > Pilih template Beasiswa Tidak Mampu

Isi Data:

• Tanggal: 1 Juli 2024
• Jumlah: Rp 5.625.000
• Keterangan: Beasiswa Tidak Mampu 75% - Agus Wijaya (2301010003)
• Referensi: BEASISWA-TM-001

Jurnal Otomatis:

Dr. 5.3.02 Beban Beasiswa Tidak Mampu  Rp 5.625.000
    Cr. 1.1.10 Piutang SPP Mahasiswa       Rp 5.625.000

Impact:

• Beban beasiswa: +Rp 5.625.000
• Piutang SPP berkurang: -Rp 5.625.000
• Outstanding receivable Agus: Rp 1.875.000 (setelah beasiswa 75%)

---

Transaksi 7: Gaji Dosen Tetap

Konteks: Pembayaran gaji bulanan Agustus 2024 untuk Dr. Siti Nurjanah M.Kom (dosen tetap TI).

Data Dosen:

• NIK: EMP-D001
• Nama: Dr. Siti Nurjanah M.Kom
• Jabatan: Dosen Tetap Teknik Informatika
• Gaji Pokok: Rp 8.500.000
• Tunjangan Fungsional: Rp 2.000.000
• Total Gaji: Rp 10.500.000

Langkah:

Menu Transaksi > Buat Transaksi > Pilih template Gaji Dosen Tetap

Isi Data:

• Tanggal: 25 Agustus 2024
• Jumlah: Rp 10.500.000
• Rekening: Bank BCA
• Keterangan: Gaji Agustus 2024 - Dr. Siti Nurjanah M.Kom (EMP-D001)
• Referensi: PAYROLL-DSN-202408-001

Jurnal Otomatis:

Dr. 5.1.01 Beban Gaji Dosen Tetap   Rp 10.500.000
    Cr. 1.1.02 Bank BCA                  Rp 10.500.000

Catatan: Untuk penggajian lengkap dengan BPJS dan PPh 21, lihat Bab 5: Penggajian.

---

Transaksi 8: Honorarium Dosen Tidak Tetap

Konteks: Pembayaran honorarium untuk dosen tidak tetap yang mengajar 4 SKS di bulan Agustus.

Data:

• Nama: Ir. Hendra Saputra M.T
• Mata Kuliah: Algoritma & Pemrograman (4 SKS)
• Honorarium: Rp 150.000/SKS
• Total: 4 SKS × Rp 150.000 = Rp 600.000

Langkah:

Menu Transaksi > Buat Transaksi > Pilih template Honorarium Dosen Tidak Tetap

Isi Data:

• Tanggal: 30 Agustus 2024
• Jumlah: Rp 600.000
• Rekening: Bank BCA
• Keterangan: Honorarium 4 SKS Agustus 2024 - Ir. Hendra Saputra M.T
• Referensi: HON-DSN-202408-001

Jurnal Otomatis:

Dr. 5.1.02 Beban Honorarium Dosen Tidak Tetap  Rp 600.000
    Cr. 1.1.02 Bank BCA                             Rp 600.000

Daftar Transaksi

Semua transaksi yang telah dibuat dapat dilihat di menu Akuntansi > Transaksi.

---

Laporan Laba Rugi

Buka menu Laporan > Laporan Laba Rugi.

Pendapatan Operasional:

• Pendapatan SPP
• Pendapatan Uang Pangkal
• Pendapatan Biaya Praktikum
• Pendapatan Wisuda

Beban Akademik:

• Beban Gaji Dosen Tetap
• Beban Honorarium Dosen Tidak Tetap
• Beban Bahan Praktikum
• Beban Pemeliharaan Lab

Beban Kemahasiswaan:

• Beban Beasiswa Prestasi
• Beban Beasiswa Tidak Mampu

---

Neraca (Balance Sheet)

Buka menu Laporan > Neraca.

Aset Lancar - Piutang:

• Piutang SPP Mahasiswa
• Piutang Uang Pangkal
• Piutang Biaya Praktikum
• Piutang Wisuda

Interpretasi:

• Piutang SPP tinggi → Banyak mahasiswa belum bayar/cicilan
• Piutang Uang Pangkal tinggi → Mahasiswa baru yang belum lunas
• Aging Analysis → Perlu strategi penagihan untuk piutang > 90 hari

---

Laporan Pendapatan per Program Studi

Konsep:

Laporan ini memecah pendapatan berdasarkan program studi untuk analisis profitabilitas.

Cara Manual (via Keterangan Transaksi):

Pastikan setiap transaksi pendapatan mencantumkan kode program di keterangan:

• [TI] untuk Teknik Informatika
• [SI] untuk Sistem Informasi
• [MI] untuk Manajemen Informatika

Contoh:

Tagihan SPP Semester Ganjil 2024/2025 - Ahmad Fauzi (2201010001) - [TI]

Export & Analisis:

1. Buka Laporan > Buku Besar > Akun 4.1.01 (Pendapatan SPP)
2. Filter periode (1 semester)
3. Export ke Excel
4. Pivot table dengan kolom:
   • Program (extract dari keterangan)
   • Total Pendapatan
   • Jumlah Mahasiswa
   • Rata-rata per Mahasiswa

Hasil Analisis Contoh:

Program	Total Pendapatan SPP	Jumlah Mahasiswa	Avg per Mhs
Teknik Informatika (S1)	Rp 375.000.000	50	Rp 7.500.000
Sistem Informasi (S1)	Rp 300.000.000	40	Rp 7.500.000
Manajemen Informatika (D3)	Rp 180.000.000	30	Rp 6.000.000
Total	Rp 855.000.000	120	Rp 7.125.000

---

Receivables Aging Report

Konsep:

Analisis umur piutang untuk identifikasi mahasiswa yang perlu ditagih.

Kategori:

• Current (0-30 hari): Baru jatuh tempo
• 30-60 hari: Perlu reminder
• 60-90 hari: Perlu teguran
• > 90 hari: Perlu tindakan tegas (surat peringatan, blokir KRS)

Cara Manual:

1. Buka Laporan > Buku Besar > Akun 1.1.10 (Piutang SPP)
2. Export transaksi
3. Analisis di Excel:
   • Hitung selisih hari dari tanggal tagihan
   • Group berdasarkan aging bucket
   • Sort by amount descending

Contoh Hasil:

NIM	Nama	Jumlah Piutang	Tgl Tagihan	Umur (Hari)	Status
2201010005	Rina Wati	Rp 7.500.000	01-Jul-24	95	Overdue
2301010007	Hendra Saputra	Rp 3.750.000	15-Jul-24	80	Overdue
2401010002	Dewi Lestari	Rp 7.500.000	01-Aug-24	35	Current

---

Field-Level Encryption

Aplikasi mengenkripsi data sensitif (PII) menggunakan AES-256-GCM:

Data yang dienkripsi:

• NPWP karyawan
• Nomor rekening bank
• Alamat
• Nomor BPJS
• Nomor telepon

Document Storage Encryption

Dokumen yang diupload (struk, invoice, bukti potong) dienkripsi:

• Encryption at rest
• Unique key per document
• Backward compatible dengan dokumen lama

Implikasi untuk User

• Data terenkripsi tidak bisa di-query langsung di database
• Export data tetap menampilkan data asli (untuk authorized user)
• Backup database tetap aman (data terenkripsi)

---

Apa yang Di-log?

Aktivitas	Contoh
Login	User login/logout, failed attempts
Data Access	View data sensitif
Data Modification	Create, Update, Delete
Export	Download report, export data
Security Events	Password change, role change

Melihat Audit Log

Buka menu Pengaturan > Audit Log.

Filter yang tersedia:

• Tanggal (dari-sampai)
• User
• Tipe aktivitas
• Entity yang diakses

Retention Policy

• Audit log disimpan minimal 2 tahun
• Log tidak bisa dihapus oleh user biasa
• Hanya ADMIN yang bisa mengakses audit log

---

Panduan fitur keamanan dan kepatuhan regulasi (GDPR, UU PDP).

Kebijakan Data (GDPR / UU PDP)

Prinsip yang Diimplementasikan

Prinsip	Implementasi
Lawfulness	Consent management
Purpose limitation	Data hanya untuk tujuan yang dinyatakan
Data minimization	Hanya kumpulkan data yang diperlukan
Accuracy	User bisa update data sendiri
Storage limitation	Retention policy
Integrity	Encryption, audit log
Accountability	Audit trail

Data Subject Management

Buka menu Pengaturan > Data Subjects.

Fitur:

• Register data subject (karyawan, klien)
• Track consent
• Manage data processing activities

Privacy Settings

Buka menu Pengaturan > Privacy.

Konfigurasi:

• Data retention period
• Consent requirements
• Data masking rules

---

Keamanan Password

Kebijakan Password

Requirement	Value
Minimum length	12 karakter
Uppercase	Minimal 1
Lowercase	Minimal 1
Number	Minimal 1
Special char	Minimal 1

Account Lockout

Parameter	Value
Max failed attempts	5
Lockout duration	30 menit
Reset after	Successful login

Password Reset

1. User request reset via "Lupa Password"
2. Sistem kirim link ke email
3. Link valid 1 jam
4. User set password baru

---

Rate Limiting

Login Endpoint

Parameter	Value
Max requests	10 per menit
Block duration	5 menit

API Endpoints

Parameter	Value
Max requests	100 per menit
Block duration	1 menit

---

Data Anonymization

Kapan Digunakan?

• Data subject request deletion
• Retention period expired
• Test/development environment

Proses

1. Identifikasi data subject
2. Anonymize PII fields:
   • Nama → "Anonymized User #123"
   • NPWP → "XX.XXX.XXX.X-XXX.XXX"
   • Alamat → "Anonymized Address"
3. Retain non-PII untuk reporting

Data yang TIDAK di-anonymize

• Transaction amounts
• Account codes
• Dates
• Aggregated reports

---

Breach Response

Prosedur Breach

1. Detect - Sistem mendeteksi anomali
2. Contain - Isolasi sistem terdampak
3. Assess - Evaluasi scope dan impact
4. Notify - Lapor ke:
   • Regulator (72 jam untuk GDPR)
   • Data subjects yang terdampak
5. Remediate - Perbaiki vulnerability
6. Document - Catat seluruh proses

Monitoring

Sistem memonitor:

• Unusual login patterns
• Bulk data access
• Failed authentication spikes
• API abuse

---

Compliance Checklist

GDPR

• [x] Lawful basis for processing
• [x] Privacy notice
• [x] Consent management
• [x] Data subject rights (access, rectification, erasure)
• [x] Data breach notification procedure
• [x] Encryption at rest
• [x] Audit logging

UU PDP (Indonesia)

• [x] Persetujuan pemrosesan
• [x] Hak akses data pribadi
• [x] Hak koreksi
• [x] Hak penghapusan
• [x] Keamanan data
• [ ] Consent management UI (pending)
• [ ] DPO appointment (organizational)

---

Tips Keamanan

1. Strong passwords - Gunakan password manager
2. Regular review - Audit log review mingguan
3. Principle of least privilege - Berikan akses minimal
4. Update software - Patch security updates
5. Backup encrypted - Backup database yang sudah terenkripsi
6. Train users - Edukasi tentang phishing

---

Lihat Juga

• Setup Awal - User management
• Penggajian - Data PII karyawan
• Tutorial Akuntansi - Audit trail transaksi

Apa itu DSAR?

Data Subject Access Request - Hak subjek data untuk mendapatkan salinan data pribadinya.

Proses DSAR

1. Terima request dari data subject
2. Verifikasi identitas
3. Generate export:
   • Data pribadi
   • History transaksi terkait
   • Log aktivitas
4. Deliver dalam format portable (JSON/PDF)

Batas Waktu

• GDPR: 30 hari
• UU PDP: 3×24 jam

Cara Generate Export

1. Buka Pengaturan > Data Subjects
2. Cari data subject
3. Klik Export Data
4. Sistem generate file
5. Download dan deliver ke subject

---

Apa Itu Rekonsiliasi Bank

Rekonsiliasi bank adalah proses mencocokkan catatan transaksi di buku besar (book) dengan mutasi rekening koran dari bank. Tujuannya memastikan bahwa saldo kas di pembukuan sesuai dengan saldo aktual di bank.

Mengapa Diperlukan

Saldo buku dan saldo bank sering berbeda karena:

Penyebab	Contoh	Ada di
Biaya administrasi bank	Biaya admin bulanan Rp 15.000	Bank saja
Pendapatan bunga	Bunga deposito yang belum dicatat	Bank saja
Cek beredar (outstanding check)	Cek yang sudah dicatat tapi belum dicairkan	Buku saja
Transfer belum dicatat	Pembayaran masuk yang belum di-input	Bank saja

Rekonsiliasi mengidentifikasi selisih ini sehingga pembukuan dapat dikoreksi.

Alur Kerja

1. Import CSV     2. Buat Rekonsiliasi     3. Pencocokan     4. Laporan
   dari bank         (pilih statement)        (auto/manual)      (print/export)

---

Parser Bawaan

Aplikasi menyediakan parser bawaan untuk bank-bank utama Indonesia. Buka menu Rekonsiliasi Bank > Konfigurasi Parser.

Setiap parser mendefinisikan posisi kolom dalam file CSV: kolom tanggal, keterangan, debit, kredit, dan saldo.

Parser bawaan:

Bank	Format Tanggal	Kolom
BCA	dd/MM/yyyy	Tanggal, Keterangan, Cabang, Debit, Credit, Saldo
Mandiri	dd/MM/yyyy	Tanggal, Keterangan, Debit, Kredit, Saldo
BNI	dd-MMM-yyyy	Tanggal, Keterangan, Cabang, Debit, Kredit, Saldo
BSI	dd/MM/yyyy	Tanggal, Keterangan, Debit, Kredit, Saldo
CIMB	dd/MM/yyyy	Tanggal, Keterangan, Debit, Kredit, Saldo

Custom Parser

Jika bank tidak tersedia dalam daftar, buat parser kustom. Buka Konfigurasi Parser > Parser Baru.

Field yang perlu diisi:

• Tipe Bank: CUSTOM
• Nama Config: Nama deskriptif (contoh: "Bank Jatim CSV")
• Kolom Tanggal: Index kolom tanggal (dimulai dari 0)
• Kolom Keterangan: Index kolom deskripsi transaksi
• Format Tanggal: Pattern Java DateTimeFormatter (contoh: dd/MM/yyyy)

---

Persiapan File CSV

Download mutasi rekening dari internet banking dalam format CSV. Pastikan file memiliki header dan format sesuai dengan parser yang dipilih.

Contoh CSV BCA (bca-statement-202401.csv):

Tanggal,Keterangan,Cabang,Debit,Credit,Saldo
01/01/2024,"Setoran Modal Awal 2024",0316,,,500000000.00
15/01/2024,"Transfer Masuk - Konsultasi Core Banking",0316,,196200000.00,696200000.00
15/01/2024,"Transfer Keluar - JetBrains License",0316,3330000.00,,692870000.00
31/01/2024,"Transfer Keluar - AWS Cloud",0316,5550000.00,,687320000.00
31/01/2024,"Biaya Admin Bank BCA",0316,15000.00,,687305000.00

Form Import

Buka menu Rekonsiliasi Bank > Import Mutasi.

Isi data import:

• Rekening Bank: Pilih rekening (contoh: BCA - 1234567890)
• Parser Config: Pilih parser sesuai bank
• Periode Mulai: Tanggal awal mutasi (01/01/2024)
• Periode Akhir: Tanggal akhir mutasi (31/01/2024)
• File CSV: Upload file yang sudah didownload

Klik Import untuk memproses.

Daftar Mutasi

Setelah import, mutasi tampil di menu Rekonsiliasi Bank > Daftar Mutasi.

Detail Mutasi

Klik pada mutasi untuk melihat detail item yang berhasil di-parse.

Informasi yang ditampilkan:

• Bank: BCA
• Total Item: 5 transaksi
• Tabel Item: Tanggal, keterangan, debit/kredit, saldo

---

Membuat Rekonsiliasi Baru

Buka menu Rekonsiliasi Bank > Rekonsiliasi Baru.

Pilih mutasi bank yang akan direkonsiliasi dari dropdown, lalu klik Buat Rekonsiliasi.

Detail Rekonsiliasi

Setelah dibuat, halaman detail menampilkan ringkasan:

Informasi yang ditampilkan:

• Status: IN_PROGRESS / COMPLETED
• Saldo Bank: Saldo akhir menurut bank (Rp 687.305.000)
• Saldo Buku: Saldo akhir menurut pembukuan
• Item Cocok: Jumlah transaksi yang sudah dicocokkan
• Selisih: Perbedaan antara saldo bank dan buku

Auto-Match (Pencocokan Otomatis)

Klik tombol Auto-Match untuk menjalankan pencocokan otomatis 3 tahap:

Tahap	Metode	Kriteria
1. Exact Match	Tanggal + jumlah persis sama	Tanggal dan nominal harus identik
2. Fuzzy Date	Jumlah sama, tanggal berdekatan	Nominal identik, selisih tanggal maks 3 hari
3. Keyword Match	Kata kunci di keterangan	Mencocokkan kata kunci keterangan bank vs buku

Contoh hasil auto-match dengan data PT ArtiVisi:

#	Item Bank	Jumlah	Match	Item Buku
1	Setoran Modal Awal 2024	Rp 500.000.000	Exact	Setoran Modal Awal 2024
2	Transfer Masuk - Konsultasi Core Banking	Rp 196.200.000	Exact	Konsultasi Core Banking - Milestone 1
3	Transfer Keluar - JetBrains License	Rp 3.330.000	Exact	JetBrains IntelliJ License 2024
4	Transfer Keluar - AWS Cloud	Rp 5.550.000	Exact	AWS Cloud Services Jan 2024
5	Biaya Admin Bank BCA	Rp 15.000	Bank Only	(tidak ada di buku)

Manual Match

Item yang tidak ter-match otomatis dapat dicocokkan secara manual:

1. Klik item bank yang belum cocok
2. Pilih transaksi buku yang sesuai
3. Konfirmasi pencocokan

Mark Bank-Only / Book-Only

Untuk item yang memang hanya ada di satu sisi:

• Bank Only: Transaksi yang ada di bank tapi belum dicatat di buku. Contoh: Biaya Admin Bank BCA Rp 15.000 — perlu dibuat jurnal penyesuaian:

  Dr. 6.1.01 Biaya Administrasi Bank    Rp 15.000
      Cr. 1.1.02 Bank BCA                   Rp 15.000
  

• Book Only: Transaksi yang sudah dicatat di buku tapi belum muncul di bank. Contoh: cek yang sudah diterbitkan tapi belum dicairkan oleh penerima.

---

Buka laporan dari halaman detail rekonsiliasi, klik Laporan.

Laporan menampilkan:

• Header: Periode, rekening bank, tanggal rekonsiliasi
• Ringkasan saldo: Saldo bank vs saldo buku
• Item cocok: Daftar transaksi yang berhasil dicocokkan
• Item Bank Only: Transaksi bank tanpa pasangan di buku
• Item Book Only: Transaksi buku tanpa pasangan di bank
• Selisih: Total selisih yang perlu ditindaklanjuti

Gunakan tombol Print untuk mencetak atau export laporan.

---

Walk-through rekonsiliasi PT ArtiVisi Intermedia untuk periode Januari 2024.

Data Awal

• Rekening: BCA 1234567890, KCU Sudirman
• Akun GL: 1.1.02 Bank BCA
• Saldo awal: Rp 500.000.000
• Saldo akhir (bank): Rp 687.305.000

Langkah 1: Import Mutasi

Import file bca-statement-202401.csv yang berisi 5 item transaksi.

Langkah 2: Buat Rekonsiliasi

Pilih mutasi Januari 2024 dan buat rekonsiliasi baru. Sistem menampilkan 5 item bank dan transaksi buku yang tersedia.

Langkah 3: Jalankan Auto-Match

Klik Auto-Match. Hasil: 4 dari 5 item berhasil dicocokkan (Exact Match), 1 item tersisa (Biaya Admin Bank BCA).

Langkah 4: Tandai Bank Only

Item "Biaya Admin Bank BCA" Rp 15.000 tidak ada di pembukuan. Tandai sebagai Bank Only.

Tindak lanjut: buat jurnal penyesuaian untuk mencatat biaya admin tersebut di buku besar.

Langkah 5: Review Laporan

Buka laporan rekonsiliasi untuk verifikasi:

Item	Bank	Buku	Status
Setoran Modal Awal 2024	Rp 500.000.000	Rp 500.000.000	Cocok
Konsultasi Core Banking	Rp 196.200.000	Rp 196.200.000	Cocok
JetBrains License	Rp 3.330.000	Rp 3.330.000	Cocok
AWS Cloud	Rp 5.550.000	Rp 5.550.000	Cocok
Biaya Admin Bank BCA	Rp 15.000	—	Bank Only

Setelah semua item diproses, rekonsiliasi dapat di-complete.

---

Aplikasi ini dirancang untuk dioperasikan sepenuhnya oleh AI assistant (Claude Code, Gemini CLI, atau AI lainnya). AI dapat menangani seluruh siklus hidup aplikasi — mulai dari instalasi server, migrasi data dari Excel, pencatatan transaksi harian, penggajian, pelaporan keuangan, hingga pelaporan pajak.

Cakupan AI:

• Instalasi dan deploy ke VPS via Ansible
• Analisis data Excel existing (transaksi, saldo awal) dan generate seed data
• Pencatatan transaksi harian (struk, invoice, text input)
• Penggajian dan PPh 21
• Tagihan vendor (bills)
• Rekonsiliasi bank
• Laporan keuangan dan analisis bisnis
• Pelaporan pajak (PPN, PPh 21, PPh Badan)

---

Gambaran Umum

Siklus Hidup Operasi AI

1. Instalasi & Deploy
   AI clone repo GitHub → setup VPS via Ansible → aplikasi live
   |
2. Analisis Data Existing
   AI baca file Excel (transaksi, neraca) → analisis struktur akun
   |
3. Inisialisasi Data
   AI generate CSV (COA, template, saldo awal) → ZIP → POST /api/data-import
   |
4. Operasi Harian
   AI baca struk/invoice → matching template → posting transaksi
   AI buat tagihan vendor → approve → mark paid
   AI import mutasi bank → auto-match → rekonsiliasi
   |
5. Penggajian Bulanan
   AI buat payroll run → hitung PPh 21 → approve → posting ke jurnal
   |
6. Laporan & Analisis
   AI baca laporan keuangan → analisis → publikasi insight
   |
7. Pelaporan Pajak
   AI export e-Faktur, Bukti Potong → generate SPT → koreksi fiskal

Prasyarat

• AI assistant dengan kemampuan HTTP API (Claude Code, Gemini CLI, atau tool dengan curl/HTTP client)
• VPS dengan Ubuntu 22.04+ dan akses SSH (untuk instalasi)
• Domain dengan DNS pointing ke VPS (untuk HTTPS)
• Aplikasi sudah ter-deploy dan dapat diakses via HTTPS

---

API Discovery via OpenAPI Spec

Sebelum mulai berinteraksi dengan API, AI assistant membaca OpenAPI spec yang mendeskripsikan seluruh kemampuan API. Spec ini di-generate otomatis oleh springdoc-openapi dan tersedia tanpa autentikasi.

Endpoint

GET /v3/api-docs
# Tidak perlu Authorization header
# Returns OpenAPI 3.x JSON spec

Swagger UI juga tersedia di /swagger-ui.html untuk eksplorasi interaktif.

Isi OpenAPI Spec

Bagian	Deskripsi
paths	Seluruh endpoint API, auto-generated dari controller annotations
components.schemas	Request/response schema dari DTO records
security	Bearer token authentication scheme
x-authentication	Alur OAuth 2.0 Device Flow lengkap (step 1-3), daftar scope, expiry
x-workflows	13 alur kerja end-to-end (receipt-based, text-based, direct posting, financial analysis, bank reconciliation, client onboarding, correction workflows, tax export)
x-csv-files	16 spesifikasi CSV untuk data import (nama kolom, tipe data, catatan)
x-industries	Daftar kode industri yang didukung (it-service, online-seller, coffee-shop, campus)
x-error-codes	7 kode error dan HTTP status

Cara AI Menggunakan OpenAPI Spec

1. AI membaca OpenAPI spec (GET /v3/api-docs)
   |
2. AI memahami:
   - Endpoint apa saja yang tersedia (dari paths)
   - Field apa yang wajib/opsional per endpoint (dari schemas)
   - Scope apa yang diperlukan (dari x-authentication)
   - Alur kerja (workflow) yang benar (dari x-workflows)
   |
3. AI mengikuti alur autentikasi dari x-authentication
   |
4. AI memanggil endpoint sesuai x-workflows

Langkah pertama integrasi: Selalu GET /v3/api-docs untuk mengetahui endpoint, schema, dan workflow yang tersedia. Metadata AI ada di x- extensions.

---

Setup Autentikasi

AI assistant memerlukan autentikasi untuk mengakses aplikasi. Proses ini menggunakan OAuth 2.0 Device Flow yang aman.

Langkah 1: AI Meminta Kode

AI assistant akan meminta device code dari aplikasi:

POST /api/device/code
{
  "clientId": "claude-code"
}

Response:

{
  "deviceCode": "a79d766e4972e61d...",
  "userCode": "MBJN-KRFJ",
  "verificationUri": "http://localhost:8080/device",
  "interval": 5,
  "expiresIn": 900
}

Langkah 2: User Otorisasi di Browser

AI akan menampilkan URL dan kode:

Please authorize this device:
  URL: http://localhost:8080/device
  Code: MBJN-KRFJ

Buka URL tersebut di browser, login, dan masukkan kode:

Langkah otorisasi:

1. Login dengan username dan password Anda
2. Verifikasi kode perangkat yang ditampilkan
3. (Opsional) Beri nama perangkat, misalnya: "Claude Code di MacBook"
4. Klik "Otorisasi Perangkat"

Keamanan: Kode device hanya berlaku 15 menit dan hanya bisa digunakan sekali.

Langkah 3: AI Mendapat Access Token

Setelah Anda otorisasi, AI akan mendapat access token:

{
  "accessToken": "15d07ef9030cba7b...",
  "tokenType": "Bearer",
  "expiresIn": 2592000
}

Token ini berlaku 30 hari. AI akan menyimpannya untuk digunakan di request berikutnya.

Scope yang Tersedia

Token yang diterbitkan melalui Device Flow memiliki scope berikut:

Scope	Hak Akses
drafts:create	Membuat dan mengedit draft transaksi
drafts:approve	Approve/reject draft
drafts:read	Membaca draft
analysis:read	Membaca laporan keuangan
analysis:write	Mempublikasikan laporan analisis
transactions:post	Posting, koreksi, dan hapus transaksi DRAFT
data:import	Import data dari file ZIP
bills:read	Membaca vendor bills
bills:create	Membuat vendor bills
bills:approve	Approve dan mark-paid vendor bills
bank-recon:read	Membaca data rekonsiliasi bank
bank-recon:write	Import statement, matching, complete reconciliation
tax-export:read	Export data pajak dan membaca data karyawan/payroll

Tanpa scope yang sesuai, request akan ditolak dengan HTTP 403.

---

Instalasi dan Deploy

AI assistant dapat menginstal aplikasi dari nol ke VPS kosong menggunakan Ansible playbook yang tersedia di repository.

Prasyarat

• VPS dengan Ubuntu 22.04+ (minimal 2GB RAM, 20GB disk)
• Domain yang sudah pointing ke IP VPS
• SSH key access ke VPS (root atau user dengan sudo)

Alur Kerja

1. AI clone repository
   git clone https://github.com/artivisi/balaka.git
   |
2. AI konfigurasi inventory Ansible
   Edit deploy/ansible/inventory.ini — set IP, domain, credentials
   |
3. AI jalankan full setup (pertama kali)
   ansible-playbook -i inventory.ini site.yml
   |
   Roles yang dijalankan:
   - common: Java 21, system packages, firewall
   - postgresql: PostgreSQL 17, database + user
   - app: Systemd service, build JAR, Flyway migration
   - nginx: Reverse proxy, HTTPS (Let's Encrypt)
   |
4. AI verifikasi aplikasi berjalan
   curl -s https://domain.example.com/actuator/health
   → {"status":"UP"}
   |
5. Untuk deploy selanjutnya (update kode):
   ansible-playbook -i inventory.ini deploy.yml

Struktur Ansible

deploy/ansible/
  site.yml              # Full setup (pertama kali)
  deploy.yml            # Deploy update (build + restart)
  setup-ssl.yml         # Setup Let's Encrypt SSL
  backup.yml            # Backup database
  restore.yml           # Restore database
  requirements.yml      # Ansible Galaxy dependencies
  roles/
    common/tasks/       # Java, packages, firewall
    postgresql/tasks/   # PostgreSQL setup
    app/tasks/          # Application service
    nginx/tasks/        # Reverse proxy
    backup/tasks/       # Automated backup

Konfigurasi Inventory

AI perlu membuat file inventory.ini dengan konfigurasi server:

[app]
server1 ansible_host=IP_VPS ansible_user=root

[app:vars]
app_domain=balaka.example.com
db_name=accountingdb
db_user=akunting
db_password=SECURE_PASSWORD

Verifikasi

Setelah deploy, AI memverifikasi:

# Health check
curl -s https://balaka.example.com/actuator/health

# OpenAPI spec tersedia
curl -s https://balaka.example.com/v3/api-docs | head -c 200

# Login page accessible
curl -s -o /dev/null -w "%{http_code}" https://balaka.example.com/login
# → 200

---

Analisis Data Existing

Sebelum menginisialisasi aplikasi, AI menganalisis data keuangan yang sudah ada (biasanya dalam format Excel) untuk merancang struktur Chart of Accounts (COA) dan template jurnal yang sesuai.

Alur Kerja

1. User memberikan file Excel ke AI
   - Laporan keuangan (neraca, laba rugi)
   - Buku besar / general ledger
   - Data transaksi harian
   - Daftar aset tetap
   - Data karyawan dan gaji
   |
2. AI menganalisis struktur data
   - Mengidentifikasi akun-akun yang digunakan
   - Mengelompokkan ke ASSET, LIABILITY, EQUITY, REVENUE, EXPENSE
   - Menentukan parent-child hierarchy
   - Mengidentifikasi pola transaksi berulang
   |
3. AI merancang COA
   - Memetakan akun Excel ke format aplikasi
   - Menentukan account_code, account_type, normal_balance
   - Mengatur hierarki (parent_code)
   |
4. AI merancang template jurnal
   - Mengidentifikasi pola transaksi berulang (listrik, gaji, penjualan, dll)
   - Membuat template dengan formula yang sesuai
   - Mengisi metadata AI (keywords, merchant patterns, semantic description)
   |
5. AI menghitung saldo awal
   - Mengambil saldo per akun dari neraca terakhir
   - Membuat transaksi saldo awal (template "Saldo Awal")
   |
6. AI generate CSV files → ZIP → POST /api/data-import

Contoh Analisis Excel

Input: File Excel "Buku Besar 2025.xlsx" dengan kolom:

Tanggal | Kode Akun | Nama Akun | Debit | Kredit | Keterangan

Output AI:

1. COA yang diidentifikasi:

   • 1.1.01 Kas (ASSET, DEBIT)
   • 1.1.02 Bank BCA (ASSET, DEBIT)
   • 2.1.01 Hutang Usaha (LIABILITY, CREDIT)
   • 4.1.01 Pendapatan Jasa (REVENUE, CREDIT)
   • 5.1.01 Beban Gaji (EXPENSE, DEBIT)
   • ... dst

2. Template yang disarankan:

   • "Pendapatan Jasa Konsultasi" — pola: klien bayar ke bank, keywords: konsultasi, jasa, proyek
   • "Bayar Beban Listrik" — pola: kas/bank keluar ke PLN, keywords: listrik, pln
   • "Bayar Gaji Karyawan" — pola: kas/bank keluar untuk gaji, keywords: gaji, salary
   • ... dst

3. Saldo awal per 31 Desember 2025:

   • Kas: Rp 25.000.000 (D)
   • Bank BCA: Rp 100.000.000 (D)
   • Hutang Usaha: Rp 15.000.000 (C)
   • Modal: Rp 110.000.000 (C)

Referensi Industry Seed Pack

Untuk mempercepat analisis, AI dapat melihat contoh seed data per industri di repository:

industry-seed/
  it-service/seed-data/       # Jasa IT & Konsultasi
  online-seller/seed-data/    # Toko Online / E-Commerce
  coffee-shop/seed-data/      # Kedai Kopi / F&B
  campus/seed-data/           # Kampus / Pendidikan

Setiap seed pack berisi file CSV lengkap (COA, template, produk, BOM, dll) yang bisa dijadikan referensi struktur.

---

Inisialisasi Data

Setelah menganalisis data existing, AI membuat file CSV dan mengirimnya ke aplikasi via POST /api/data-import.

Alur Kerja

1. AI generate file CSV sesuai format yang diharapkan
   |
2. AI membuat ZIP dari file-file CSV
   |
3. AI mengirim ZIP ke POST /api/data-import
   |
4. Aplikasi memproses ZIP: truncate tabel yang ada CSV-nya, lalu import
   |
5. AI memverifikasi data via GET /api/analysis/accounts
   |
6. AI membuat transaksi saldo awal jika diperlukan

Format CSV

ZIP berisi file CSV dengan nama berurut (dependency order). File utama untuk onboarding:

01_company_config.csv -- Konfigurasi perusahaan (1 baris data):

company_name,company_address,company_phone,company_email,tax_id,npwp,nitku,fiscal_year_start_month,currency_code,signing_officer_name,signing_officer_title,company_logo_path,established_date,is_pkp,pkp_since,industry

02_chart_of_accounts.csv -- Daftar akun:

account_code,account_name,account_type,parent_code,normal_balance,active,is_permanent

• account_type: ASSET, LIABILITY, EQUITY, REVENUE, EXPENSE
• normal_balance: DEBIT atau CREDIT
• parent_code: kosong jika akun top-level, isi kode parent jika sub-akun

04_journal_templates.csv -- Template jurnal:

template_name,category,cash_flow_category,template_type,description,is_system,active,version,usage_count,last_used_at,semantic_description,keywords,example_merchants,typical_amount_min,typical_amount_max,merchant_patterns

• category: REVENUE, EXPENSE, TRANSFER, ADJUSTMENT, PAYROLL, TAX, RECEIVABLE, PAYABLE, ASSET_PURCHASE, ASSET_DEPRECIATION
• cash_flow_category: OPERATING, INVESTING, FINANCING
• template_type: SIMPLE, VARIABLE, SPLIT, MULTI_LINE
• keywords, example_merchants, merchant_patterns: nilai dipisahkan dengan | (pipe)

05_journal_template_lines.csv -- Baris template jurnal:

template_name,line_order,account_code,account_hint,position,formula,description

• position: DEBIT atau CREDIT
• formula: AMOUNT (nilai penuh), AMOUNT * 0.11 (PPN 11%), dsb.

API Import

curl -X POST https://balaka.example.com/api/data-import \
  -H "Authorization: Bearer {accessToken}" \
  -F "file=@seed-data.zip"

Response (HTTP 201):

{
  "totalRecords": 45,
  "documentCount": 0,
  "durationMs": 1234
}

Populasi Saldo Awal

Setelah COA dan template ter-import, AI membuat transaksi saldo awal:

POST /api/transactions
Authorization: Bearer {accessToken}
Content-Type: application/json

{
  "templateId": "UUID-template-saldo-awal",
  "description": "Saldo awal per 31 Desember 2025",
  "amount": 125000000,
  "transactionDate": "2025-12-31",
  "source": "claude-code",
  "userApproved": true
}

Ulangi untuk setiap akun yang memiliki saldo awal. Atau gunakan data import dengan file 18_transactions.csv yang berisi transaksi saldo awal.

Verifikasi

# Cek COA ter-import
GET /api/analysis/accounts

# Cek saldo awal tercatat
GET /api/analysis/trial-balance?asOfDate=2025-12-31

# Cek neraca balance
GET /api/analysis/balance-sheet?asOfDate=2025-12-31

Catatan

• Import mengganti (truncate) data pada tabel yang memiliki CSV di dalam ZIP. Tabel tanpa CSV di ZIP tidak terpengaruh
• File CSV boleh hanya berisi header (tanpa data) -- tabel tersebut akan dilewati
• Lihat direktori industry-seed/ di source code untuk contoh lengkap seed data per industri

---

Pencatatan Transaksi

AI assistant mencatat transaksi akuntansi melalui API -- baik dari struk, invoice, text input, maupun input langsung.

Template Journal dengan Metadata

AI memilih template journal berdasarkan metadata semantik. Untuk melihat template yang tersedia:

GET /api/templates
Authorization: Bearer {accessToken}

Response (contoh 1 template):

[
  {
    "id": "1bbc7ccc-4e8f-44ef-87d3-0cd011fbc56d",
    "name": "Bayar Beban Listrik",
    "category": "EXPENSE",
    "semanticDescription": "Gunakan template ini untuk mencatat pembayaran tagihan listrik bulanan ke PLN.",
    "keywords": ["listrik", "electricity", "pln", "token", "utility"],
    "exampleMerchants": ["PLN", "PLN Mobile", "Tokopedia PLN"],
    "typicalAmountMin": 50000,
    "typicalAmountMax": 5000000,
    "merchantPatterns": [".*pln.*", ".*listrik.*"],
    "lines": [
      {
        "lineOrder": 1,
        "position": "DEBIT",
        "accountCode": "5.1.05",
        "accountName": "Beban Listrik",
        "accountHint": null,
        "formula": "AMOUNT"
      },
      {
        "lineOrder": 2,
        "position": "CREDIT",
        "accountId": null,
        "accountCode": null,
        "accountName": null,
        "accountHint": "Kas / Bank",
        "formula": "AMOUNT"
      }
    ]
  }
]

Keterangan:

• accountCode/accountName: Akun tetap (sudah ditentukan di template)
• accountHint: Akun yang perlu dipilih saat transaksi (gunakan accountSlots dengan accountHint sebagai key)

AI mencocokkan template berdasarkan: keyword matching, merchant matching, regex pattern (merchantPatterns), amount range, dan semantic similarity.

Posting Transaksi Langsung

Setelah matching template dan user approve:

POST /api/transactions
Authorization: Bearer {accessToken}
Content-Type: application/json

{
  "templateId": "UUID-template",
  "merchant": "PLN",
  "amount": 350000,
  "transactionDate": "2026-02-10",
  "description": "Bayar listrik Januari 2026",
  "source": "claude-code",
  "userApproved": true,
  "accountSlots": {
    "Kas / Bank": "UUID-akun-bank-bca"
  }
}

accountSlots memetakan accountHint dari template ke UUID akun yang dipilih.

Untuk template DETAILED (formula non-standar), tambahkan variables:

{
  "templateId": "UUID-template-pembelian-aset",
  "amount": 3681200,
  "transactionDate": "2026-02-12",
  "description": "Pembelian laptop Lenovo",
  "source": "claude-code",
  "userApproved": true,
  "accountSlots": {
    "ASET_TETAP": "UUID-akun-peralatan",
    "BANK": "UUID-akun-bank"
  },
  "variables": {
    "assetCost": 3681200
  }
}

Response:

{
  "transactionId": "83da31e4-acdc-4ca9-898e-df2cefbe95c7",
  "transactionNumber": "TRX-2026-0001",
  "status": "POSTED",
  "amount": 350000,
  "journalEntries": [
    {
      "accountCode": "5.1.05",
      "accountName": "Beban Listrik",
      "debitAmount": 350000,
      "creditAmount": 0
    },
    {
      "accountCode": "1.1.02",
      "accountName": "Bank BCA",
      "debitAmount": 0,
      "creditAmount": 350000
    }
  ]
}

Transaksi yang dibuat via AI terlihat di halaman Transaksi:

Alur Draft (Review Sebelum Posting)

Jika AI ingin user review sebelum posting, gunakan alur draft:

POST /api/drafts              → buat DRAFT
GET /api/transactions/{id}/journal-preview  → preview jurnal
PUT /api/transactions/{id}    → koreksi (opsional)
POST /api/transactions/{id}/post            → posting

Buat draft:

POST /api/drafts

{
  "templateId": "UUID-template",
  "description": "Bayar listrik Januari 2026",
  "amount": 350000,
  "transactionDate": "2026-02-10",
  "accountSlots": {
    "Kas / Bank": "UUID-akun-bank-bca"
  }
}

Preview jurnal:

GET /api/transactions/{id}/journal-preview

{
  "valid": true,
  "errors": [],
  "entries": [
    { "accountCode": "5.1.05", "accountName": "Beban Listrik", "debitAmount": 350000, "creditAmount": 0 },
    { "accountCode": "1.1.02", "accountName": "Bank BCA", "debitAmount": 0, "creditAmount": 350000 }
  ],
  "totalDebit": 350000,
  "totalCredit": 350000
}

Jika valid bernilai false, field errors berisi daftar masalah.

Posting:

POST /api/transactions/{id}/post

Batch posting:

POST /api/transactions/bulk-post

{
  "transactionIds": ["uuid-1", "uuid-2", "uuid-3"]
}

Koreksi dan Pembatalan

Koreksi draft PENDING:
  PATCH /api/drafts/{id}

Koreksi transaksi DRAFT (belum posted):
  PUT /api/transactions/{id}

Hapus transaksi DRAFT:
  DELETE /api/transactions/{id}

Void transaksi POSTED (reversing entries otomatis):
  POST /api/transactions/{id}/void

Purge transaksi VOID (hapus permanen):
  DELETE /api/transactions/purge-voided
  DELETE /api/transactions/purge-voided?before=2026-01-01

Purge transaksi VOID:

Menghapus permanen semua transaksi berstatus VOID beserta journal entries-nya. Detail transaksi yang dihapus dikembalikan dalam response sebagai backup.

DELETE /api/transactions/purge-voided
DELETE /api/transactions/purge-voided?before=2026-01-01

{
  "purgedTransactions": [
    {
      "id": "uuid",
      "transactionNumber": "TRX-2026-0042",
      "transactionDate": "2025-12-15",
      "amount": 500000,
      "description": "Pembayaran duplikat",
      "voidReason": "DUPLICATE",
      "voidedAt": "2026-01-05T10:30:00",
      "voidedBy": "admin"
    }
  ],
  "purgedCount": 1
}

Parameter:

• before (opsional): Hanya purge transaksi dengan tanggal sebelum tanggal ini (eksklusif, format YYYY-MM-DD)
• Tanpa parameter: purge semua transaksi VOID

Koreksi transaksi DRAFT:

PUT /api/transactions/{id}
{
  "templateId": "UUID-template-yang-benar",
  "description": "Deskripsi yang diperbaiki",
  "amount": 350000,
  "transactionDate": "2026-02-10",
  "accountSlots": {
    "Kas / Bank": "UUID-akun-bank-lain"
  }
}

Validasi:

• Hanya transaksi berstatus DRAFT yang bisa dikoreksi
• Tanggal transaksi tidak boleh di masa depan
• accountSlots dapat dikirim berulang kali (idempotent) -- slot sebelumnya akan diganti

Template CRUD via API

AI juga dapat membuat dan mengelola template jurnal:

GET /api/templates           → list semua template
GET /api/templates/{id}      → detail template
POST /api/templates          → buat template baru
PUT /api/templates/{id}      → update template
DELETE /api/templates/{id}   → hapus (soft delete)

---

Penggajian (Payroll)

AI mengelola siklus penggajian lengkap -- dari setup karyawan hingga posting jurnal gaji dan perhitungan PPh 21.

Alur Kerja

1. Setup komponen gaji
   POST /api/salary-components (Gaji Pokok, Tunjangan Transport, dll)
   |
2. Setup karyawan
   POST /api/employees
   POST /api/employees/{id}/salary-components (assign komponen + nominal)
   |
3. Buat payroll run bulanan
   POST /api/payroll { "month": 1, "year": 2026, "description": "Gaji Januari 2026" }
   |
4. Hitung PPh 21
   POST /api/payroll/{id}/calculate
   → Sistem menghitung: bruto → biaya jabatan → neto → PTKP → PKP → tarif progresif
   |
5. Review dan approve
   GET /api/payroll/{id} (review detail per karyawan)
   POST /api/payroll/{id}/approve
   |
6. Posting ke jurnal akuntansi
   POST /api/payroll/{id}/post
   |
7. Generate data pajak
   GET /api/payroll/employees/{id}/1721-a1?year=2026
   GET /api/payroll/pph21/summary?year=2026

Komponen Gaji

# List komponen aktif
GET /api/salary-components

# Buat komponen
POST /api/salary-components
{
  "name": "Gaji Pokok",
  "type": "EARNING",
  "taxable": true,
  "description": "Gaji pokok bulanan"
}

# Update
PUT /api/salary-components/{id}

# Nonaktifkan
DELETE /api/salary-components/{id}

Karyawan

# List karyawan (filter: active, status)
GET /api/employees?active=true

# Buat karyawan
POST /api/employees
{
  "employeeId": "EMP-001",
  "fullName": "Ahmad Fauzi",
  "email": "ahmad@example.com",
  "joinDate": "2024-01-15",
  "ptkpStatus": "K_1",
  "npwp": "12.345.678.9-012.000",
  "bankAccountNumber": "1234567890",
  "bankName": "BCA"
}

# Assign komponen gaji
POST /api/employees/{id}/salary-components
{
  "salaryComponentId": "UUID-gaji-pokok",
  "amount": 8000000,
  "effectiveDate": "2024-01-15"
}

Payroll Run

# Buat payroll (DRAFT)
POST /api/payroll
{
  "month": 1,
  "year": 2026,
  "description": "Gaji Januari 2026"
}

# Hitung PPh 21 (annualized progressive rate)
POST /api/payroll/{id}/calculate

# Review detail
GET /api/payroll/{id}
# → Response berisi detail per karyawan: bruto, potongan, neto, PPh 21

# Approve
POST /api/payroll/{id}/approve

# Post ke jurnal akuntansi
POST /api/payroll/{id}/post

# Hapus (hanya DRAFT)
DELETE /api/payroll/{id}

PPh 21

Perhitungan PPh 21 menggunakan metode annualisasi (Pasal 17 UU HPP):

Lapisan PKP	Tarif
0 - 60 juta	5%
60 - 250 juta	15%
250 - 500 juta	25%
500 juta - 5 miliar	30%
> 5 miliar	35%

PTKP (PMK 101/2016): TK/0 = Rp 54.000.000, K/0 = Rp 58.500.000, dst.

# Data 1721-A1 per karyawan
GET /api/payroll/employees/{id}/1721-a1?year=2026
# → Monthly breakdown: bruto, biaya jabatan, neto, PTKP, PKP, PPh 21

# Summary PPh 21 seluruh karyawan
GET /api/payroll/pph21/summary?year=2026

---

Tagihan Vendor (Bills)

AI membuat tagihan vendor dari invoice/dokumen yang diterima, lalu melacak pembayarannya.

Alur Kerja

1. AI menerima invoice vendor (PDF/foto)
   |
2. AI ekstrak data: vendor, tanggal, item, nominal
   |
3. AI buat bill
   POST /api/bills
   |
4. Review dan approve
   POST /api/bills/{id}/approve
   |
5. Setelah dibayar
   POST /api/bills/{id}/mark-paid

API

# List bills (filter: status, vendor, date range)
GET /api/bills?status=DRAFT&vendorId=UUID&dateFrom=2026-01-01&dateTo=2026-01-31

# Detail bill
GET /api/bills/{id}

# Buat bill
POST /api/bills
{
  "vendorName": "PT Telkom Indonesia",
  "billDate": "2026-02-01",
  "dueDate": "2026-02-28",
  "vendorInvoiceNumber": "INV-TLK-2026-001",
  "notes": "Tagihan internet Februari 2026",
  "lines": [
    {
      "description": "Internet Dedicated 100 Mbps",
      "quantity": 1,
      "unitPrice": 5500000,
      "taxRate": 11,
      "expenseAccountCode": "5.1.06"
    }
  ]
}

# Approve
POST /api/bills/{id}/approve

# Mark paid
POST /api/bills/{id}/mark-paid

vendorName akan otomatis membuat vendor baru jika belum ada di database.

---

Rekonsiliasi Bank

AI mengimpor mutasi bank, mencocokkan dengan transaksi di buku, dan menyelesaikan rekonsiliasi.

Alur Kerja

1. Setup parser config (format CSV bank)
   GET /api/bank-reconciliation/parser-configs
   POST /api/bank-reconciliation/parser-configs (jika belum ada)
   |
2. Import statement bank
   POST /api/bank-reconciliation/statements/import
   |
3. Buat reconciliation session
   POST /api/bank-reconciliation/reconciliations
   |
4. Auto-match (3 pass: exact → fuzzy date → keyword)
   POST /api/bank-reconciliation/reconciliations/{id}/auto-match
   |
5. Manual match untuk item yang tidak ter-match otomatis
   POST /api/bank-reconciliation/reconciliations/{id}/match
   |
6. Tandai item bank-only atau book-only
   POST /api/bank-reconciliation/reconciliations/{id}/mark-bank-only
   POST /api/bank-reconciliation/reconciliations/{id}/mark-book-only
   |
7. Buat transaksi dari item bank yang belum tercatat
   POST /api/bank-reconciliation/reconciliations/{id}/create-transaction
   |
8. Review summary
   GET /api/bank-reconciliation/reconciliations/{id}/summary
   |
9. Complete reconciliation
   POST /api/bank-reconciliation/reconciliations/{id}/complete

Import Statement

POST /api/bank-reconciliation/statements/import
Content-Type: multipart/form-data

# Form fields:
# - file: CSV file mutasi bank
# - bankAccountId: UUID akun bank (dari COA)
# - parserConfigId: UUID parser config
# - statementDate: tanggal statement (yyyy-MM-dd)

Auto-Match

POST /api/bank-reconciliation/reconciliations/{id}/auto-match

Sistem menjalankan 3 pass:

1. Exact match: Jumlah dan tanggal persis sama
2. Fuzzy date: Jumlah sama, tanggal selisih 1-3 hari
3. Keyword: Deskripsi bank mengandung keyword transaksi

Manual Match

POST /api/bank-reconciliation/reconciliations/{id}/match
{
  "bankStatementItemId": "UUID-item-bank",
  "transactionId": "UUID-transaksi"
}

Buat Transaksi dari Item Bank

Untuk mutasi bank yang belum ada transaksinya di buku:

POST /api/bank-reconciliation/reconciliations/{id}/create-transaction
{
  "bankStatementItemId": "UUID-item-bank",
  "templateId": "UUID-template",
  "description": "Deskripsi transaksi"
}

Outstanding Items

# Item yang belum ter-match
GET /api/bank-reconciliation/reconciliations/{id}/unmatched-book

# Outstanding items (bank vs book)
GET /api/bank-reconciliation/reconciliations/{id}/outstanding

---

Perpajakan

AI mengelola pelaporan pajak -- dari pengisian detail pajak per transaksi hingga export data untuk e-Faktur, e-Bupot, dan SPT.

Alur Kerja Pajak Bulanan

1. Transaksi harian sudah ter-posting dengan template yang benar
   (template PPN otomatis menghitung PPN 11%)
   |
2. AI mengisi detail pajak per transaksi
   POST /api/transactions/{id}/tax-details
   |
3. AI upload dokumen pendukung (faktur, bukti potong)
   POST /api/transactions/{id}/documents
   |
4. Akhir bulan: AI export data pajak
   GET /api/tax-export/efaktur-keluaran?startMonth=2026-01&endMonth=2026-01&format=json
   GET /api/tax-export/efaktur-masukan?startMonth=2026-01&endMonth=2026-01&format=json
   GET /api/tax-export/bupot-unifikasi?startMonth=2026-01&endMonth=2026-01&format=json
   |
5. AI review ringkasan
   GET /api/tax-export/ppn-detail?startMonth=2026-01&endMonth=2026-01
   GET /api/tax-export/pph23-detail?startMonth=2026-01&endMonth=2026-01
   |
6. AI generate data SPT PPh Badan (tahunan)
   GET /api/tax-export/pph-badan?year=2025
   GET /api/tax-export/rekonsiliasi-fiskal?year=2025

Detail Pajak per Transaksi

Setiap transaksi PPN/PPh perlu dilengkapi detail pajak (nomor faktur, NPWP lawan transaksi, dll):

# List tax details
GET /api/transactions/{id}/tax-details

# Tambah detail
POST /api/transactions/{id}/tax-details
{
  "taxType": "PPN_KELUARAN",
  "taxNumber": "010.000-26.00000001",
  "counterpartyNpwp": "01.234.567.8-901.000",
  "counterpartyName": "PT Klien ABC",
  "taxBase": 10000000,
  "taxAmount": 1100000,
  "taxDate": "2026-01-15"
}

# Update
PUT /api/transactions/{id}/tax-details/{detailId}

# Hapus
DELETE /api/transactions/{id}/tax-details/{detailId}

# Bulk operations
POST /api/tax-details/bulk

Dokumen Pendukung

# Upload dokumen
POST /api/transactions/{id}/documents
Content-Type: multipart/form-data
# Form field: file (PDF, image)

# List dokumen
GET /api/transactions/{id}/documents

# Download
GET /api/transactions/{id}/documents/{docId}

# Hapus
DELETE /api/transactions/{id}/documents/{docId}

Export Pajak

Semua endpoint export mendukung format=json (untuk AI) dan format=excel (untuk upload ke DJP):

# e-Faktur Keluaran (PPN yang dipungut)
GET /api/tax-export/efaktur-keluaran?startMonth=2026-01&endMonth=2026-01&format=json

# e-Faktur Masukan (PPN yang dibayar)
GET /api/tax-export/efaktur-masukan?startMonth=2026-01&endMonth=2026-01&format=json

# Bukti Potong Unifikasi (PPh 23/26)
GET /api/tax-export/bupot-unifikasi?startMonth=2026-01&endMonth=2026-01&format=json

# Detail PPN (ringkasan Keluaran vs Masukan)
GET /api/tax-export/ppn-detail?startMonth=2026-01&endMonth=2026-12

# Detail PPh 23 (ringkasan potongan)
GET /api/tax-export/pph23-detail?startMonth=2026-01&endMonth=2026-12

Koreksi Fiskal (SPT PPh Badan)

Untuk penyusunan SPT PPh Badan tahunan, AI mengelola koreksi fiskal:

# List koreksi fiskal per tahun
GET /api/fiscal-adjustments?year=2025

# Buat koreksi
POST /api/fiscal-adjustments
{
  "year": 2025,
  "category": "ENTERTAINMENT",
  "direction": "POSITIVE",
  "amount": 5000000,
  "description": "Biaya entertainment tanpa daftar nominatif",
  "notes": "Pasal 6 ayat 1 huruf a UU PPh"
}

# Update
PUT /api/fiscal-adjustments/{id}

# Hapus
DELETE /api/fiscal-adjustments/{id}

Rekonsiliasi Fiskal dan PPh Badan

# Rekonsiliasi fiskal (laba komersial → laba fiskal)
GET /api/tax-export/rekonsiliasi-fiskal?year=2025
# → Laba komersial, koreksi positif, koreksi negatif, laba fiskal

# Perhitungan PPh Badan
GET /api/tax-export/pph-badan?year=2025
# → PKP, tarif, PPh terutang, kredit pajak, kurang/lebih bayar

PPh 21 Karyawan

Data PPh 21 tersedia via Payroll API (lihat bagian Penggajian):

# 1721-A1 per karyawan
GET /api/payroll/employees/{id}/1721-a1?year=2026

# Summary PPh 21 seluruh karyawan
GET /api/payroll/pph21/summary?year=2026

---

Monitoring & Audit

Audit Log

Semua API call tercatat di audit log dengan detail:

• Event Type: API_CALL
• User: Username yang otorisasi device
• IP Address: IP address request
• Details: Source (claude-code), merchant, amount, confidence

Token Management (Self-Service)

Setiap user dapat melihat dan mencabut device token miliknya di halaman Perangkat API.

Lokasi: Sidebar > Master Data > Perangkat API, atau langsung buka /settings/devices

Informasi per token:

Kolom	Deskripsi
Perangkat	Nama device (jika diisi saat otorisasi)
Client ID	Identifier aplikasi (contoh: claude-code)
Scope	Hak akses token (contoh: drafts:create,analysis:read)
Status	Aktif (hijau) atau Kedaluwarsa (abu-abu)
Dibuat	Waktu token diterbitkan
Terakhir Digunakan	Waktu terakhir token digunakan
IP Terakhir	IP address terakhir yang menggunakan token

Aksi:

• Cabut (per token): Mencabut satu token tertentu
• Cabut Semua: Mencabut semua token aktif sekaligus

Catatan: Setelah token dicabut, AI assistant yang menggunakan token tersebut tidak dapat mengakses API lagi. User perlu melakukan device flow ulang untuk mendapatkan token baru.

Admin view: Administrator juga dapat melihat dan mencabut token dari halaman detail pengguna di menu Pengguna > klik user > bagian Sesi Perangkat Aktif.

---

API Reference

Discovery (public, tanpa autentikasi)

Method	Endpoint	Deskripsi
GET	/v3/api-docs	OpenAPI spec -- seluruh endpoint, schema, x- extensions
GET	/swagger-ui.html	Swagger UI -- eksplorasi API interaktif

Autentikasi (public)

Method	Endpoint	Deskripsi
POST	/api/device/code	Request device code
POST	/api/device/token	Poll for access token

Draft Transaksi (scope: drafts:*, transactions:post)

Method	Endpoint	Deskripsi
POST	/api/drafts	Buat DRAFT transaction dengan template + overrides
POST	/api/drafts/from-receipt	Buat draft dari struk
POST	/api/drafts/from-text	Buat draft dari teks
GET	/api/drafts/{id}	Get draft by ID
PATCH	/api/drafts/{id}	Koreksi draft PENDING
POST	/api/drafts/{id}/approve	Approve draft
POST	/api/drafts/{id}/reject	Reject draft

Template (scope: drafts:read, drafts:create)

Method	Endpoint	Deskripsi
GET	/api/templates	List templates dengan metadata dan lines
GET	/api/templates/{id}	Get single template dengan lines
POST	/api/templates	Buat template baru
PUT	/api/templates/{id}	Update template
DELETE	/api/templates/{id}	Hapus template (soft delete)

Transaksi (scope: transactions:post)

Method	Endpoint	Deskripsi
POST	/api/transactions	Post transaction langsung
PUT	/api/transactions/{id}	Koreksi transaksi DRAFT
DELETE	/api/transactions/{id}	Hapus transaksi DRAFT
POST	/api/transactions/{id}/post	Post satu transaksi DRAFT
POST	/api/transactions/{id}/void	Void transaksi POSTED
GET	/api/transactions/{id}/journal-preview	Preview jurnal entries
POST	/api/transactions/bulk-post	Batch post transaksi DRAFT
DELETE	/api/transactions/purge-voided	Hapus permanen transaksi VOID

Analisis Keuangan (scope: analysis:read)

Method	Endpoint	Deskripsi
GET	/api/analysis/company	Konfigurasi perusahaan
GET	/api/analysis/snapshot	KPI bulanan
GET	/api/analysis/trial-balance	Neraca saldo
GET	/api/analysis/income-statement	Laporan laba rugi
GET	/api/analysis/balance-sheet	Neraca
GET	/api/analysis/cash-flow	Laporan arus kas
GET	/api/analysis/tax-summary	Ringkasan pajak
GET	/api/analysis/receivables	Piutang usaha
GET	/api/analysis/payables	Hutang usaha
GET	/api/analysis/accounts	Daftar akun (COA)
GET	/api/analysis/accounts/{id}/ledger	Buku besar per akun
GET	/api/analysis/drafts	Draft transaksi pending
GET	/api/analysis/transactions	List transaksi dengan filter
GET	/api/analysis/transactions/{id}	Detail transaksi + jurnal entries
GET	/api/analysis/reports	Daftar laporan analisis

Publikasi Laporan Analisis (scope: analysis:write)

Method	Endpoint	Deskripsi
POST	/api/analysis/reports	Publikasi laporan analisis terstruktur

Tagihan Vendor (scope: bills:*)

Method	Endpoint	Deskripsi
GET	/api/bills	List bills dengan filter
GET	/api/bills/{id}	Detail bill
POST	/api/bills	Buat bill baru
POST	/api/bills/{id}/approve	Approve bill
POST	/api/bills/{id}/mark-paid	Mark bill as paid

Rekonsiliasi Bank (scope: bank-recon:*)

Method	Endpoint	Deskripsi
GET	/api/bank-reconciliation/parser-configs	List parser configs
POST	/api/bank-reconciliation/parser-configs	Buat parser config
POST	/api/bank-reconciliation/statements/import	Import statement CSV
GET	/api/bank-reconciliation/statements/{id}	Detail statement
GET	/api/bank-reconciliation/statements/{id}/items	Items statement
POST	/api/bank-reconciliation/reconciliations	Buat reconciliation session
GET	/api/bank-reconciliation/reconciliations/{id}	Detail reconciliation
POST	/api/bank-reconciliation/reconciliations/{id}/auto-match	Auto-match 3 pass
POST	/api/bank-reconciliation/reconciliations/{id}/match	Manual match
POST	/api/bank-reconciliation/reconciliations/{id}/mark-bank-only	Mark bank-only
POST	/api/bank-reconciliation/reconciliations/{id}/mark-book-only	Mark book-only
DELETE	/api/bank-reconciliation/reconciliations/{id}/items/{itemId}	Remove match
POST	/api/bank-reconciliation/reconciliations/{id}/create-transaction	Create from bank item
POST	/api/bank-reconciliation/reconciliations/{id}/complete	Complete reconciliation
GET	/api/bank-reconciliation/reconciliations/{id}/unmatched-book	Unmatched book items
GET	/api/bank-reconciliation/reconciliations/{id}/summary	Reconciliation summary
GET	/api/bank-reconciliation/reconciliations/{id}/statement	Statement data
GET	/api/bank-reconciliation/reconciliations/{id}/outstanding	Outstanding items

Komponen Gaji (scope: tax-export:read)

Method	Endpoint	Deskripsi
GET	/api/salary-components	Daftar komponen gaji aktif
POST	/api/salary-components	Buat komponen gaji
PUT	/api/salary-components/{id}	Update komponen gaji
DELETE	/api/salary-components/{id}	Nonaktifkan komponen gaji

Karyawan (scope: tax-export:read)

Method	Endpoint	Deskripsi
GET	/api/employees	Daftar karyawan
POST	/api/employees	Buat karyawan
GET	/api/employees/{id}	Detail karyawan + komponen gaji
PUT	/api/employees/{id}	Update data karyawan
POST	/api/employees/{id}/salary-components	Assign komponen gaji
PUT	/api/employees/{id}/salary-components/{componentId}	Update assignment

Payroll (scope: tax-export:read)

Method	Endpoint	Deskripsi
GET	/api/payroll	Daftar payroll run
POST	/api/payroll	Buat payroll run (DRAFT)
GET	/api/payroll/{id}	Detail payroll + semua detail karyawan
POST	/api/payroll/{id}/calculate	Hitung PPh 21
POST	/api/payroll/{id}/approve	Set APPROVED
POST	/api/payroll/{id}/post	Posting ke jurnal
DELETE	/api/payroll/{id}	Hapus payroll DRAFT
GET	/api/payroll/employees/{id}/1721-a1?year=YYYY	Data 1721-A1 per karyawan
GET	/api/payroll/pph21/summary?year=YYYY	Ringkasan PPh 21

Detail Pajak (scope: tax-export:read)

Method	Endpoint	Deskripsi
GET	/api/transactions/{id}/tax-details	List tax details per transaksi
GET	/api/transactions/{id}/tax-details/{detailId}	Detail satu tax detail
POST	/api/transactions/{id}/tax-details	Tambah tax detail
PUT	/api/transactions/{id}/tax-details/{detailId}	Update tax detail
DELETE	/api/transactions/{id}/tax-details/{detailId}	Hapus tax detail
POST	/api/tax-details/bulk	Bulk operations

Dokumen (scope: tax-export:read)

Method	Endpoint	Deskripsi
POST	/api/transactions/{id}/documents	Upload dokumen
GET	/api/transactions/{id}/documents	List dokumen
GET	/api/transactions/{id}/documents/{docId}	Download dokumen
DELETE	/api/transactions/{id}/documents/{docId}	Hapus dokumen

Export Pajak (scope: tax-export:read)

Method	Endpoint	Deskripsi
GET	/api/tax-export/efaktur-keluaran	Export e-Faktur Keluaran
GET	/api/tax-export/efaktur-masukan	Export e-Faktur Masukan
GET	/api/tax-export/bupot-unifikasi	Export Bukti Potong Unifikasi
GET	/api/tax-export/ppn-detail	Detail PPN (Keluaran vs Masukan)
GET	/api/tax-export/pph23-detail	Detail PPh 23
GET	/api/tax-export/rekonsiliasi-fiskal	Rekonsiliasi fiskal
GET	/api/tax-export/pph-badan	Perhitungan PPh Badan

Koreksi Fiskal (scope: tax-export:read)

Method	Endpoint	Deskripsi
GET	/api/fiscal-adjustments?year=YYYY	Daftar koreksi fiskal per tahun
POST	/api/fiscal-adjustments	Buat koreksi fiskal baru
PUT	/api/fiscal-adjustments/{id}	Update koreksi fiskal
DELETE	/api/fiscal-adjustments/{id}	Hapus koreksi fiskal

Manajemen Data (scope: data:import)

Method	Endpoint	Deskripsi
POST	/api/data-import	Import data dari file ZIP

Authentication

Endpoint yang tidak memerlukan autentikasi:

• GET /v3/api-docs
• GET /swagger-ui.html
• POST /api/device/code
• POST /api/device/token

Semua endpoint lainnya memerlukan Bearer token:

Authorization: Bearer {accessToken}

Rate Limiting

• Draft creation: 10 requests/menit per IP
• Transaction posting: 30 requests/menit per IP

Error Codes

Code	Error	Deskripsi
400	MISSING_PARAMETER	Parameter wajib tidak dikirim
400	INVALID_REQUEST	Request tidak valid
401	unauthorized	Token tidak valid atau expired
403	--	Scope tidak memadai
404	NOT_FOUND	Resource tidak ditemukan
409	CONFLICT	State conflict (contoh: transaksi sudah POSTED)
429	RATE_LIMIT_EXCEEDED	Terlalu banyak request
500	INTERNAL_ERROR	Server error

---

FAQ

Apakah data saya aman?

Ya. Autentikasi menggunakan OAuth 2.0 Device Flow yang merupakan standard industri. Access token:

• Tersimpan hanya di AI assistant Anda (tidak di server pihak ketiga)
• Berlaku maksimal 30 hari
• Dapat dicabut kapan saja di Settings

AI mana yang didukung?

API ini generik dan dapat digunakan oleh AI assistant apapun yang mendukung HTTP API:

• Claude Code
• Gemini CLI
• ChatGPT dengan plugin
• Custom script (curl, Python, dll)

Bagaimana jika AI salah pilih template?

1. Koreksi draft: PATCH /api/drafts/{id} sebelum approve
2. Koreksi transaksi DRAFT: PUT /api/transactions/{id} sebelum posting
3. Hapus dan buat ulang: DELETE /api/transactions/{id} lalu buat baru
4. Void transaksi POSTED: POST /api/transactions/{id}/void (reversing entries otomatis)
5. Edit di web: Setelah posted, edit di web UI

Bagaimana cara menambah metadata ke template?

1. Web UI: Buka template > Edit > bagian Metadata AI > isi field > Simpan. Lihat Referensi Template untuk detail field.
2. API: PUT /api/templates/{id}

Apakah AI bisa deploy aplikasi dari nol?

Ya. Berikan AI akses SSH ke VPS kosong dan arahkan ke repository GitHub. AI akan menjalankan Ansible playbook untuk instalasi lengkap (Java, PostgreSQL, Nginx, SSL, aplikasi). Lihat bagian "Instalasi dan Deploy".

Apakah AI bisa migrasi data dari Excel?

Ya. Berikan AI file Excel (buku besar, neraca, data transaksi). AI akan menganalisis struktur akun, merancang COA dan template jurnal, generate file CSV, lalu import ke aplikasi. Lihat bagian "Analisis Data Existing" dan "Inisialisasi Data".

---

Troubleshooting

Error: "Authentication required" (401)

Penyebab: Token tidak valid atau expired

Solusi:

1. Lakukan device flow authentication ulang
2. Pastikan token disimpan dengan benar di AI assistant
3. Cek apakah token sudah expired (30 hari)

Error: "Template not found" (404)

Penyebab: Template ID tidak valid

Solusi:

1. Refresh template list: GET /api/templates
2. Pastikan template ID ada di list
3. Jangan hardcode template ID, selalu fetch dari API

AI matching template yang salah

Penyebab: Metadata template belum lengkap atau keyword tidak match

Solusi:

1. Lengkapi metadata template: buka template > Edit > bagian Metadata AI
2. Tambahkan keyword yang lebih spesifik
3. Tambahkan merchant patterns (regex)
4. User bisa override template saat approve

Transaction failed to post

Penyebab:

• Template tidak balanced (debit != credit)
• Account tidak valid
• Tanggal transaksi invalid

Solusi:

1. Cek template lines (harus ada debit dan credit)
2. Cek account mapping
3. Pastikan tanggal tidak di masa depan

Data import gagal

Penyebab: Format CSV tidak sesuai

Solusi:

1. Cek nama file CSV (harus berurut: 01_company_config.csv, 02_chart_of_accounts.csv, dst)
2. Cek header CSV (harus persis sesuai format yang didokumentasikan)
3. Cek dependency order (template lines membutuhkan template dan COA sudah ter-import)
4. Lihat contoh di industry-seed/ untuk referensi format

Ansible deploy gagal

Penyebab: Konfigurasi server atau inventory tidak benar

Solusi:

1. Verifikasi SSH access: ssh user@server 'echo ok'
2. Pastikan server memenuhi prasyarat (Ubuntu 22.04+, 2GB RAM)
3. Cek Ansible inventory file (IP, user, variables)
4. Jika Flyway migration gagal, cek log: sudo journalctl -u aplikasi-akunting

---

Info: Dokumentasi ini ditulis berdasarkan test scenario yang sebenarnya. Semua screenshot dan JSON response diambil dari functional test yang berjalan pada aplikasi.