Buku Panduan Penggunaan Aplikasi Billing

1. Halaman Login

Langkah awal untuk masuk dan mengelola sistem billing adalah dengan melakukan autentikasi pada halaman login utama.

Buka halaman utama aplikasi billing Anda pada browser.
Masukkan kredensial default yang telah ditentukan sistem:

Username: admin
Password: 123

Centang opsi INGAT SAYA jika diperlukan agar sesi tetap tersimpan.
Klik tombol MASUK SISTEM untuk masuk ke Panel Admin.

2. Pengaturan Awal (Settings)

PENTING: Sebelum menggunakan fitur aplikasi, Anda diwajibkan menyelesaikan konfigurasi sistem pada menu Settings agar aplikasi terintegrasi dengan Router MikroTik dan Gateway WhatsApp.

Profil Usaha & Branding: Lengkapi Nama Aplikasi, Nama Perusahaan, dan Kontak WhatsApp. Unggah berkas Logo Struk usaha Anda dan tambahkan daftar Rekening Bank/E-Wallet untuk mempermudah pembayaran.
Integrasi WhatsApp & Auto-Isolir:
- WhatsApp API: Masukkan kredensial URL API, Token Gateway, dan Delay Pengiriman. Sesuaikan juga Template Pesan WhatsApp menggunakan variabel dinamis (misal: {{nama}}, {{tagihan}}, dll).
- Metode Auto-Isolir: Pilih sistem isolir yang diinginkan: Disable Secret (mematikan akun) atau Ubah Profile (memindahkan akun ke profil khusus, misal `ISOLIR`).
Integrasi Multi-Router MikroTik:
- Buka menu Data Router pada panel kiri untuk menambahkan mesin MikroTik Anda.
- Sistem ini mendukung lebih dari satu router (Router Cluster). Masukkan IP Address/Host, API Port, Username, dan Password API MikroTik Anda (Pastikan menggunakan RouterOS versi 7+).

3. Dashboard & Monitoring Mutakhir

Halaman muka (Dashboard) kini dilengkapi dengan sistem Smart Tabs dan status lisensi real-time yang memisahkan fokus monitoring Anda secara rapi:

1
Tab Keuangan & Tren Pendapatan: Menampilkan laporan instan omset terbayar bulan ini, grafik tahunan uang masuk (Lunas), potensi piutang, dan riwayat 5 mutasi pembayaran terbaru pelanggan. (Tab ini tersembunyi bagi akun Teknisi).
2
Tab Ringkasan & Klien: Menyajikan matriks total pelanggan aktif, perbandingan grafik pertumbuhan pelanggan baru, dan tombol Scan & Isolir Sekarang (Force-Isolir) untuk mengeksekusi pemutusan massal secara paksa tanpa menunggu jadwal cron.
3
Tab Status Kluster PPPoE: Halaman Live System Monitoring terperinci. Memantau berapa banyak boks router yang Online, jumlah sesi PPPoE yang aktif secara global, dan tabel rincian status (Online, Offline, Terisolir) di masing-masing router yang terdaftar.
🔑
Status Lisensi (Bawah Jam): Admin dapat memantau status validasi dan tanggal kedaluwarsa lisensi secara real-time pada lencana (badge) di pojok kanan atas di bawah jam. Admin juga dapat mengklik lencana tersebut untuk memasukkan/memperbarui kode lisensi aplikasi.

4. Manajemen Paket & Data Pelanggan

Basis data paket internet dan pengguna (PPPoE Secret) diintegrasikan langsung dari perangkat MikroTik Anda.

📦 Paket Internet

Buka menu Paket Internet.
Klik tombol Sync Router. Sistem akan menarik data Profile PPPoE dari seluruh router Anda.
Edit paket yang ditarik untuk menentukan Harga (Rp) secara manual agar tagihan dapat dikalkulasi oleh sistem.

👥 Data Pelanggan

Buka menu Data Pelanggan lalu klik Sync Router untuk menarik PPPoE Secret.
Klik tombol Edit pada pelanggan untuk melengkapi: Nama Lengkap, Nomor WA, Tanggal Gabung (Wajib untuk siklus tagihan), Koordinat Peta, dan menetapkan pelanggan ini berada di Router Box yang mana.

5. Tagihan & Sistem Autopilot

Menu Tagihan mengatur sirkulasi keuangan. Sistem ini dilengkapi dengan Mesin Autopilot (Cron Job) yang bekerja di latar belakang (server).

Pembuatan Invoice Massal: Klik tombol Buat Tagihan Baru, pilih Bulan & Tahun, lalu tekan Proses. Invoice baru akan tercetak otomatis berdasarkan daftar pelanggan aktif.
⚙️ Autopilot Engine (Otomatisasi Server):
Aplikasi ini memiliki 3 blok mesin otomatis yang berjalan sendiri via Crontab Linux:
- Auto-WA Blast: Mengirim pesan tagihan otomatis setiap hari sesuai jam yang diatur di menu Pengaturan WA kepada pelanggan yang jatuh tempo hari ini.
- Auto-Isolir: Memutus (disable/ganti profil) pelanggan yang belum bayar tepat pada tengah malam (atau waktu yang ditentukan) pada hari H jatuh tempo.
- Smart Log Cleaner: Sistem pembersih otomatis yang akan menghapus log riwayat cron dan WA usang (di atas 30 hari) agar server Anda tetap ringan dan cepat.
Aksi Manual Tagihan: Di dalam tabel tagihan, Anda tetap bisa melakukan aksi manual:
- Kirim WA: Kirim pesan notifikasi personal kapan saja.
- Bayar: Ubah status dari BELUM BAYAR menjadi LUNAS. Akun akan otomatis ter-reaktivasi dari isolir.
- Cetak (Printer): Cetak fisik struk menggunakan printer thermal.

6. Laporan Keuangan

Semua riwayat tagihan pelanggan yang sudah dikonfirmasi berstatus Lunas secara otomatis terekam ke dalam jurnal laporan keuangan.

Menyajikan visualisasi ringkasan Total Transaksi terkumpul dan akumulasi Total Omset kotor.
Gunakan filter canggih di bagian atas (berdasarkan kombinasi Bulan, Tahun, dan Status Pembayaran) untuk menyortir data rekapan kas secara spesifik.
Cetak pembukuan ini atau ekspor ke PDF dengan menekan ikon Print / Cetak Laporan PDF.

7. Kelola Role & Manajemen User

Sistem ini menggunakan pembatasan hak akses yang sangat dinamis untuk keamanan data.

🛡️ Kelola Hak Akses (Role)

Buka menu Kelola Role.
Klik + Tambah Role untuk membuat jabatan (Misal: Kasir, Teknisi).
Gunakan tombol Edit untuk mencentang modul/menu apa saja yang boleh dibuka oleh jabatan tersebut (contoh: mematikan menu Keuangan untuk Teknisi).

👤 Manajemen Akun User

Buka menu Manajemen User.
Klik + Tambah User untuk mendaftarkan akun staf baru.
Isi Username dan Password, lalu pasangkan akun tersebut dengan Role yang sudah dibuat. Anda juga bisa menonaktifkan atau menghapus akun staf kapan saja.