Panduan SKREP WooCommerce Importer

Apa fungsi SKREP WooCommerce Importer?

SKREP WooCommerce Importer mengubah file ekspor dari ekstensi SKREP menjadi produk WooCommerce tanpa menyalin data satu per satu. Plugin mendukung data produk dari Shopee, Tokopedia, dan Lazada, termasuk produk sederhana atau bervariasi, harga, stok, SKU, atribut, gambar, dan media yang didukung.

Pastikan WordPress siap sebelum mengimpor

Plugin 0.3.5 mendeklarasikan kebutuhan minimum berikut:

• WordPress 7.1+ dan PHP 7.4+.
• WooCommerce 11.1.1+ sebagai dependency wajib.
• YITH WooCommerce Featured Video 1.57.0–1.58.0 sebagai dependency wajib yang sudah diverifikasi untuk binding video yang didukung.
• YITH WooCommerce Product Add-ons & Extra Options 4.33.0+ bersifat opsional.
• Variation Swatches for WooCommerce bersifat opsional/rekomendasi.

Di menu SKREP Importer → Welcome, pilih Check Environment. Jika akun WordPress memiliki izin instalasi/aktivasi plugin, SKREP dapat membantu memasang atau mengaktifkan dependency wajib yang belum siap.

Pasang dan aktifkan plugin importer

1. Buka WordPress Admin → Plugins → Add New Plugin → Upload Plugin.
2. Pilih file ZIP SKREP-WooCommerce.zip.
3. Klik Install Now, lalu Activate Plugin.
4. Buka menu SKREP Importer di sidebar WordPress.
5. Hubungkan akun SKREP dengan tombol Continue with Google. Tanpa login aktif, importer tetap terkunci.
6. Setelah login berhasil, jalankan Check Environment sampai seluruh dependency wajib berstatus siap.

Gunakan file ekspor SKREP yang sesuai kontrak

Buka ekstensi SKREP untuk marketplace sumber, rekam produk, periksa hasilnya, lalu ekspor file JSON atau CSV yang didukung. Importer melakukan deteksi sumber dan format secara otomatis.

• File dapat berasal dari Shopee, Tokopedia, atau Lazada.
• Jangan menghapus kolom provenance, metadata, atau payload SKREP sebelum impor.
• Woo-style CSV yang menggunakan provenance sidecar harus memuat Meta: skrep_source_payload. CSV lama tanpa sidecar akan dihentikan dengan kode CSV_SIDECAR_REQUIRED agar stok, SKU, dan media tidak ditebak.
• Jika struktur tidak cocok dengan kontrak SKREP yang dikenal, analyzer akan menghentikan file dengan SOURCE_SCHEMA_UNKNOWN.

Analisis file sebelum menulis produk

1. Buka SKREP Importer → Import Products.
2. Seret file ke area upload atau pilih file dari komputer.
3. Tunggu proses Analyzing file….
4. Periksa halaman Import Preview / Summary: sumber marketplace, jumlah produk, variasi, media, video, dan peringatan data.
5. Peringatan non-blocking dapat ditinjau sebelum melanjutkan. Error kontrak atau dependency wajib harus diselesaikan terlebih dahulu.
6. Jika file sudah benar, pilih Start Import.

Biarkan job durable menyelesaikan pekerjaan

Setelah Start Import, plugin menjalankan job di server dan menyimpan progress. Anda dapat meninggalkan halaman atau logout; proses yang sudah dijadwalkan tetap dapat berlanjut.

Layar progress menampilkan counter Products, Variations, Media, dan Videos. Selama proses, importer mempertahankan SKU sumber bila tersedia, membuat fallback SKU deterministik hanya bila diperlukan, menjaga semantik stok sumber, menulis variasi WooCommerce native, dan melokalkan media remote dengan deduplikasi.

100% berarti pekerjaan wajib sudah terverifikasi

Pada tahap Final verification, progress tampil 99% sambil plugin memeriksa jumlah produk, variasi, SKU, image binding, dan featured video yang relevan. Hanya hasil yang lolos verifikasi akhir yang berubah menjadi 100% / Import complete.

Jika sebagian pekerjaan wajib gagal, status menjadi Import needs attention. Produk yang sudah berhasil tetap dipertahankan. Gunakan Retry Failed Items bila item tersebut masih retryable, lalu biarkan verifikasi berjalan kembali.

Kelola hasil melalui Import History

Buka SKREP Importer → Import History untuk mencari job berdasarkan sumber, status, review state, nama file, atau ID. Mark as complete hanya mengubah status review di riwayat dan tidak menghapus produk WooCommerce yang sudah dibuat.

Masalah yang paling umum

• CSV_SIDECAR_REQUIRED: ekspor ulang CSV menggunakan ekstensi SKREP terbaru.
• SOURCE_SCHEMA_UNKNOWN: pastikan file benar-benar berasal dari ekspor SKREP yang didukung.
• Dependency tidak siap: kembali ke Welcome dan jalankan Check Environment.
• Upload/connection gagal: periksa koneksi WordPress, limit upload/PHP, security plugin, proxy, atau timeout server.
• Media gagal: pastikan server WordPress dapat mengakses URL sumber melalui HTTP/HTTPS dan tidak memblokir download remote.