Lewati ke konten utama

Invoice Management

Melalui Backoffice, Admin Finance dapat memantau seluruh lalu lintas keuangan yang terjadi di Frog Cloud, baik yang bersumber dari deposit Prepaid maupun tagihan Postpaid.

1. Pemantauan Global (All Invoices)​

Frontend Backoffice menyediakan dua tabel terpisah untuk manajemen arus kas.

A. Tabel Semua Deposit (Prepaid)​

Menampilkan seluruh tiket Topup yang dibuat oleh seluruh Customer.

Request
GET /api/backoffice/billing/prepaid/invoices?page=1&limit=20

B. Tabel Penagihan Bulanan (Postpaid)​

Menampilkan seluruh tagihan pascabayar, berguna untuk mendeteksi pelanggan korporat mana yang menunggak (Overdue).

Request
GET /api/backoffice/billing/postpaid/invoices?page=1&limit=20

2. Verifikasi Pembayaran Manual​

Terkadang, pelanggan korporat besar lebih suka mentransfer uang penagihan langsung ke Rekening Giro Bank perusahaan tanpa melalui Payment Gateway. Dalam skenario ini, tiket Invoice tidak akan otomatis lunas. Admin Finance yang memeriksa mutasi rekening bank harus memvalidasinya secara manual di dasbor.

Request
PATCH /api/backoffice/billing/postpaid/invoices/{invoice_id}/verify
Content-Type: application/json
Request Body
{
  "paid_note": "Lunas via Transfer Bank BCA tgl 5 Mei"
}

Kondisi & Tindakan: Status Invoice tersebut langsung diubah menjadi PAID di database, dan Customer akan menerima Email Receipt bahwa tagihannya sudah diverifikasi oleh Admin.

3. Injeksi & Pemotongan Saldo Manual (Adjustment)​

Ada kalanya Admin harus memasukkan saldo kompensasi secara manual (karena SLA tidak tercapai), atau melakukan koreksi pemotongan saldo karena kesalahan sistem.

Request
POST /api/backoffice/customer/{customer_id}/balance
Content-Type: application/json
Request Body
{
  "type": "ADD", 
  "amount": 50000,
  "description": "Kompensasi Downtime VM 2 Jam"
}

(Gunakan "type": "DEDUCT" jika Anda bermaksud memotong saldo pengguna secara paksa).

4. Riwayat Mutasi Saldo Pelanggan (Credit History)​

Admin dapat melihat riwayat lengkap perubahan saldo (wallet mutations) untuk pelanggan tertentu, baik karena pemotongan cronjob maupun karena pengisian ulang/topup.

Request
GET /api/backoffice/customer/{customer_id}/credit-history?page=1&limit=20

Respons (200 OK): Mereturn senarai (list) log mutasi lengkap dari pelanggan spesifik.

5. Ekspor PDF Invoice​

Untuk kebutuhan arsip fisik atau dikirimkan ulang ke klien, Admin Finance dapat mengunduh dokumen Invoice (penagihan bulanan) dalam format PDF langsung dari Dashboard.

Request
GET /api/backoffice/billing/export-invoice?id={id}

Respons (200 OK): Sistem langsung mereturn Raw Bytes berformat dokumen PDF dengan header Content-Disposition: attachment; filename="admin_invoice_YYYY-MM.pdf".