Idoneità alla classificazione

La mutazione customsDescriptionValidate verifica se le informazioni di un articolo sono sufficienti per assegnare con sicurezza un codice HS a 6 cifre, prima dell'esecuzione della classificazione. Restituisce uno stato di idoneità a cui applichi la tua policy: procedere con la classificazione, avvisare, chiedere all'acquirente o al commerciante maggiori dettagli, oppure rifiutare l'articolo.

È un controllo preliminare, non una classificazione: customsDescriptionValidate non classifica l'articolo e non restituisce un codice HS. Usalo per individuare in anticipo descrizioni scarne o inutilizzabili, in modo che le descrizioni che invii in seguito a Classify producano risultati accurati e privi di supposizioni.

Il controllo di idoneità, tuttavia, è solo uno degli usi possibili. Poiché gli stessi dati dell'articolo alimentano i servizi di descrizione doganale e di classificazione di Zonos, questa mutazione è il punto d'ingresso di un flusso di lavoro più ampio di Descrizione doganale: un controllo della qualità dei dati seguito dalla generazione di una descrizione doganale conforme per l'articolo. Vedi Più di un semplice filtro di classificazione di seguito.

Stati di idoneità 

Ogni convalida restituisce un singolo status. Lo stato è indicativo: è la tua integrazione a decidere la conseguenza di ciascun valore.

Quando lo stato è INCOMPLETE, il campo missingAttributes restituisce l'attributo o gli attributi mancanti come una breve frase (ad es. "fiber content" o "material, construction"), adatta a comporre un messaggio rivolto all'utente. Per qualsiasi altro stato, il valore è null.

Convalida un articolo tramite API 

Fornisci direttamente i campi dell'articolo: è obbligatorio almeno un campo descrittivo. L'esempio seguente convalida un articolo il cui nome e descrizione lo identificano come una maglietta ma omettono il contenuto di fibre necessario per classificarlo, quindi la mutazione restituisce INCOMPLETE.

Campi di input

Fornisci existingItemId oppure direttamente i campi dell'articolo: è obbligatorio almeno un campo descrittivo.

Convalida un articolo esistente 

Se l'articolo esiste già in Zonos, passa il suo ID come existingItemId invece di inviare nuovamente ogni campo. I campi dell'articolo memorizzato vengono utilizzati come base per la convalida, e gli eventuali campi che fornisci nello stesso input sovrascrivono i valori memorizzati: utile per verificare se una modifica renderebbe pronto per la classificazione un articolo con informazioni scarne.

La risposta content riporta i dati dell'articolo che è stato convalidato, con existingItemId risolto, quindi ogni CustomsDescriptionValidation memorizzata è autoesplicativa.

Più di un semplice filtro di classificazione 

Poiché lo stato di idoneità è indicativo, lo stesso controllo alimenta più di un flusso di lavoro: non si tratta solo di decidere se classificare. customsDescriptionValidate valuta gli stessi dati dell'articolo utilizzati dai servizi di classificazione e di descrizione doganale di Zonos, il che lo rende un primo passo naturale in un più ampio flusso di lavoro di Descrizione doganale:

• Filtro di qualità dei dati — Individua informazioni scarne o inutilizzabili sull'articolo nel punto di ingresso (in un PIM, in un'importazione di catalogo o nel checkout) e richiedi esattamente ciò che manca tramite missingAttributes, prima che questi dati proseguano a valle.
• Genera una descrizione doganale — Una volta che un articolo è READY, invia gli stessi dati alla mutazione customsDescriptionsCreate per far generare a Zonos una descrizione doganale concisa, conforme alle normative doganali e a ICS2, a partire dall'articolo, richiedendo facoltativamente un codice HS nella stessa chiamata. Convalidare prima l'idoneità significa che la descrizione generata si basa su informazioni complete anziché su supposizioni.
• Classify con sicurezza — Procedi a Classify sapendo che la descrizione è sufficientemente ricca da consentire di assegnare un codice HS accurato a 6 cifre senza congetture.

Un tipico flusso end-to-end è: convalida l'idoneità → raccogli eventuali missingAttributes → genera una descrizione doganale conforme (ed eventualmente un codice HS) → classifica o archivia.