Pratinjau terbatas — dokumentasi ini masih berstatus draf dan belum diterbitkan.
TutorialMenengah10 menitOwnerAdmin

Cara Mengimpor Produk dari File CSV

Tambah banyak produk sekaligus dari file CSV: siapkan file dari template, baca hasil dan rincian error, lalu periksa produk yang masuk.

Kata kunci: impor csv, import produk, unggah produk, template csv, stok per cabang. Modul: Manajemen Produk.

Status: Draf — belum diterbitkanTerverifikasi uji alur nyata (E2E) · 2026-10-26
Di halaman ini

Gunakan impor saat memindahkan katalog dari sistem lama atau lembar kerja, atau menambah puluhan produk sekaligus. Untuk beberapa produk saja, tambah satu per satu lebih mudah dikendalikan. Pakai akun Owner atau Admin, karena impor juga menulis stok.

Menyiapkan file#

Klik Unduh Template CSV di dialog Impor untuk mendapat contoh. Kolom yang dipakai:

NamaKeteranganWajibContoh
skuKode unik produk. Wajib, dan tidak boleh sudah ada di toko.YaHDS-010
nameNama produk. Wajib.YaHeadset Bluetooth X1
priceHarga jual, angka lebih dari 0.Ya150000
costHarga modal per unit. Menjadi biaya stok awal.Dianjurkan90000
categoryNama kategori. Bila belum ada, otomatis dibuat di menu Koleksi.TidakHeadset
vendorHanya disimpan sebagai teks yang tampil di kolom Vendor. Tidak membuat merek baru dan tidak terhubung ke menu Merek / Vendor.TidakBaseus
Stok (Outlet Utama)Stok awal per outlet; satu kolom per outlet, namanya harus sama dengan nama outlet Anda.Tidak8

Langkah#

  1. Buka dialog Impor

    Di Katalog > Produk, klik Impor.

    Dialog Impor Produk dari CSV.
  2. Pilih file

    Klik area unggah atau seret file .csv. Nama file tampil setelah dipilih.

    File sudah dipilih.
  3. Klik Impor Sekarang

    Tunggu sampai muncul Impor Selesai!. Jangan menutup halaman selagi diproses.

  4. Baca hasilnya

    Layar hasil menampilkan jumlah baris yang berhasil dan gagal. Pada file uji berisi empat baris: 2 baris berhasil diimpor. 2 baris gagal. Klik Lihat Rincian Error untuk melihat nomor baris, SKU, dan alasannya.

    Hasil impor: 2 berhasil, 2 gagal.

Setiap baris diproses sendiri-sendiri, jadi baris yang valid tetap tersimpan walau baris lain gagal. Tidak ada pembatalan otomatis untuk keseluruhan file.

Membaca rincian error#

Rincian error: SKU ganda dan nama kosong.
  • SKU sudah terdaftar di sistem: SKU sudah dipakai produk lain.
  • Nama Produk wajib diisi atau Harga Jual wajib diisi dan harus angka positif: perbaiki kolomnya di file.

Memeriksa hasil#

Cari beberapa SKU dari file di kolom pencarian. Dua produk yang valid muncul dengan harga dan stok sesuai file, kategori terisi, dan kolom Vendor berisi teks dari file. Di halaman detail, kolom cost menjadi Biaya FIFO terkini (Rp 20.000 untuk cost 20000), tetapi Brand / Vendor masih Pilih brand; pasang merek di sana bila perlu.

Dua produk hasil impor tersimpan setelah reload.
Kategori yang belum ada otomatis dibuat di menu Koleksi.

Jangan mengimpor ulang seluruh file#

Mengimpor file yang sama lagi menolak semua baris: baris yang sudah masuk dianggap SKU ganda. Hasil uji: 0 baris berhasil diimpor. 4 baris gagal. Perbaiki hanya baris yang gagal, simpan sebagai file baru, lalu impor file itu.

Impor ulang file yang sama: semua baris ditolak.

Kendala#

  • "Gagal memproses file CSV...": file rusak atau bukan CSV; simpan ulang sebagai CSV.
  • Nama outlet tidak dikenal pada judul kolom stok: impor dihentikan dengan pesan nama cabang tidak terdaftar. Samakan dengan nama outlet.
  • Tombol Impor nonaktif: paket langganan belum mencakup fitur impor (akses dan paket).