Find the insights and best practices about our product.
Bulk Create & Update Menu Items

Ringkasan

Mengelola data menu secara manual dapat menjadi memakan waktu dan rentan kesalahan, terutama bagi merchant dengan menu besar atau tim onboarding yang menangani beberapa store.

Fitur Bulk Item Upload memungkinkan Anda membuat dan memperbarui beberapa item menu secara bersamaan menggunakan spreadsheet Excel (.xls atau .xlsx). Alih-alih mengedit item satu per satu di Portal, tim dapat menyiapkan data menu secara offline dan mengunggahnya dalam batch.

Fitur ini dirancang untuk:

  • Mempercepat onboarding merchant
  • Mengurangi pekerjaan manual yang berulang
  • Meminimalkan kesalahan entri data
  • Menstandarkan struktur menu di seluruh store


Mengapa Menggunakan Bulk Menu Upload

Bulk Menu Upload umumnya digunakan untuk:

  • Onboarding merchant awal
  • Pembaruan menu musiman
  • Pembaruan harga di beberapa item
  • Meluncurkan kategori produk baru
  • Koreksi menu secara massal
  • Migrasi menu berskala besar

Apa yang Didukung Fitur Ini

Bulk Create

Membuat item menu dan kategori baru dalam satu kali unggah

Bulk Update

Memperbarui item menu yang sudah ada menggunakan item yang diekspor 



Apa yang Tidak Didukung Fitur Ini

  • Merah: Nilai yang diperbarui melalui sheet bulk upload
  • Kuning: Memerlukan pengaturan manual


Konfigurasi berikut tetap harus dikelola secara manual di dalam Portal setelah unggah:

  • Item images
  • Sub-categories
  • Pembuatan dan konfigurasi modifier
  • Pengaturan item berbasis berat (weight-based)
  • Fixed Price toggle
  • Purchase Cost
  • Special Instructions
  • Order Printing Control
  • Nutri-Grade settings
  • Pengaturan visibilitas khusus store


Mengakses Bulk Item Upload

Titik Masuk

Buka Menu Management dari sidebar kiri.

  1. Buka tab Item
  2. Klik Create Item di pojok kanan atas.
  3. Pilih:
    • Import from File untuk mengimpor Item.
    • Download untuk mengekspor data item yang sudah ada.


Bulk Create Item Menu

Gunakan alur kerja ini saat membuat item menu baru yang belum ada di sistem.

Langkah 1 — Unduh Template Resmi


Dari dialog Import Item Data:

  1. Klik Download Template
  2. Simpan template terbaru secara lokal sebelum mengedit

Penting:
Sistem hanya menerima format template resmi.

Modifikasi Template yang Tidak Didukung

Proses unggah tidak mendukung:

  • Pemetaan kolom kustom
  • Header yang diubah namanya
  • Kolom yang diurutkan ulang
  • Template spreadsheet pihak ketiga

Menggunakan template yang dimodifikasi akan menyebabkan unggahan gagal.



Langkah 2 — Isi Template

Persyaratan Kolom ID

Untuk semua item baru:

  • Atur kolom ID menjadi NEW
  • Jangan biarkan kolom ID kosong

Baris 4–5 pada template hanya berupa data contoh.

Mulailah memasukkan data menu yang sebenarnya mulai dari Baris 7.

Pembuatan Kategori

Jika nama kategori belum ada di sistem:

  • Kategori ditambahkan selama unggah
  • Kategori muncul di Category List di bawah Menu V2

Ini membantu mempercepat onboarding bagi merchant dengan menu besar atau menu yang baru disusun.

Langkah 3 — Simpan File

Sebelum mengunggah:

  • Simpan spreadsheet sebagai .xls atau .xlsx
  • Pastikan ukuran file di bawah 2MB

Format File yang Tidak Didukung

Jenis file berikut tidak didukung:

  • .csv
  • .ods
  • Tautan/file Google Sheets

Jika menggunakan Google Sheets, ekspor file sebagai .xlsx sebelum mengunggah.


Langkah 4 — Unggah File

  1. Buka Item Data → Upload
  2. Seret dan lepas file ke area unggah
    atau klik untuk menjelajahi komputer Anda
  3. Centang kotak konfirmasi:
    “I’ve confirmed and reviewed the item info I upload is correct.”
  4. Klik Upload

Setelah Unggah Berhasil

Setelah unggah berhasil:

  • Item baru langsung muncul di Item List
  • Kategori yang baru dibuat muncul di Category List



Pengaturan default berikut diterapkan secara otomatis:


Visibility

Terlihat oleh semua store

Item Status

Active

Stock Tracking

Dinonaktifkan



Bulk Update Item yang Sudah Ada

Gunakan alur kerja ini saat memperbarui item yang sudah ada di sistem.

Contoh umum meliputi:

  • Pembaruan harga
  • Koreksi deskripsi
  • Perubahan kategori
  • Penyesuaian SKU

Langkah 1 — Unduh Data Item yang Sudah Ada

  1. Buka Create Item → Export Items
  2. Ekspor daftar item menu saat ini

File yang diekspor berisi:

  • ID sistem yang sudah ada
  • Data item saat ini
  • Kolom yang dapat diedit

Mengapa Ini Penting

Sistem menggunakan kolom ID untuk mengidentifikasi item mana yang harus diperbarui.

Menggunakan ekspor terbaru membantu mencegah:

  • Memperbarui item yang salah
  • Kolom wajib yang hilang
  • Menggunakan ID yang sudah usang

Langkah 2 — Edit Spreadsheet

Perbarui hanya kolom yang ingin Anda ubah.

Baris dengan nilai yang tidak berubah secara otomatis diabaikan selama unggah.

Menambahkan Item Baru dalam File yang Sama

Anda dapat menggabungkan pembuatan dan pembaruan dalam spreadsheet yang sama:

  • Item yang sudah ada → pertahankan ID sistem asli
  • Item baru → atur ID menjadi NEW

Langkah 3 — Unggah File yang Diperbarui

Ikuti proses unggah yang sama seperti yang digunakan untuk Bulk Create:

  1. Unggah spreadsheet
  2. Centang kotak konfirmasi
  3. Klik Upload

Perubahan diterapkan segera setelah validasi berhasil.



Validasi Unggah & Penanganan Kesalahan

Aturan Validasi

Sistem menerapkan logika validasi yang sama seperti yang digunakan dalam pembuatan item secara manual.

Contohnya meliputi:

  • Item Code duplikat
  • Item Name duplikat
  • SKU duplikat
  • Kolom wajib yang hilang
  • Format harga tidak valid
  • Nilai non-numerik


Pemrosesan All-or-Nothing

Penting:
Bulk upload menggunakan model validasi all-or-nothing.

Jika ada baris yang mengandung kesalahan:

  • Seluruh unggahan ditolak
  • Tidak ada item yang dibuat
  • Tidak ada item yang diperbarui

Ini mencegah unggahan sebagian dan data menu yang tidak konsisten.


Mengunduh Error File

Ketika validasi gagal:

  1. Klik Download Error File
  2. Buka spreadsheet
  3. Tinjau kolom pesan kesalahan
  4. Perbaiki semua baris yang ditandai
  5. Unggah ulang file yang telah diperbaiki

Setiap baris yang gagal menyertakan pesan kesalahan inline untuk pemecahan masalah.

Kendala & Keterbatasan

  • Format yang didukung
    • .xls dan .xlsx saja
  • Ukuran file maksimum
    • 2MB
  • Persyaratan template
    • Hanya template resmi
  • Dukungan unggah sebagian
    • Tidak didukung
  • Unggah modifier
    • Tidak didukung
  • Unggah gambar
    • Tidak didukung
  • Visibilitas khusus store
    • Tidak didukung
  • Undo / rollback
    • Tidak tersedia


Praktik Terbaik

Selalu Mulai dengan Template Terbaru

Unduh template baru sebelum setiap sesi unggah untuk menghindari masalah ketidakcocokan versi.

Gunakan Ekspor Terbaru untuk Pembaruan

Saat melakukan Bulk Update:

  • Selalu mulai dari ekspor yang baru diunduh
  • Hindari menggunakan kembali spreadsheet lama

Ini memastikan semua ID dan struktur kolom selalu terbaru.

Validasi Kolom Harga Sebelum Unggah

Pastikan:

  • Harga hanya berisi angka
  • Tidak ada simbol mata uang yang disertakan
  • Tidak ada spasi atau teks tambahan

Format yang salah adalah salah satu penyebab kegagalan unggah yang paling umum.

Periksa Sampel Item yang Diunggah

Setelah unggah berhasil:

  • Verifikasi beberapa item sampel
  • Konfirmasi harga, kategori, dan nama
  • Pastikan kategori dibuat dengan benar

Ini sangat penting selama onboarding atau migrasi menu besar.


Kesalahan Umum

Mengharapkan Keberhasilan Sebagian

Satu baris yang tidak valid menyebabkan seluruh unggahan gagal.

Selalu tinjau error file dengan cermat sebelum mengunggah ulang.

Melupakan Konfigurasi Manual Pasca-Unggah

Bulk upload tidak mengonfigurasi:

  • Item images
  • Modifier
  • Nutri-Grade
  • Store visibility
  • Perilaku pencetakan

Tim harus memelihara checklist pasca-unggah untuk menyelesaikan konfigurasi ini.



Menggunakan NEW untuk Item yang Sudah Ada

Jika item yang sudah ada memiliki kesamaan:

  • Item Code
  • Item Name
  • SKU

maka unggahan akan gagal.

Untuk memodifikasi item yang sudah ada, selalu gunakan Bulk Update dengan ID sistem yang benar.



Pertanyaan yang Sering Diajukan

Bisakah saya mengunggah file CSV?

Tidak. Hanya file .xls dan .xlsx yang didukung.

Bisakah saya membuat dan memperbarui item dalam satu unggahan?

Ya.

  • Gunakan NEW untuk item baru
  • Gunakan ID sistem yang sudah ada untuk pembaruan

Kedua operasi dapat berada dalam spreadsheet yang sama.

Bagaimana sistem mengidentifikasi item selama pembaruan?

Sistem mencocokkan record menggunakan kolom ID saja.

Item Name, SKU, atau Item Code tidak digunakan untuk pencocokan.

Bisakah saya mengunggah modifier secara massal?

Tidak. Modifier harus dibuat dan dikelola secara manual di Portal.

Bisakah saya mengunggah gambar item?

Tidak. Gambar harus diunggah secara manual setelah item dibuat.

Apakah ada fungsi undo?

Tidak.

Jika data yang salah diunggah, lakukan Bulk Update lagi untuk memperbaiki item yang terpengaruh.

Apakah ada batas jumlah baris?

Tidak ada batas jumlah baris yang tetap.

Namun, unggahan harus tetap di bawah batas ukuran file 2MB.

Untuk menu besar, pertimbangkan untuk mengunggah per kategori atau bagian guna menyederhanakan pemecahan masalah dan validasi.