Stati di preparazione
Ogni convalida ne restituisce uno status. The status is advisory—your integration decides the consequence of each value.
| Stato↕ | Senso↕ | Azione suggerita↕ |
|---|---|---|
READY | Le informazioni sono sufficienti per assegnare con sicurezza un codice HS a 6 cifre senza supposizioni. | Procedi con la classificazione. |
INCOMPLETE | L'oggetto è identificabile, ma manca un attributo decisivo, quindi la classificazione si baserebbe su ipotesi. | Richiedi l'attributo indicato in missingAttributes, quindi riprova. |
UNRECOGNIZABLE | Il testo non stabilisce cosa sia fondamentalmente l'elemento: valori vuoti, semplici SKU o codici interni o incomprensibili. | Chiedi all'utente di reinserire l'elemento. |
When the status is INCOMPLETE, IL missingAttributes Il campo restituisce gli attributi mancanti come una breve frase (ad es. "fiber content" O "material, construction") adatto a comporre un messaggio rivolto all'utente. È null per qualsiasi altro stato.
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 ritorna INCOMPLETE.
mutation CustomsDescriptionValidate($input: CustomsDescriptionValidationInput!) { customsDescriptionValidate(input: $input) { id status missingAttributes content { name description material categories existingItemId } createdAt }}Input fields
| Campo↕ | Tipo↕ | Descrizione↕ |
|---|---|---|
name | String | Nome dell'articolo. |
description | String | Descrizione leggibile dell'articolo. |
material | String | Materiale o composizione dell'articolo, se noto (ad es. "55% cotton, 45% polyester"). |
categories | [String!] | Categorie associate e descrittive dell'articolo. |
existingItemId | ID | ID di un esistente Item convalidare. Quando forniti, vengono utilizzati i campi dell'elemento archiviato e tutti i campi forniti qui sovrascrivono i valori archiviati. |
Fornisci uno dei due existingItemId o direttamente i campi dell'articolo: è obbligatorio almeno un campo descrittivo.
Convalida un elemento esistente
Se l'elemento esiste già in Zonos, passa il suo ID come existingItemId invece di inviare nuovamente ogni campo. I campi dell'elemento archiviato vengono utilizzati come base per la convalida e tutti i campi forniti nello stesso input sovrascrivono i valori archiviati, utili per verificare se una modifica renderebbe un oggetto sottile pronto per la classificazione.
La risposta content fa eco ai dati dell'articolo che è stato convalidato, con existingItemId risolto, quindi ciascuno memorizzato CustomsDescriptionValidation si autodescrive.
Più di un cancello di classificazione
Poiché lo stato di preparazione è consultivo, lo stesso controllo alimenta più di un flusso di lavoro: non si tratta solo di decidere se classificare. customsDescriptionValidate valuta gli stessi dati sugli articoli utilizzati dai servizi di classificazione e descrizione doganale di Zonos, il che lo rende un primo passo naturale in un contesto più ampio Descrizione doganale flusso di lavoro:
- Data-quality gate: mostra informazioni scarse o inutilizzabili sugli articoli nel punto di ingresso (in un PIM, nell'importazione di un catalogo o nel checkout) e richiede esattamente ciò che manca utilizzando
missingAttributes, prima che i dati scorrano a valle. - Genera una descrizione doganale — Una volta che un articolo è
READY, consegnare gli stessi dati alcustomsDescriptionsCreatemutazione per avere Zonos generare un conciso, personalizzato- e ICS2- descrizione doganale conforme dell'articolo, richiedendo facoltativamente un codice HS nella stessa chiamata. Convalidare innanzitutto la preparazione significa che la descrizione generata è costruita sulla base di informazioni complete anziché su ipotesi. - Classify con fiducia — Procedi a Classify sapendo che la descrizione è abbastanza ricca da poter assegnare un codice HS accurato a 6 cifre senza congetture.
Un tipico flusso end-to-end è: convalidare la disponibilità → raccogliere eventuali informazioni missingAttributes → generare una descrizione doganale conforme (e un codice HS) → classificare o archiviare.
Preparazione alla classificazione
Controlla se le informazioni di un articolo sono sufficientemente dettagliate per poterlo classificare, prima di richiedere un codice HS.
GraphQL
IL
customsDescriptionValidatela mutazione controlla se le informazioni di un elemento sono sufficienti per assegnare con sicurezza un valore di 6 cifre Codice HS, prima dell'esecuzione della classificazione. Restituisce uno stato di disponibilità a cui applichi la tua politica: procedi con la classificazione, l'avviso, chiedi all'acquirente o al commerciante maggiori dettagli o rifiuta l'articolo.È un controllo pre-volo, non una classificazione:
customsDescriptionValidatenon classifica l'oggetto e non restituisce un codice HS. Usalo per catturare in anticipo descrizioni scarse o inutilizzabili in modo che siano le descrizioni a cui eventualmente invierai Classify produrre risultati accurati e privi di ipotesi.Tuttavia, il controllo della disponibilità è solo un utilizzo. Poiché gli stessi dati sugli articoli guidano i servizi di descrizione doganale e classificazione di Zonos, questa mutazione è il punto di accesso a un sistema più ampio Descrizione doganale flusso di lavoro: verifica della qualità dei dati e quindi generazione di una descrizione doganale conforme dall'articolo. Vedere Più di un cancello di classificazione sotto.