DOCS

Prontezza di classificazione

Preparazione alla classificazione

Controlla se le informazioni di un articolo sono sufficientemente dettagliate per poterlo classificare, prima di richiedere un codice HS.

GraphQL

IL customsDescriptionValidate la 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: customsDescriptionValidate non 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.

Stati di preparazione 

Ogni convalida ne restituisce uno status. The status is advisory—your integration decides the consequence of each value.

StatoSensoAzione suggerita
READYLe informazioni sono sufficienti per assegnare con sicurezza un codice HS a 6 cifre senza supposizioni.Procedi con la classificazione.
INCOMPLETEL'oggetto è identificabile, ma manca un attributo decisivo, quindi la classificazione si baserebbe su ipotesi.Richiedi l'attributo indicato in missingAttributes, quindi riprova.
UNRECOGNIZABLEIl 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.

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}

Input fields

CampoTipoDescrizione
nameStringNome dell'articolo.
descriptionStringDescrizione leggibile dell'articolo.
materialStringMateriale o composizione dell'articolo, se noto (ad es. "55% cotton, 45% polyester").
categories[String!]Categorie associate e descrittive dell'articolo.
existingItemIdIDID 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 al customsDescriptionsCreate mutazione 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.

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

Questa pagina è stata utile?