DOCS

Manage products

/

Kelola Katalog

Buat dan modifikasi produk.

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

Buat produk

Dashboard
API

Buat produk di Katalog:

  1. Pergi ke Katalog dan klik pada Tambah produk di sudut kanan atas.
  2. Tambahkan detail produk Anda. Satu-satunya kolom yang diperlukan untuk membuat produk adalah kolom SKU dan/atau ID produk. Kolom ini akan digunakan untuk merujuk produk katalog Anda. Pelajari lebih lanjut tentang pengenal Katalog.
  3. Opsional—Tambahkan kode HS Anda.
  4. Opsional—Tambahkan informasi pengiriman Anda (berat, dimensi, satuan ukuran, dll.).
  5. Opsional—Tambahkan negara yang dibatasi.
  6. Klik simpan produk.

Buat beberapa produk di Katalog:

Unggah beberapa produk atau seluruh katalog produk Anda sekaligus.

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

Edit produk

Mengedit produk memungkinkan Anda untuk 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 Katalog akan mencocokkannya dengan produk yang ada menggunakan SKU atau ID produk Anda, tergantung pada preferensi kunci item Anda. Dengan cara ini, Anda dapat menjaga katalog Anda tetap terbaru dengan usaha 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 Katalog, harapkan hal berikut:

Katalog 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 lb akan menimpa bidang yang sebelumnya kosong.

Katalog 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 menjadi 22.99 USD, harga baru 22.99 USD akan menimpa harga sebelumnya.

Katalog 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.
Dashboard
API

Untuk mengedit produk:

  1. Klik pada tab Produk.
  2. Pilih produk yang ingin Anda edit.
  3. Lakukan perubahan Anda.
  4. Klik simpan produk.

Untuk mengedit beberapa atau semua produk sekaligus, cukup unggah file CSV yang diperbarui ke Katalog, termasuk kombinasi SKU/ID Produk Anda. Ini akan memicu pembaruan otomatis pada item yang ada.

Hapus produk

Dashboard
API

Untuk menghapus produk:

  1. Klik tab Produk di Dashboard.
  2. Pilih produk yang ingin Anda hapus. Setelah produk Anda dipilih, tombol hapus akan muncul.
  3. Klik Hapus dan kemudian Hapus semua untuk mengonfirmasi penghapusan Anda.

Untuk menghapus semua produk:

  1. Pilih tab Produk di Dashboard.
  2. Klik Kelola Katalog di sudut kanan atas dan kemudian Hapus semua.
  3. Klik Hapus semua sekali lagi untuk mengonfirmasi penghapusan Anda.

Perhatikan bahwa jika Anda menghapus sejumlah besar item (lebih dari 20.000 produk atau lebih), notifikasi akan muncul yang menunjukkan bahwa penghapusan Anda sedang diproses. Selama waktu ini, Anda tidak akan dapat berinteraksi dengan Katalog sampai penghapusan selesai. Namun, Anda dapat menutup notifikasi dan menavigasi pergi tanpa mengganggu proses penghapusan.

Restrict produk

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

Dasbor
API

Untuk restrict satu produk di Katalog:

  1. Klik pada tab Produk.
  2. Pilih produk yang ingin Anda tambahkan pembatasan, yang akan membuka halaman edit.
  3. Temukan bagian Negara yang dibatasi di bagian bawah halaman edit.
  4. Tambahkan negara yang ingin Anda restrict produk Anda dengan memilih atau mengetik nama negara.
  5. Klik simpan produk.

Untuk restrict beberapa produk di Katalog:

  1. Klik pada tab Impor/ekspor.
  2. Unduh Template CSV Katalog.
  3. Isi template dengan detail produk Anda, termasuk SKU/ID Produk dan negara yang dibatasi. Masukkan kode ISO 2-digit yang dipisahkan dengan tanda vertikal (misalnya, AU|KR|MY|SG). Untuk restrict semua negara, cukup masukkan ALL sebagai nilai. Jika Anda ingin restrict semua negara kecuali satu atau beberapa, masukkan ALL- diikuti dengan negara yang ingin Anda buka batasan, dipisahkan dengan tanda vertikal (misalnya, ALL-CA|FR|US). Pelajari lebih lanjut tentang format CSV. Jika Anda ingin menghapus semua negara yang dibatasi yang ada, masukkan NONE sebagai nilai.
  4. Simpan file Anda sebagai CSV dan unggah ke Katalog dengan menyeret dan menjatuhkan atau memilih file Anda dengan mengklik telusuri di halaman yang sama tempat Anda mengunduh CSV.
  5. Tinjau produk yang diunggah di screen pratinjau dan klik unggah.

Menyaring produk yang dibatasi:

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

Jika Anda perlu memperbarui katalog Anda setelah melakukan perubahan pada CSV Anda, unggah kembali file tersebut 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 terbatas akan ditampilkan di checkout Anda ketika suatu produk dibatasi untuk negara pelanggan. Secara default, pesan tersebut akan mengatakan "Barang ini dibatasi untuk diimpor ke negara Anda," tetapi Anda dapat menyesuaikan pesan terbatas Anda sendiri dengan menyediakannya di bidang restrictedCountriesMessage saat menambahkan pembatasan negara Anda.

Memfilter produk

Anda dapat mencari produk di Katalog melalui Dasbor atau melalui API menggunakan SKU atau ID produk. Perhatikan bahwa hanya kecocokan yang tepat yang akan mengembalikan hasil; kecocokan sebagian tidak akan dikenali.

Dasbor
API

Untuk memfilter berdasarkan SKU atau ID produk:

  1. Klik pada tab Produk.
  2. Pilih SKU atau ID Produk di sudut kiri atas Katalog Anda.
  3. Masukkan SKU atau ID produk Anda.
  4. Klik Terapkan untuk melihat produk yang telah difilter.

Ekspor produk Anda

Jika Anda memilih 50 item atau kurang dari tabel Katalog, katalog Anda akan diunduh langsung dari Dashboard. Namun, jika Anda memilih Ekspor semua atau lebih dari 50 item, CSV Anda akan diekspor melalui email.

Untuk mengekspor 50 item atau kurang, ikuti langkah-langkah berikut:

  1. Pilih 50 item atau kurang langsung dari tabel Katalog.
  2. Klik Ekspor di sudut kanan atas.
  3. Temukan file CSV Anda di kotak masuk email Anda.

Untuk mengekspor semua produk:

Dashboard
API
  1. Pergi ke Dashboard -> Produk -> Katalog.
  2. Klik dropdown Kelola Katalog di samping Tambahkan produk dan klik Ekspor semua.
  3. Temukan file katalog Anda di unduhan Anda.

Masalah mengunduh dari email Anda?

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

  1. Klik kanan pada tombol "Unduh" di email Anda.
  2. Pilih "Salin alamat tautan" untuk menyalin URL unduhan.
  3. Tempelkan URL yang disalin ke browser Anda dan tekan enter.
  4. Katalog Anda kemudian akan diunduh langsung dari browser Anda.

Classify produk

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

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

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

Classify produk katalog ke kode HS 8+ digit (spesifik negara)

Ketika bidang shipToCountries diisi, klasifikasi akan menjadi kode HS 8+ digit (spesifik 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 spesifik negara.

Dalam contoh di bawah ini, bidang shipToCountries disediakan untuk menghasilkan kode spesifik negara untuk Kanada.

Mutasi

1
2
3
4
5
6
7
8
9
10
11
12
13
14
mutation ClassificationsCreateFromCatalog(
  $catalogItemToClassify: [ClassificationFromCatalogInput!]!
) {
  classificationsCalculateFromCatalog(input: $catalogItemToClassify) {
    id
    configuration {
      shipToCountries
    }
    hsCode {
      code
    }
    name
  }
}

Berikut adalah contoh permintaan. Sementara Zonos Classify akan menghasilkan klasifikasi hanya dengan name, kami sangat menyarankan untuk menambahkan sebanyak mungkin detail untuk hasil klasifikasi terbaik.

Variabel

1
2
3
4
5
6
7
8
9
10
{
  "catalogItemToClassify": [
    {
      "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",
      "configuration": {
        "shipToCountries": ["CA"]
      }
    }
  ]
}

Respon

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "data": {
    "classificationsCreateFromCatalog": [
      {
        "id": "classification_8C49fk2945jmm232CcQtHtXdu",
        "configuration": {
          "shipToCountries": ["CA"]
        },
        "countryOfOrigin": "US",
        "hsCode": {
          "code": "6116.10.0020"
        },
        "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
      }
    ]
  }
}

Kesalahan API dan resolusi

KesalahanResolusi
SKU atau ID produk diperlukan untuk membuat produkSebuah pengidentifikasi (SKU/ID produk) diperlukan untuk membuat, mengedit, atau menghapus item katalog. Untuk mengatasi ini, tambahkan SKU dan/atau ID produk.
Produk yang Anda coba edit tidak ada*Anda tidak dapat mengedit produk yang tidak ada. Untuk mengatasi ini, buat produk baru dengan SKU dan/atau ID produk yang diinginkan.
Deskripsi bea cukai melebihi batas karakter 30 karakter.Secara default, deskripsi bea cukai dibatasi hingga 30 karakter, yang sesuai dengan batas karakter yang paling umum untuk faktur komersial.
Tipe produk tidak valid. Katalog mendukung tipe produk berikut: digital_good. Untuk barang fisik, biarkan kosong.Katalog hanya mendukung tipe produk berikut: digital_good dan physical_good. Jika produk Anda adalah barang fisik (yang paling umum), biarkan kolom ini kosong.
Preferensi kemasan tidak valid. Katalog mendukung preferensi kemasan berikut: ships_alone dan consolidated. Jika produk Anda dapat digabungkan dengan produk lain, biarkan kosong.Preferensi kemasan tidak valid. Katalog mendukung preferensi kemasan berikut: ships_alone dan consolidated. Jika produk Anda dapat digabungkan dengan produk lain, Anda dapat membiarkannya kosong karena consolidated adalah default.
Negara harus ditentukan saat memberikan kode HSJika Anda memberikan kode HS spesifik negara saat membuat item, negara tujuan pengiriman diperlukan. Untuk mengatasi ini, tambahkan negara tujuan pengiriman.
Harga harus lebih besar dari 0Katalog tidak mendukung nilai harga negatif. Untuk mengatasi ini, tambahkan harga yang lebih besar dari nol.
Kode mata uang harus disediakan saat nilai harga disuplaiJika Anda menyuplai harga, kode mata uang diperlukan. Untuk mengatasi ini, tambahkan kode mata uang.
Harga harus disediakan saat kode mata uang disuplaiJika Anda menyuplai kode mata uang, harga diperlukan. Untuk mengatasi ini, tambahkan harga.
Bidang dimensi yang menyertai tidak dapat dibiarkan kosongJika satu bidang dimensi disuplai, dua bidang lainnya diperlukan. Misalnya, jika Anda menyuplai lebar “8 inci,” maka tinggi dan panjang akan diperlukan.
Nilai pengukuran harus lebih besar dari 0Katalog tidak mendukung nilai pengukuran negatif atau nol. Untuk mengatasi ini, tambahkan nilai yang lebih besar dari nol.
Saat memberikan nilai dimensi, unit dimensi tidak dapat dibiarkan kosongJika Anda menyuplai nilai dimensi, unit dimensi diperlukan. Untuk mengatasi ini, tambahkan unit dimensi.
Saat memberikan nilai berat, unit berat tidak dapat dibiarkan kosongJika Anda menyuplai nilai berat, unit berat diperlukan. Untuk mengatasi ini, tambahkan unit berat.

* Kesalahan API saja

Apakah halaman ini membantu?