DOCS

Bundles

Bundles

Jual produk bundel dengan landed cost yang akurat dan opsi pengemasan yang fleksibel.

Bundel adalah produk yang dijual sebagai unit tunggal (induk) yang terpecah menjadi item komponen individual saat checkout. Ketika pelanggan membeli bundel, Zonos mengembangkannya menjadi komponen-komponennya, mendiskon harga setiap komponen agar sesuai dengan harga bundel, dan menghitung bea serta pajak berdasarkan HS code dan negara asal setiap komponen.

Misalnya, seorang pedagang menjual baju secara individual seharga $30 masing-masing, atau sebagai bundel 4 buah seharga $100. Ketika pelanggan membeli bundel:

  • Pesanan dan invoice komersial menampilkan 4 baju masing-masing $25 (bukan 1 bundel seharga $100 atau 4 baju seharga $30 masing-masing)
  • HS code dan negara asal setiap baju digunakan untuk perhitungan landed cost
  • Biaya pengiriman dihitung menggunakan dimensi kotak sebenarnya yang digunakan pedagang untuk mengirimnya

Mode pengemasan 

Bundel mendukung dua mode pengemasan yang mengatur bagaimana item dikemas untuk pengiriman:

Assigned box

Pedagang menentukan terlebih dahulu item ke kotak tertentu dengan dimensi yang diketahui. Setiap kotak ditentukan dengan panjang, lebar, tinggi, dan kapasitas berat. Kartonisasi menggunakan kotak yang tepat ini alih-alih melakukan estimasi.

Paling cocok untuk: Produk yang kotak pengirimannya sudah Anda ketahui, atau bundel yang selalu dikirim dalam kotak yang sama.

Auto-box

Pedagang mengelompokkan item ke dalam bundel tanpa menentukan kotak. Pada saat pesanan dibuat, Zonos menggunakan algoritma kartonisasinya untuk menentukan pengemasan kotak yang optimal berdasarkan dimensi item dan opsi pengemasan yang tersedia.

Paling cocok untuk: Bundel dengan pengemasan yang bervariasi, produk dengan pengemasan yang fleksibel, atau ketika Anda ingin Zonos mengoptimalkan pemilihan kotak secara otomatis.

Kedua mode mengembangkan bundel menjadi komponen individual dengan HS code per item, negara asal, dan harga yang didiskon. Perbedaannya hanya pada bagaimana kotak ditentukan.

Cara kerja bundel 

Ketika Anda membuat bundel di Catalog, Anda menentukan:

  • SKU bundel atau ID produk — pengidentifikasi produk yang cocok dengan toko Anda
  • Harga bundel — harga total seperti yang muncul di toko Anda
  • Mode pengemasan — assigned box atau auto-box
  • Item komponen — setiap produk individual yang disertakan dalam bundel, dirujuk oleh ID item katalognya. Komponen harus sudah ada sebagai item katalog sebelum Anda dapat menambahkannya ke bundel.
  • Penugasan kotak (hanya assigned box) — komponen mana yang dikirim dalam kotak mana, dengan dimensi dan berat sebenarnya

Ketika pesanan yang berisi bundel ditempatkan, Zonos secara otomatis:

  1. Mengembangkan bundel menjadi komponen-komponennya yang terpisah
  2. Mendiskon setiap komponen menggunakan rasio harga yang dihitung sehingga harga per item cocok dengan harga bundel
  3. Menghitung landed cost menggunakan HS code, negara asal, dan dimensi kotak setiap komponen — menghasilkan total bea, pajak, dan pengiriman yang akurat
  4. Menghasilkan label — bundel assigned-box mendapat satu label per kotak yang ditentukan; bundel auto-box mendapat label berdasarkan hasil kartonisasi

Prasyarat 

Sebelum membuat bundel, pastikan bahwa:

  • Semua item komponen ada sebagai item katalog di Zonos Catalog Anda. Bundel merujuk komponen berdasarkan ID item katalognya — Anda tidak dapat menambahkan item yang belum ada. Komponen tidak perlu dijual secara individual di toko Anda — mereka dapat ada di katalog Anda hanya sebagai bagian bundel.
  • Setiap komponen memiliki HS code yang akurat, negara asal, dan pengukuran (berat dan dimensi). Ini digunakan untuk perhitungan landed cost ketika bundel dikembangkan.
  • SKU atau ID produk bundel cocok dengan pengidentifikasi yang dikirim platform e-commerce Anda ke Zonos dan preferensi kunci Item di Zonos Dashboard Anda. Untuk toko Shopify, ID produk bundel harus menjadi Shopify variant ID dari produk bundel.

Setiap bundel harus berisi setidaknya 2 item komponen. Bundel dengan satu item sebaiknya menjadi item katalog mandiri.

  1. Buka Dashboard > Products > Bundles.
  2. Klik Add Bundle di sudut kanan atas.
  3. Masukkan SKU atau ID Produk bundel — ini harus cocok dengan pengidentifikasi yang dikirim toko Anda ke Zonos. Item key preference di Zonos Dashboard Anda juga harus diatur ke pengidentifikasi yang benar.
  4. Masukkan nama, harga, dan mata uang bundel.
  5. Pilih Assigned box sebagai mode pengemasan.
  6. Tambahkan kotak dengan dimensi spesifik (panjang, lebar, tinggi, dan kapasitas berat).
  7. Tambahkan item komponen dengan mencari katalog Anda dan tetapkan masing-masing ke sebuah kotak. Untuk setiap komponen, tentukan:
    • Kuantitas — berapa banyak unit komponen ini dalam bundel
    • Kotak — kotak mana komponen ini dikirim
    • Rasio harga — porsi dari harga bundel yang direpresentasikan komponen ini (dihitung otomatis jika dibiarkan kosong)
  8. Klik Save.

Ada dua opsi impor yang tersedia dari Manage > Import:

Impor bundel 

Membuat bundel yang merujuk item katalog yang sudah ada. Item komponen harus sudah ada di katalog Anda sebelum diimpor.

  1. Buka Dashboard > Products > Bundles.
  2. Klik Manage > Import bundles.
  3. Unduh templat CSV sampel — pilih format Assigned box atau Auto-box.
  4. Isi satu baris per item komponen. Bidang tingkat bundel (SKU, nama, harga) diulang di setiap baris untuk bundel yang sama.
  5. Unggah CSV lengkap Anda dan klik Import.

Bidang CSV bundel 

KolomDeskripsi
Bundle SKUSKU bundel seperti yang muncul di toko Anda.
Bundle Product IDID produk bundel seperti yang muncul di toko Anda.
Bundle NameNama bundel.
Bundle DescriptionDeskripsi bundel.
Bundle Image URLURL gambar untuk bundel.
Bundle AmountHarga total bundel.
Bundle CurrencyMata uang harga bundel, misal USD.
Box NumberNomor kotak komponen baris ini dikirim, misal 1 atau 2. Gunakan nomor yang sama untuk semua komponen di kotak yang sama.
Box LengthPanjang kotak untuk baris ini.
Box WidthLebar kotak untuk baris ini.
Box HeightTinggi kotak untuk baris ini.
Box Dimensional UnitSatuan dimensi untuk kotak, misal INCH.
Box Weight CapacityKapasitas berat maksimal kotak.
Box Weight UnitSatuan berat untuk kapasitas kotak, misal POUND.
Item SKUSKU item komponen ini. Harus cocok dengan item katalog yang ada.
Item Product IDID produk item komponen ini. Harus cocok dengan item katalog yang ada.
Item QuantityBerapa banyak unit komponen ini dalam bundel.

Catatan: Awalan kolom "Bundle" dan "Kit" sama-sama diterima untuk kompatibilitas mundur (misalnya, "Kit SKU" berfungsi sama dengan "Bundle SKU").

Aturan validasi impor CSV 

Aturan validasi berikut berlaku untuk semua impor CSV bundel:

  • Minimum 2 item — Setiap bundel harus berisi setidaknya 2 item komponen. Bundel dengan satu item sebaiknya menjadi item katalog mandiri.
  • Bidang kotak all-or-nothing — Untuk bundel assigned-box, semua 6 bidang kotak harus ada di setiap baris: Box Length, Box Width, Box Height, Box Dimensional Unit, Box Weight Capacity, dan Box Weight Unit. Jika salah satu bidang kotak diisi, keenamnya wajib diisi. Jika semua bidang kotak kosong, bundel diperlakukan sebagai auto-box.
  • Tidak boleh mencampur mode pengemasan — Satu bundel tidak dapat mencampur baris assigned-box (dengan dimensi kotak) dan baris auto-box (tanpa dimensi kotak). Semua baris untuk satu bundel harus menggunakan mode yang sama.
  • Normalisasi HS code — HS code diformat secara otomatis saat impor. Karakter non-alfanumerik (titik, tanda hubung, spasi) dihapus dan kode dinormalisasi ke format angka genap.

Impor bundel + item katalog 

Membuat item katalog DAN bundel sekaligus dalam satu unggahan. Gunakan ini ketika item komponen Anda belum ada di katalog — item tersebut akan dibuat atau diperbarui secara otomatis.

  1. Buka Dashboard > Products > Bundles.
  2. Klik Manage > Import bundles + catalog items.
  3. Unduh templat CSV sampel — pilih format Assigned box atau Auto-box.
  4. Isi satu baris per item komponen, termasuk kolom detail item (nama, HS code, negara asal, pengukuran).
  5. Unggah CSV lengkap Anda dan klik Import.

Impor terlebih dahulu membuat atau memperbarui item katalog turunan, kemudian membuat bundel yang merujuknya. Jika item dengan SKU atau ID produk yang sama sudah ada, detailnya diperbarui dengan nilai dari CSV. HS code dinormalisasi secara otomatis selama impor (karakter non-alfanumerik dihapus dan kode diformat ke format angka genap standar).

Bidang CSV gabungan 

Mencakup semua bidang CSV bundel ditambah kolom detail item:

KolomDeskripsi
Bundle SKUSKU bundel.
Bundle Product IDID produk bundel.
Bundle NameNama bundel.
Bundle DescriptionDeskripsi bundel.
Bundle Image URLURL gambar untuk bundel.
Bundle AmountHarga total bundel.
Bundle CurrencyMata uang harga bundel, misal USD.
Box NumberKotak mana komponen ini dikirim.
Box LengthPanjang kotak.
Box WidthLebar kotak.
Box HeightTinggi kotak.
Box Dimensional UnitSatuan dimensi, misal INCH.
Box Weight CapacityKapasitas berat kotak.
Box Weight UnitSatuan berat, misal POUND.
Item SKUSKU item komponen.
Item Product IDID produk item komponen.
Item NameNama tampilan untuk item katalog.
Item DescriptionDeskripsi item.
Item HS CodeKode Harmonized System untuk klasifikasi bea cukai.
Item Country of OriginKode negara dua huruf tempat item diproduksi, misal CN.
Item WeightBerat item.
Item Weight UnitSatuan berat, misal POUND.
Item LengthPanjang item.
Item WidthLebar item.
Item HeightTinggi item.
Item Dimensional UnitSatuan dimensi untuk pengukuran item, misal INCH.
Item QuantityBerapa banyak unit komponen ini dalam bundel.
Item AmountHarga item komponen individual. Digunakan saat membuat atau memperbarui item katalog.
Item CurrencyMata uang harga item, misal USD.
Item Packing PreferenceBagaimana item ini harus dikemas. Gunakan ASSIGNED_BOX untuk item yang dikemas dalam kotak yang ditentukan, CONSOLIDATED untuk kartonisasi, atau SHIPS_ALONE untuk item yang harus dikirim terpisah. Opsional — default ke ASSIGNED_BOX ketika kolom kotak ada.
  1. Buka Dashboard > Products > Bundles.
  2. Klik Manage > Export.
  3. Pilih opsi ekspor:
    • Export all bundles — mengekspor semua bundel
    • Export assigned box bundles — hanya mengekspor bundel dengan kotak yang telah ditentukan sebelumnya
    • Export auto bundles — hanya mengekspor bundel auto-box
  4. Klik Export. CSV akan dikirim ke email Anda saat sudah siap.

Catatan: Pengeditan bundel memengaruhi pesanan masa depan saja. Pesanan yang sudah ditempatkan dan dipenuhi tidak terpengaruh.

  1. Buka Dashboard > Products > Bundles.
  2. Klik bundel yang ingin Anda edit.
  3. Perbarui bidang dan klik Save.

Anda dapat mengubah mode pengemasan, menambah atau menghapus komponen, memperbarui penugasan kotak, dan mengubah harga bundel.

Untuk menghapus satu bundel, buka bundel dan klik Delete.

Untuk menghapus beberapa bundel sekaligus:

  1. Pilih bundel yang ingin Anda hapus menggunakan checkbox.
  2. Klik Delete selected.
  3. Konfirmasi penghapusan.

Untuk menghapus semua bundel di halaman saat ini, klik Manage > Delete page.

Anda dapat menambahkan bundel ke penawaran langsung dari quoter untuk melihat pratinjau landed cost sebelum menempatkan pesanan.

  1. Di quoter, alihkan ke tab Search bundles di bagian Items.
  2. Cari bundel berdasarkan nama, SKU, atau ID produk.
  3. Pilih bundel. Zonos secara otomatis:
    • Mengembangkan bundel menjadi item komponen individual di daftar item, masing-masing dengan HS code, negara asal, dan harga yang didiskon sendiri.
    • Mengisi kotak (hanya bundel assigned-box) — kotak yang telah ditentukan sebelumnya untuk bundel ditambahkan ke bagian Boxes dengan dimensinya yang sudah terisi.
    • Melewati pengisian kotak (bundel auto-box) — kartonisasi menentukan kotak saat penawaran dihitung.
  4. Item komponen muncul dikelompokkan di bawah nama bundel dalam daftar item.
  5. Hitung penawaran. Landed cost mencerminkan struktur bundel sebenarnya — bea, pajak, dan pengiriman per komponen berdasarkan dimensi kotak yang sebenarnya atau yang ditentukan secara otomatis.

Anda dapat menambahkan beberapa bundel dan item mandiri ke penawaran yang sama. Setiap bundel dikembangkan secara independen.

Mengapa bundel penting untuk landed cost 

Tanpa bundel, Zonos melihat item baris tunggal (misal, "Truck Tire 4-Pack — $1.000") tanpa visibilitas ke apa yang ada di dalamnya. Ini menyebabkan masalah:

  • Tidak ada HS code per item — Zonos tidak dapat mengklasifikasikan komponen untuk tingkat bea yang akurat
  • Tidak ada dimensi kotak sebenarnya — biaya pengiriman diestimasi menggunakan algoritma auto-packing bukan kotak sebenarnya pedagang
  • Tidak ada harga per item — harga bundel penuh digunakan untuk perhitungan bea bukan harga per komponen yang didiskon

Bundel mengatasi ketiganya dengan memberikan Zonos rincian komponen, penugasan kotak (atau pengelompokan auto-box), dan alokasi harga di muka. Hasilnya adalah kutipan landed cost yang mencerminkan apa yang akan benar-benar dibayar pelanggan di perbatasan.

Rasio harga dan harga komponen 

Saat bundel terjual, Zonos perlu mengetahui berapa nilai masing-masing komponen secara individual. Ini karena pengiriman internasional memerlukan nilai yang dinyatakan per item pada invoice komersial, dan bea/pajak dihitung untuk setiap item secara terpisah.

priceRatio mengontrol bagaimana harga total bundel dibagi di antara komponen-komponennya. Anda tidak harus mengaturnya sendiri — jika dibiarkan kosong, Zonos secara otomatis membagi harga secara merata ke semua komponen.

Misalnya, bundel seharga $1.000 dengan 4 ban dan tanpa rasio harga yang diatur akan secara otomatis menyatakan setiap ban seharga $250 (0,25 masing-masing). Jika komponen Anda memiliki nilai yang berbeda — misalnya 2 ban premium dan 2 ban standar — Anda dapat mengatur rasio secara manual seperti 0,35 dan 0,15 untuk mencerminkan perbedaan nilai sebenarnya.

Zonos secara otomatis menormalisasi rasio sehingga Anda tidak perlu khawatir tentang perhitungannya:

  • Jika Anda membiarkan beberapa rasio kosong, nilai yang tersisa dibagi secara merata di antara komponen-komponen tersebut
  • Jika rasio tidak berjumlah tepat 1,0, Zonos menskalakannya secara proporsional
  • Rasio akhir selalu berjumlah tepat 1,0

Kartonisasi dan label 

Komponen bundel assigned-box menggunakan kotak yang ditentukan pedagang alih-alih algoritma bin-packing standar. packingPreference setiap komponen diatur ke ASSIGNED_BOX, yang memberi tahu kartonisasi untuk menempatkannya di kotak yang ditentukan oleh packageOptionId dan packageOptionIdIndex.

Ini adalah keuntungan inti dari bundel assigned-box — pedagang tahu persis bagaimana produk mereka dikirim, sehingga dimensi kotak dan berat yang digunakan untuk perhitungan landed cost akurat, bukan diestimasi.

Setiap kotak dalam bundel menghasilkan label pengiriman sendiri dengan nomor pelacakan sendiri. Bundel dengan dua kotak menghasilkan dua label.

Pesanan campuran

Item non-bundel dalam pesanan yang sama dikemas secara terpisah menggunakan algoritma kartonisasi standar, terlepas dari mode pengemasan yang digunakan bundel.

Pesanan bundel campuran 

Satu pesanan dapat berisi beberapa bundel dan item mandiri secara bersamaan. Misalnya, pesanan dengan:

  • 1x bundel 4-pack dengan assigned box (dikirim dalam 2 kotak)
  • 1x bundel auto-box berisi 3 item (kartonisasi menentukan pengemasan)
  • 1x item mandiri tunggal

Zonos mengembangkan setiap bundel secara independen. Perhitungan landed cost mencakup semua kotak dengan dimensi yang akurat dan semua harga komponen individual. Setiap kotak mendapat labelnya sendiri.

Integrasi Shopify 

Bundel memiliki perilaku khusus saat digunakan dengan toko Shopify.

Setup

ID produk bundel di Zonos Catalog harus cocok dengan variant ID Shopify dari produk bundel. Ini adalah cara Zonos mencocokkan item baris Shopify dengan definisi bundel. Anda dapat menemukan variant ID di URL admin Shopify saat melihat varian produk.

Alur pesanan

Ketika pelanggan memesan bundel di toko Shopify:

  1. Shopify mengirim item baris tunggal untuk induk bundel (misal, "Truck Tire 4-Pack x 1").
  2. Zonos mencocokkan variant ID item baris dengan ID produk bundel di katalog Anda.
  3. Zonos mengembangkan bundel menjadi komponen-komponennya untuk perhitungan landed cost — HS code, negara asal, dan harga yang didiskon dari setiap komponen digunakan untuk bea dan pajak yang akurat.
  4. Pesanan Shopify masih menampilkan item baris bundel tunggal — ekspansi komponen ditangani sepenuhnya oleh Zonos.

Pemenuhan

Saat membuat pemenuhan, Zonos memetakan komponen bundel yang dikembangkan kembali ke item baris bundel Shopify asli. Pedagang melihat induk bundel dipenuhi di Shopify (misal, "Truck Tire 4-Pack x 1 dipenuhi"), sementara invoice komersial dan dokumen bea daftar setiap komponen secara terpisah.

GraphQL API ReferenceTypes, inputs, and operations used in this guide
Pesan demo

Apakah halaman ini bermanfaat?