Menu Reload Setup

Tujuan Halaman

Halaman Reload Setup dipakai untuk menyiapkan fitur MAXsi Reload / TopUp di aplikasi MAXsi POS, supaya Anda bisa:

  1. Mendaftarkan perangkat (HP) ke layanan Reload.
  2. Validasi data agen (WhatsApp, ID Agen, PIN).
  3. Membuat & membagikan pesan verifikasi ke WhatsApp.
  4. Mengunduh katalog produk digital.
  5. Import katalog ke database toko.
  6. Reset (hapus) produk reload jika diperlukan.

Halaman ini biasanya digunakan sekali saat awal setup, lalu dipakai lagi kalau ada perubahan akun agen, pindah HP, atau ingin refresh katalog.

Bagian “Validasi Data Agen”

Di bagian ini Anda mengisi data agen yang digunakan untuk layanan Reload.

1) Nomor WhatsApp Terdaftar

Isi nomor WhatsApp yang memang sudah terdaftar di MAXsi Reload.

  • Contoh format: 62812xxxxxx
  • Kalau format salah/kurang lengkap, validasi bisa gagal.

2) ID Agen

Isi ID Agen Anda (contoh yang tampil di aplikasi: AGN001).

  • ID Agen wajib diisi.

3) PIN Reload

Isi PIN untuk transaksi Reload.

  • PIN wajib diisi.
  • Kolom ini disembunyikan (secure) supaya tidak mudah terlihat orang.

Tombol “Simpan”

Menjalankan fungsi:

  • Menyimpan Nomor WhatsApp + ID Agen + PIN di aplikasi (untuk dipakai saat transaksi Reload).

Gunakan tombol ini jika Anda hanya ingin menyimpan data dulu tanpa validasi.

Tombol “Validasi”

Fungsi tombol ini:

  • Menghubungkan aplikasi ke server MAXsi Reload untuk memvalidasi data agen dan perangkat.
  • Jika berhasil, tombol akan berubah menjadi “Tervalidasi ✓”.

Catatan penting:

  • Setelah validasi, akan muncul masa berlaku singkat (timer) untuk melakukan langkah verifikasi WhatsApp.
  • Jika timer habis, Anda perlu menekan Validasi lagi.

Pesan Verifikasi (Kotak Teks)

Setelah validasi sukses, aplikasi akan menampilkan teks pesan verifikasi yang berisi:

  • ID Agen
  • ID perangkat (App Instance ID)
  • Nama perangkat (MAXsi POS-android / MAXsi POS-ios)

Pesan ini memang dibuat untuk Anda kirim via WhatsApp sesuai instruksi layanan Reload.

Tombol “Share ke WhatsApp”

Gunanya:

  • Membuka menu share dan mengirim pesan verifikasi tersebut ke WhatsApp.

Tombol ini hanya bisa dipakai jika:

  • Anda sudah Validasi, dan
  • Timer validasi masih aktif.

Tombol “Reset ID”

Gunanya:

  • Mengganti ID unik aplikasi (ID perangkat untuk Reload).
  • Biasanya dipakai kalau Anda:
    • Ganti HP / reinstall aplikasi,
    • Ingin mengulang proses aktivasi dari awal,
    • Ada kendala verifikasi.

Catatan:

  • Reset ID akan mematikan status aktivasi Reload di aplikasi (perlu validasi ulang).

Bagian “Katalog Produk Digital”

Bagian ini dipakai untuk mengambil dan memasukkan daftar produk digital dari layanan Reload ke database toko.

Tombol “Download”

Fungsi:

  • Mengunduh katalog produk digital dari server Reload.
  • Katalog akan disimpan sebagai file di HP (file products_reload.json).

Syarat:

  • Harus sudah Validasi dan status Verified aktif.

Jika berhasil, akan muncul informasi lokasi file (contoh: “Sukses disimpan: …/products_reload.json”).

Tombol “Import”

Fungsi:

  • Membaca file katalog yang sudah didownload.
  • Memasukkan produk-produk digital ke database toko.

Saat import berjalan, akan muncul status progress (misalnya “Import batch 1/…”). Setelah selesai, akan muncul ringkasan:

  • Total
  • Baru (insert)
  • Update
  • Lewat (skipped)

Syarat:

  • Harus sudah download katalog dulu (file harus ada).
  • Harus sudah validasi dan verified.

Tombol “Reset Produk Reload”

Fungsi:

  • Menghapus semua produk reload di database toko.

Catatan penting:

  • Yang dihapus adalah produk dengan jenis semi digital (produk reload).
  • Gunakan tombol ini dengan hati-hati (misalnya untuk bersih-bersih sebelum import ulang).

Opsi Saat Import

Di bawah tombol-tombol, ada beberapa switch (opsi):

  1. Perbarui harga jual

    • Jika ON, import akan ikut memperbarui harga jual sesuai katalog (jika ada).
    • Jika OFF, harga jual produk yang sudah ada bisa dipertahankan (tergantung aturan import).

  2. Set hide = 1

    • Jika ON, produk hasil import akan diset “hide” (tersembunyi) sesuai kebutuhan operasional.

  3. Set hide_pos = 1

    • Jika ON, produk hasil import akan diset “hide_pos” (disembunyikan dari POS) sesuai kebutuhan.

Alur Setup yang Disarankan

  1. Isi Nomor WhatsApp Terdaftar, ID Agen, dan PIN Reload.
  2. Tekan Simpan (opsional, tapi disarankan).
  3. Tekan Validasi sampai status “Tervalidasi ✓”.
  4. Tekan Share ke WhatsApp dan kirim pesan verifikasi sesuai instruksi.
  5. Setelah status Verified aktif, tekan Download katalog.
  6. Setelah download sukses, tekan Import untuk memasukkan produk ke toko.

Jika Terjadi Kendala

  1. “Validasi gagal”

    • Pastikan Nomor WhatsApp benar dan memang terdaftar.
    • Pastikan ID Agen dan PIN benar.
    • Coba ulangi tombol Validasi.

  2. “Token validasi kadaluarsa”

    • Tekan Validasi ulang, lalu segera Share ke WhatsApp saat timer masih aktif.

  3. “File katalog belum ada”

    • Tekan Download dulu.

  4. “Koneksi WebSocket gagal” / download gagal

    • Cek koneksi internet.
    • Ulangi Download.

Tips Praktis

  • Lakukan validasi saat koneksi stabil karena ada batas waktu.
  • Jika Anda ganti HP, selalu lakukan “Reset ID” lalu validasi ulang.
  • Jika ada produk reload yang sudah tidak relevan, gunakan “Reset Produk Reload” lalu import ulang.

Dibuat oleh: MAXsi POS "Aplikasi Kasir Murah"