DOCS

Öğeleri sınıflandırma

Öğeleri sınıflandırma

Dashboard ve API aracılığıyla sınıflandırma talep etmeyi öğrenin.

Aşağıda Dashboard ve API aracılığıyla evrensel ve ülkeye özgü sınıflandırmalar talep etme konusunda örnekler bulacaksınız. Daha kapsamlı teknik ayrıntılar ve kapsamlı belgeler arayan kişiler için Zonos GraphQL API referans geliştirici sitesini ziyaret edin. Bu kapsamlı kaynak, API uç noktaları, GraphQL mutasyonları ve kapsamlı teknik bilgiler hakkında ayrıntılı bilgiler sunmaktadır.

Giriş alanları 

Sınıflandırma oluşturmak için yalnızca bir açıklama gerekli olsa da, ne kadar çok ürün ayrıntısı sağlarsanız, sınıflandırmanız o kadar doğru olur. Alternatif olarak, basitçe bir ürün URL'si sağlayabilir ve Classify, ilgili tüm öğe ayrıntılarını otomatik olarak çıkaracaktır. Aşağıda, Classify tarafından kabul edilen her giriş alanının kapsamlı bir açıklaması bulunmaktadır. Bu giriş alanlarını anlayarak, bunların kullanımını en üst düzeye çıkarabilir ve oldukça doğru sınıflandırmalar oluşturabilirsiniz.

AlanAçıklama
Ad (gerekli)Ürünün adı
Ürün URL'si (isteğe bağlı)Bir ürün URL'si yapıştırın ve Classify sayfayı otomatik olarak alacak ve ilgili öğe ayrıntılarını (ad, açıklama, kategoriler, vb.) sınıflandırma için çıkaracaktır. Dashboard'da + simgesini tıklayarak veya ana metin alanına doğrudan ekleyerek kullanılabilir. API entegrasyonları için lütfen Zonos temsilcinize başvurun. Demolar ve testler için ideal olsa da, üretim uygulamaları öğe verilerini arka uç sistemlerinden doğrudan ileterek en iyi performans ve maliyet verimliliğini elde eder.
Açıklama (isteğe bağlı)Ürünün ayrıntılı, uzun biçimli bir açıklaması
Görüntü URL'si (isteğe bağlı)Ürünün görüntüsüne bağlantı. Not: Ürün sayfası URL'sini değil, gerçek görüntü URL'sine bir bağlantı kullandığınızdan emin olun
Kategoriler (isteğe bağlı)Genel alt ürün kategorileri, örneğin Giyim ve Aksesuarlar, Pet Malzemeleri, Ofis Ürünleri veya Bebek Giysileri, Pet Yatakları, Yapışkanlar ve Bant
Malzeme (isteğe bağlı)Ürünün yapılı olduğu şey, örneğin plastik, ahşap, çelik
Üretim Ülkesi (isteğe bağlı)Ürünün üretildiği veya üretildiği ülkenin iki harfli kısaltması (ISO kodu)
Sağlanan HS Kodu (isteğe bağlı)Sınıflandırma talebinizi yönlendirmek için talebinize mevcut bir HS kodu dahil edin. Tercihlerinize ve sağlanan HS kodunuzun kaynağına bağlı olarak, Classify HS kodunu doğrulayabilir ve ürünün açıklaması ayrıntılarına karşı tutarlılığını kontrol edebilir. Daha fazla bilgi edinin.
Hedef ülke (isteğe bağlı)Ürünün sınıflandırılacağı ülkeyi tanımlar. Hedef ülke, her ülkenin iki harfli kısaltması (ISO kodu) ile gösterilmeli ve gerçek ülke adı değil, örneğin AU, Avustralya değil. Bu alanı içermek, Classify'yi evrensel 6 haneli kod yerine 8+ haneli ülkeye özgü HS kodu döndürmeye güçlendirecektir. Evrensel ve ülkeye özgü HS kodları arasındaki farklar hakkında daha fazla bilgi edinin.
Ürün Kimliği (isteğe bağlı)Ürün kimliğiniz veya her ürünü benzersiz olarak tanımlamak için kullanılabilecek herhangi bir sayı. Bir ürün kimliği sağlanmıyorsa, Classify 1'den başlayarak ürün kimliklerini atayacaktır

Not: Dashboard'da toplu istek CSV'nizi yüklüyorsanız, hedef ülke şablonun parçası olmayacaktır; bunun yerine toplu istek CSV'nizi yükledikten sonra hedef ülkelerinizi seçersiniz.

Sınıflandırma talep etme 

Dashboard veya API aracılığıyla sınıflandırma talep etmek için aşağıdaki adımları ve mutasyonu izleyin.

Aşağıdaki örnek, bir evrensel (6 haneli) talebini göstermektedir. Belirli ülkelere sınıflandırmalar talep etmek için, aşağıdaki örnekte görüldüğü gibi Classify talebine ülkelerin ISO kodlarını ekleyin. Evrensel HS kodu talep etmek için, Classify talebinde gönderim ülkesini null bırakın.

Giriş bir liste alır, böylece birçok veya tek bir sınıflandırmayı aynı anda talep edebilirsiniz.

Not: API aracılığıyla denetim izleri oluşturmak için, sorgunuza auditTrail alanını ekleyin. Erişim ve uygulama ayrıntıları için lütfen Zonos temsilcinize başvurun.

1mutation ClassifyItems($input: [ClassificationCalculateInput!]!) {
2 classificationsCalculate(input: $input) {
3 id
4 name
5 categories
6 imageUrl
7 hsCode {
8 code
9 description {
10 full
11 }
12 }
13 }
14}

Olası API Yanıtları

Classify bir sınıflandırma talebini aldığında, talebe dahil edilen giriş öğesi verilerini, en yüksek güven puanına göre Classify'nin veritabanındaki bir eşleşme ile eşleştirmeyi dener. Bulunanlar temel alınarak, Classify aşağıdaki yanıtlardan birini döndürecektir:

  1. hsCode, talebe bir gönderim ülkesinin dahil edilip edilmediğine bağlı olarak 6 ila 8+ haneli HS kodu ile döndürüldüğünde, sınıflandırma talebiniz başarılı olmuştur.
  2. {"errors": [ { "message": "No adequate response"}]} döndürüldüğünde, bu, Classify'nin yetersiz giriş bilgisi nedeniyle sınıflandırma bulamaması anlamına gelir.
GraphQL API ReferenceTypes, inputs, and operations used in this guide

Bu sayfa faydalı mıydı?