Scopri come richiedere una classificazione in Dashboard e tramite API.
Di seguito troverai esempi che illustrano come richiedere classificazioni universali e specifiche per paese tramite Dashboard o tramite API. Per chi cerca dettagli tecnici più completi e documentazione estesa, visitare il nostro Zonos GraphQL API sito sviluppatore di riferimento. Questa risorsa completa offre approfondimenti dettagliati sugli endpoint API, sulle mutazioni GraphQL e informazioni tecniche approfondite.
Anche se per generare una classificazione è necessaria solo una descrizione, maggiori sono i dettagli del prodotto forniti, più accurata sarà la classificazione. In alternativa, puoi semplicemente fornire l'URL del prodotto e Classify estrarrà automaticamente tutti i dettagli rilevanti dell'articolo per te. Di seguito è riportata una spiegazione completa di ciascun campo di input accettato da Classify. Comprendendo questi campi di input, è possibile massimizzarne l'utilizzo e generare classificazioni estremamente accurate.
Descrizioni dei campi di input
Campo↕
Descrizione↕
Nome (richiesto)
Il nome del prodotto
URL del prodotto (facoltativo)
Incolla l'URL di un prodotto e Classify recupererà automaticamente la pagina ed estrarrà i dettagli rilevanti dell'articolo (nome, descrizione, categorie, ecc.) per la classificazione. Disponibile in Dashboard facendo clic sull'icona + o aggiungendo direttamente nel campo di testo principale. Per le integrazioni API, contatta il tuo rappresentante Zonos. Sebbene siano ideali per dimostrazioni e test, le implementazioni di produzione raggiungono prestazioni ottimali ed efficienza in termini di costi trasmettendo i dati degli articoli direttamente dai sistemi back-end.
Descrizione (facoltativa)
Una descrizione approfondita e lunga del prodotto
URL immagine (facoltativo)
Collegamento a un'immagine del prodotto. Nota: assicurati di utilizzare un collegamento all'URL dell'immagine effettiva e non all'URL della pagina del prodotto
Categorie (facoltativo)
Sottocategorie generali di prodotti, ad esempio Abbigliamento e accessori, Articoli per animali, Prodotti per ufficio o Vestiti per neonati, cucce per animali, adesivi e nastri
Materiale (facoltativo)
Di cosa è fatto il prodotto, ad esempio plastica, legno, acciaio
Includi un codice HS esistente nella tua richiesta di classificazione per guidare la tua richiesta. A seconda delle tue preferenze e dell'origine del codice HS fornito, Classify può convalidare il codice HS e verificarne la coerenza rispetto ai dettagli della descrizione dell'articolo. Saperne di più.
Paese di destinazione (facoltativo)
Identifica in quale paese verrà classificato il prodotto. Il paese di destinazione deve essere visualizzato insieme a quello di ciascun paese abbreviazione di due lettere (codice ISO) e non il nome effettivo del paese, ad esempio AU, non Australia. L'inclusione di questo campo consentirà a Classify di restituire un codice HS specifico per paese di oltre 8 cifre invece del codice universale a 6 cifre. Scopri di più sulle differenze tra codici HS universali e specifici per paese.
ID prodotto (facoltativo)
Il tuo ID prodotto o qualsiasi numero che possa essere utilizzato per identificare in modo univoco ciascun prodotto. Se non viene fornito un ID prodotto, Classify assegnerà gli ID prodotto che iniziano con 1
Nota: Se stai caricando il tuo CSV di richiesta in blocco in Dashboard, il paese di destinazione non farà parte del modello; piuttosto, selezionerai i paesi di destinazione dopo aver caricato il CSV di richiesta in blocco.
Per richiedere una classificazione in Dashboard o tramite API, seguire i passaggi e la mutazione di seguito.
L'esempio seguente mostra una richiesta universale (6 cifre). Per richiedere classificazioni per paesi specifici, aggiungere i codici ISO dei paesi nella richiesta Classify come mostrato nell'esempio seguente. Per richiedere un codice universale HS, lascia il paese di destinazione della spedizione null nella richiesta Classify.
L'input accetta un elenco in modo da poter richiedere più o una singola classificazione contemporaneamente.
Nota: Per generare piste di controllo tramite API, includi il campo auditTrail nella tua query. Contatta il tuo rappresentante Zonos per i dettagli di accesso e implementazione.
Quando Classify riceve una richiesta di classificazione, tenta di abbinare i dati dell'elemento di input inclusi nella richiesta con una corrispondenza nel database di Classify in base al punteggio di confidenza più alto. In base a quanto trovato, Classify restituirà una delle seguenti risposte:
Quando hsCode viene restituito con un codice HS da 6 a 8+ cifre, a seconda che nella richiesta sia stato incluso o meno un paese di spedizione, la richiesta di classificazione ha avuto esito positivo.
Quando {"errors": [ { "message": "No adequate response"}]} viene restituito, ciò significa che Classify non è riuscito a trovare una classificazione a causa di informazioni di input insufficienti.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Classificazione degli articoli
Classificazione degli articoli
Scopri come richiedere una classificazione in Dashboard e tramite API.
Di seguito troverai esempi che illustrano come richiedere classificazioni universali e specifiche per paese tramite Dashboard o tramite API. Per chi cerca dettagli tecnici più completi e documentazione estesa, visitare il nostro Zonos GraphQL API sito sviluppatore di riferimento. Questa risorsa completa offre approfondimenti dettagliati sugli endpoint API, sulle mutazioni GraphQL e informazioni tecniche approfondite.
Campi di immissione
Anche se per generare una classificazione è necessaria solo una descrizione, maggiori sono i dettagli del prodotto forniti, più accurata sarà la classificazione. In alternativa, puoi semplicemente fornire l'URL del prodotto e Classify estrarrà automaticamente tutti i dettagli rilevanti dell'articolo per te. Di seguito è riportata una spiegazione completa di ciascun campo di input accettato da Classify. Comprendendo questi campi di input, è possibile massimizzarne l'utilizzo e generare classificazioni estremamente accurate.
Descrizioni dei campi di input
Richiedi una classificazione
Per richiedere una classificazione in Dashboard o tramite API, seguire i passaggi e la mutazione di seguito.
L'esempio seguente mostra una richiesta universale (6 cifre). Per richiedere classificazioni per paesi specifici, aggiungere i codici ISO dei paesi nella richiesta Classify come mostrato nell'esempio seguente. Per richiedere un codice universale HS, lascia il paese di destinazione della spedizione
nullnella richiesta Classify.L'input accetta un elenco in modo da poter richiedere più o una singola classificazione contemporaneamente.
mutation ClassifyItems($input: [ClassificationCalculateInput!]!) {classificationsCalculate(input: $input) {idnamecategoriesimageUrlhsCode {codedescription {full}}}}Possibili risposte API
Quando Classify riceve una richiesta di classificazione, tenta di abbinare i dati dell'elemento di input inclusi nella richiesta con una corrispondenza nel database di Classify in base al punteggio di confidenza più alto. In base a quanto trovato, Classify restituirà una delle seguenti risposte:
hsCodeviene restituito con un codice HS da 6 a 8+ cifre, a seconda che nella richiesta sia stato incluso o meno un paese di spedizione, la richiesta di classificazione ha avuto esito positivo.{"errors": [ { "message": "No adequate response"}]}viene restituito, ciò significa che Classify non è riuscito a trovare una classificazione a causa di informazioni di input insufficienti.ClassificationCalculateInput
classificationsCalculate
Questa pagina è stata utile?