Panduan Pengguna - Aplikasi Akunting

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

---

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 dan isi nilai
5. Klik Simpan

---

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 dan isi nilai
5. Klik Simpan

---

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
   

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

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

Aplikasi menggunakan metode TER (Tarif Efektif Rata-rata) sesuai PP 58/2023.

Kalkulator PPh 21

Buka menu Penggajian > Kalkulator PPh 21.

1. Masukkan:
   • Gaji bruto bulanan
   • Status PTKP
   • Tunjangan-tunjangan
2. Sistem menghitung:
   • Penghasilan bruto
   • Biaya jabatan (5%, maks 500rb)
   • BPJS yang dibayar karyawan
   • Penghasilan neto
   • PKP (Penghasilan Kena Pajak)
   • PPh 21 terutang

Referensi (lihat Perpajakan)

• Tarif PPh 21 progresif
• PTKP per status

---

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.

---

1. Setup komponen dulu - Sebelum input karyawan
2. Verifikasi BPJS - Pastikan nomor BPJS valid
3. Review sebelum posting - Cek perhitungan PPh 21
4. Backup sebelum posting - Jurnal tidak bisa di-reverse
5. Arsip bukti potong - Simpan PDF untuk audit

---

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 mendukung pencatatan transaksi dengan bantuan AI assistant seperti Claude Code, Gemini CLI, atau asisten AI lainnya. AI assistant dapat membaca struk, invoice, atau dokumen keuangan lainnya, kemudian secara otomatis membuat transaksi akuntansi yang sesuai.

Fitur Utama:

• Autentikasi aman via OAuth 2.0 Device Flow
• AI membaca dan menganalisis dokumen (struk, invoice, bank statement)
• Template matching otomatis berdasarkan metadata
• User approval sebelum transaksi diposting
• Transaksi langsung tercatat (tanpa draft)
• Analisis keuangan: AI membaca laporan keuangan dan memberikan insight

---

Cara Kerja

Alur Umum

1. AI membaca OpenAPI spec (GET /v3/api-docs)
   ↓
2. AI melakukan autentikasi (OAuth 2.0 Device Flow)
   ↓
3. User mengirim struk/dokumen ke AI assistant
   ↓
4. AI menganalisis dokumen (merchant, jumlah, tanggal)
   ↓
5. AI mencocokkan template journal yang sesuai
   ↓
6. AI menampilkan preview dan meminta persetujuan user
   ↓
7. User menyetujui → AI posting transaksi ke aplikasi
   ↓
8. Transaksi tercatat di aplikasi

Keuntungan

• Cepat: Tidak perlu input manual di web
• Akurat: AI membaca struk dengan akurasi tinggi
• Konsisten: Template journal dipilih otomatis
• Audit Trail: Semua API call tercatat

---

API Discovery via OpenAPI Spec

Sebelum mulai berinteraksi dengan API, AI assistant sebaiknya membaca OpenAPI spec yang mendeskripsikan seluruh kemampuan API aplikasi ini. 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 8 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

Keuntungan

• Auto-generated: Spec di-generate langsung dari kode (controller annotations, DTO records), sehingga selalu sinkron
• Standard format: OpenAPI 3.x yang dipahami oleh semua AI assistant dan developer tools
• AI extensions: Metadata khusus AI (workflows, CSV specs, industries) disimpan di x- extensions
• Swagger UI: Eksplorasi API interaktif di /swagger-ui.html
• Tanpa autentikasi: AI dapat membaca spec sebelum melakukan device flow

Untuk pengembang AI assistant: Langkah pertama integrasi adalah 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 Anda. 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.

---

Template Journal dengan Metadata

AI memilih template journal berdasarkan metadata semantik yang terdapat pada setiap template.

Contoh Response Template API

GET /api/templates
Authorization: Bearer {accessToken}

Response (contoh 1 template, field lines disertakan):

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

Setiap template menyertakan array lines yang menunjukkan struktur jurnal:

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

Catatan: Semua template dari seed pack (IT Service, Online Seller, Coffee Shop, Campus) sudah dilengkapi metadata semantik untuk AI matching.

Cara AI Matching Template

AI menggunakan metadata untuk mencocokkan template:

1. Keyword matching: Cocokkan kategori/deskripsi dengan array keywords
2. Merchant matching: Cocokkan nama merchant dengan exampleMerchants
3. Regex pattern: Cocokkan dengan merchantPatterns
4. Amount range: Validasi jumlah dalam rentang typicalAmountMin - typicalAmountMax
5. Semantic similarity: Cocokkan deskripsi dengan semanticDescription

Contoh matching:

• User: "Bayar listrik PLN 350 ribu"
• AI matching:
  • Keyword: "listrik" ✓
  • Merchant: "PLN" ✓
  • Amount: 350000 (dalam range 50k-5jt) ✓
  • Result: Template "Bayar Beban Listrik"

---

Posting Transaksi Langsung

Setelah AI matching template dan user approve, AI langsung posting transaksi (tanpa draft).

Request

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

Body:

{
  "templateId": "9aa9c785-bb32-4e1e-80db-1c30a10aa3e3",
  "merchant": "Starbucks Grand Indonesia",
  "amount": 85000,
  "transactionDate": "2026-02-12",
  "currency": "IDR",
  "description": "Team coffee break at Starbucks",
  "category": "Food & Beverage",
  "items": ["Caffe Latte Grande", "Blueberry Muffin"],
  "source": "claude-code",
  "userApproved": true
}

Untuk template DETAILED yang menggunakan formula non-standar, tambahkan variables:

{
  "templateId": "UUID-template-pembelian-aset",
  "merchant": "Tokopedia",
  "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",
  "merchant": "Team coffee break at Starbucks",
  "amount": 85000,
  "transactionDate": "2026-02-12",
  "description": "Team coffee break at Starbucks",
  "journalEntries": [
    {
      "journalNumber": "JE-2026-0001-01",
      "accountCode": "5.1.01",
      "accountName": "Beban Gaji",
      "debitAmount": 85000,
      "creditAmount": 0
    },
    {
      "journalNumber": "JE-2026-0001-02",
      "accountCode": "2.1.10",
      "accountName": "Hutang Gaji",
      "debitAmount": 0,
      "creditAmount": 85000
    }
  ]
}

Verifikasi di Web UI

Setelah transaksi diposting, Anda dapat melihatnya di halaman Transaksi:

Transaksi yang dibuat via AI akan memiliki:

• Transaction Number: TRX-2026-0001 (auto-generated)
• Status: POSTED (langsung posted, bukan draft)
• Created By: Nama user yang otorisasi device

---

Buat Draft Langsung via API

Selain alur dari-teks/dari-struk, AI juga dapat membuat transaksi DRAFT langsung dengan template dan account overrides dalam satu panggilan. Alur ini cocok ketika AI sudah tahu template mana yang harus dipakai.

Request

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

Body:

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

Field accountSlots memetakan accountHint template ke akun yang dipilih. Key = string accountHint dari template line, Value = UUID akun. Gunakan GET /api/templates untuk melihat accountHint mana yang perlu diisi.

Template DETAILED (Formula Non-Standar)

Beberapa template menggunakan formula selain amount (contoh: template "Pembelian Aset Tetap" menggunakan formula assetCost). Untuk template seperti ini, tambahkan field variables yang memetakan nama variabel formula ke nilainya:

{
  "templateId": "UUID-template-pembelian-aset",
  "description": "Pembelian laptop Lenovo untuk operasional kantor",
  "amount": 3681200,
  "transactionDate": "2026-02-10",
  "accountSlots": {
    "ASET_TETAP": "UUID-akun-peralatan-kantor",
    "BANK": "UUID-akun-bank-bca"
  },
  "variables": {
    "assetCost": 3681200
  }
}

Field variables hanya diperlukan jika template menggunakan formula selain amount. Cek field formula di template lines (GET /api/templates) untuk mengetahui variabel yang dibutuhkan.

Response

{
  "transactionId": "uuid-transaksi-baru",
  "transactionNumber": null,
  "status": "DRAFT",
  "amount": 350000,
  "transactionDate": "2026-02-10",
  "description": "Bayar listrik Januari 2026",
  "journalEntries": []
}

Transaksi dibuat dalam status DRAFT. Langkah selanjutnya:

1. (Opsional) Preview jurnal: GET /api/transactions/{id}/journal-preview
2. (Opsional) Koreksi: PUT /api/transactions/{id}
3. Posting: POST /api/transactions/{id}/post

---

Preview Jurnal Sebelum Posting

Sebelum mem-posting transaksi DRAFT, AI dapat melihat preview jurnal yang akan dihasilkan:

GET /api/transactions/{id}/journal-preview
Authorization: Bearer {accessToken}

Response:

{
  "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 (contoh: akun belum dipilih untuk line dengan accountHint).

---

Koreksi Transaksi via AI

Jika AI salah mengklasifikasi transaksi atau ada kesalahan pada draft/transaksi, AI dapat memperbaikinya tanpa perlu intervensi manual di web UI.

Koreksi Draft (PENDING)

Draft yang masih berstatus PENDING dapat dikoreksi sebelum di-approve:

PATCH /api/drafts/{id}
Authorization: Bearer {accessToken}
Content-Type: application/json

Body (semua field opsional, hanya field yang dikirim yang diperbarui):

{
  "merchantName": "Starbucks Reserve",
  "amount": 95000,
  "description": "Coffee meeting with client",
  "suggestedTemplateId": "UUID-template-lain",
  "category": "Entertainment"
}

Approve Draft → transactionId

Setelah approve, response menyertakan transactionId dari transaksi yang dibuat:

POST /api/drafts/{id}/approve

Response:

{
  "draftId": "uuid-draft",
  "status": "APPROVED",
  "transactionId": "uuid-transaksi-yang-dibuat",
  "merchant": "Starbucks Reserve",
  "amount": 95000
}

Catatan: Draft endpoints mengembalikan draftId (bukan id) untuk membedakan konteks draft dari transaksi.

Koreksi Transaksi DRAFT (Belum Posted)

Transaksi yang sudah di-approve dari draft tetapi belum di-post (status DRAFT) dapat dikoreksi:

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

Body (semua field opsional):

{
  "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

Hapus Transaksi DRAFT

Transaksi DRAFT yang salah total dapat dihapus:

DELETE /api/transactions/{id}
Authorization: Bearer {accessToken}

Response: 204 No Content

Hanya transaksi berstatus DRAFT yang bisa dihapus. Transaksi yang sudah POSTED tidak bisa dihapus via API.

Alur Koreksi

Skenario 1: Koreksi sebelum approve
  PATCH /api/drafts/{id}  →  POST /api/drafts/{id}/approve

Skenario 2: Buat draft langsung, preview, lalu post
  POST /api/drafts  →  GET /api/transactions/{id}/journal-preview
  →  PUT /api/transactions/{id} (opsional)  →  POST /api/transactions/{id}/post

Skenario 3: Koreksi setelah approve, sebelum post
  PUT /api/transactions/{id}  →  POST /api/transactions/{id}/post

Skenario 4: Hapus dan buat ulang
  DELETE /api/transactions/{id}  →  (buat draft/transaksi baru)

Skenario 5: Void transaksi yang sudah POSTED
  POST /api/transactions/{id}/void  →  (status jadi VOID, reversing entries dibuat otomatis)

---

Analisis Keuangan via AI

Selain mencatat transaksi, AI assistant juga dapat menganalisis data keuangan perusahaan Anda. Aplikasi menyediakan 10 endpoint read-only di bawah /api/analysis yang mengembalikan data terstruktur — AI yang menginterpretasikan datanya.

Endpoint Analisis

Endpoint	Deskripsi	Parameter
GET /api/analysis/snapshot	KPI bulanan (revenue, expense, profit, cash)	month (yyyy-MM)
GET /api/analysis/trial-balance	Neraca saldo	asOfDate (yyyy-MM-dd)
GET /api/analysis/income-statement	Laporan laba rugi	startDate, endDate
GET /api/analysis/balance-sheet	Neraca	asOfDate
GET /api/analysis/cash-flow	Laporan arus kas	startDate, endDate
GET /api/analysis/tax-summary	Ringkasan pajak (PPN, PPh)	startDate, endDate
GET /api/analysis/receivables	Piutang usaha	asOfDate
GET /api/analysis/payables	Hutang usaha	asOfDate
GET /api/analysis/accounts	Daftar akun (COA)	—
GET /api/analysis/accounts/{id}/ledger	Buku besar per akun (running balance)	startDate, endDate
GET /api/analysis/drafts	Draft transaksi pending	—

Semua parameter wajib (tidak ada nilai default). Request tanpa parameter yang diperlukan akan mengembalikan HTTP 400.

Format Response

Semua endpoint mengembalikan format AnalysisResponse yang konsisten:

{
  "reportType": "trial-balance",
  "generatedAt": "2026-02-17T14:30:00",
  "parameters": {
    "asOfDate": "2026-01-31"
  },
  "data": { ... },
  "metadata": {
    "currency": "IDR",
    "accountingBasis": "accrual",
    "description": "Trial balance as of 2026-01-31..."
  }
}

Field metadata memberikan konteks yang membantu AI memahami data (mata uang, basis akuntansi, penjelasan arti debit/credit, dll).

Contoh: KPI Snapshot

GET /api/analysis/snapshot?month=2026-01
Authorization: Bearer {accessToken}

Response:

{
  "reportType": "snapshot",
  "generatedAt": "2026-02-17T14:30:00",
  "parameters": { "month": "2026-01" },
  "data": {
    "month": "2026-01",
    "revenue": 50000000,
    "revenueChange": 12.5,
    "expense": 35000000,
    "expenseChange": -3.2,
    "netProfit": 15000000,
    "profitChange": 8.7,
    "profitMargin": 30.0,
    "marginChange": 2.1,
    "cashBalance": 125000000,
    "receivablesBalance": 20000000,
    "payablesBalance": 15000000,
    "transactionCount": 47,
    "cashBankItems": [
      { "accountName": "Kas", "balance": 25000000 },
      { "accountName": "Bank BCA", "balance": 100000000 }
    ]
  },
  "metadata": {
    "currency": "IDR",
    "accountingBasis": "accrual",
    "description": "Financial KPI snapshot for 2026-01. Change percentages are vs previous month."
  }
}

Contoh: Neraca Saldo

GET /api/analysis/trial-balance?asOfDate=2026-01-31
Authorization: Bearer {accessToken}

Response (ringkasan):

{
  "reportType": "trial-balance",
  "data": {
    "items": [
      {
        "accountCode": "1.1.01",
        "accountName": "Kas",
        "accountType": "ASSET",
        "normalBalance": "DEBIT",
        "debitBalance": 25000000,
        "creditBalance": 0
      },
      {
        "accountCode": "4.1.01",
        "accountName": "Pendapatan Jasa",
        "accountType": "REVENUE",
        "normalBalance": "CREDIT",
        "debitBalance": 0,
        "creditBalance": 50000000
      }
    ],
    "totalDebit": 85000000,
    "totalCredit": 85000000
  }
}

Contoh: Draft Transaksi Pending

GET /api/analysis/drafts
Authorization: Bearer {accessToken}

Response:

{
  "reportType": "drafts",
  "data": {
    "items": [
      {
        "id": "a1b2c3d4-...",
        "status": "PENDING",
        "merchantName": "Starbucks Grand Indonesia",
        "amount": 85000,
        "currency": "IDR",
        "transactionDate": "2026-02-12",
        "source": "API",
        "apiSource": "claude-code",
        "overallConfidence": 0.95,
        "suggestedTemplateName": "Konsumsi Karyawan",
        "createdBy": "admin",
        "createdAt": "2026-02-12T14:30:00"
      }
    ],
    "pendingCount": 1
  }
}

AI dapat menggunakan data ini untuk merekomendasikan approval draft dengan confidence tinggi, atau menandai draft yang perlu review manual.

Contoh Interaksi Analisis

User:

Bagaimana kondisi keuangan bulan Januari?

AI:

Berdasarkan data keuangan Januari 2026:

Revenue:     Rp 50.000.000 (+12.5% vs Desember)
Expense:     Rp 35.000.000 (-3.2% vs Desember)
Net Profit:  Rp 15.000.000 (+8.7%)
Margin:      30.0%

Kas & Bank:
  - Kas:      Rp 25.000.000
  - Bank BCA: Rp 100.000.000

Piutang:     Rp 20.000.000
Hutang:      Rp 15.000.000

Bulan ini cukup baik — revenue naik, expense turun, dan
profit margin meningkat 2.1 poin.

User:

Ada pajak yang perlu dibayar?

AI:

Berdasarkan ringkasan pajak Januari 2026:

PPN Keluaran:  Rp 5.000.000
PPN Masukan:   Rp 2.000.000
PPN Kurang Bayar: Rp 3.000.000

PPh 23:        Rp 1.500.000 (sudah dipotong)
PPh 21:        Rp 2.800.000 (gaji karyawan)

Total kewajiban pajak bulan ini: Rp 7.300.000
Batas setor PPN: 31 Februari 2026

Otorisasi Scope

Token yang diterbitkan melalui Device Flow secara otomatis memiliki scope berikut:

• 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 vendor bills

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

---

Inisialisasi Data Klien Baru

Untuk onboarding klien baru, AI membaca laporan keuangan klien (XLS/PDF neraca, laba rugi), mengekstrak struktur Chart of Accounts dan template jurnal, lalu menginisialisasi aplikasi secara programatis via POST /api/data-import.

Alur Kerja

1. AI menerima file XLS/PDF laporan keuangan klien
   ↓
2. AI mengekstrak struktur COA, template jurnal, dan data awal
   ↓
3. AI menghasilkan file CSV sesuai format yang diharapkan
   ↓
4. AI membuat ZIP dari file-file CSV tersebut
   ↓
5. AI mengirim ZIP ke POST /api/data-import
   ↓
6. Aplikasi memproses ZIP: truncate tabel yang ada data CSV-nya, lalu import
   ↓
7. Klien baru siap menggunakan aplikasi dengan COA dan template yang sesuai

Format CSV

ZIP berisi file CSV dengan nama berurut (dependency order). File yang paling umum untuk onboarding klien baru:

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.

Contoh Penggunaan API

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

Response (HTTP 201):

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

Referensi

• Lihat direktori industry-seed/ di source code untuk contoh lengkap seed data per industri (it-service, online-seller, coffee-shop)
• 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

---

Contoh Interaksi dengan AI

Skenario 1: Struk Kopi Starbucks

User:

[Kirim foto struk Starbucks]

AI:

📄 Saya menganalisis struk:
   • Merchant: Starbucks Grand Indonesia
   • Jumlah: Rp 85.000
   • Tanggal: 12 Feb 2026
   • Item: Caffe Latte Grande, Blueberry Muffin

   Template yang cocok: "Konsumsi Karyawan" (confidence: 0.95)

   Posting transaksi ini?
   ✓ Ya
   ✏️ Edit dulu
   🔄 Pilih template lain
   ✗ Batal

User:

Ya

AI:

✓ Transaksi berhasil diposting!
  Nomor: TRX-2026-0001
  Status: POSTED

  Jurnal:
  [DEBIT]  Beban Konsumsi Karyawan: Rp 85.000
  [CREDIT] Kas: Rp 85.000

Skenario 2: Text Input Listrik

User:

Bayar listrik PLN 350 ribu

AI:

📄 Saya memahami:
   • Merchant: PLN
   • Jumlah: Rp 350.000
   • Kategori: Utilities

   Template yang cocok: "Bayar Beban Listrik"

   Posting?

User:

Ya, tapi edit deskripsi dulu

AI:

Deskripsi apa yang Anda inginkan?

User:

Listrik bulan Januari 2026

AI:

✓ Siap posting:
  • Merchant: PLN
  • Jumlah: Rp 350.000
  • Deskripsi: "Listrik bulan Januari 2026"
  • Template: Bayar Beban Listrik

  Posting sekarang? (ya/tidak)

User:

ya

AI:

✓ Posted TRX-2026-0002

---

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 sendiri di halaman Perangkat API.

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

Informasi yang ditampilkan 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 untuk API call
IP Terakhir	IP address terakhir yang menggunakan token

Aksi yang tersedia:

• 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

Endpoint Summary

Discovery (public, tanpa autentikasi):

Method	Endpoint	Deskripsi
GET	/v3/api-docs	OpenAPI spec — seluruh endpoint, schema, x- extensions (workflow, scope, CSV specs)
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 langsung 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 (response menyertakan transactionId)
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 (termasuk accountSlots)
DELETE	/api/transactions/{id}	Hapus transaksi DRAFT
POST	/api/transactions/{id}/post	Post satu transaksi DRAFT
POST	/api/transactions/{id}/void	Void transaksi POSTED (buat reversing entries)
GET	/api/transactions/{id}/journal-preview	Preview jurnal entries sebelum posting
POST	/api/transactions/bulk-post	Batch post transaksi DRAFT

Analisis Keuangan (scope: analysis:read):

Method	Endpoint	Deskripsi
GET	/api/analysis/company	Konfigurasi perusahaan (industry, currency, fiscal year)
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 (running balance)
GET	/api/analysis/drafts	Draft transaksi pending
GET	/api/analysis/transactions	List transaksi dengan filter (status, category, date range, search)
GET	/api/analysis/transactions/{id}	Detail transaksi dengan 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

Manajemen Data (scope: data:import):

Method	Endpoint	Deskripsi
POST	/api/data-import	Import data dari file ZIP (COA, template, transaksi)

Authentication

Endpoint yang tidak memerlukan autentikasi:

• GET /v3/api-docs (OpenAPI spec)
• GET /swagger-ui.html (Swagger UI)
• 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 (contoh: asOfDate)
400	INVALID_REQUEST	Request tidak valid (field required kosong, dll)
401	unauthorized	Token tidak valid atau expired
403	—	Scope tidak memadai (contoh: token tanpa analysis:read)
404	NOT_FOUND	Template/resource tidak ditemukan
409	CONFLICT	State conflict (contoh: transaksi sudah POSTED, tidak bisa dihapus)
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?

Anda bisa:

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

Apakah bisa batch import banyak transaksi?

Saat ini belum. Fitur batch import via CSV/Excel akan ditambahkan di versi berikutnya.

Bagaimana cara menambah metadata ke template?

Administrator dapat menambah metadata via:

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

---

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 yang dipilih 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

---

Lihat Juga

• Setup Awal - Setup aplikasi pertama kali
• Tutorial Akuntansi - Dasar-dasar akuntansi
• Rekonsiliasi Bank - Bank reconciliation (data tersedia via /api/analysis)
• API Documentation - Technical API reference

---

Pengembangan Selanjutnya

Fitur yang akan ditambahkan:

• [ ] Batch transaction import (CSV/Excel)
• [x] Template metadata management UI
• [ ] Webhook notifications (transaksi berhasil/gagal)
• [ ] AI confidence feedback loop
• [ ] Multi-currency support dengan auto-conversion
• [ ] PDF invoice parsing
• [ ] Template suggestion improvement (machine learning)

---

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

Setelah AI membaca data keuangan via endpoint /api/analysis/*, AI dapat menganalisis data tersebut dan mempublikasikan hasilnya kembali ke aplikasi. Laporan yang dipublikasikan langsung tersedia di web UI sehingga seluruh tim (akuntan, pemilik, manajer) dapat membacanya.

Konfigurasi Industri

Sebelum AI melakukan analisis, pastikan industri perusahaan sudah diatur di Pengaturan > Perusahaan > Industri. AI membaca konfigurasi ini via GET /api/analysis/company untuk menentukan metrik dan analisis yang relevan.

Industri yang didukung:

Kode	Nama	Fokus Analisis
it-service	Jasa IT & Konsultasi	Utilisasi, DSO, margin proyek, konsentrasi klien
online-seller	Toko Online / E-Commerce	Margin per channel, inventory turnover, fee marketplace, cash conversion cycle
coffee-shop	Kedai Kopi / F&B	Food cost %, labor cost %, prime cost, waste %, BOM costing
campus	Kampus / Pendidikan	Kolektibilitas SPP, rasio biaya akademik, beasiswa, deferred revenue

Struktur Laporan

Laporan analisis terdiri dari 5 bagian terstruktur:

Bagian	Deskripsi
Ringkasan Eksekutif	Paragraf singkat kondisi keuangan periode ini
Indikator Utama	Metrik KPI spesifik industri dengan perubahan vs periode sebelumnya
Temuan	Hal-hal yang perlu diperhatikan, dengan kategori dan severity
Rekomendasi	Langkah-langkah yang disarankan, dengan prioritas dan dampak
Penilaian Risiko	Risiko yang teridentifikasi beserta mitigasi

API Publikasi

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

Field industry diisi sesuai konfigurasi perusahaan. Field reportType diisi sesuai jenis analisis per industri (lihat tabel di bawah).

Membaca Konfigurasi Perusahaan

GET /api/analysis/company
Authorization: Bearer {accessToken}

Response berisi industry, currencyCode, fiscalYearStartMonth, dan isPkp — informasi yang AI butuhkan untuk memilih metrik yang tepat.

Daftar Laporan via API

GET /api/analysis/reports
Authorization: Bearer {accessToken}

Mengembalikan semua laporan yang sudah dipublikasikan, terbaru lebih dulu.

---

Analisis per Industri: Jasa IT & Konsultasi (it-service)

Tipe Laporan

reportType	Kegunaan	Frekuensi
utilization-review	Review utilisasi billable konsultan	Bulanan
project-profitability	Analisis margin per proyek	Per proyek / bulanan
receivables-aging	Aging piutang & DSO analysis	Bulanan
client-concentration	Analisis konsentrasi pendapatan per klien	Kuartalan
tax-withholding-recon	Rekonsiliasi Bukti Potong PPh 23	Bulanan

Metrik Utama

Metrik	Formula	Benchmark
Utilisasi Billable	Jam billable / Total jam tersedia	70-80% (optimal 75%)
DSO (Days Sales Outstanding)	(Piutang / Pendapatan) x Hari	< 45 hari
Rasio Biaya Tenaga Kerja	Total gaji / Pendapatan	55-65%
Revenue per Konsultan	Pendapatan / Jumlah konsultan	Track trend
Margin Proyek	(Revenue proyek - Biaya langsung) / Revenue proyek	> 15% sehat, > 25% kuat
Konsentrasi Klien Top-3	Revenue 3 klien terbesar / Total revenue	< 60% sehat
Realization Rate	Revenue terkumpul / (Jam billable x Tarif standar)	> 80%

Kategori Temuan

utilisasi, piutang, profitabilitas-proyek, klien, pajak, bench-time

Risiko Spesifik

• Konsentrasi klien (1 klien > 20% revenue)
• Bench time (konsultan idle = pure cost)
• DSO creep (klien korporat bayar Net-60 sampai Net-90)
• Bukti Potong PPh 23 yang hilang (kehilangan kredit pajak 2%)
• Key-person dependency (revenue bergantung pada beberapa senior)

---

Analisis per Industri: Toko Online / E-Commerce (online-seller)

Tipe Laporan

reportType	Kegunaan	Frekuensi
marketplace-profitability	P&L per marketplace (Tokopedia, Shopee, dll)	Bulanan
inventory-health	Turnover, dead stock, aging persediaan	Bulanan
cash-conversion-cycle	Analisis siklus konversi kas	Bulanan
channel-comparison	Perbandingan profitabilitas antar channel	Kuartalan
shipping-cost-analysis	Analisis biaya pengiriman vs pendapatan	Bulanan

Metrik Utama

Metrik	Formula	Benchmark
Gross Margin per Channel	(Revenue - HPP - Fee marketplace) / Revenue	> 30%
Inventory Turnover	HPP / Rata-rata persediaan	4-8x/tahun
Dead Stock Ratio	Nilai stok mati / Total nilai persediaan	< 10%
Fee Marketplace Ratio	Total fee marketplace / Revenue	< 12%
Shipping Cost Ratio	Biaya kirim / Revenue	< 10%
Return Rate	Jumlah retur / Jumlah order	< 10%
Cash Conversion Cycle	DIO + DSO - DPO	< 60 hari
ROAS (Return on Ad Spend)	Revenue dari iklan / Belanja iklan	> 3:1

Kategori Temuan

margin, persediaan, arus-kas, marketplace, retur, pengiriman, iklan

Risiko Spesifik

• Kenaikan fee marketplace (platform menaikkan komisi secara berkala)
• Dead stock (modal terjebak di persediaan tidak laku > 180 hari)
• Cash conversion cycle panjang (bayar supplier duluan, pencairan marketplace 7-21 hari)
• Ketergantungan pada satu marketplace
• Subsidi ongkir menggerus margin pada produk AOV rendah

---

Analisis per Industri: Kedai Kopi / F&B (coffee-shop)

Tipe Laporan

reportType	Kegunaan	Frekuensi
food-cost-review	Analisis food cost % dan variance resep	Bulanan
labor-efficiency	Rasio biaya tenaga kerja dan produktivitas per shift	Bulanan
menu-engineering	Profitabilitas dan popularitas per menu item	Kuartalan
production-cost	Analisis biaya produksi BOM vs harga jual	Bulanan
daily-sales-analysis	Analisis penjualan harian, peak hours, average check	Mingguan

Metrik Utama

Metrik	Formula	Benchmark
Food Cost %	HPP / Revenue	20-30%
Labor Cost %	Total biaya tenaga kerja / Revenue	25-30%
Prime Cost %	(HPP + Biaya tenaga kerja) / Revenue	< 60%
Gross Margin	(Revenue - HPP) / Revenue	70-80%
Waste %	Nilai bahan terbuang / Total HPP	< 2-4%
Average Transaction Value	Revenue / Jumlah transaksi	Track trend
Inventory Turnover (perishable)	HPP perishable / Rata-rata stok perishable	> 4x/bulan
Variance Resep	(HPP aktual - HPP teoritis) / HPP teoritis	< 2%

Kategori Temuan

biaya-bahan, tenaga-kerja, produksi, penjualan, persediaan, waste

Risiko Spesifik

• Spoilage bahan perishable (susu, roti — shelf life pendek)
• Over-portioning (resep tidak terstandar, HPP aktual > teoritis)
• Kenaikan harga komoditas (kopi arabica, butter volatil)
• Prime cost > 65% (biaya bahan + tenaga kerja melampaui batas sehat)
• Ketergantungan lokasi (revenue sangat terkait foot traffic)

---

Analisis per Industri: Kampus / Pendidikan (campus)

Tipe Laporan

reportType	Kegunaan	Frekuensi
tuition-collection	Analisis kolektibilitas SPP per angkatan	Per semester
budget-realization	Realisasi RKAT vs anggaran	Per semester
scholarship-impact	Dampak beasiswa terhadap net tuition revenue	Per semester
faculty-cost-analysis	Analisis biaya dosen tetap vs tidak tetap	Per semester
enrollment-forecast	Proyeksi pendapatan berdasarkan tren pendaftaran	Tahunan

Metrik Utama

Metrik	Formula	Benchmark
SPP Collection Rate	SPP terkumpul / SPP tertagih	> 90%
Tuition Dependency Ratio	Pendapatan SPP / Total pendapatan	< 85% (semakin rendah semakin sehat)
Operating Margin	(Total pendapatan - Total beban) / Total pendapatan	> 5%
Biaya per Mahasiswa	Total beban operasional / Jumlah mahasiswa	Track trend
Days Cash on Hand	Kas / (Total beban / 365)	> 90 hari
Rasio Biaya Akademik	Beban akademik / Total beban operasional	30-40%
Rasio Biaya Administratif	Beban administratif / Total beban operasional	< 30%
Scholarship Expense Ratio	Total beban beasiswa / Gross SPP	Track (jaga agar tidak > 35%)
Piutang SPP > 90 Hari	Piutang SPP aging > 90 hari / Total piutang SPP	< 5%

Kategori Temuan

penerimaan-spp, beasiswa, biaya-akademik, biaya-administratif, aset-tetap, tren-pendaftaran

Risiko Spesifik

• Penurunan jumlah mahasiswa baru (dampak langsung ke uang pangkal dan pipeline SPP)
• Ketergantungan tinggi pada SPP (> 90%) tanpa diversifikasi pendapatan
• Cash flow musiman (penerimaan terkonsentrasi di awal semester, beban tersebar sepanjang tahun)
• Deferred maintenance gedung dan laboratorium (tropical climate mempercepat deteriorasi)
• Piutang SPP yang tidak tertagih dari mahasiswa non-aktif

---

Format Field API

Indikator Utama (metrics)

Field	Wajib	Deskripsi
name	Ya	Nama metrik sesuai industri
value	Ya	Nilai saat ini
previousValue	Tidak	Nilai periode sebelumnya
change	Tidak	Perubahan (contoh: "+12.5%", "+4pp", "+14 hari")
status	Tidak	positive (hijau), negative (merah), warning (kuning), neutral (abu-abu)

Temuan (findings)

Field	Wajib	Deskripsi
category	Ya	Kategori sesuai industri (lihat tabel per industri di atas)
severity	Ya	info (biru), warning (kuning), critical (merah)
description	Ya	Deskripsi temuan

Rekomendasi (recommendations)

Field	Wajib	Deskripsi
priority	Ya	high (merah), medium (kuning), low (abu-abu)
description	Ya	Deskripsi rekomendasi
impact	Tidak	Dampak yang diharapkan

Risiko (risks)

Field	Wajib	Deskripsi
severity	Ya	high (merah), medium (kuning), low (abu-abu)
description	Ya	Deskripsi risiko
mitigation	Tidak	Langkah mitigasi

Melihat Laporan di Web UI

Laporan yang sudah dipublikasikan dapat dilihat di menu Laporan > Analisis AI.

Halaman Daftar Laporan

Halaman daftar menampilkan semua laporan terbaru dengan:

• Badge industri (Jasa IT, Toko Online, Kedai Kopi, Kampus) dengan warna berbeda per industri
• Tipe laporan dan judul
• Ringkasan eksekutif (2 baris pertama)
• Periode, sumber AI, dan jumlah metrik/temuan

Halaman Detail Laporan

Klik laporan untuk melihat detail lengkap. Setiap industri menampilkan metrik KPI yang berbeda sesuai karakteristik bisnisnya.

Bagian atas: Badge industri, tipe laporan, header, ringkasan eksekutif, dan grid indikator utama.

Bagian bawah: Tabel temuan dengan severity badge, daftar rekomendasi yang diurutkan berdasarkan prioritas, dan penilaian risiko dengan langkah mitigasi.

Menghapus Laporan

Klik tombol Hapus di halaman detail untuk menghapus laporan (soft delete). Laporan yang dihapus tidak akan muncul di daftar.

Contoh Laporan per Industri

Jasa IT & Konsultasi

Metrik utama:

• Pendapatan Bulanan
• Beban Operasional
• Laba Bersih
• Margin Laba
• Saldo Kas
• Rasio Beban/Pendapatan

---

Toko Online / E-Commerce

Metrik utama:

• Penjualan Bersih
• HPP (Harga Pokok)
• Laba Kotor
• Gross Margin
• Biaya Marketplace
• Biaya Pengiriman

---

Kedai Kopi / F&B

Metrik utama:

• Pendapatan
• Food Cost %
• Labor Cost %
• Prime Cost %
• Laba Bersih
• Net Margin

---

Kampus / Pendidikan

Metrik utama:

• Pendapatan Total
• Pendapatan SPP
• Biaya Dosen & Akademik
• Rasio Beasiswa
• Surplus Operasional
• Margin Operasional

Contoh Alur Lengkap

1. AI membaca data keuangan
   GET /api/analysis/snapshot?month=2026-01
   GET /api/analysis/income-statement?startDate=2026-01-01&endDate=2026-01-31
   GET /api/analysis/receivables?asOfDate=2026-01-31
   ↓
2. AI menganalisis data dan membuat laporan terstruktur
   ↓
3. AI mempublikasikan laporan
   POST /api/analysis/reports
   ↓
4. Tim membuka menu Laporan > Analisis AI di web browser
   ↓
5. Akuntan membaca temuan, rekomendasi, dan risiko
   ↓
6. Tindak lanjut: buat jurnal penyesuaian, tagih piutang, dll.

---