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 Anda terapkan kebijakan Anda sendiri—lanjutkan untuk mengklasifikasi, beri peringatan, minta pembeli atau pedagang untuk detail lebih lanjut, atau tolak item.

Ini adalah pemeriksaan pra-penerbangan, bukan klasifikasi: customsDescriptionValidate tidak mengklasifikasi item dan tidak mengembalikan kode HS. Gunakan untuk menangkap deskripsi tipis atau tidak dapat digunakan di depan 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 kustom dan klasifikasi Zonos, mutasi ini adalah titik masuk ke alur kerja Deskripsi Kustom yang lebih luas—mengatur gerbang kualitas data, kemudian menghasilkan deskripsi kustom 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 kustom Zonos, yang menjadikannya langkah pertama alami dalam alur kerja Deskripsi Kustom 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 yang tepat hilang menggunakan missingAttributes, sebelum data itu mengalir ke hilir.
• Hasilkan deskripsi kustom — Setelah item READY, serahkan data yang sama kepada mutasi customsDescriptionsCreate agar Zonos menghasilkan deskripsi kustom yang ringkas, sesuai dengan kustom 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 kustom yang sesuai (dan kode HS) → klasifikasi atau arsip.