title: “Bank Accounts” description: “Manajemen rekening bank, kas, dan e-wallet perusahaan — 4 tipe akun, saldo real-time, transfer antar rekening, deposit/withdrawal workflow, dan integrasi POS di SNISHOP ERP.”

Bank Accounts

Halaman Bank Accounts (atau Saldo) mengelola seluruh rekening keuangan perusahaan: kas, bank, dan e-wallet. Sistem mendukung 4 tipe akun, saldo real-time yang di-refresh setiap 30 detik, workflow deposit dengan upload bukti transfer, withdrawal dengan approval admin, dan integrasi langsung dengan POS melalui flag is_default_pos. Setiap akun terhubung ke Chart of Accounts (COA) untuk pelaporan keuangan.

Arsitektur Akun Keuangan

Entity Account

Field Account

Field	Tipe	Deskripsi
name	string	Nama akun (BCA Rupiah, Kas Utama, GoPay)
type	enum	cash, bank, e-wallet, other
account_number	string	Nomor rekening
initial_balance	number	Saldo awal saat pembuatan
current_balance	number	Saldo terkini (server-authoritative)
is_default_pos	boolean	Akun default untuk transaksi POS
coa_code	string	Kode COA (1-1100, 1-1200, dst)
company_id	UUID	Multi-tenant isolation

COA Code Mapping

Tipe Akun	Kode COA Default	Contoh
cash	1-1000	Kas Utama, Kas Cabang
bank	1-1100	BCA Rupiah, Mandiri Rupiah
e-wallet	1-1200	GoPay, OVO, DANA
other	1-4000	Rekening PayPal, Rekening Stripe

Add Bank Account

Step-by-Step

Klik “Tambah Rekening” di halaman Saldo
Isi form:

Field	Required	Deskripsi
Nama Akun	✓	Contoh: BCA Rupiah, Kas Utama
Tipe	✓	cash, bank, e-wallet, other
Nomor Rekening	✓	Nomor rekening bank
Saldo Awal	✓	Saldo saat akun dibuat
Kode COA	Opsional	Auto-inferred dari tipe jika kosong
Default POS	Opsional	Centang jika ingin jadi akun default POS

Klik “Simpan”
Sistem create Account entity dengan current_balance = initial_balance

Multiple Accounts

Sistem mendukung unlimited rekening:

Bank	Contoh Rekening
BCA	BCA Rupiah, BCA Dollar
Mandiri	Mandiri Rupiah, Mandiri Bisnis
BNI	BNI Rupiah
BRI	BRI Rupiah
E-Wallet	GoPay, OVO, DANA, ShopeePay
Kas	Kas Utama, Kas Cabang, Kas Kecil

Saldo Real-Time

Auto-Refresh

Sistem auto-refresh setiap 30 detik
Menampilkan current_balance (server-authoritative)
Bukan field balance (undeclared, tidak digunakan)

Balance Monitoring

Indikator	Deskripsi
Saldo Saat Ini	`current_balance` dari server
Saldo Tersedia	Saldo - pending transactions
Pending Transactions	Transaksi yang belum cleared
Last Updated	Timestamp terakhir refresh

Balance Alerts

Alert	Trigger	Aksi
Low Balance	Saldo < threshold	Notifikasi kuning
Negative Balance	Saldo < 0	Notifikasi merah
Unusual Transaction	Transaksi tidak biasa	Review required
Reconciliation Overdue	Belum rekonsiliasi > 30 hari	Reminder

Deposit Workflow

Deposit Rules

Rule	Value
Minimum deposit	Rp 10.000
Bukti transfer	Required (JPG, PNG, PDF)
Approval	Manual oleh admin/finance
Balance update	Setelah approved

Withdrawal Workflow

Withdrawal Rules

Rule	Value
Minimum withdrawal	Rp 50.000
Balance check	current_balance >= amount
Approval	Required dari admin
Balance update	Setelah approved

Transfer Antar Rekening

Transfer Rules

Rule	Deskripsi
Akun asal ≠ tujuan	Tidak bisa transfer ke akun yang sama
Balance check	Saldo asal harus cukup
Net zero	Total saldo perusahaan tidak berubah
Journal entry	Otomatis dibuat untuk audit trail

Transfer di Laporan

All accounts view: Transfer net zero (tidak mempengaruhi total)
Single account view: Transfer tercatat sebagai inflow/outflow

POS Integration

Default POS Account

Flag is_default_pos menentukan akun mana yang menerima revenue dari POS:

Multiple POS Accounts

Jika ada multiple outlet, setiap outlet bisa punya akun POS sendiri:

Outlet	Default POS Account
Toko Offline	Kas Toko
Gudang	BCA Gudang
Cabang 2	Mandiri Cabang 2

Transaction Tracking

Incoming Transactions

Sumber	Deskripsi
Customer Payment	Pembayaran invoice
POS Revenue	Revenue dari transaksi POS
Transfer In	Transfer dari rekening lain
Deposit	Deposit yang sudah approved
Interest Income	Bunga bank
Other Income	Pendapatan lain

Outgoing Transactions

Sumber	Deskripsi
Supplier Payment	Pembayaran PO
Expense Payment	Pembayaran expense
Transfer Out	Transfer ke rekening lain
Withdrawal	Withdrawal yang sudah approved
Other Expense	Pengeluaran lain

Transaction Details

Field	Deskripsi
Date	Tanggal transaksi
Amount	Nominal
Description	Keterangan
Reference Number	Nomor referensi
Category	Kategori transaksi
Status	cleared, pending
Source	pos, invoice, expense, transfer, dll

Rekonsiliasi Bank

Import Bank Statement

Download statement dari bank (CSV/Excel)
Upload ke sistem
Auto-match berdasarkan nominal + tanggal
Review unmatched items
Complete reconciliation

Manual Reconciliation

Input statement balance
List outstanding items
Calculate adjusted balance
Compare with system balance
Investigate differences

Reconciliation Report

Item	Deskripsi
Reconciled Items	Transaksi yang sudah cocok
Unreconciled Items	Transaksi yang belum cocok
Differences	Selisih
Resolution Actions	Tindakan koreksi

Reporting

Bank Statement

Report	Deskripsi
Monthly Statement	Laporan bulanan per rekening
Transaction List	Daftar transaksi
Balance Summary	Ringkasan saldo
Reconciliation Status	Status rekonsiliasi

Cash Flow Report

Component	Deskripsi
Cash Inflow	Total uang masuk
Cash Outflow	Total uang keluar
Net Cash Flow	Inflow - Outflow
Cash Position	Posisi kas terkini

Best Practices

Security

Limit akses ke rekening bank (hanya owner/finance)
Regular password change
Two-factor authentication
Audit trail untuk semua transaksi

Reconciliation

Rekonsiliasi minimal sebulan sekali
Investigate semua differences
Document adjustments
Keep records untuk audit

Monitoring

Check balance harian
Review transactions mingguan
Monitor alerts
Report discrepancies segera

Entity Schema & Relasi ke General Ledger

ER Diagram — Bank Account Entities

Tabel Schema — BankAccount

Field	Tipe	Required	Default	Deskripsi
id	string (UUID)	✓ (auto)	—	Primary key
user_id	string (UUID)	—	—	ID pengguna pemilik akun
company_id	string (UUID)	—	—	ID perusahaan pemilik rekening (multi-tenant)
account_type	enum	✓	—	Jenis akun: `bank` atau `ewallet`
provider	string	✓	—	Nama penyedia: BRI, BNI, BCA, DANA, GOPAY, dst
account_name	string	✓	—	Nama pemilik rekening
account_number	string	✓	—	Nomor rekening bank atau nomor telepon E-Wallet
description	string	—	—	Catatan tambahan (max 1000 karakter)
is_primary	boolean	—	`false`	Penanda rekening utama perusahaan
balance	number	—	`0`	Saldo rekening untuk tracking internal
is_active	boolean	—	`true`	Status aktif rekening

Tabel Schema — Account (Field Relevan)

Field	Tipe	Required	Default	Deskripsi
id	string (UUID)	✓ (auto)	—	Primary key
user_id	string (UUID)	✓	—	ID pengguna pemilik rekening
company_id	string (UUID)	—	—	ID perusahaan (null untuk personal)
name	string	✓	—	Nama rekening/kantong (Kas, BCA, Mandiri, GoPay)
type	enum	✓	`cash`	Jenis: `cash`, `bank`, `e-wallet`, `other`
account_number	string	—	—	Nomor rekening (opsional)
bank_name	string	—	—	Nama bank (untuk type=bank)
initial_balance	number	—	`0`	Saldo awal saat pembuatan
current_balance	number	—	`0`	Saldo server-authoritative (di-update oleh POS, invoice, expense, void)
currency	string	—	`IDR`	Mata uang
icon	string	—	💰	Icon rekening untuk UI
color	string	—	`#3B82F6`	Warna untuk UI
is_active	boolean	—	`true`	Status aktif rekening
is_default_pos	boolean	—	`false`	Rekening default untuk POS Kasir
notes	string	—	—	Catatan tambahan
mode	enum	—	`personal`	Mode: `personal` atau `business`

Field	Tipe	Required	Default	Deskripsi
id	string (UUID)	✓ (auto)	—	Primary key
company_id	string (UUID)	✓	—	ID perusahaan
entry_date	date	✓	—	Tanggal entri jurnal
reference_number	string	—	—	Nomor referensi (TRX-001, INV-001)
reference_type	enum	—	—	Tipe sumber: `manual`, `invoice`, `purchase_order`, `transfer`, `expense`
reference_id	string	—	—	ID dokumen sumber
description	string	✓	—	Deskripsi jurnal
line_items	array	✓	—	Line items debit/credit (account_id, account_code, debit, credit, description)
total_debit	number	—	`0`	Total debit
total_credit	number	—	`0`	Total credit
is_balanced	boolean	—	`false`	Apakah debit = credit
status	enum	—	`draft`	Status: `draft`, `posted`, `reversed`
posted_date	date	—	—	Tanggal posting
posted_by	string	—	—	User yang memposting
notes	string	—	—	Catatan tambahan

Tabel Schema — FinancialRecord (Transaksi Keuangan)

Field	Tipe	Required	Default	Deskripsi
id	string (UUID)	✓ (auto)	—	Primary key
user_id	string (UUID)	✓	—	ID pengguna
company_id	string (UUID)	—	—	ID perusahaan
account_id	string (UUID)	—	—	ID rekening sumber dana
type	enum	✓	—	Jenis: `income`, `expense`, `transfer`
amount	number	✓	—	Jumlah transaksi
category	string	—	—	Kategori transaksi
description	string	—	—	Deskripsi singkat
date	datetime	✓	—	Tanggal transaksi
attachment_url	string	—	—	URL bukti transaksi
source	enum	—	`manual`	Sumber: `manual`, `ai_text`, `ai_scan`, `pos`, `manufacturing`, `distribution`, `recall`, `stock_opname`
mode	enum	—	`personal`	Mode: `personal` atau `business`
transfer_to_account_id	string	—	—	ID rekening tujuan (untuk type=transfer)
transfer_fee	number	—	`0`	Biaya transfer
reference_id	string	—	—	ID referensi sumber (invoice, POS, expense)
reference_type	enum	—	—	Tipe referensi: `invoice_payment`, `pos_transaction`, `expense`, `manual`, `transfer`, dst
idempotency_key	string	—	—	Kunci idempoten (cegah duplikasi)
is_inventory_material	boolean	—	`false`	Pembelian bahan baku (anti double-counting HPP)
channel_fee	number	—	`0`	Potongan biaya marketplace
cogs_amount	number	—	`0`	HPP/COGS yang dibekukan saat transaksi POS
tax_amount	number	—	`0`	Jumlah pajak (PPN keluaran)

State Machine — Status Rekening Bank

Transisi Status

Dari	Ke	Trigger	Syarat
—	Active	Create rekening	Validasi field required
Active	Frozen	Admin freeze	Alasan investigasi wajib diisi
Active	Closed	Admin/User close	Saldo harus = 0 atau dipindahkan
Frozen	Active	Admin unfreeze	Approval dari finance manager
Frozen	Closed	Admin close	Investigasi selesai, saldo = 0

Implikasi Status terhadap Operasi

Operasi	Active	Frozen	Closed
Deposit	✓	✗	✗
Withdrawal	✓	✗	✗
Transfer In	✓	✗	✗
Transfer Out	✓	✗	✗
POS Payment	✓	✗	✗
Lihat Saldo	✓	✓ (read-only)	✓ (snapshot)
Riwayat Transaksi	✓	✓	✓ (archive)

Sequence Diagram — Rekonsiliasi Bank

Status Rekonsiliasi per Transaksi

Status	Deskripsi	Aksi Selanjutnya
matched	Transaksi internal cocok dengan statement bank	Tidak perlu aksi
unmatched_internal	Ada di sistem tapi tidak di statement bank	Investigasi: timing difference atau error
unmatched_external	Ada di statement bank tapi tidak di sistem	Input transaksi yang hilang
adjusted	Sudah dikoreksi secara manual	Journal entry dibuat
pending_review	Menunggu review finance	Finance harus approve/reject

Sequence Diagram — Transfer Antar Rekening

Aturan Transfer

Aturan	Deskripsi
Akun asal ≠ tujuan	Tidak bisa transfer ke diri sendiri
Amount > 0	Nominal harus positif
Saldo >= amount	Validasi server-side (current_balance)
Net zero	Total saldo perusahaan tidak berubah
Atomic	Semua operasi dalam satu transaction (rollback jika gagal)
Idempotent	Menggunakan idempotency_key untuk cegah duplikasi
Journal wajib	GLJournalEntry otomatis dibuat (debit = credit)

Enum Tables

account_type (BankAccount)

Nilai	Deskripsi	Contoh Provider
`bank`	Rekening bank konvensional	BCA, Mandiri, BNI, BRI
`ewallet`	Dompet elektronik / e-wallet	GoPay, OVO, DANA, ShopeePay

type (Account)

Nilai	Deskripsi	Kode COA Default
`cash`	Kas tunai	1-1000
`bank`	Rekening bank	1-1100
`e-wallet`	Dompet elektronik	1-1200
`other`	Rekening lain (PayPal, Stripe)	1-4000

bank_name / provider

Nilai	Kategori	Negara
`BCA`	Bank Swasta	Indonesia
`Mandiri`	Bank BUMN	Indonesia
`BNI`	Bank BUMN	Indonesia
`BRI`	Bank BUMN	Indonesia
`BSI`	Bank Syariah	Indonesia
`CIMB Niaga`	Bank Swasta	Indonesia
`GoPay`	E-Wallet	Indonesia
`OVO`	E-Wallet	Indonesia
`DANA`	E-Wallet	Indonesia
`ShopeePay`	E-Wallet	Indonesia
`LinkAja`	E-Wallet	Indonesia
`PayPal`	E-Wallet	Internasional

reconciliation_status

Nilai	Deskripsi	Warna UI
`matched`	Transaksi cocok antara sistem dan statement bank	Hijau
`unmatched_internal`	Ada di sistem, tidak ada di statement bank	Kuning
`unmatched_external`	Ada di statement bank, tidak ada di sistem	Orange
`adjusted`	Sudah dikoreksi secara manual	Biru
`pending_review`	Menunggu review finance	Abu-abu

reference_type (GLJournalEntry)

Nilai	Deskripsi	Sumber
`manual`	Entri jurnal manual	Input langsung oleh akuntan
`invoice`	Dari invoice	Pembayaran invoice otomatis
`purchase_order`	Dari purchase order	Penerimaan barang/jasa
`transfer`	Dari transfer antar rekening	Transfer internal
`expense`	Dari expense	Pengajuan expense yang approved

status (GLJournalEntry)

Nilai	Deskripsi	Bisa Di-edit
`draft`	Belum diposting, masih bisa diubah	✓
`posted`	Sudah diposting ke GL, tidak bisa diubah	✗ (harus reverse)
`reversed`	Sudah dibalik (reversal journal)	✗

source (FinancialRecord)

Nilai	Deskripsi
`manual`	Input manual oleh user
`ai_text`	Dari AI text parsing
`ai_scan`	Dari AI scan dokumen
`pos`	Dari transaksi POS Kasir
`manufacturing`	Dari modul manufaktur
`distribution`	Dari modul distribusi
`recall`	Dari batch recall
`stock_opname`	Dari stock opname

RBAC — Hak Akses Rekening Bank

Role	Create	Read	Update	Delete	Freeze/Unfreeze	Approval Deposit	Approval Withdrawal
Owner	✓	✓	✓	✓	✓	✓	✓
Admin	✓	✓	✓	✓	✓	✓	✓
Finance	✓	✓	✓	✗	✗	✓	✓
Accounting	✗	✓	✗	✗	✗	✗	✗
Staff	✗	✗	✗	✗	✗	✗	✗
POS Operator	✗	✓ (default POS only)	✗	✗	✗	✗	✗

RLS Policy Summary

Operasi	Kondisi Akses
Create	`user_id` = current user, ATAU `company_id` = active_company_id, ATAU role = admin
Read	`user_id` = current user, ATAU `company_id` = active_company_id, ATAU role = admin
Update	`user_id` = current user, ATAU `company_id` = active_company_id, ATAU role = admin
Delete	`user_id` = current user, ATAU `company_id` = active_company_id, ATAU role = admin

Catatan Keamanan

Semua mutasi saldo dicatat di FinancialRecord dengan idempotency_key untuk mencegah duplikasi
current_balance bersifat server-authoritative — frontend tidak boleh meng-update langsung
Transfer antar rekening menggunakan database lock untuk mencegah race condition
Rekening yang di-freeze (is_active = false) menolak semua operasi transaksi
Audit trail tersedia melalui GLJournalEntry dengan status posted yang tidak bisa di-mutate (hanya reversal)

​title: “Bank Accounts” description: “Manajemen rekening bank, kas, dan e-wallet perusahaan — 4 tipe akun, saldo real-time, transfer antar rekening, deposit/withdrawal workflow, dan integrasi POS di SNISHOP ERP.”

​Bank Accounts

​Arsitektur Akun Keuangan

​Entity Account

​Field Account

​COA Code Mapping

​Add Bank Account

​Step-by-Step

​Multiple Accounts

​Saldo Real-Time

​Auto-Refresh

​Balance Monitoring

​Balance Alerts

​Deposit Workflow

​Deposit Rules

​Withdrawal Workflow

​Withdrawal Rules

​Transfer Antar Rekening

​Transfer Rules

​Transfer di Laporan

​POS Integration

​Default POS Account

​Multiple POS Accounts

​Transaction Tracking

​Incoming Transactions

​Outgoing Transactions

​Transaction Details

​Rekonsiliasi Bank

​Import Bank Statement

​Manual Reconciliation

​Reconciliation Report

​Reporting

​Bank Statement

​Cash Flow Report

​Best Practices

​Security

​Reconciliation

​Monitoring

​Entity Schema & Relasi ke General Ledger

​ER Diagram — Bank Account Entities

​Tabel Schema — BankAccount

​Tabel Schema — Account (Field Relevan)

​Tabel Schema — GLJournalEntry (Bank-Related)

​Tabel Schema — FinancialRecord (Transaksi Keuangan)

​State Machine — Status Rekening Bank

​Transisi Status

​Implikasi Status terhadap Operasi

​Sequence Diagram — Rekonsiliasi Bank

​Status Rekonsiliasi per Transaksi

​Sequence Diagram — Transfer Antar Rekening

​Aturan Transfer

​Enum Tables

​account_type (BankAccount)

​type (Account)

​bank_name / provider

​reconciliation_status

​reference_type (GLJournalEntry)

​status (GLJournalEntry)

​source (FinancialRecord)

​RBAC — Hak Akses Rekening Bank

​RLS Policy Summary

​Catatan Keamanan