Bagaimana cara membuat produk di Zonos Catalog?

Anda dapat membuat produk di Zonos Catalog baik melalui Dashboard atau API. Di Dashboard, buka Catalog dan klik Add product di sudut kanan atas. Tambahkan detail produk Anda dan klik save product. Jika Anda ingin membuat beberapa produk sekaligus, ikuti langkah-langkah untuk mengimpor produk. Di API, buat daftar catalogItemInputs untuk menambahkan produk ke katalog Anda.

Bagaimana cara mengedit produk di Zonos Catalog?

Anda dapat mengedit produk di Zonos Catalog baik melalui Dashboard atau API. Di Dashboard, klik tab All products, pilih produk yang ingin Anda edit, buat perubahan Anda, dan klik save product. Di API, gunakan mutasi CatalogItemUpdate untuk mengedit produk.

Bagaimana cara menghapus produk di Zonos Catalog?

Anda dapat menghapus produk di Zonos Catalog baik melalui Dashboard atau API. Di Dashboard, klik tab All products, pilih produk atau produk yang ingin Anda hapus, dan klik delete. Di API, gunakan mutasi CatalogItemDelete untuk menghapus produk.

Bagaimana cara membatasi produk di Zonos Catalog?

Jika Anda ingin mencegah pengiriman ke negara tertentu (atau negara-negara), Anda dapat menambahkan pembatasan saat membuat atau memperbarui produk di Zonos Catalog. Di Dashboard, pilih produk yang ingin Anda tambahkan pembatasan, temukan bagian pembatasan di bagian bawah halaman edit, tambahkan negara yang ingin Anda batasi produk Anda, dan klik save product. Di API, tambahkan restrictedCountries saat membuat atau memperbarui catalogItem.

Bagaimana cara mengekspor produk Anda di Zonos Dashboard?

Saat Anda mengekspor produk Anda di Zonos Dashboard, secara otomatis akan mengekspor seluruh katalog produk Anda dalam file CSV. Buka halaman utama Catalog Anda, klik tombol Export di sebelah Add product, dan temukan file katalog lengkap Anda di unduhan Anda.

BerandaEcommerce global Katalog Kelola produk

Kelola Katalog

Buat dan modifikasi produk.

Pelajari cara menambah, memodifikasi, dan menghapus produk Zonos Catalog Anda di Dashboard atau melalui API. Gunakan Catalog di Dashboard untuk menghindari penulisan kode atau jika Anda membuat perubahan kecil. Jika Anda ingin terintegrasi langsung dengan Catalog untuk implementasi produksi, gunakan API.

Buat produk

Buat produk di Catalog:

Pergi ke Catalog dan klik Add product di sudut kanan atas.
Tambahkan detail produk Anda. Satu-satunya bidang yang diperlukan untuk membuat produk adalah bidang SKU dan/atau ID produk. Bidang ini akan digunakan untuk mereferensikan produk katalog Anda. Pelajari lebih lanjut tentang pengenal Catalog.
Opsional—Tambahkan kode HS Anda.
Opsional—Tambahkan informasi pengiriman Anda (berat, dimensi, unit pengukuran, dll.).
Opsional—Tambahkan negara yang dibatasi.
Klik save product.

Buat beberapa produk di Catalog:

Unggah beberapa produk atau seluruh katalog produk Anda sekaligus.

Penting: Jika Anda mencoba membuat produk yang sudah ada, Catalog akan mengenali produk berdasarkan SKU dan/atau ID produk dan mengganti detail produk asli dengan detail baru.

Tandai produk sebagai barang berbahaya (DHL)

Untuk pengiriman DHL, Anda dapat menandai produk sebagai barang berbahaya sehingga layanan nilai tambah DHL yang benar diterapkan secara otomatis setiap kali Anda membuat label untuk produk tersebut. Ini mencakup kelas "risiko rendah" atau yang dikecualikan dari barang yang diatur—item yang secara teknis diatur tetapi dikirim di bawah ketentuan khusus atau pengecualian jumlah.

Tag barang berbahaya disimpan sebagai atribut item katalog: pasangan key/value pada produk. Atribut diatur melalui API (catalogItemsCreate atau catalogItemsUpdate)—tidak ada bidang Dashboard atau kolom CSV untuk itu.

Hanya DHL

Penandaan barang berbahaya hanya berlaku untuk pengiriman DHL. Tag ini diabaikan untuk pembawa lain.

Kunci atribut yang didukung

DANGEROUS_GOODS adalah kunci atribut yang didukung untuk penandaan barang berbahaya DHL. Saat ini belum tercantum di antara kunci yang disetujui dalam referensi ItemAttributeInput, tetapi diterima oleh API.

Untuk menandai produk, tambahkan atribut dengan kunci DANGEROUS_GOODS dan nilai salah satu kategori yang didukung di bawah ini.

1mutation CatalogItemsCreate(

2$sku: String!

3$name: String

4$attributes: [ItemAttributeInput!]

5) {

6 catalogItemsCreate(

7 input: [{ sku: $sku, name: $name, attributes: $attributes }]

8 ) {

9 id

10 name

11 sku

12 attributes

13 key

14 value

Nilai barang berbahaya yang didukung

Nilai↕	Kategori↕
`NOT_RESTRICTED_A70`	Not Restricted, Special Provision A70—artikel bertekanan, seperti dudukan gas dan peredam kejut (UN3164).
`NOT_RESTRICTED_A67`	Not Restricted, Special Provision A67—mesin atau perkakas yang ditenagai oleh cairan mudah terbakar (UN3528).
`NOT_RESTRICTED_A02`	Not Restricted, Special Provision A02—dikecualikan berdasarkan ketentuan muatan kecil transportasi jalan ADR.
`LIMITED_QUANTITY`	Limited Quantity (ADR)—barang berbahaya yang dikemas dalam jumlah kecil sesuai batas peraturan.
`EXCEPTED_QUANTITY`	Excepted Quantity (IATA)—jumlah yang sangat kecil yang dikecualikan dari sebagian besar aturan barang berbahaya transportasi udara.
`CONSUMER_COMMODITY`	Consumer commodity ID8000—produk ritel siap pakai sehari-hari dengan kandungan berbahaya kecil, seperti aerosol dan parfum.
`MAGNETIZED_MATERIAL`	Magnetized material (UN2807)—barang dengan medan magnet yang cukup kuat untuk mempengaruhi instrumen pesawat.
`BIOLOGICAL_SUBSTANCE`	Biological substance (UN3373)—zat biologis Kategori B, seperti spesimen diagnostik atau klinis.

Terapkan tag secara otomatis pada label

Menandai produk adalah langkah pertama. Untuk membuat Zonos menerapkan kategori ke label DHL Anda secara otomatis, aktifkan Ship dangerous goods di pengaturan label. Anda juga dapat memilih kategori secara manual pada label individual—lihat deklarasikan barang berbahaya.

Edit produk

Mengedit produk memungkinkan Anda memperbarui produk yang ada dengan informasi tambahan atau yang diperbarui secara efisien. Alih-alih harus menghapus dan mengunggah ulang produk, Anda dapat mengunggah informasi yang diperbarui, dan Catalog akan mencocokkannya dengan produk yang ada menggunakan SKU atau ID produk Anda, tergantung pada preferensi item key Anda. Dengan cara ini, Anda dapat menjaga katalog Anda tetap terbaru dengan upaya minimal, baik Anda menggunakan Dashboard atau API untuk membuat produk baru atau mengedit produk yang ada.

Jika Anda membuat/mengedit produk katalog yang sudah ada di Catalog, harapkan berikut ini:

Catalog akan menimpa bidang kosong pada item yang ada.

Misalnya, jika produk yang ada, SKU 321, tidak memiliki nilai untuk berat, dan produk yang sama, SKU 321, memiliki berat 1,3 lbs dalam unggahan baru, berat 1,3 lbs akan menimpa bidang yang sebelumnya kosong.

Catalog akan menimpa bidang yang ada dengan nilai bidang baru.

Misalnya, jika produk yang ada, SKU 123, memiliki harga 18,99 USD dan produk yang sama, SKU 123, memiliki harga yang diperbarui 22,99 USD, harga baru 22,99 USD akan menimpa harga sebelumnya.

Catalog tidak akan menimpa nilai yang ada dengan bidang kosong.

Misalnya, jika produk yang ada, SKU 456, memiliki kode HS 6109.10, tetapi kode HS produk yang diperbarui, SKU 456, kosong, kode HS yang ada tetap berlaku.

Untuk mengedit produk:

Klik tab Products.
Pilih produk yang ingin Anda edit.
Buat perubahan Anda.
Klik save product.

Untuk mengedit beberapa atau semua produk sekaligus, cukup unggah file CSV yang diperbarui ke Catalog, termasuk SKU atau ID produk Anda. Ini akan memicu pembaruan otomatis untuk item yang ada.

Hapus produk

Untuk menghapus produk:

Klik tab Products di Dashboard.
Pilih produk yang ingin Anda hapus. Setelah produk Anda dipilih, tombol hapus akan muncul.
Klik Delete dan kemudian Delete all untuk mengkonfirmasi penghapusan Anda.

Untuk menghapus semua produk:

Pilih tab Products di Dashboard.
Klik Manage Catalog di sudut kanan atas dan kemudian Delete all.
Klik Delete all sekali lagi untuk mengkonfirmasi penghapusan Anda.

Perhatikan bahwa jika Anda menghapus jumlah item yang besar (lebih dari 20.000 produk atau lebih), notifikasi akan muncul yang menunjukkan bahwa penghapusan Anda sedang berlangsung. Selama waktu ini, Anda tidak akan dapat berinteraksi dengan Catalog sampai penghapusan selesai. Namun, Anda dapat menutup notifikasi dan berpindah ke halaman lain tanpa mengganggu proses penghapusan.

Batasi produk

Jika Anda ingin mencegah pengiriman ke negara tertentu (atau negara-negara), Anda dapat menambahkan pembatasan saat membuat atau memperbarui produk.

Aplikasi Zonos Duty & Tax tidak mendukung pembatasan tingkat item yang menghapus produk tertentu dari pesanan internasional. Jika item yang dibatasi ada di keranjang, seluruh keranjang harus diblokir dari pengiriman ke negara tersebut. Ini ditangani melalui aturan pembatasan tingkat keranjang, yang harus dikonfigurasi terlebih dahulu selama onboarding. Meskipun Catalog kompatibel dengan aplikasi Duty & Tax, pembatasan tingkat item hanya didukung saat menggunakan Zonos Checkout.

Untuk membatasi satu produk di Catalog:

Klik tab Products.
Pilih produk yang ingin Anda tambahkan pembatasan, yang akan membuka halaman edit.
Temukan bagian Restricted countries di bagian bawah halaman edit.
Tambahkan negara yang ingin Anda batasi produk Anda dengan memilih atau mengetik nama negara.
Klik save product.

Untuk membatasi beberapa produk di Catalog:

Klik tab Import/export.
Unduh Catalog template CSV.
Isi template dengan detail produk Anda, termasuk SKU/Product ID dan negara yang dibatasi. Masukkan kode ISO 2 digit yang dipisahkan dengan batang vertikal, misalnya AU|KR|MY|SG. Untuk membatasi semua negara, cukup masukkan ALL sebagai nilainya. Jika Anda ingin membatasi semua negara kecuali satu atau beberapa, masukkan ALL- diikuti oleh negara yang ingin Anda batalkan pembatasannya, dipisahkan dengan batang vertikal, misalnya ALL-CA|FR|US. Pelajari lebih lanjut tentang pemformatan CSV. Jika Anda ingin menghapus semua negara yang dibatasi yang ada, masukkan NONE sebagai nilainya.
Simpan file Anda sebagai CSV dan unggah ke Catalog dengan menyeret dan menjatuhkan atau memilih file Anda dengan mengklik browse di halaman yang sama tempat Anda mengunduh CSV.
Tinjau produk yang diunggah di layar pratinjau dan klik upload.

Memfilter produk yang dibatasi:

Anda dapat memfilter produk yang dibatasi langsung di katalog dengan mengunduh seluruh katalog Anda dalam format CSV dari Dashboard dan membukanya di Excel atau Google Sheets. Dari sana, Anda dapat menggunakan fitur pemfilteran untuk melihat hanya produk yang dibatasi. Ini memungkinkan Anda menemukan dan mengelola produk yang dibatasi di katalog dengan mudah.

Jika Anda perlu memperbarui katalog Anda setelah membuat perubahan pada CSV Anda, unggah ulang file dan produk yang cocok akan diganti dengan versi yang diperbarui. Ini dilakukan dengan mengidentifikasi dan mencocokkan SKU dan/atau ID produk.

Jika Anda menggunakan Checkout, pesan pembatasan akan ditampilkan di checkout Anda saat produk dibatasi ke negara pelanggan. Secara default, pesan tersebut akan berbunyi: "This item is restricted from import to your country."

Filter produk

Anda dapat mencari produk di Catalog melalui Dashboard atau melalui API menggunakan SKU, ID produk, atau nama produk. Untuk pencarian SKU dan ID produk, hanya kecocokan yang tepat yang akan menampilkan hasil; kecocokan sebagian tidak didukung. Saat mencari berdasarkan nama produk, bagaimanapun, kecocokan sebagian didukung.

Untuk memfilter berdasarkan SKU atau ID produk:

Klik tab Products di Dashboard.
Pilih SKU atau Product ID di kiri atas Catalog Anda.
Masukkan SKU, ID produk, atau nama produk Anda.
Klik Apply untuk melihat produk yang disaring.

Untuk mencari nama produk:

Klik tab Products di Dashboard.
Di kanan atas Catalog Anda, ketikkan nama produk ke dalam bidang pencarian.
Lihat produk yang disaring Anda.

Ekspor produk Anda

Jika Anda memilih 50 item atau lebih sedikit dari tabel Catalog, katalog Anda akan diunduh langsung dari Dashboard. Namun, jika Anda memilih Export all atau lebih dari 50 item, CSV Anda akan diekspor melalui email.

Untuk mengekspor 50 item atau lebih sedikit, ikuti langkah-langkah berikut:

Pilih 50 item atau lebih sedikit langsung dari tabel Catalog.
Klik Export di sudut kanan atas.
Temukan file CSV Anda di kotak masuk email Anda.

Untuk mengekspor semua produk:

Pergi ke Dashboard -> Products -> Catalog.
Klik dropdown Manage Catalog di sebelah Add product dan klik Export all.
Temukan file katalog Anda di unduhan Anda.

Mengalami masalah mengunduh dari email Anda?

Jika Anda mengalami masalah mengunduh CSV dari tautan email, ini mungkin karena browser Anda memblokir unduhan. Jika demikian, ikuti langkah-langkah berikut:

Klik kanan pada tombol "Download" di email Anda.
Pilih "Copy link address" untuk menyalin URL unduhan.
Tempel URL yang disalin ke dalam browser Anda dan tekan enter.
Katalog Anda kemudian akan diunduh langsung dari browser Anda.

Klasifikasikan produk

Anda dapat mengklasifikasikan produk dari katalog Anda dengan API menggunakan catalogItemId dalam mutasi ClassificationsCreateFromCatalog.

Perhatikan bahwa name diperlukan untuk mengklasifikasikan produk dari katalog Anda. Konsultasikan referensi API GraphQL untuk daftar lengkap bidang katalog dan klasifikasi.

Untuk membuat dan mengklasifikasikan produk katalog secara bersamaan, tambahkan mutasi ClassificationsCreateFromCatalog di bawah ini ke mutasi CatalogItemsCreate Anda.

Klasifikasikan produk katalog ke 8+ digit (khusus negara)

Ketika bidang shipToCountries diisi, klasifikasi akan menjadi kode HS 8+ digit (khusus negara). Jika tidak ada shipToCountries yang diberikan, klasifikasi akan default ke kode HS 6 digit (universal). Pelajari lebih lanjut tentang perbedaan antara kode HS universal dan khusus negara.

Dalam contoh di bawah, bidang shipToCountries diberikan untuk menghasilkan kode khusus negara untuk Kanada.

1mutation ClassificationsCreateFromCatalog(

2$catalogItemToClassify: [ClassificationFromCatalogInput!]!

3) {

4 classificationsCalculateFromCatalog(input: $catalogItemToClassify) {

5 id

6 configuration {

7 shipToCountries

8 }

9 hsCode {

10 code

11 }

12 name

13 }

14}

Berikut adalah contoh permintaan. Meskipun Zonos Classify akan membuat klasifikasi dengan hanya name, kami sangat merekomendasikan menambahkan sebanyak mungkin detail untuk hasil klasifikasi terbaik.

1{

2 "catalogItemToClassify": [

3 {

4 "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",

5 "configuration": {

6 "shipToCountries": [

7 "CA"

8 ]

9 }

10 }

11 ]

12}

Kesalahan API dan resolusi

Error↕	Resolusi↕
*A SKU or product ID is required to create a product*	Pengenal (SKU/ID produk) diperlukan untuk membuat, mengedit, atau menghapus item katalog. Untuk mengatasi ini, tambahkan SKU dan/atau ID produk.
*The product you are trying to edit does not exist**	Anda tidak dapat mengedit produk yang tidak ada. Untuk mengatasi ini, buat produk baru dengan SKU dan/atau ID produk yang Anda inginkan.
*Customs description exceeds character limit of 30 characters.*	Secara default, deskripsi bea cukai dibatasi hingga 30 karakter, yang selaras dengan batas karakter paling umum untuk invoice komersial.
*Product type invalid. Catalog supports the following product types: digital_good. For physical goods, leave it blank.*	Catalog hanya mendukung jenis produk berikut: `digital_good` dan `physical_good`. Jika produk Anda adalah barang fisik (paling umum), biarkan bidang ini kosong.
*Packing preference invalid. Catalog supports the following packing preferences: ships_alone and consolidated. If your product can be consolidated with other products, leave blank.*	Preferensi pengemasan tidak valid. Catalog mendukung preferensi pengemasan berikut: `ships_alone` dan `consolidated`. Jika produk Anda dapat digabungkan dengan produk lain, Anda dapat membiarkannya kosong karena `consolidated` adalah default.
*Country must be specified when providing an HS code*	Jika Anda memberikan kode HS khusus negara saat membuat item, negara tujuan pengiriman diperlukan. Untuk mengatasi ini, tambahkan negara tujuan pengiriman.
*Price must be greater than 0*	Catalog tidak mendukung nilai harga negatif. Untuk mengatasi ini, tambahkan harga yang lebih besar dari nol.
*Currency code must be provided when a price value is supplied*	Jika Anda memberikan harga, kode mata uang diperlukan. Untuk mengatasi ini, tambahkan kode mata uang.
*Price must be provided when a currency code is supplied*	Jika Anda memberikan kode mata uang, harga diperlukan. Untuk mengatasi ini, tambahkan harga.
*The accompanying dimensional field cannot be left blank*	Jika satu bidang dimensi diberikan, dua bidang lainnya diperlukan, misalnya, jika Anda memberikan lebar 8 inci, maka tinggi dan panjang akan diperlukan.
*Measurement value must be greater than 0*	Catalog tidak mendukung nilai pengukuran negatif atau nol. Untuk mengatasi ini, tambahkan nilai yang lebih besar dari nol.
*When providing a dimensional value, dimensional units cannot be left empty*	Jika Anda memberikan nilai dimensi, unit dimensi diperlukan. Untuk mengatasi ini, tambahkan unit dimensi.
*When providing a weight value, the weight unit cannot be left empty*	Jika Anda memberikan nilai berat, unit berat diperlukan. Untuk mengatasi ini, tambahkan unit berat.

* Hanya kesalahan API

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

INPUTS

ItemAttributeInput

Pesan demo