Lewati ke konten utama

Customer Service Reports

Laporan Layanan (Service Reports) adalah rincian granular per resource (seperti VM individu, IP Publik, atau Disk) yang dipakai oleh pengguna selama satu bulan penagihan penuh. Modul ini memberi transparansi penuh atas apa saja yang ditagihkan kepada mereka.

1. Daftar Laporan Bulanan​

Pelanggan dapat melihat riwayat semua Billing Reports yang diterbitkan setiap bulannya.

Request
GET /api/billing/reports?page=1&limit=10

Respons (200 OK):

{
  "data": [
    {
      "id": 101,
      "month": "May 2026",
      "total_cost": 500000.00,
      "status": "BILLED"
    }
  ]
}

2. Detail Laporan Layanan​

Untuk melihat breakdown biaya, pelanggan dapat memanggil endpoint ini yang akan mengembalikan rincian item layanan. Misalnya VM A menghabiskan biaya sekian, dan VM B menghabiskan sekian.

Request
GET /api/billing/reports/{id}/details

Respons (200 OK): Mereturn senarai (list) dari resource dan detail pemakaian beserta nilai nominalnya.

3. Ekspor Laporan ke PDF​

Pelanggan yang memerlukan laporan rinci pengeluaran layanan bulanan untuk dilaporkan ke Finance internal mereka dapat mengunduh format PDF.

Request
GET /api/billing/reports/{id}/export

Respons (200 OK): Sistem mengembalikan Raw Bytes dokumen PDF dengan header Content-Disposition: attachment; filename="service_report.pdf".