Sınıflandırma hazırlığı

Bir öğenin bilgisinin sınıflandırılmaya hazır olup olmadığını kontrol edin—HS kodu talep etmeden önce.

GraphQL

customsDescriptionValidate mutasyonu, bir öğenin bilgisinin 6 haneli bir HS kodu tahsis etmek için yeterli olup olmadığını, sınıflandırma çalışmadan önce kontrol eder. Bir hazırlık durumu döndürür ve bunu kendi politikanıza uygularsınız—sınıflandırmaya devam edin, uyarı verin, alıcı veya tüccar tarafından daha fazla detay isteyin veya öğeyi reddedin.

Bu bir ön uçuş kontrolüdür, sınıflandırma değildir: customsDescriptionValidate öğeyi sınıflandırmaz ve HS kodu döndürmez. Bunu, zayıf veya kullanılamaz açıklamaları önceden yakalamak için kullanın, böylece sonunda Classify öğesine gönderdiğiniz açıklamalar doğru, varsayım içermeyen sonuçlar üretir.

Hazırlık kontrolü sadece bir kullanımdır. Aynı öğe verileri Zonos'un gümrük açıklaması ve sınıflandırma hizmetlerini yönlendirdiğinden, bu mutasyon daha geniş bir Customs Description iş akışının giriş noktasıdır—önce veri kalitesini denetleyerek, ardından öğeden uyumlu bir gümrük açıklaması oluşturarak. Bkz. Sınıflandırma kapısından daha fazlası aşağıda.

Hazırlık durumları

Her doğrulama bir status döndürür. Durum tavsiye niteliğindedir—entegrasyonunuz her değerin sonucuna karar verir.

Durum↕	Anlam↕	Önerilen eylem↕
`READY`	Bilgiler, 6 haneli HS kodunu hiçbir varsayım olmadan güvenle tahsis etmeye yeterlidir.	Sınıflandırmaya devam edin.
`INCOMPLETE`	Öğe tanımlanabilir, ancak belirleyici bir öznitelik eksiktir, bu nedenle sınıflandırma varsayımlara dayanacaktır.	`missingAttributes` öğesinde adı verilen özniteliği isteyin, ardından yeniden deneyin.
`UNRECOGNIZABLE`	Metin, öğenin temel olarak ne olduğunu belirlemez—boş değerler, basit SKU'lar veya dahili kodlar veya anlamsız metinler.	Kullanıcıdan öğeyi yeniden girmesini isteyin.

Durum INCOMPLETE olduğunda, missingAttributes alanı eksik öznitelik(leri) kısa bir cümle olarak döndürür (örn. "fiber içeriği" veya "malzeme, yapı") ve bu, kullanıcıya yönelik bir ileti oluşturmaya uygundur. Diğer tüm durumlar için null değerindedir.

API üzerinden bir öğeyi doğrulayın

Öğe alanlarını doğrudan sağlayın—en az bir açıklayıcı alan gereklidir. Aşağıdaki örnek, adı ve açıklaması onu tişört olarak tanımlayan ancak sınıflandırmak için gereken fiber içeriğini atlayan bir öğeyi doğrular, bu nedenle mutasyon INCOMPLETE döndürür.

1mutation CustomsDescriptionValidate(

2$input: CustomsDescriptionValidationInput!

3) {

4 customsDescriptionValidate(input: $input) {

5 id

6 status

7 missingAttributes

8 content {

9 name

10 description

11 material

12 categories

13 existingItemId

14 }

15 createdAt

16 }

17}

Giriş alanları

Alan↕	Tür↕	Açıklama↕
`name`	`String`	Öğenin adı.
`description`	`String`	Öğenin insan tarafından okunabilir açıklaması.
`material`	`String`	Biliniyorsa öğenin malzeme veya bileşimi (örn. `"55% pamuk, 45% polyester"`).
`categories`	`[String!]`	Öğeyi ilişkilendiren ve tanımlayan kategoriler.
`existingItemId`	`ID`	Doğrulanacak mevcut bir `Item` öğesinin kimliği. Sağlandığında, depolanan öğenin alanları kullanılır ve burada sağlanan tüm alanlar depolanan değerleri geçersiz kılar.

existingItemId veya öğe alanlarını doğrudan sağlayın—en az bir açıklayıcı alan gereklidir.

Mevcut bir öğeyi doğrulayın

Öğe zaten Zonos'ta mevcutsa, her alanı yeniden göndermek yerine kimliğini existingItemId olarak geçirin. Depolanan öğenin alanları doğrulanmanın temeli olarak kullanılır ve aynı girdide de sağladığınız tüm alanlar depolanan değerleri geçersiz kılar—zayıf bir öğeyi düzenlemek için sınıflandırmaya hazır hale getirip getiremeyeceğini test etmek için kullanışlıdır.

Yanıt content doğrulanan öğe verilerini yineler ve existingItemId çözülür, bu nedenle her depolanan CustomsDescriptionValidation kendi kendini açıklar.

Sınıflandırma kapısından daha fazlası

Hazırlık durumu tavsiye niteliğinde olduğundan, aynı kontrol birden fazla iş akışını besler—sadece sınıflandırmaya devam etme kararı hakkında değildir. customsDescriptionValidate Zonos'un sınıflandırma ve gümrük açıklaması hizmetlerinin tükettiği aynı öğe verilerini değerlendirir, bu onu daha geniş bir Customs Description iş akışında doğal bir ilk adım yapar:

Veri kalitesi kapısı — Zayıf veya kullanılamaz öğe bilgisini giriş noktasında (PIM, katalog içeri aktarma veya ödeme sayfasında) açığa çıkarın ve missingAttributes kullanarak tam olarak eksik olanı isteyin, bu veriler aşağı akışa akmadan önce.
Gümrük açıklaması oluştur — Bir öğe READY olduktan sonra, aynı verileri customsDescriptionsCreate mutasyonuna ilet, böylece Zonos öğeden özlü, gümrük ve ICS2 uyumlu bir gümrük açıklaması oluşturur—isteğe bağlı olarak aynı çağrıda bir HS kodu talep et. Hazırlığı önceden doğrulamak, oluşturulan açıklamanın varsayımlar yerine tam bilgilerden oluşturulduğu anlamına gelir.
Güvenle sınıflandırın — Açıklamanın, varsayım olmadan doğru bir 6 haneli HS kodunu tahsis etmeye yeterince zengin olduğunu bilerek Classify öğesine ilerleyin.

Tipik bir uçtan uca akış şu şekildedir: hazırlığı doğrula → herhangi bir missingAttributes topla → uyumlu bir gümrük açıklaması oluştur (ve HS kodu) → sınıflandır veya dosyala.

GraphQL API ReferenceTypes, inputs, and operations used in this guide

INPUTS

CustomsDescriptionValidationInput

MUTATIONS

customsDescriptionValidate

Demo rezervasyonu yap