NexaCore Billing Manual Lengkap

1) Scope & Tujuan

• Manual ini mencakup alur billing dari onboarding pelanggan sampai pelunasan dan isolasi otomatis.
• Dipakai sebagai referensi operasional tim untuk 1 instance billing NexaCore.
• Jika nama menu berbeda, ikuti fungsi modulnya.

2) Arsitektur & Istilah Kunci

2b) Kamus Analogi (Biar Tidak Bingung)

2c) Kesalahan Paling Sering + Cara Berpikirnya

"Saya sudah isi profile, kenapa masih harus package_id?"

Karena billing dan jaringan itu dua hal berbeda: profile untuk teknis koneksi, package_id untuk hitungan uang.

"partner_id saya kosong, boleh?"

Gunakan 0 jika pelanggan direct/non-partner supaya data tetap konsisten.

"Alamat pakai koma kok error CSV?"

Bungkus alamat dengan tanda kutip "...".

3) Peta Modul Billing

4) Setup Awal

1. Set profil perusahaan, timezone, prefix invoice.
2. Set user admin utama dan role dasar.
3. Set koneksi network (RADIUS/Mikrotik) + tes autentikasi.
4. Set metode pembayaran (manual/gateway).
5. Set kebijakan due date, denda, grace period, dan isolasi.

5) Master Data

Master Paket

• Isi nama paket, harga, durasi, status aktif.
• Catat ID paket untuk import/API.

Master Partner

• Isi agen aktif + skema komisi.
• Partner non-aktif jangan dipakai transaksi baru.

6) Pelanggan & Layanan

1. Buat pelanggan baru manual atau via import.
2. Assign paket, partner, activation date, isolation date.
3. Pastikan sinkron profile teknis ke perangkat jaringan.
4. Simpan histori perubahan paket/suspend.

7) Import CSV PPPoE

username,password,profile,customer_name,phone,email,address,package_id,partner_id,isolation_date

pppoe001,SandiKuat123,basic-10m,Budi Santoso,081234567890,budi@contoh.id,"Jl. Melati No. 8",1,0,20
pppoe002,SandiKuat456,premium-30m,Siti Aminah,081299988877,siti@contoh.id,"Jl. Kenanga No. 2",2,3,25

• package_id: ID paket dari Master Paket.
• partner_id: ID partner, isi 0 jika non-partner.
• profile: profil teknis network.

8) Invoice & Billing Cycle

1. Set tanggal generate dan tanggal jatuh tempo.
2. Generate invoice massal per periode.
3. Kirim notifikasi tagihan ke channel aktif.
4. Void invoice hanya jika ada alasan audit.

9) Pembayaran & Rekonsiliasi

• Pembayaran manual: input nominal + bukti + reference.
• Pembayaran gateway: pastikan callback/webhook valid.
• Rekonsiliasi harian wajib untuk hindari salah status.

10) Isolasi & Unsuspend

1. Pelanggan overdue masuk antrian isolasi.
2. Isolasi dilakukan sesuai policy + grace period.
3. Setelah lunas, unsuspend otomatis/manual.

11) Partner & Komisi

• Skema komisi per paket/periode.
• Komisi dihitung pada invoice paid.
• Export laporan komisi bulanan per partner.

12) Laporan & Audit

• Laporan pendapatan, aging piutang, churn, ARPU.
• Audit log semua perubahan kritikal.
• Closing bulanan dengan rekonsiliasi akhir.

13) Role & Keamanan

14) Notifikasi & Scheduler

• Reminder H-3, H-1, H+1 jatuh tempo.
• Job generate invoice otomatis.
• Job isolasi otomatis dan log eksekusi.

15) API & Integrasi

• Pisahkan API key per aplikasi.
• Aktifkan logging request dan retry policy.
• Gunakan hak akses minimal per key.

16) SOP Harian per Tim

Billing Admin

1. Cek invoice due hari ini.
2. Rekonsiliasi pembayaran.
3. Proses unsuspend pelanggan paid.

CS

1. Validasi data kontak.
2. Tangani komplain layanan/tagihan.

NOC

1. Validasi sinkron profile PPPoE.
2. Cek status isolasi di perangkat.

17) Checklist Go-Live

• Backup DB harian + uji restore.
• Uji billing cycle penuh dengan data uji.
• Uji callback gateway dan fallback manual.
• Dokumentasikan rollback plan.

18) Troubleshooting