DOCS

Mengklasifikasikan barang

Mengklasifikasikan barang

Pelajari cara meminta klasifikasi di Dashboard dan melalui API.

Di bawah ini Anda akan menemukan contoh yang menggambarkan cara meminta klasifikasi universal dan spesifik negara melalui Dashboard atau melalui API. Bagi mereka yang mencari detail teknis yang lebih komprehensif dan dokumentasi yang luas, kunjungi situs referensi pengembang API GraphQL Zonos. Sumber daya komprehensif ini menawarkan wawasan mendetail tentang endpoint API, mutasi GraphQL, dan informasi teknis yang luas.

Bidang input 

Meskipun hanya deskripsi yang diperlukan untuk menghasilkan klasifikasi, semakin banyak detail produk yang Anda berikan, semakin akurat klasifikasi Anda. Di bawah ini adalah penjelasan komprehensif tentang setiap bidang input yang diterima oleh Classify. Dengan memahami bidang input ini, Anda dapat memaksimalkan penggunaannya dan menghasilkan klasifikasi yang sangat akurat.

Deskripsi bidang input

BidangDeskripsi
Nama (diperlukan)Nama produk
Deskripsi (opsional)Deskripsi mendalam dan panjang tentang produk
URL Gambar (opsional)Tautan ke gambar produk. Catatan: Pastikan Anda menggunakan tautan ke URL gambar yang sebenarnya dan bukan URL halaman produk
Kategori (opsional)Sub kategori produk umum, misalnya, Pakaian & Aksesori, Perlengkapan Hewan Peliharaan, Produk Kantor atau Pakaian Bayi, Tempat Tidur Hewan Peliharaan, Perekat & Pita
Bahan (opsional)Apa yang terbuat dari produk, misalnya, plastik, kayu, baja
Negara Asal (opsional)singkatan dua huruf (kode ISO) untuk negara tempat produk diproduksi atau dibuat
Kode HS yang Diberikan (opsional)Sertakan kode HS yang ada dalam permintaan klasifikasi Anda untuk memandu permintaan Anda. Tergantung pada preferensi Anda dan asal kode HS yang Anda berikan, Classify dapat memvalidasi kode HS dan memeriksa koherensinya terhadap detail deskripsi barang. Pelajari lebih lanjut.
Negara tujuan (opsional)Mengidentifikasi negara mana produk akan diklasifikasikan. Negara tujuan harus ditampilkan dengan singkatan dua huruf (kode ISO) setiap negara dan bukan nama negara yang sebenarnya, misalnya, AU, bukan Australia. Menyertakan bidang ini akan memungkinkan Classify untuk mengembalikan kode HS spesifik negara 8+ digit alih-alih kode 6 digit universal. Pelajari lebih lanjut tentang perbedaan antara kode HS universal dan spesifik negara.
ID Produk (opsional)ID produk Anda atau nomor apa pun yang dapat digunakan untuk mengidentifikasi setiap produk secara unik. Jika ID produk tidak diberikan, Classify akan menetapkan ID produk yang dimulai dengan 1

Catatan: Jika Anda mengunggah CSV permintaan massal Anda di Dashboard, negara tujuan tidak akan menjadi bagian dari template, melainkan Anda akan memilih negara tujuan Anda setelah mengunggah CSV permintaan massal Anda.

Meminta klasifikasi 

Untuk meminta klasifikasi di Dashboard atau melalui API, ikuti langkah-langkah dan mutasi di bawah ini.

Contoh di bawah ini menunjukkan permintaan universal (6-digit). Untuk meminta klasifikasi ke negara tertentu, tambahkan '[kode ISO]'(/docs/guides/country-guides/country-iso-codes) negara dalam permintaan Classify seperti yang terlihat pada contoh di bawah ini. Untuk meminta kode HS universal, biarkan negara tujuan null dalam permintaan Classify.

Input menerima daftar sehingga Anda dapat meminta banyak atau satu klasifikasi sekaligus.

MUTASI

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

RESPON

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

Kemungkinan respons API

Ketika Classify menerima permintaan klasifikasi, ia berusaha mencocokkan data item input yang termasuk dalam permintaan dengan kecocokan dalam database Classify's berdasarkan skor kepercayaan tertinggi. Berdasarkan apa yang ditemukan, Classify akan mengembalikan salah satu respons berikut:

  1. Ketika hsCode dikembalikan dengan kode HS 6 hingga 8+ digit, tergantung pada apakah negara tujuan disertakan dalam permintaan atau tidak, permintaan klasifikasi Anda berhasil.
  2. Ketika {"errors": [ { "message": "No adequate response"}]} dikembalikan, itu berarti Classify tidak dapat menemukan klasifikasi karena informasi input yang tidak memadai.

Apakah halaman ini bermanfaat?