DOCS

Ürünleri yönetin

Catalog Yönetin

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

Zonos Catalog ürünlerinizi Dashboard'da veya API aracılığıyla nasıl ekleyeceğiniz, değiştireceğiniz ve sileceğinizi öğrenin. Kod yazmaktan kaçınmak veya küçük değişiklikler yapmak istiyorsanız Dashboard'da Catalog'u kullanın. Catalog ile üretim uygulamaları için doğrudan entegrasyonu istiyorsanız API'yi kullanın.

Catalog'ta ürün oluşturun:

  1. Catalog sayfasına gidin ve sağ üst köşede Ürün ekle düğmesine tıklayın.
  2. Ürün ayrıntılarınızı ekleyin. Ürün oluşturmak için gereken tek alan SKU ve/veya ürün ID alanıdır. Bu alanlar Catalog ürünlerinize başvurmak için kullanılır. Catalog'un tanımlayıcıları hakkında daha fazla bilgi edinin.
  3. İsteğe bağlı—HS kodunuzu ekleyin.
  4. İsteğe bağlı—Kargo bilgilerinizi ekleyin (ağırlık, boyutlar, ölçü birimleri vb.).
  5. İsteğe bağlı—Kısıtlı ülkeleri ekleyin.
  6. Ürünü kaydet seçeneğine tıklayın.

Catalog'ta birden fazla ürün oluşturun:

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

Önemli: Zaten var olan bir ürün oluşturmaya çalışırsanız, Catalog ürünü SKU ve/veya ürün ID temelinde tanıyacak ve orijinal ürünün ayrıntılarını yeni ayrıntılarla geçersiz kılacaktır.

DHL gönderileri için, bir ürünü tehlikeli mal olarak etiketleyebilirsiniz, böylece o ürün için her bir etiketi oluşturduğunuzda doğru DHL katma değer hizmeti otomatik olarak uygulanır. Bu, düşük riskli veya muaf sınıflandırılmış mal kategorilerini kapsar—teknik olarak düzenlenmiş ancak özel bir hüküm veya miktar istisnası kapsamında sevk edilen ürünler.

Tehlikeli mal etiketi bir katalog öğesi niteliği olarak depolanır: ürün üzerinde key/value çifti. Nitelikler API aracılığıyla (catalogItemsCreate veya catalogItemsUpdate) ayarlanır—Dashboard alanı veya CSV sütunu yoktur.

Yalnızca DHL

Tehlikeli mal etiketleme yalnızca DHL gönderilerini etkiler. Etiket diğer taşıyıcılar için yoksayılır.

Desteklenen nitelik anahtarı

DANGEROUS_GOODS DHL tehlikeli mal etiketlemesi için desteklenen bir nitelik anahtarıdır. Henüz ItemAttributeInput referansında onaylı anahtarlar arasında listelenmemiştir, ancak API tarafından kabul edilir.

Ürünü etiketlemek için DANGEROUS_GOODS anahtarına ve aşağıdaki desteklenen kategorilerden birine sahip bir nitelik ekleyin.

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

Desteklenen tehlikeli mal değerleri 

DeğerKategori
NOT_RESTRICTED_A70Kısıtlanmadı, Özel Hüküm A70—basınçlı makaleler, gaz strüsü ve şok emicileri gibi (UN3164).
NOT_RESTRICTED_A67Kısıtlanmadı, Özel Hüküm A67—yanıcı sıvı tarafından tahrikli motorlar veya makineler (UN3528).
NOT_RESTRICTED_A02Kısıtlanmadı, Özel Hüküm A02—ADR karayolu taşımacılığı küçük yük hükmü kapsamında muaftır.
LIMITED_QUANTITYSınırlı Miktar (ADR)—yasal sınırlar içinde küçük miktarlarda paketlenmiş tehlikeli maddeler.
EXCEPTED_QUANTITYMuaf Miktar (IATA)—çoğu hava taşımacılığı tehlikeli maddeler kurallarından muaf çok küçük miktarlar.
CONSUMER_COMMODITYTüketici mallı ID8000—aerosol ve parfüm gibi küçük tehlikeli içeriğe sahip perakenda hazır gündelik ürünler.
MAGNETIZED_MATERIALManyetikleştirilmiş malzeme (UN2807)—uçak enstrümanlarını etkileyecek kadar güçlü bir manyetik alana sahip öğeler.
BIOLOGICAL_SUBSTANCEBiyolojik madde (UN3373)—tanı veya klinik numuneler gibi Kategori B biyolojik maddeler.
Etiketleri otomatik olarak etiketlere uygula

Ürünü etiketlemek ilk adımdır. Zonos'un kategoriyi DHL etiketlerinize otomatik olarak uygulaması için, etiket ayarlarında Tehlikeli maddeler sevk et seçeneğini açın. Ayrıca tek bir etiket üzerinde manuel olarak bir kategori seçebilirsiniz—bkz. tehlikeli maddeler bildirin.

Ürünleri düzenlemek, mevcut ürünlerinizi ek veya güncellenmiş bilgilerle verimli bir şekilde güncellemenizi sağlar. Ürünü silip yeniden yüklemeniz yerine, güncellenmiş bilgiyi yükleyebilirsiniz ve Catalog onu SKU veya ürün ID'nizi kullanarak mevcut ürünle eşleştirecektir. Bu şekilde, ister Dashboard ister API kullanın, yeni ürünler oluştururken veya mevcut ürünleri düzenlerken kataloğunuzu minimum çabayla güncel tutabilirsiniz.

Zaten Catalog'ta var olan bir ürünü oluşturur/düzenlerseniz, şunları bekleyin:

Catalog mevcut öğeler üzerinde boş alanları yazacaktı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 lbs ağırlığı önceden boş alan yerine yazacaktır.

Catalog 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, 22,99 USD güncellenmiş fiyatına sahipse, yeni 22,99 USD fiyatı önceki fiyatı geçersiz kılacaktır.

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

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

Ü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 seçeneğine tıklayın.

Birden fazla veya tüm ürünleri aynı anda düzenlemek için, Catalog'a güncellenmiş bir CSV dosyası yükleyin, SKU veya ürün ID'niz de dahil olmak üzere. Bu işlem mevcut öğelerinizin otomatik olarak güncellenmesini tetikleyecektir.

Ürünü silmek için:

  1. Dashboard'da Ürünler sekmesine tıklayın.
  2. Silmek istediğiniz ürünü seçin. Ürün(ler)iniz seçildikten sonra silme düğmesi görünecektir.
  3. Sil düğmesine tıklayın ve ardından silmeyi 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 Catalog'u Yönet seçeneğine tıklayın ve ardından Tümünü Sil seçeneğine tıklayın.
  3. Silmeyi onaylamak için bir kez daha Tümünü Sil seçeneğine tıklayın.

Çok sayıda öğeyi silerseniz (20.000'den fazla ürün veya benzeri), silmenizin devam ettiğini belirten bir bildirim görünecektir. Bu süre boyunca silme işlemi tamamlanana kadar Catalog ile etkileşim kuramayacaksınız. Ancak, bildirimi kapatabilir ve silme işlemini kesintiye uğratmadan uzaklaşabilirsiniz.

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

Zonos Duty & Tax uygulamaları, uluslararası siparişlerden belirli ürünleri kaldıran ürün seviyesi kısıtlamalarını desteklemez. Kısıtlı bir öğe sepette varsa, tüm sepet bu ülkeye gönderilmesi için engellenmesi gerekir. Bu, ön tanımlı olarak onboarding sırasında yapılandırılması gereken bir sepet düzeyindeki kısıtlama kuralı aracılığıyla işlenir. Catalog, Duty & Tax uygulamalarıyla uyumlu olsa da, ürün seviyesi kısıtlamalar yalnızca Zonos Checkout kullanılırken desteklenir.

Catalog'ta tek bir ürünü kısıtlamak için:

  1. Ürünler sekmesine tıklayın.
  2. Kısıtlama eklemek istediğiniz ürünü seçin ve bu işlem düzenleme sayfasını açacaktır.
  3. Düzenleme sayfasının alt kısmında Kısıtlı ülkeler bölümünü bulun.
  4. Ürüne kısıtlamak istediğiniz ülkeleri ülke adını seçerek veya yazarak ekleyin.
  5. Ürünü kaydet seçeneğine tıklayın.

Catalog'ta birden fazla ürünü kısıtlamak için:

  1. İçe Aktarma/Dışa Aktarma sekmesine tıklayın.
  2. Catalog şablonu CSV dosyasını indirin.
  3. Şablonu ürün ayrıntılarınızla doldurun, SKU/Ürün ID'niz ve kısıtlı ülkelerini de dahil edin. 2 haneli ISO kodunu dikey çubukla ayrılmış şekilde girin, örneğin, AU|KR|MY|SG. Tüm ülkeleri kısıtlamak için, basitçe ALL değerini girin. Tüm ülkeleri kısıtlamak istiyorsanız, ancak bir veya birkaç ülkeyi serbest bırakmak istiyorsanız, ALL- yazın ve ardından kısıtlamak istediğiniz ülkeleri dikey çubukla ayrılmış olarak girin, örneğin, ALL-CA|FR|US. CSV biçimlendirmesi hakkında daha fazla bilgi edinin. Varolan tüm kısıtlı ülkeleri kaldırmak istiyorsanız, değer olarak NONE girin.
  4. Dosyayı CSV olarak kaydedin ve CSV'yi indirdiğiniz sayfada sürükle-bırak veya gözat seçeneğine tıklayarak Catalog'a yükleyin.
  5. Yüklenen ürünlerinizi önizleme ekranında inceleyin ve yükle seçeneğine tıklayın.

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

Catalog'tan tüm kataloğunuzu CSV biçiminde indirerek ve Excel veya Google Sheets'te açarak doğrudan kataloğda kısıtlı ürünleri filtreleyebilirsiniz. Oradan, yalnızca kısıtlı ürünleri görmek için filtreleme özelliğini kullanabilirsiniz. Bu, kataloğunuzdaki kısıtlı ürünleri kolayca bulmanıza ve yönetmenize izin verir.

CSV'niz yapıldı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'ni tanımlayıp eşleştirerek yapılır.

If you're using Checkout, ürün müşterinin ülkesine kısıtlandığında checkout'unuzda kısıtlı bir mesaj görüntülenecektir. Varsayılan olarak, mesaj "Bu öğe ülkenize ithalatı için kısıtlanmıştır" şeklinde olacaktır.

SKU, ürün ID'si veya ürün adı kullanarak Dashboard'da veya API aracılığıyla Catalog'ta ürünleri arayabilirsiniz. SKU ve ürün ID aramaları için yalnızca tam eşleşmeler sonuç döndürür; kısmi eşleşmeler desteklenmez. Ancak ürün adına göre arama yaparken, kısmi eşleşmeler desteklenir.

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

  1. Dashboard'da Ürünler sekmesine tıklayın.
  2. Catalog'unuzun sol üst köşesinde SKU veya Ürün ID'si seçeneğini seçin.
  3. SKU'nuz, ürün ID'niz veya ürün adınızı girin.
  4. Filtrelenmiş ürünü/ürünleri görmek için Uygula seçeneğine tıklayın.

Ürünün adını aramak için:

  1. Dashboard'da Ürünler sekmesine tıklayın.
  2. Catalog'unuzun sağ üst köşesinde, ürün adını arama alanına yazın.
  3. Filtrelenmiş ürünü/ürünleri görüntüleyin.

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

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

  1. Doğrudan Catalog tablosundan 50 veya daha az öğe seçin.
  2. Sağ üst köşedeki Dışa Aktar seçeneğine tıklayın.
  3. CSV dosyasını e-posta gelen kutunuzda bulun.

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

  1. Dashboard -> Ürünler -> Catalog sayfasına gidin.
  2. Ürün ekle seçeneğinin yanındaki Catalog'u 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. Katalog dosyasını indirmelerinizde bulun.

E-postanızdan indirmekte sorun mu yaşıyorsunuz? 

E-posta bağlantısından CSV indirmekte sorun yaşıyorsanız, bu tarayıcınız indirmeyi engellediği için olabilir. Öyleyse şu adımları izleyin:

  1. E-postanızdaki "İndir" düğmesine 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'a basın.
  4. Kataloğunuz daha sonra tarayıcınızdan doğrudan indirilecektir.

API kullanarak catalogItemId öğesini ClassificationsCreateFromCatalog mutasyonunda kullanarak kataloğunuzdaki bir ürünü sınıflandırabilirsiniz.

name ürünü sınıflandırmak için gerekli olduğunu unutmayın. Eksiksiz katalog ve sınıflandırma alanları listesi için GraphQL API referansı sayfasına göz atın.

Ürünü aynı anda oluşturmak ve sınıflandırmak için, aşağıdaki ClassificationsCreateFromCatalog mutasyonunu CatalogItemsCreate mutasyonunuza ekleyin.

Katalog ürünü 8+ haneli (ülkeye özgü) sınıflandırma 

shipToCountries alanı doldurulduğunda, sınıflandırma 8+ haneli (ülkeye özgü) HS kodu olacaktır. shipToCountries sağlanmazsa, sınıflandırma varsayılan 6 haneli (evrensel) HS koduna ayarlanacaktır. evrensel ve ülkeye özgü HS kodları arasındaki ayrımlar hakkında daha fazla bilgi edinin.

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

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}

Bir isteğin örneği burada verilmiştir. Zonos Classify yalnızca bir name ile sınıflandırma üretimine rağmen, en iyi sınıflandırma sonuçları için mümkün olduğunca fazla ayrıntı eklemenizi kuvvetle tavsiye ederiz.

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

API hataları ve çözümleri 

HataÇözüm
Ürün oluşturmak için SKU veya ürün ID gereklidirKatalog öğesi oluşturmak, düzenlemek veya silmek için tanımlayıcı (SKU/ürün ID) gereklidir. Bunu çözmek için SKU ve/veya ürün ID ekleyin.
Düzenlemek istediğiniz ürün mevcut değil*Mevcut olmayan bir ürünü düzenleyemezsiniz. Bunu çözmek için istediğiniz SKU ve/veya ürün ID'si ile yeni bir ürün oluşturun.
Gümrük açıklaması 30 karakter sınırını aşmaktadır.Varsayılan olarak, gümrük açıklamalarının sınırı 30 karakterdir, bu ticari faturalar için en yaygın karakter sınırıyla uyumludur.
Ürün türü geçersiz. Catalog aşağıdaki ürün türlerini destekler: dijital_good. Fiziksel mallar için boş bırakın.Catalog yalnızca aşağıdaki ürün türlerini destekler: digital_good ve physical_good. Ürün fiziksel bir mal ise (en yaygın), boş bırakın.
Paketleme tercihi geçersiz. Catalog aşağıdaki paketleme tercihlerini destekler: ships_alone ve consolidated. Ürün diğer ürünlerle birleştirilebilirse boş bırakın.Paketleme tercihi geçersiz. Catalog aşağıdaki paketleme tercihlerini destekler: ships_alone ve consolidated. Ürün diğer ürünlerle birleştirilebilirse, bunu boş bırakabilirsiniz çünkü consolidated varsayılandır.
HS kodu sağlanırken ülke belirtilmelidirÜlkeye özgü HS kodu sağladığınızda öğe oluştururken, gönderme yapacak ülke gereklidir. Bunu çözmek için, gönderme yapılacak ülke ekleyin.
Fiyat 0'dan büyük olmalıdırCatalog negatif fiyat değerlerini desteklemez. Bunu çözmek için sıfırdan büyük bir fiyat ekleyin.
Fiyat değeri sağlandığında para birimi kodu sağlanmalıdırFiyat sağlarsanız para birimi kodu gereklidir. Bunu çözmek için para birimi kodu ekleyin.
Para birimi kodu sağlandığında fiyat sağlanmalıdırPara birimi kodu sağlarsanız fiyat gereklidir. Bunu çözmek için fiyat ekleyin.
Eşlik eden boyutsal alan boş bırakılamazBir boyutsal alan sağlanırsa, diğer ikisi gereklidir, örneğin, 8 inç genişlik sağlarsanız, yükseklik ve uzunluk gerekli olacaktır.
Ölçüm değeri 0'dan büyük olmalıdırCatalog 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 değer sağlanırken boyutsal birimler boş bırakılamazBoyutsal değer sağlarsanız boyutsal birim gereklidir. Bunu çözmek için boyutsal birim ekleyin.
Ağırlık değeri sağlanırken ağırlık birimi boş bırakılamazAğırlık değeri sağlarsanız ağırlık birimi gereklidir. Bunu çözmek için ağırlık birimi ekleyin.

* Yalnızca API hatası

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

Bu sayfa faydalı mıydı?