Import Saldo Awal
Halaman Import Saldo Awal digunakan oleh Admin untuk memasukkan saldo deposit awal (initial balance), baik saldo aktif maupun saldo tertunda (pending), ke dalam akun pengguna/mitra secara massal menggunakan berkas spreadsheet (Excel/CSV).
Fitur ini mempermudah migrasi data finansial saldo mitra lama ke dalam platform Teem.id secara bersamaan tanpa perlu menambah saldo satu per satu secara manual.
Prasyarat Penting Sebelum Impor
- Akun Harus Terdaftar: Pastikan email user/mitra sudah terdaftar di sistem sebelum melakukan impor.
- Penanganan Saldo Rp 0: Jika salah satu jenis saldo (saldo aktif atau saldo pending) bernilai 0, kosongkan saja kolom tersebut di berkas spreadsheet (sistem akan otomatis menganggapnya bernilai 0).
Cara Mengakses Halaman Import Saldo Awal
Bagi Admin yang ingin mengunggah atau menyesuaikan saldo awal mitra, ikuti langkah navigasi berikut:
- Pada bilah navigasi kiri (sidebar), buka modul Keuangan > Saldo Awal.
- Sistem akan menampilkan halaman utama Import Saldo Awal beserta area pengunggahan berkas dan ringkasan petunjuknya.
Tampilan Halaman Import Saldo Awal
Panduan Pengelolaan & Eksekusi Impor Saldo Awal
Admin dapat mengunduh berkas acuan, mengunggah data saldo, meninjau tabel validasi sistem, hingga mengonfirmasi pembaruan saldo akun.
1. Persiapan Berkas & Pengisian Data
- Download Template: Klik tombol Download Template di kotak instruksi untuk mengunduh acuan berkas spreadsheet resmi (
template-import-saldo-cutover.xlsx). - Pengisian Kolom Data: Lengkapi kolom data finansial pada berkas spreadsheet sesuai ketentuan berikut:
| Header Kolom | Deskripsi Pengisian |
|---|---|
| Alamat email terdaftar milik pengguna/mitra (Wajib). | |
| Saldo Aktif (Rp) | Nominal rupiah saldo aktif yang dapat langsung digunakan untuk transaksi (Kosongkan jika 0). |
| Saldo Pending (Rp) | Nominal rupiah saldo tertunda yang sedang ditahan/dalam proses (Kosongkan jika 0). |
2. Pengunggahan & Peninjauan Hasil Validasi
- Klik tombol Upload berwarna merah di sebelah tombol Download Template.
- Pilih berkas spreadsheet yang telah diisi dari perangkat Anda.
- Setelah proses pemuatan selesai, periksa indikator badge di atas tabel:
- Indikator Valid (Centang Hijau): Akumulasi baris akun yang lolos verifikasi dan siap menerima masukan saldo.
- Indikator Bermasalah (Tanda Seru Merah): Akumulasi baris data yang mengalami kendala/error.
Struktur Tabel Validasi Data
| Kolom | Keterangan & Deskripsi Fungsi |
|---|---|
| Baris | Nomor baris posisi data pada berkas spreadsheet. |
| Alamat email akun pengguna yang diverifikasi. | |
| Saldo Aktif | Nominal saldo aktif yang siap dimasukkan. |
| Saldo Pending | Nominal saldo pending yang siap dimasukkan. |
| Status | Label hasil verifikasi sistem (Valid berwarna hijau, atau pesan Error berwarna merah). |
3. Eksekusi Impor Saldo Awal
- Penanganan Data Error: Apabila terdapat baris data dengan status error, perbaiki nilai pada berkas spreadsheet Anda lalu unggah kembali.
- Konfirmasi Impor: Apabila seluruh data telah berstatus Valid, klik tombol Import Saldo Awal di pojok kanan bawah untuk memperbarui saldo ke dalam akun pengguna secara resmi.
Panduan Mengatasi Masalah Validasi (Troubleshooting)
Gunakan tabel acuan berikut untuk mengidentifikasi penyebab dan solusi penanganan jika sistem menampilkan pesan kendala verifikasi:
1. Kendala Akun User / Email
| Pesan Error Sistem | Penyebab Utama | Solusi Penanganan |
|---|---|---|
| Email kosong | Kolom Email pada baris spreadsheet tidak diisi. | Lengkapi alamat email mitra yang ingin diberi saldo awal. |
| Email "[email]" tidak ditemukan di sistem | Alamat email tidak terdaftar di dalam tabel profil pengguna Teem.id. | Pastikan mitra sudah mendaftar/dibuatkan akunnya terlebih dahulu sebelum dilakukan impor saldo. |
| Email "[email]" duplikat di file ini (baris X, Y) | Email yang sama ditulis lebih dari 1 kali di dalam berkas Excel. | Hapus baris duplikat dan tinggalkan 1 baris saja di berkas Excel Anda. |
2. Kendala Format Nominal Saldo
| Pesan Error Sistem | Penyebab Utama | Solusi Penanganan |
|---|---|---|
| Saldo Aktif "[nilai]" tidak valid (harus angka >= 0) | Teks bernilai minus/negatif atau format tulisan non-angka diinput pada kolom Saldo Aktif. | Masukkan nominal angka positif atau 0 (kosongkan saja jika 0). Jangan masukkan teks/huruf. |
| Saldo Pending "[nilai]" tidak valid (harus angka >= 0) | Teks bernilai minus/negatif atau format tulisan non-angka diinput pada kolom Saldo Pending. | Masukkan nominal angka positif atau 0 (kosongkan saja jika 0). Jangan masukkan teks/huruf. |
Peringatan Overwrite Saldo Cut-off
Sistem secara otomatis mendeteksi jika suatu akun pengguna sudah pernah menerima saldo cut-off sebelumnya. Apabila akun yang sama diimpor kembali, nominal saldo baru di berkas spreadsheet akan menimpa (overwrite) nilai saldo aktif dan pending yang sudah ada sebelumnya.
Ringkasan Fungsi Elemen Utama
| Elemen UI | Tipe | Fungsi Utama |
|---|---|---|
| Download Template | Tombol | Mengunduh berkas acuan spreadsheet saldo resmi (template-import-saldo-cutover.xlsx). |
| Upload | Tombol | Mengunggah berkas Excel saldo yang telah diisi. |
| Badge Valid & Bermasalah | Indikator | Ringkasan jumlah baris akun yang sukses vs error. |
| Kolom Status Tabel | Informasi Status | Menampilkan label Valid atau alasan error penolakan data saldo. |
| Tombol Import Saldo Awal | Eksekusi | Mengkreditkan dan memperbarui seluruh saldo tervalidasi ke dalam dompet akun pengguna. |
Tips Format Angka
Selalu pastikan format nominal angka saldo di Excel ditulis murni angka tanpa tambahan simbol mata uang (Rp) atau titik pemisah ribuan agar tidak terbaca error oleh sistem parser.

