Skip to content

Import Spreadsheet (Paket, Pelanggan, Voucher) ​

Gunakan fitur ini untuk impor data massal dari Google Sheets dengan template standar HIJINETBILL.

Checklist Cepat ​

  1. Buka modal Import Spreadsheet di halaman tujuan:
    • Manager > Katalog Layanan untuk impor paket
    • Manager > Pelanggan untuk impor pelanggan
    • Manager > Voucher untuk impor voucher
  2. Klik Buka Template.
  3. Di Google Sheets pilih File -> Buat salinan.
  4. Isi sheet salinan (jangan ubah nama header).
  5. Paste Spreadsheet ID/URL ke modal.
  6. Klik Import Sekarang.

Template Resmi ​

Template default sudah ditanam oleh sistem:

  • Customers: 1_nWYAo7eDAqVyPoeK70bwXy7Jq_navw5AmKlAlK7hs4
  • Packages: 1fErDDl7jqwLCMaNmnv92QTmeP98pOnG_zA-UhRLbh4I
  • Vouchers: 15doUwMT_re28NnoB9xDi5EZ6iv9RWp1I0ivddNe_tmY

Autofill Template Otomatis ​

Gunakan command ini untuk mengisi template default (header + contoh row + style kuning/border):

bash
hijinetbill --autofill-sheets

Catatan:

  • Flag ini memang disembunyikan dari output --help.
  • Command hanya memproses sheet template yang sudah dikonfigurasi sistem.
  • Jika ID voucher belum diset, voucher akan SKIP.

Aturan Penting ​

  1. Import paket:
    • package_code wajib unik global (voucher/pppoe/hotspot).
    • Gunakan kode mudah dibaca, contoh: paket10mbps, hotspot-harian, voucher-6jam.
  2. Import pelanggan:
    • Paket harus sudah ada dulu.
    • Gunakan kolom terpisah per layanan:
      • pppoe_service_code untuk layanan PPPoE
      • hotspot_service_code untuk layanan Hotspot
    • Nilai kode layanan harus mengacu ke package_code paket yang valid.
    • Layanan aktif PPPoE/Hotspot bisa diisi (termasuk expires_at).
    • Nilai status valid untuk pppoe_status / hotspot_status:
      • active
      • suspended
      • expired
      • terminated
      • pending_installation
      • ready_to_activate
  3. Import voucher:
    • Tetap wajib package_code valid.
    • Tidak butuh data pelanggan.
    • Jika status kosong, sistem otomatis isi dari expires_at:
      • tanpa expires_at => unused
      • expires_at masa depan => active
      • expires_at lewat => expired