DOCS

Manage products

/

Katalogu Yönet

Ürün oluşturun ve değiştirin.

Dashboard veya API aracılığıyla Zonos Katalog ürünlerinizi nasıl ekleyeceğinizi, değiştireceğinizi ve sileceğinizi öğrenin. Küçük değişiklikler yapıyorsanız kod yazmaktan kaçınmak için Dashboard'da Katalogu kullanın. Üretim uygulamaları için Katalog ile doğrudan entegre olmak istiyorsanız, API'yi kullanın.

Bir ürün oluştur

Dashboard
API

Katalogda bir ürün oluşturun:

  1. Katalog sayfasına gidin ve sağ üst köşedeki Ürün ekle butonuna tıklayın.
  2. Ürün bilgilerinizi ekleyin. Bir ürün oluşturmak için gereken tek alan SKU ve/veya ürün kimliği alanıdır. Bu alanlar, katalog ürünlerinizi referans almak için kullanılacaktır. Katalog’un tanımlayıcıları hakkında daha fazla bilgi edinin.
  3. Opsiyonel—HS kodlarınızı ekleyin.
  4. Opsiyonel—Gönderim bilgilerinizi (ağırlık, boyutlar, ölçü birimleri vb.) ekleyin.
  5. Opsiyonel—Kısıtlı ülkeleri ekleyin.
  6. Ürünü kaydet butonuna tıklayın.

Katalogda birden fazla ürün oluşturun:

Birden fazla ürünü veya tüm ürün kataloğunuzu aynı anda yükleyin.

Önemli: Zaten mevcut olan bir ürün oluşturmaya çalışırsanız, Katalog, ürünü SKU ve/veya ürün kimliği temelinde tanıyacak ve orijinal ürünün detaylarını yeni detaylarla geçersiz kılacaktır.

Bir ürünü düzenle

Ürünleri düzenlemek, mevcut ürünlerinizi ek veya güncellenmiş bilgilerle verimli bir şekilde güncellemenizi sağlar. Ürünü silip yeniden yüklemek yerine, güncellenmiş bilgileri yükleyebilir ve Katalog, ürün anahtar tercihlerinize bağlı olarak SKU veya ürün kimliğinizi kullanarak bunu mevcut ürünle eşleştirecektir. Bu şekilde, Dashboard veya API kullanarak yeni ürünler oluşturup mevcut ürünleri düzenleseniz de, kataloğunuzu güncel tutmak için minimum çaba harcayabilirsiniz.

Eğer Katalog'da zaten mevcut olan bir katalog ürünü oluşturur/düzenlerseniz, aşağıdakileri bekleyin:

Katalog, mevcut öğelerde boş alanları geçersiz kılacaktır.

  • Örneğin, mevcut bir ürün, SKU 321, ağırlık için bir değere sahip değilse ve aynı ürün, SKU 321, yeni yüklemede 1.3 lbs ağırlığa sahipse, 1.3 lb ağırlık daha önce boş olan alanı geçersiz kılacaktır.

Katalog, mevcut alanları yeni alan değerleriyle geçersiz kılacaktır.

  • Örneğin, mevcut bir ürün, SKU 123, 18.99 USD fiyatına sahipse ve aynı ürün, SKU 123, güncellenmiş fiyatı 22.99 USD ise, yeni fiyat olan 22.99 USD önceki fiyatı geçersiz kılacaktır.

Katalog, mevcut değerleri boş alanlarla geçersiz kılmayacaktır.

  • Örneğin, mevcut bir ürün, SKU 456, 6109.10 HS koduna sahipse, ancak güncellenmiş ürün, SKU 456, HS kodu boşsa, mevcut HS kodu kalacaktır.
Dashboard
API

Bir ürünü düzenlemek için:

  1. Ürünler sekmesine tıklayın.
  2. Düzenlemek istediğiniz ürünü seçin.
  3. Değişikliklerinizi yapın.
  4. Ürünü kaydet butonuna tıklayın.

Birden fazla veya tüm ürünleri aynı anda düzenlemek için, SKU/Ürün Kimliği kombinasyonlarınızı içeren güncellenmiş bir CSV dosyasını Katalog'a yükleyin. Bu, mevcut öğelerinizde otomatik güncellemeleri tetikleyecektir.

Bir ürünü sil

Dashboard
API

Bir ürünü silmek için:

  1. Dashboard'da Ürünler sekmesine tıklayın.
  2. Silmek istediğiniz ürün(ler)i seçin. Ürün(ler)iniz seçildiğinde, bir silme butonu görünecektir.
  3. Sil butonuna tıklayın ve ardından silme işleminizi onaylamak için Tümünü Sil seçeneğine tıklayın.

Tüm ürünleri silmek için:

  1. Dashboard'da Ürünler sekmesini seçin.
  2. Sağ üst köşede Kataloğu Yönet seçeneğine tıklayın ve ardından Tümünü Sil seçeneğine tıklayın.
  3. Silme işleminizi onaylamak için bir kez daha Tümünü Sil seçeneğine tıklayın.

Eğer büyük bir miktarda ürün (20,000'den fazla ürün gibi) siliyorsanız, silme işleminizin devam ettiğini belirten bir bildirim görünecektir. Bu süre zarfında, silme işlemi tamamlanana kadar Katalog ile etkileşimde bulunamayacaksınız. Ancak, bildirimi kapatabilir ve silme işlemini kesintiye uğratmadan başka bir sayfaya geçebilirsiniz.

Restrict bir ürünü

Belirli bir ülkeye (veya ülkelere) gönderimleri engellemek istiyorsanız, bir ürünü oluştururken veya güncellerken kısıtlamalar ekleyebilirsiniz.

Gösterge Paneli
API

Katalogda tek bir ürünü restrict için:

  1. Ürünler sekmesine tıklayın.
  2. Kısıtlama eklemek istediğiniz ürünü seçin, bu düzenleme sayfasını açacaktır.
  3. Düzenleme sayfasının en altındaki Kısıtlı ülkeler bölümünü bulun.
  4. Ürününüzü restrict istediğiniz ülkeleri seçerek veya ülke adını yazarak ekleyin.
  5. Ürünü kaydet butonuna tıklayın.

Katalogda birden fazla ürünü restrict için:

  1. İçe/Dışa Aktar sekmesine tıklayın.
  2. Katalog şablon CSV dosyasını indirin.
  3. Ürün detaylarınızı, SKU/Ürün ID'niz ve kısıtlı ülkeler dahil olmak üzere şablonu doldurun. 2 haneli ISO kodunu dikey çubuklarla ayırarak girin (örneğin, AU|KR|MY|SG). Tüm ülkeleri restrict için, değeri ALL olarak girin. Bir veya birkaç ülke hariç tüm ülkeleri restrict istiyorsanız, ALL- yazdıktan sonra kısıtlamayı kaldırmak istediğiniz ülkeleri dikey çubuklarla ayırarak girin (örneğin, ALL-CA|FR|US). CSV formatlama hakkında daha fazla bilgi edinin. Mevcut tüm kısıtlı ülkeleri kaldırmak istiyorsanız, değeri NONE olarak girin.
  4. Dosyanızı CSV olarak kaydedin ve CSV'yi indirdiğiniz sayfada gözat butonuna tıklayarak dosyanızı sürükleyip bırakarak veya seçerek Kataloğa yükleyin.
  5. Yüklediğiniz ürünleri önizleme screen üzerinde gözden geçirin ve yükle butonuna tıklayın.

Kısıtlı ürünleri filtreleme:

Katalogda kısıtlı ürünleri doğrudan filtreleyebilirsiniz; Dashboard'dan tüm kataloğunuzu CSV formatında indirip Excel veya Google Sheets'te açarak. Buradan, yalnızca kısıtlı ürünleri görüntülemek için filtreleme özelliğini kullanabilirsiniz. Bu, katalogunuzdaki kısıtlı ürünleri kolayca bulup yönetmenizi sağlar.

CSV'nizde değişiklik yaptıktan sonra kataloğunuzu güncellemeniz gerekiyorsa, dosyayı yeniden yükleyin ve eşleşen ürünler güncellenmiş sürümle değiştirilecektir. Bu, SKU ve/veya ürün ID'sini tanımlayarak ve eşleştirerek yapılır.

Eğer Checkout kullanıyorsanız, bir ürün müşterinin ülkesine kısıtlı olduğunda checkout'ınızda kısıtlı bir mesaj görüntülenecektir. Varsayılan olarak, mesaj "Bu ürün ülkenize ithalatı kısıtlanmıştır" şeklinde olacaktır, ancak ülke kısıtlamalarınızı eklerken restrictedCountriesMessage alanında kendi kısıtlı mesajınızı sağlayarak bunu özelleştirebilirsiniz.

Bir ürünü filtrele

Dashboard üzerinden veya API aracılığıyla SKU veya ürün ID'si kullanarak Katalogda ürün arayabilirsiniz. Sadece tam eşleşmeler sonuç döndürecektir; kısmi eşleşmeler tanınmayacaktır.

Dashboard
API

SKU veya ürün ID'sine göre filtrelemek için:

  1. Ürünler sekmesine tıklayın.
  2. Katalogunuzun sol üst köşesinde SKU veya Ürün ID'si'ni seçin.
  3. SKU veya ürün ID'nizi girin.
  4. Filtrelenmiş ürün(ler)inizi görüntülemek için Uygula'ya tıklayın.

Ürünlerinizi Dışa Aktarın

Katalog tablosundan 50 veya daha az öğe seçerseniz, kataloğunuz doğrudan Dashboard'dan indirilecektir. Ancak, Tümünü Dışa Aktar veya 50'den fazla öğe seçerseniz, CSV'niz e-posta ile dışa aktarılacaktır.

50 öğe veya daha azını dışa aktarmak için bu adımları izleyin:

  1. Katalog tablosundan 50 veya daha az öğe seçin.
  2. Sağ üst köşedeki Dışa Aktar butonuna tıklayın.
  3. E-posta gelen kutunuzda CSV dosyanızı bulun.

Tüm ürünleri dışa aktarmak için:

Dashboard
API
  1. Dashboard -> Ürünler -> Katalog sayfasına gidin.
  2. Ürün Ekle'nin yanındaki Katalogu Yönet açılır menüsüne tıklayın ve Tümünü Dışa Aktar seçeneğine tıklayın.
  3. İndirilenler klasörünüzde katalog dosyanızı bulun.

E-postanızdan indirme sorunları mı yaşıyorsunuz?

E-posta bağlantısından CSV indirmekte sorun yaşıyorsanız, bu tarayıcınızın indirimi engellemesinden kaynaklanıyor olabilir. Eğer öyleyse, şu adımları izleyin:

  1. E-postanızdaki "İndir" butonuna sağ tıklayın.
  2. İndirme URL'sini kopyalamak için "Bağlantı adresini kopyala" seçeneğini seçin.
  3. Kopyalanan URL'yi tarayıcınıza yapıştırın ve enter tuşuna basın.
  4. Kataloğunuz tarayıcınızdan doğrudan indirilecektir.

Classify bir ürünü

API kullanarak ClassificationsCreateFromCatalog mutasyonunda catalogItemId ile kataloğunuzdan bir ürünü classify edebilirsiniz.

Kataloğunuzdan bir ürünü classify etmek için bir name gereklidir. Tam bir katalog ve sınıflandırma alanları listesi için GraphQL API referansına başvurun.

Aynı anda bir katalog ürünü oluşturmak ve classify etmek için, aşağıdaki ClassificationsCreateFromCatalog mutasyonunu CatalogItemsCreate mutasyonunuza ekleyin.

Classify bir katalog ürününü 8+ haneli (ülkeye özel)

shipToCountries alanı doldurulduğunda, sınıflandırma 8+ haneli (ülkeye özel) HS kodu olacaktır. Eğer shipToCountries sağlanmazsa, sınıflandırma varsayılan olarak 6 haneli (evrensel) HS kodu olacaktır. Evrensel ve ülkeye özel HS kodları arasındaki farklar hakkında daha fazla bilgi edinin.

Aşağıdaki örnekte, Kanada için ülkeye özel bir kod oluşturmak amacıyla shipToCountries alanı sağlanmıştır.

Mutasyon

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
  }
}

İşte bir talep örneği. Zonos Classify yalnızca bir name ile bir sınıflandırma oluşturacak, ancak en iyi sınıflandırma sonuçları için mümkün olduğunca fazla ayrıntı eklemenizi şiddetle tavsiye ederiz.

Değişkenler

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

Yanıt

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"
      }
    ]
  }
}

API hataları ve çözümleri

HataÇözüm
Bir SKU veya ürün kimliği, bir ürün oluşturmak için gereklidirBir tanımlayıcı (SKU/ürün kimliği) bir katalog öğesi oluşturmak, düzenlemek veya silmek için gereklidir. Bunu çözmek için bir SKU ve/veya ürün kimliği ekleyin.
Düzenlemeye çalıştığınız ürün mevcut değil*Mevcut olmayan bir ürünü düzenleyemezsiniz. Bunu çözmek için istediğiniz SKU ve/veya ürün kimliği ile yeni bir ürün oluşturun.
Gümrük tanımı 30 karakter sınırını aşıyor.Varsayılan olarak, gümrük tanımları 30 karakterle sınırlıdır; bu, ticari faturalar için en yaygın karakter sınırıyla uyumludur.
Ürün türü geçersiz. Katalog aşağıdaki ürün türlerini destekler: digital_good. Fiziksel ürünler için boş bırakın.Katalog yalnızca aşağıdaki ürün türlerini destekler: digital_good ve physical_good. Ürününüz fiziksel bir ürünse (en yaygın olanı), bu alanı boş bırakın.
Paketleme tercihi geçersiz. Katalog aşağıdaki paketleme tercihlerini destekler: ships_alone ve consolidated. Ürününüz diğer ürünlerle birleştirilebiliyorsa, boş bırakın.Paketleme tercihi geçersiz. Katalog aşağıdaki paketleme tercihlerini destekler: ships_alone ve consolidated. Ürününüz diğer ürünlerle birleştirilebiliyorsa, bu alanı boş bırakabilirsiniz çünkü consolidated varsayılandır.
HS kodu sağlarken ülke belirtilmelidirBir öğe oluştururken ülkeye özgü HS kodu sağlarsanız, bir gönderim ülkesi gereklidir. Bunu çözmek için bir gönderim ülkesi ekleyin.
Fiyat 0'dan büyük olmalıdırKatalog negatif fiyat değerlerini desteklemez. Bunu çözmek için sıfırdan büyük bir fiyat ekleyin.
Bir fiyat değeri sağlandığında para birimi kodu sağlanmalıdırBir fiyat sağlarsanız, bir para birimi kodu gereklidir. Bunu çözmek için bir para birimi kodu ekleyin.
Bir para birimi kodu sağlandığında fiyat sağlanmalıdırBir para birimi kodu sağlarsanız, bir fiyat gereklidir. Bunu çözmek için bir fiyat ekleyin.
Eşlik eden boyutsal alan boş bırakılamazBir boyutsal alan sağlandığında, diğer iki alan gereklidir. Örneğin, "8 inç" genişlik sağlarsanız, yükseklik ve uzunluk gereklidir.
Ölçüm değeri 0'dan büyük olmalıdırKatalog negatif veya sıfır ölçüm değerlerini desteklemez. Bunu çözmek için sıfırdan büyük bir değer ekleyin.
Boyutsal bir değer sağlarken, boyutsal birim boş bırakılamazBir boyutsal değer sağlarsanız, bir boyutsal birim gereklidir. Bunu çözmek için bir boyutsal birim ekleyin.
Ağırlık değeri sağlarken, ağırlık birimi boş bırakılamazBir ağırlık değeri sağlarsanız, bir ağırlık birimi gereklidir. Bunu çözmek için bir ağırlık birimi ekleyin.

* API hatası yalnızca

Bu sayfa yardımcı oldu mu?