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 uygun olup. 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 T-shirt 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.
mutation CustomsDescriptionValidate($input: CustomsDescriptionValidationInput!) { customsDescriptionValidate(input: $input) { id status missingAttributes content { name description material categories existingItemId } createdAt }}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
missingAttributeskullanarak tam olarak eksik olanı isteyin, bu veriler aşağı akışa akmadan önce. - Gümrük açıklaması oluştur — Bir öğe
READYolduktan sonra, aynı verilericustomsDescriptionsCreatemutasyonuna 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.
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
customsDescriptionValidatemutasyonu, 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—veri kalitesini sınırlandırarak, 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.