DOCS

Classificazione degli articoli

Classificazione degli articoli

Scopri come richiedere una classificazione nel Dashboard e tramite API.

Di seguito troverai esempi che illustrano come richiedere classificazioni universali e specifiche per paese tramite il Dashboard o tramite API. Per coloro che cercano dettagli tecnici più completi e una documentazione estesa, visita il nostro Zonos GraphQL API reference developer site. Questa risorsa completa offre approfondimenti dettagliati sugli endpoint API, le mutazioni GraphQL e informazioni tecniche estese.

Campi di input 

Sebbene sia richiesta solo una descrizione per generare una classificazione, più dettagli sul prodotto fornisci, più accurata sarà la tua classificazione. Di seguito è riportata una spiegazione completa di ciascun campo di input accettato da Classify. Comprendendo questi campi di input, puoi massimizzarne l'uso e generare classificazioni altamente accurate.

Descrizioni dei campi di input

CampoDescrizione
Nome (obbligatorio)Il nome del prodotto
Descrizione (opzionale)Una descrizione dettagliata e lunga del prodotto
URL immagine (opzionale)Link a un'immagine del prodotto. Nota: Assicurati di utilizzare un link all'URL dell'immagine effettiva e non all'URL della pagina del prodotto
Categorie (opzionale)Sottocategorie generali del prodotto, ad esempio, Abbigliamento e Accessori, Forniture per Animali, Prodotti per Ufficio o Vestiti per Bambini, Letti per Animali, Adesivi e Nastro
Materiale (opzionale)Di cosa è fatto il prodotto, ad esempio, plastica, legno, acciaio
Paese di origine (opzionale)Labbreviazione di due lettere (codice ISO) per il paese di fabbricazione o produzione del prodotto
Codice HS fornito (opzionale)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 controllarne la coerenza rispetto ai dettagli della descrizione dell'articolo. Scopri di più.
Paese di destinazione (opzionale)Identifica a quale paese il prodotto sarà classificato. Il paese di destinazione deve essere visualizzato con labbreviazione di due lettere (codice ISO) di ciascun paese e non con il nome effettivo del paese, ad esempio, AU, non Australia. Includere questo campo permetterà a Classify di restituire un codice HS specifico per paese di 8+ cifre invece del codice universale di 6 cifre. Scopri di più sulle differenze tra codici HS universali e specifici per paese.
ID prodotto (opzionale)Il tuo ID prodotto o qualsiasi numero che può essere utilizzato per identificare univocamente ciascun prodotto. Se non viene fornito un ID prodotto, Classify assegnerà ID prodotto a partire da 1

Nota: Se stai caricando il tuo CSV di richiesta in blocco nel Dashboard, il paese di destinazione non farà parte del modello, ma selezionerai i tuoi paesi di destinazione dopo aver caricato il tuo CSV di richiesta in blocco.

Richiedere una classificazione 

Per richiedere una classificazione nel Dashboard o tramite API, segui i passaggi e la mutazione qui sotto.

L'esempio qui sotto mostra una richiesta universale (6 cifre). Per richiedere classificazioni per paesi specifici, aggiungi i 'codici ISO' dei paesi nella richiesta di Classify come mostrato nell'esempio qui sotto. Per richiedere un codice HS universale, lascia il paese di destinazione null nella richiesta di Classify.

L'input accetta un elenco, quindi puoi richiedere molte o una singola classificazione alla volta.

MUTAZIONE

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
mutation {
  classificationsCalculate(
    input: [
      {
        categories: "women's clothing"
        imageUrl: "https://zonos.com/images/cozygloves.webp"
        name: "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
        configuration: { shipToCountries: KR }
      }
    ]
  ) {
    id
    name
    categories
    imageUrl
    hsCode {
      code
      description {
        full
      }
    }
  }
}

RISPOSTA

JSON

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "data": {
    "classificationsCalculate": [
      {
        "id": "classification_313d8d9d-e330-4d79-9922-cb7a1ff317e2",
        "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
        "categories": ["women's clothing"],
        "imageUrl": null,
        "hsCode": {
          "code": "6116.99.0000",
          "description": {
            "full": "Articles of apparel and clothing accessories, knitted or crocheted: Gloves, mittens and mitts, knitted or crocheted: Other : Of other textile materials"
          }
        }
      }
    ]
  }
}

Possibili risposte API

Quando Classify riceve una richiesta di classificazione, tenta di abbinare i dati dell'oggetto di input inclusi nella richiesta con un abbinamento nel database di Classify's in base al punteggio di fiducia più alto. In base a ciò che viene trovato, Classify restituirà una delle seguenti risposte:

  1. Quando viene restituito hsCode con un codice HS di 6 a 8+ cifre, a seconda che un paese di destinazione sia stato incluso o meno nella richiesta, la tua richiesta di classificazione è stata completata con successo.
  2. Quando viene restituito {"errors": [ { "message": "Nessuna risposta adeguata"}]}, ciò significa che Classify non è riuscito a trovare una classificazione a causa di informazioni di input insufficienti.

Questa pagina è stata utile?