Import Data Mitra
Halaman Import Data Mitra digunakan oleh Admin untuk memasukkan atau menyelaraskan data mitra dalam jumlah banyak sekaligus menggunakan berkas spreadsheet (Excel/CSV) ke dalam platform Teem.id.
Fitur ini mempermudah registrasi masal dan migrasi data keanggotaan tanpa perlu menginput data satu per satu secara manual.
Cara Mengakses Halaman Import Data Mitra
Bagi Admin yang baru pertama kali mengakses fitur ini, ikuti langkah navigasi berikut untuk menuju ke halaman impor:
- Pada bilah navigasi kiri (sidebar), buka modul Kemitraan > Mitra.
- Di bagian atas tabel daftar mitra, klik tombol Import Data Mitra yang berada di sebelah tombol Filter.
- Sistem akan mengarahkan (redirect) Anda secara langsung ke halaman utama Import Mitra.
Tampilan Halaman Mitra (klik gambar untuk memperbesar)
Panduan Penggunaan & Pengisian Berkas
Setelah berada di halaman Import Mitra, Anda dapat mengunduh berkas acuan (template), mengisi data, dan memvalidasi isi berkas sebelum disimpan ke sistem.
Tampilan Halaman Import Mitra
1. Mengunduh & Mengisi Berkas Template
Gunakan tombol Download Template pada bagian atas untuk mendapatkan format spreadsheet acuan resmi, lalu lengkapi kolom-kolomnya sesuai ketentuan berikut:
| Header Kolom | Deskripsi Pengisian |
|---|---|
| Alamat email mitra yang terdaftar (Wajib). | |
| Level Mitra | Tingkatan jenjang kemitraan (Wajib). |
| NIK | Nomor Induk Kependudukan 16 digit angka (Wajib). |
| NPWP | Nomor Pokok Wajib Pajak mitra (Opsional). |
| Alamat Lengkap | Alamat domisili atau lokasi jalan/nomor rumah (Wajib). |
| Provinsi | Nama provinsi domisili (Wajib). |
| Kota/Kabupaten | Nama kota atau kabupaten (Wajib). |
| Kecamatan | Nama kecamatan (Wajib). |
| Desa/Kelurahan | Nama desa atau kelurahan (Wajib). |
| Latitude | Koordinat garis lintang peta, dengan rentang -90 sampai 90 (Opsional). |
| Longitude | Koordinat garis bujur peta, dengan rentang -180 sampai 180 (Opsional). |
| Nama Bank | Nama atau kode bank resmi yang terdaftar di sistem (Opsional). |
| Nomor Rekening | Nomor rekening bank atau e-wallet mitra (Wajib jika Nama Bank diisi). |
| Nama Pemilik Rekening | Nama pemilik sesuai yang tertera pada buku tabungan (Opsional). |
| Tanggal Mulai Kontrak | Tanggal awal berlakunya masa aktif kemitraan (Wajib, format YYYY-MM-DD). |
| Tanggal Berakhir Kontrak | Tanggal berakhirnya masa aktif. Kosongkan jika tidak memiliki batas waktu. |
2. Mengunggah Berkas & Memeriksa Hasil Validasi
Setelah berkas diisi, klik tombol Upload berwarna merah untuk memproses data. Sistem akan memverifikasi isi berkas dan menampilkan hasilnya pada tabel validasi:
- Indikator Ringkasan: Menampilkan jumlah baris data Valid (siap diimpor) dan Bermasalah (perlu diperbaiki).
- Tabel Peninjauan: Menampilkan rincian nomor baris (Kolom), email, level, serta pesan detail pada kolom Status jika terdapat kesalahan.
- Eksekusi Akhir: Jika seluruh data sudah valid, klik tombol Import Mitra di pojok kanan bawah untuk mengunggah data secara resmi ke database.
Panduan Mengatasi Masalah Validasi
Apabila sistem menampilkan pesan kesalahan pada tabel validasi, gunakan tabel acuan berikut untuk mengetahui penyebab dan cara solusinya:
1. Masalah Akun dan Role Mitra
| Pesan Error Sistem | Penyebab Utama | Solusi Penanganan |
|---|---|---|
| Email "[email]" tidak ditemukan | Email belum terdaftar pada data profil sistem. | Pastikan mitra sudah membuat atau didaftarkan akunnya di Teem.id. |
| Email "[email]" duplikat di file ini | Alamat email ditulis lebih dari satu kali dalam berkas Excel. | Hapus baris duplikat dan sisakan satu data untuk email tersebut. |
| Email "[email]" sudah terdaftar sebagai mitra sebelumnya | Akun tersebut sudah memiliki profil mitra. | Tidak perlu diimpor kembali. Kelola data mitra melalui Kemitraan > Mitra. |
| Email "[email]" belum mendaftar akun di platform | Profil pengguna belum memiliki Role yang diperlukan untuk menjadi mitra. | Minta pengguna mendaftar melalui aplikasi atau halaman publik terlebih dahulu. |
| Level "[kode]" tidak dikenali | Kode level kemitraan tidak sesuai dengan Role yang tersedia di sistem. | Gunakan kode Role sesuai dengan data yang tersedia di sistem. |
2. Masalah Wilayah dan Alamat
| Pesan Error Sistem | Penyebab Utama | Solusi Penanganan |
|---|---|---|
| Provinsi "[nama]" tidak ditemukan | Penulisan nama provinsi tidak sesuai dengan data wilayah di sistem. | Sesuaikan penulisan nama provinsi dengan data yang tersedia di sistem. |
| Kota/Kabupaten "[nama]" tidak ditemukan di provinsi tersebut | Nama kota atau kabupaten salah atau tidak berada di provinsi yang dipilih. | Pastikan penulisan nama kota atau kabupaten benar dan sesuai dengan provinsinya. |
| Kecamatan "[nama]" tidak ditemukan di kota tersebut | Nama kecamatan tidak terdaftar dalam wilayah kota atau kabupaten yang dipilih. | Periksa kembali penulisan nama kecamatan sesuai data wilayah di sistem. |
| Desa/Kelurahan "[nama]" tidak ditemukan | Nama desa atau kelurahan tidak berada di bawah kecamatan yang dipilih. | Periksa kembali penulisan nama desa atau kelurahan sesuai wilayah kecamatannya. |
Ketelitian Wilayah Berjenjang
Validasi wilayah dilakukan secara berjenjang dari Provinsi → Kota/Kabupaten → Kecamatan → Desa/Kelurahan. Pastikan hubungan antarwilayah sudah sesuai.
3. Masalah Format Data dan Koordinat
| Pesan Error Sistem | Penyebab Utama | Solusi Penanganan |
|---|---|---|
| Latitude / Longitude tidak valid | Format koordinat salah atau nilainya di luar batas bumi. | Pastikan Latitude (-90 s/d 90) dan Longitude (-180 s/d 180). |
| Tanggal Mulai Kontrak kosong atau format salah | Format tanggal tidak sesuai. | Ubah format tanggal pada Excel menjadi format standar YYYY-MM-DD. |
| Bank "[nama]" tidak ditemukan | Nama bank tidak tersedia pada master data bank. | Gunakan nama bank yang terdaftar di sistem. |
| Nama Bank diisi tapi Nomor Rekening kosong | Nomor rekening belum diisi saat bank dipilih. | Lengkapi Nomor Rekening atau kosongkan kedua kolom jika tidak ada data bank. |
Ringkasan Fungsi Elemen Utama
| Elemen | Jenis | Fungsi Utama |
|---|---|---|
| Download Template | Tombol | Mengunduh format acuan spreadsheet resmi. |
| Upload | Tombol | Mengunggah berkas Excel yang telah diisi. |
| Badge Valid dan Bermasalah | Indikator | Menampilkan jumlah data yang valid dan bermasalah. |
| Kolom Status Tabel | Informasi Kesalahan | Menampilkan alasan penolakan data oleh sistem. |
| Tombol Import Mitra | Eksekusi | Menyimpan data yang telah lolos validasi ke dalam sistem. |