Panduan User Billing NexaCore

Versi ini dibuat khusus untuk user operasional, dengan bahasa sederhana dan analogi sehari-hari.

1) Gambaran Sederhana (Analogi)

Istilah Sistem	Analogi Harian	Maksud Praktis
`profile`	Mesin kendaraan	Menentukan “tenaga” layanan internet (teknis jaringan).
`package_id`	Harga tiket	Menentukan pelanggan bayar paket mana di billing.
`partner_id`	Sales/agen yang bawa pelanggan	Untuk tracking penjualan dan komisi.
`invoice`	Tagihan listrik bulanan	Dokumen yang harus dibayar pelanggan.
`isolation`	Layanan sementara dihentikan	Diterapkan jika menunggak sesuai aturan.

2) Kebingungan Paling Sering

"Kenapa ada profile dan package_id? Bukannya sama?"

Tidak sama. profile itu teknis jaringan, package_id itu paket tagihan.

Contoh: pelanggan pakai profile basic-10m (teknis), tapi secara billing dia tercatat di package_id=1.

"partner_id harus diisi berapa?"

Kalau pelanggan datang langsung tanpa agen, isi 0. Kalau dari agen, isi ID agen tersebut.

"isolation_date angka 20 itu apa?"

Artinya sistem pakai tanggal 20 sebagai acuan isolasi (sesuai policy dan grace period yang diatur).

3) Urutan Kerja yang Aman (Step-by-step)

Buat dulu Master Paket.
Buat Master Partner (kalau pakai agen).
Baru input/import pelanggan.
Generate invoice.
Saat pembayaran masuk, lakukan rekonsiliasi.
Pelanggan yang sudah bayar harus aktif kembali (unsuspend).

Jangan import pelanggan sebelum Master Paket siap. Kalau belum siap, biasanya error di package_id.

4) Contoh CSV yang Benar

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 harus angka ID paket yang ada di Master Paket.
partner_id isi ID partner atau 0.
Alamat yang ada koma wajib pakai tanda kutip "...".

5) Contoh Kasus Nyata

Kasus A: Sudah bayar tapi internet masih mati

Cek status invoice, pastikan benar-benar paid.
Jalankan rekonsiliasi (kalau pembayaran gateway/manual belum sinkron).
Eksekusi unsuspend.
Cek lagi status layanan di sistem jaringan.

Kasus B: Import gagal “package_id tidak ditemukan”

Buka Master Paket, lihat ID paket valid.
Perbaiki kolom package_id di CSV.
Import ulang hanya baris gagal.

6) FAQ Singkat

Q: Boleh isi package_id dengan nama paket seperti “basic-10m”?
A: Tidak. Harus angka ID paket.

Q: Kalau pelanggan bukan dari agen?
A: Isi partner_id=0.

Q: Kalau lupa profile?
A: Cek mapping profile teknis di router/RADIUS, lalu sesuaikan.