DOCS

Ürünleri Sınıflandırma

Ürünleri Sınıflandırma

Dashboard ve API üzerinden nasıl sınıflandırma talep edeceğinizi öğrenin.

Aşağıda, Dashboard veya API aracılığıyla evrensel ve ülkeye özgü sınıflandırmaların nasıl talep edileceğini gösteren örnekler bulacaksınız. Daha kapsamlı teknik detaylar ve geniş belgeler arayanlar için Zonos GraphQL API referans geliştirici sitesini ziyaret edin. Bu kapsamlı kaynak, API uç noktaları, GraphQL mutasyonları ve geniş teknik bilgiler hakkında ayrıntılı bilgiler sunmaktadır.

Girdi Alanları 

Sınıflandırma oluşturmak için yalnızca bir açıklama gereklidir, ancak sağladığınız ürün detayları ne kadar fazla olursa, sınıflandırmanız o kadar doğru olur. Aşağıda Classify tarafından kabul edilen her girdi alanının kapsamlı bir açıklaması bulunmaktadır. Bu girdi alanlarını anlayarak, kullanımını maksimize edebilir ve son derece doğru sınıflandırmalar oluşturabilirsiniz.

Girdi Alanı Açıklamaları

AlanAçıklama
Ad (zorunlu)Ürünün adı
Açıklama (isteğe bağlı)Ürünün derinlemesine, uzun bir açıklaması
Görüntü URL'si (isteğe bağlı)Ürünün bir resmine bağlantı. Not: Gerçek resim URL'sine bağlantı kullandığınızdan emin olun, ürün sayfası URL'sini değil
Kategoriler (isteğe bağlı)Genel alt ürün kategorileri, örneğin, Giyim & Aksesuarlar, Evcil Hayvan Malzemeleri, Ofis Ürünleri veya Bebek Kıyafetleri, Evcil Hayvan Yatakları, Yapıştırıcılar & Bantlar
Malzeme (isteğe bağlı)Ürünün yapıldığı malzeme, örneğin, plastik, ahşap, çelik
Menşei Ülke (isteğe bağlı)Ürünün üretildiği veya imal edildiği ülkenin iki harfli kısaltması (ISO kodu)
Sağlanan HS Kodu (isteğe bağlı)Sınıflandırma talebinize rehberlik etmek için mevcut bir HS kodunu dahil edin. Sağladığınız HS kodunun kökenine ve tercihinize bağlı olarak, Classify HS kodunu doğrulayabilir ve ürünün açıklama detaylarıyla tutarlılığını kontrol edebilir. Daha fazla bilgi edinin.
Hedef ülke (isteğe bağlı)Ürünün hangi ülkeye sınıflandırılacağını belirler. Hedef ülke, her ülkenin iki harfli kısaltması (ISO kodu) ile gösterilmeli ve gerçek ülke adı değil, örneğin, AU, değil Avustralya olmalıdır. Bu alanı dahil etmek, Classify'ın evrensel 6 haneli kod yerine 8+ haneli ülkeye özgü HS kodu döndürmesini sağlar. Evrensel ve ülkeye özgü HS kodları arasındaki farkları öğrenin.
Ürün ID'si (isteğe bağlı)Ürün ID'niz veya her ürünü benzersiz bir şekilde tanımlamak için kullanılabilecek herhangi bir numara. Bir ürün ID'si sağlanmazsa, Classify 1 ile başlayan ürün ID'leri atayacaktır.

Not: Dashboard'da toplu talep CSV'nizi yüklüyorsanız, hedef ülke şablonun bir parçası olmayacak, bunun yerine toplu talep CSV'nizi yükledikten sonra hedef ülkelerinizi seçeceksiniz.

Sınıflandırma Talep Etme 

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

Aşağıdaki örnek, evrensel (6 haneli) bir talebi göstermektedir. Belirli ülkelere sınıflandırma talep etmek için, Classify talebine ülkelerin 'ISO kodlarını ekleyin. Evrensel bir HS kodu talep etmek için, Classify talebinde gönderim yapılacak ülkeyi null bırakın.

Girdi, bir liste alır, böylece birden fazla veya tek bir sınıflandırma talep edebilirsiniz.

MUTASYON

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
mutation {
  classificationsCalculate(
    input: [
      {
        categories: "women's clothing"
        imageUrl: "https://zonos.com/images/cozygloves.webp"
        name: "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
        configuration: { shipToCountries: KR }
      }
    ]
  ) {
    id
    name
    categories
    imageUrl
    hsCode {
      code
      description {
        full
      }
    }
  }
}

YANIT

JSON

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "data": {
    "classificationsCalculate": [
      {
        "id": "classification_313d8d9d-e330-4d79-9922-cb7a1ff317e2",
        "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
        "categories": ["women's clothing"],
        "imageUrl": null,
        "hsCode": {
          "code": "6116.99.0000",
          "description": {
            "full": "Articles of apparel and clothing accessories, knitted or crocheted: Gloves, mittens and mitts, knitted or crocheted: Other : Of other textile materials"
          }
        }
      }
    ]
  }
}

Olası API yanıtları

Classify bir sınıflandırma talebi aldığında, talepte yer alan girdi öğesi verilerini Classify's veritabanındaki en yüksek güven puanına göre bir eşleşme ile eşleştirmeye çalışır. Bulunan verilere dayanarak, Classify aşağıdaki yanıtlardan birini döndürecektir:

  1. hsCode 6 ila 8+ haneli HS kodu ile döndüğünde, gönderim yapılacak bir ülke talepte yer alıp almadığına bağlı olarak, sınıflandırma talebiniz başarılı olmuştur.
  2. {"errors": [ { "message": "Yeterli yanıt bulunamadı"}]} döndüğünde, bu, Classify'nın yetersiz girdi bilgileri nedeniyle bir sınıflandırma bulamadığı anlamına gelir.

Bu sayfa faydalı mıydı?