Zonos Catalog'ta ürün nasıl oluşturulur?

Zonos Catalog'ta Dashboard'da veya API aracılığıyla ürün oluşturabilirsiniz. Dashboard'da Catalog'a gidin ve sağ üst köşede Ürün ekle seçeneğine tıklayın. Ürün ayrıntılarınızı ekleyin ve ürünü kaydet seçeneğine tıklayın. Birden fazla ürünü aynı anda oluşturmak istiyorsanız, ürünleri alma adımlarını izleyin. API'de kataloğunuza ürün eklemek için catalogItemInputs listesi oluşturun.

Zonos Catalog'ta ürün nasıl düzenlenir?

Zonos Catalog'ta Dashboard'da veya API aracılığıyla ürün düzenleyebilirsiniz. Dashboard'da, Tüm ürünler sekmesine tıklayın, düzenlemek istediğiniz ürünü seçin, değişikliklerinizi yapın ve ürünü kaydet seçeneğine tıklayın. API'de, ürünü düzenlemek için CatalogItemUpdate mutasyonunu kullanın.

Zonos Catalog'ta ürün nasıl silinir?

Zonos Catalog'ta Dashboard'da veya API aracılığıyla ürün silebilirsiniz. Dashboard'da, Tüm ürünler sekmesine tıklayın, silmek istediğiniz ürünü veya ürünleri seçin ve sil seçeneğine tıklayın. API'de, ürünü silmek için CatalogItemDelete mutasyonunu kullanın.

Zonos Catalog'ta ürün nasıl kısıtlanır?

Belirli bir ülkeye (veya ülkelere) gönderileri önlemek istiyorsanız, Zonos Catalog'ta ürün oluştururken veya güncellerken kısıtlamalar ekleyebilirsiniz. Dashboard'da, kısıtlama eklemek istediğiniz ürünü seçin, düzenleme sayfasının alt kısmında kısıtlamalar bölümünü bulun, ürüne kısıtlamak istediğiniz ülkeleri ekleyin ve ürünü kaydet seçeneğine tıklayın. API'de, catalogItem oluştururken veya güncellerken restrictedCountries ekleyin.

Zonos Dashboard'da ürünler nasıl dışa aktarılır?

Zonos Dashboard'da ürünlerinizi dışa aktarırken, tüm ürün kataloğunuz otomatik olarak CSV dosyasında dışa aktarılacaktır. Katalog'un ana sayfasına gidin, Ürün ekle seçeneğinin yanındaki Dışa Aktar düğmesine tıklayın ve tam katalog dosyasını indirmelerinizde bulun.

API aracılığıyla Catalog ürünü nasıl sınıflandırılır?

Catalog'unuzdaki bir ürünü ClassificationsCreateFromCatalog mutasyonunda catalogItemId'yi kullanarak sınıflandırabilirsiniz. Ürünü sınıflandırmak için name'in gerekli olduğunu unutmayın. Ürünü aynı anda oluşturmak ve sınıflandırmak için, ClassificationsCreateFromCatalog mutasyonunu CatalogItemsCreate mutasyonunuza ekleyin.

Ana sayfaKüresel e-ticaret Katalog Ü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.

Ürün oluşturma

Catalog'ta ürün oluşturun:

Catalog sayfasına gidin ve sağ üst köşede Ürün ekle düğmesine tıklayın.
Ü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.
İsteğe bağlı—HS kodunuzu ekleyin.
İsteğe bağlı—Kargo bilgilerinizi ekleyin (ağırlık, boyutlar, ölçü birimleri vb.).
İsteğe bağlı—Kısıtlı ülkeleri ekleyin.
Ü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.

Ürünü tehlikeli mal olarak etiketle (DHL)

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ğer↕	Kategori↕
`NOT_RESTRICTED_A70`	Kısıtlanmadı, Özel Hüküm A70—gaz amortisörleri ve şok emiciler gibi basınçlı parçalar (UN3164).
`NOT_RESTRICTED_A67`	Kısıtlanmadı, Özel Hüküm A67—yanıcı sıvıyla çalışan motorlar veya makineler (UN3528).
`NOT_RESTRICTED_A02`	Kısıtlanmadı, Özel Hüküm A02—ADR karayolu taşımacılığı küçük yük hükmü kapsamında muaftır.
`LIMITED_QUANTITY`	Sınırlı Miktar (ADR)—yasal sınırlar içinde küçük miktarlarda paketlenmiş tehlikeli maddeler.
`EXCEPTED_QUANTITY`	Muaf Miktar (IATA)—çoğu hava taşımacılığı tehlikeli maddeler kurallarından muaf çok küçük miktarlar.
`CONSUMER_COMMODITY`	Tüketici malı ID8000—aerosol ve parfüm gibi küçük tehlikeli içeriğe sahip perakenda hazır gündelik ürünler.
`MAGNETIZED_MATERIAL`	Manyetikleştirilmiş malzeme (UN2807)—uçak enstrümanlarını etkileyecek kadar güçlü bir manyetik alana sahip öğeler.
`BIOLOGICAL_SUBSTANCE`	Biyolojik 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ü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ü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 koduna sahipse, ancak güncellenmiş ürünün HS kodu, SKU 456, boşsa, mevcut HS kodu kalır.

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

Ürünler sekmesine tıklayın.
Düzenlemek istediğiniz ürünü seçin.
Değişikliklerinizi yapın.
Ü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ü sil

Ürünü silmek için:

Dashboard'da Ürünler sekmesine tıklayın.
Silmek istediğiniz ürünü seçin. Ürün(ler)iniz seçildikten sonra silme düğmesi görünecektir.
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:

Dashboard'da Ürünler sekmesini seçin.
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.
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.

Ürünü kısıtla

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ı desteklemez. Kısıtlı bir öğe sepette varsa, tüm sepetin bu ülkeye gönderimi engellenmelidir. Bu, onboarding sırasında önceden 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:

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

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

İçe Aktarma/Dışa Aktarma sekmesine tıklayın.
Catalog şablonu CSV dosyasını indirin.
Ş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 serbest bırakmak istediğiniz ülkeleri dikey çubukla ayrılmış olarak girin, örneğin, ALL-CA|FR|US. CSV biçimlendirmesi hakkında daha fazla bilgi edinin. Var olan tüm kısıtlı ülkeleri kaldırmak istiyorsanız, değer olarak NONE girin.
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.
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'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ımlayıp eşleştirerek yapılır.

Checkout kullanıyorsanız, ü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.

Ürünü filtrele

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:

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

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

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

Ürünlerinizi dışa aktar

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:

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

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

Dashboard -> Ürünler -> Catalog sayfasına gidin.
Ü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.
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:

E-postanızdaki "İndir" düğmesine sağ tıklayın.
İndirme URL'sini kopyalamak için "Bağlantı adresini kopyala" seçeneğini seçin.
Kopyalanan URL'yi tarayıcınıza yapıştırın ve Enter'a basın.
Kataloğunuz daha sonra tarayıcınızdan doğrudan indirilecektir.

Ürünü sınıflandır

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 bir sınıflandırma oluşturacak olsa da, 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 gereklidir*	Katalog öğ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: digital_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ır*	Catalog 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ır*	Fiyat 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ır*	Para birimi kodu sağlarsanız fiyat gereklidir. Bunu çözmek için fiyat ekleyin.
*Eşlik eden boyutsal alan boş bırakılamaz*	Bir 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ır*	Catalog 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ılamaz*	Boyutsal 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ılamaz*	Ağı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

INPUTS

ItemAttributeInput

Demo rezervasyonu yap