Dokumentasi · Spesifikasi datafeed v1

Spesifikasi datafeed yang dirahasiakan kompetitor.

Satu CSV (atau JSON) mendeskripsikan seluruh katalog Anda. Sengaja dibuat kompatibel dengan format de-facto yang sudah dipakai kebanyakan visualizer ruangan — kalau Anda sudah mengelola datafeed produk untuk salah satunya, langsung bisa diunggah ke Ruangmu tanpa diubah.

Unduh template CSV↓13 kolom · UTF-8 · satu baris per SKU

Sudah pakai visualizer lain? Ekspor CSV yang sama dengan yang Anda kelola untuknya sekarang dan unggah apa adanya. Kolom tambahan diabaikan, tidak pernah ditolak.

Referensi kolom

Kolom	Wajib	Fungsinya
SKU Number	Wajib	ID produk unik dan stabil milik Anda. Dipakai untuk deep link (data-sku), analitik, dan re-upload berbasis diff — render dan riwayat tetap menempel padanya.
Product Name	Wajib	Ditampilkan ke pelanggan di widget dan pada gambar render yang dibagikan.
Category	Wajib	Teks bebas yang tampil sebagai filter, mis. “SPC”, “WPC”, “Karpet”.
Collection	Opsional	Mengelompokkan produk jadi filter tingkat kedua di widget.
Colors	Opsional	Nama warna dipisah koma; menggerakkan filter warna dan pencarian.
Thickness	Opsional	Ketebalan fisik dengan satuan, mis. “4mm”. Tampil di detail produk.
Width	Disarankan	Lebar fisik dengan satuan, mis. “180mm”. Masuk ke prompt render agar skala papan/panel/keramik terlihat benar di ruangan.
Length	Disarankan	Panjang fisik dengan satuan. Peran sama dengan Width untuk realisme render.
Surface Applicability	Wajib	Satu dari enam permukaan di bawah. Menentukan pipeline render yang dipakai produk Anda — kolom terpenting di feed ini.
Product Layout	Opsional	Straight, Herringbone, atau Chevron. Memberi tahu renderer cara memasang produk, mis. arah papan herringbone.
Top-Down Image URL	Wajib	Link HTTPS ke foto produk dari atas (swatch), datar. Gambar ini dipakai AI sebagai referensi tekstur — kualitasnya menentukan kualitas render Anda.
Product Page URL	Opsional	Tujuan link “Lihat produk” dari widget.
Add to Cart URL	Opsional	Menggerakkan CTA “Tambah ke keranjang”. Boleh berisi {sku} yang kami ganti saat diklik.

Nilai Surface Applicability

Tepat satu nilai per produk. Menentukan tab kategori dan prompt render yang tepat.

Floorpapan, keramik, karpet, vinyl gulungan

Ceilingpanel uPVC / WPC, kisi-kisi

Wallpanel dinding, wallpaper, cat

Curtaingorden, diterapkan per jendela

Rugdiletakkan di lantai, lantai lama tetap

Furnituremenggantikan furnitur sejenis

Nilai Product Layout

Opsional, khusus produk lantai/dinding: Straight (default), Herringbone, Chevron. Kalau produk Anda dipasang dengan pola tetap, isi di sini agar render memasangnya dengan benar.

StraightHerringboneChevron

Panduan gambar swatch

✓Dari atas, datar, pencahayaan merata — tanpa foto perspektif, tanpa scene ruangan, tanpa watermark.
✓Minimal 800×800px; JPG, PNG, atau WebP; di bawah 5MB.
✓Tampilkan produk secukupnya sampai pengulangan polanya terlihat (untuk papan: minimal 2–3 papan).
✓AI memakai gambar ini sebagai referensi tekstur — yang Anda unggah itulah yang dirender.

Lebih suka JSON?

POST field yang sama sebagai array objek dengan key camelCase. Kedua format divalidasi identik.

[
  {
    "skuNumber": "SPC-305",
    "productName": "Walnut Herringbone",
    "category": "SPC Flooring",
    "collection": "Heritage",
    "colors": "Dark Walnut",
    "thickness": "4mm",
    "width": "120mm",
    "length": "610mm",
    "surfaceApplicability": "Floor",
    "productLayout": "Herringbone",
    "topDownImageUrl": "https://yourstore.com/images/spc-305-topdown.jpg",
    "productPageUrl": "https://yourstore.com/products/spc-305",
    "addToCartUrl": "https://yourstore.com/cart/add?sku={sku}"
  }
]

Validasi

✓Unggahan divalidasi baris per baris — Anda mendapat laporan error per baris (kolom hilang, URL rusak, nilai surface tak dikenal), tidak pernah impor parsial diam-diam.
✓Re-upload di-diff berdasarkan SKU Number: baris berubah diperbarui, baris hilang bisa dinonaktifkan, riwayat analitik tidak pernah dihapus.
✓SKU Number ganda dalam satu file ditolak dengan daftar nomor barisnya.

Dokumentasi embed & JS API

Embed widget (satu script tag), deep link data-sku, dan API JavaScript didokumentasikan di dashboard Anda setelah membuat akun.