Kesiapan Klasifikasi

Mutasi customsDescriptionValidate memeriksa apakah informasi item cukup untuk dengan percaya diri menetapkan kode HS 6 digit, sebelum klasifikasi dijalankan. Ini mengembalikan status kesiapan yang penerapan kebijakannya Anda tentukan sendiri—lanjutkan untuk mengklasifikasi, beri peringatan, minta pembeli atau pedagang untuk detail lebih lanjut, atau tolak item.

Ini adalah pemeriksaan pendahuluan, bukan klasifikasi: customsDescriptionValidate tidak mengklasifikasi item dan tidak mengembalikan kode HS. Gunakan untuk menangkap deskripsi tipis atau tidak dapat digunakan sejak awal sehingga deskripsi yang akhirnya Anda kirim ke Classify menghasilkan hasil yang akurat dan bebas asumsi.

Pemeriksaan kesiapan hanya salah satu penggunaan. Karena data item yang sama mendorong layanan deskripsi bea cukai dan klasifikasi Zonos, mutasi ini adalah titik masuk ke alur kerja Deskripsi Bea Cukai yang lebih luas—mengatur gerbang kualitas data, kemudian menghasilkan deskripsi bea cukai yang sesuai dari item. Lihat Lebih dari sekedar gerbang klasifikasi di bawah.

Status kesiapan 

Setiap validasi mengembalikan satu status. Status bersifat informatif—integrasi Anda menentukan konsekuensi dari setiap nilai.

Ketika status adalah INCOMPLETE, bidang missingAttributes mengembalikan atribut yang hilang sebagai frasa pendek (misalnya "fiber content" atau "material, construction") yang cocok untuk menyusun pesan yang menghadap pengguna. Ini adalah null untuk status lainnya.

Validasi item melalui API 

Berikan bidang item secara langsung—setidaknya satu bidang deskriptif diperlukan. Contoh di bawah memvalidasi item yang nama dan deskripsinya mengidentifikasinya sebagai t-shirt tetapi menghilangkan konten serat yang diperlukan untuk mengklasifikasinya, sehingga mutasi mengembalikan INCOMPLETE.

Bidang masukan

Berikan salah satu existingItemId atau bidang item secara langsung—setidaknya satu bidang deskriptif diperlukan.

Validasi item yang ada 

Jika item sudah ada di Zonos, berikan ID-nya sebagai existingItemId alih-alih mengirim ulang setiap bidang. Bidang item yang disimpan digunakan sebagai basis untuk validasi, dan bidang apa pun yang juga Anda berikan dalam input yang sama menggantikan nilai yang disimpan—berguna untuk menguji apakah edit akan membuat item tipis siap klasifikasi.

Respons content mengeluarkan data item yang divalidasi, dengan existingItemId diselesaikan, sehingga setiap CustomsDescriptionValidation yang disimpan mendeskripsikan dirinya sendiri.

Lebih dari sekedar gerbang klasifikasi 

Karena status kesiapan bersifat informatif, pemeriksaan yang sama memberi makan lebih dari satu alur kerja—bukan hanya tentang memutuskan apakah akan mengklasifikasi. customsDescriptionValidate mengevaluasi data item yang sama yang digunakan layanan klasifikasi dan deskripsi bea cukai Zonos, yang menjadikannya langkah pertama alami dalam alur kerja Deskripsi Bea Cukai yang lebih luas:

• Gerbang kualitas data — Tampilkan informasi item tipis atau tidak dapat digunakan pada titik masuk (dalam PIM, impor katalog, atau checkout) dan minta secara tepat apa yang hilang menggunakan missingAttributes, sebelum data itu mengalir ke hilir.
• Hasilkan deskripsi bea cukai — Setelah item READY, serahkan data yang sama kepada mutasi customsDescriptionsCreate agar Zonos menghasilkan deskripsi bea cukai yang ringkas, sesuai dengan bea cukai dan ICS2 dari item—secara opsional meminta kode HS dalam panggilan yang sama. Memvalidasi kesiapan terlebih dahulu berarti deskripsi yang dihasilkan dibangun dari informasi lengkap daripada asumsi.
• Klasifikasi dengan percaya diri — Lanjutkan ke Classify mengetahui deskripsi cukup kaya untuk menetapkan kode HS 6 digit yang akurat tanpa tebakan.

Alur end-to-end yang khas adalah: validasi kesiapan → kumpulkan missingAttributes apa pun → hasilkan deskripsi bea cukai yang sesuai (dan kode HS) → klasifikasi atau arsip.