Creare un prodotto
Crea un prodotto in Catalog:
- Vai a Catalog e fai clic su Add product nell'angolo in alto a destra.
- Aggiungi i dettagli del prodotto. L'unico campo obbligatorio per creare un prodotto è il campo SKU e/o ID prodotto. Questi campi verranno utilizzati per fare riferimento ai tuoi prodotti del catalogo. Scopri di più sugli identificatori di Catalog.
- Facoltativo: aggiungi i codici HS.
- Facoltativo: aggiungi le informazioni di spedizione (peso, dimensioni, unità di misura e così via).
- Facoltativo: aggiungi i Paesi soggetti a restrizioni.
- Fai clic su save product.
Crea più prodotti in Catalog:
Carica più prodotti o l'intero catalogo prodotti in una sola volta.
Importante: se tenti di creare un prodotto già esistente, Catalog riconoscerà il prodotto in base a SKU e/o ID prodotto e sovrascriverà i dettagli del prodotto originale con quelli nuovi.
Contrassegnare un prodotto come merce pericolosa (DHL)
Per le spedizioni DHL, puoi contrassegnare un prodotto come merce pericolosa affinché il corretto servizio a valore aggiunto DHL venga applicato automaticamente ogni volta che crei un'etichetta per quel prodotto. Questa funzione riguarda le classi di merci regolamentate a "basso rischio" o esenti: articoli tecnicamente regolamentati, ma spediti secondo una disposizione speciale o un'esenzione per quantità.
Un contrassegno di merce pericolosa viene memorizzato come attributo dell'articolo del catalogo: una coppia key/value sul prodotto. Gli attributi vengono impostati tramite API (catalogItemsCreate o catalogItemsUpdate); non esistono un campo Dashboard o una colonna CSV per essi.
Per contrassegnare un prodotto, aggiungi un attributo con la chiave DANGEROUS_GOODS e un valore di una delle categorie supportate riportate di seguito.
mutation CatalogItemsCreate($sku: String!$name: String$attributes: [ItemAttributeInput!]) { catalogItemsCreate( input: [{ sku: $sku, name: $name, attributes: $attributes }] id name sku attributes key valueValori delle merci pericolose supportati
| Valore↕ | Categoria↕ |
|---|---|
NOT_RESTRICTED_A70 | Non soggetto a restrizioni, disposizione speciale A70: articoli pressurizzati, come molle a gas e ammortizzatori (UN3164). |
NOT_RESTRICTED_A67 | Non soggetto a restrizioni, disposizione speciale A67: motori o macchinari alimentati da liquido infiammabile (UN3528). |
NOT_RESTRICTED_A02 | Non soggetto a restrizioni, disposizione speciale A02: esente ai sensi della disposizione ADR per piccoli carichi stradali. |
LIMITED_QUANTITY | Quantità limitata (ADR): merci pericolose imballate in piccole quantità entro i limiti normativi. |
EXCEPTED_QUANTITY | Quantità esente (IATA): quantità molto ridotte esenti dalla maggior parte delle norme sulle merci pericolose nel trasporto aereo. |
CONSUMER_COMMODITY | Merce di consumo ID8000: prodotti di uso quotidiano pronti per la vendita al dettaglio con contenuto pericoloso minore, come aerosol e profumi. |
MAGNETIZED_MATERIAL | Materiale magnetizzato (UN2807): articoli con un campo magnetico abbastanza forte da influire sugli strumenti degli aeromobili. |
BIOLOGICAL_SUBSTANCE | Sostanza biologica (UN3373): sostanze biologiche di categoria B, come campioni diagnostici o clinici. |
Modificare un prodotto
La modifica dei prodotti ti permette di aggiornare in modo efficiente i prodotti esistenti con informazioni aggiuntive o aggiornate. Invece di eliminare e ricaricare il prodotto, puoi caricare le informazioni aggiornate e Catalog le assocerà al prodotto esistente tramite SKU o ID prodotto, in base alla preferenza della chiave articolo. In questo modo puoi mantenere aggiornato il catalogo con il minimo sforzo, sia che utilizzi Dashboard o l'API per creare nuovi prodotti o modificare quelli esistenti.
Se crei o modifichi un prodotto del catalogo già esistente in Catalog, tieni presente quanto segue:
Catalog scriverà nei campi vuoti degli articoli esistenti.
- Ad esempio, se un prodotto esistente, SKU 321, non aveva un valore per il peso e lo stesso prodotto, SKU 321, aveva un peso di 1,3 lb nel nuovo caricamento, il peso di 1,3 lb sovrascriverà il campo precedentemente vuoto.
Catalog sovrascriverà i campi esistenti con nuovi valori.
- Ad esempio, se un prodotto esistente, SKU 123, aveva un prezzo di 18,99 USD e lo stesso prodotto, SKU 123, aveva un prezzo aggiornato di 22,99 USD, il nuovo prezzo di 22,99 USD sovrascriverà quello precedente.
Catalog non sovrascriverà i valori esistenti con campi vuoti.
- Ad esempio, se un prodotto esistente, SKU 456, aveva un codice HS di 6109.10, ma il codice HS del prodotto aggiornato, SKU 456, è vuoto, il codice HS esistente rimane.
Per modificare un prodotto:
- Fai clic sulla scheda Products.
- Seleziona il prodotto che desideri modificare.
- Apporta le modifiche.
- Fai clic su save product.
Per modificare più prodotti o tutti i prodotti contemporaneamente, carica semplicemente un file CSV aggiornato in Catalog, includendo SKU o ID prodotto. Ciò attiverà aggiornamenti automatici agli articoli esistenti.
Eliminare un prodotto
Per eliminare un prodotto:
- Fai clic sulla scheda Products in Dashboard.
- Seleziona i prodotti che desideri eliminare. Dopo aver selezionato i prodotti, verrà visualizzato un pulsante di eliminazione.
- Fai clic su Delete e quindi su Delete all per confermare l'eliminazione.
Per eliminare tutti i prodotti:
- Seleziona la scheda Products in Dashboard.
- Fai clic su Manage Catalog nell'angolo in alto a destra e quindi su Delete all.
- Fai clic nuovamente su Delete all per confermare l'eliminazione.
Tieni presente che se elimini una grande quantità di articoli (oltre 20.000 prodotti circa), verrà visualizzata una notifica che indica che l'eliminazione è in corso. Durante questo periodo, non potrai interagire con Catalog finché l'eliminazione non sarà completata. Tuttavia, puoi chiudere la notifica e uscire dalla pagina senza interrompere il processo di eliminazione.
Limitare un prodotto
Se desideri impedire le spedizioni verso uno o più Paesi, puoi aggiungere restrizioni quando crei o aggiorni un prodotto.
Per limitare un singolo prodotto in Catalog:
- Fai clic sulla scheda Products.
- Seleziona il prodotto a cui desideri aggiungere una restrizione per aprire la pagina di modifica.
- Individua la sezione Restricted countries nella parte inferiore della pagina di modifica.
- Aggiungi i Paesi verso cui desideri limitare il prodotto selezionando o digitando i nomi dei Paesi.
- Fai clic su save product.
Per limitare più prodotti in Catalog:
- Fai clic sulla scheda Import/export.
- Scarica il modello CSV di Catalog.
- Compila il modello con i dettagli dei prodotti, inclusi SKU/ID prodotto e Paesi soggetti a restrizioni. Inserisci il codice ISO di due lettere separato da barre verticali, ad esempio
AU|KR|MY|SG. Per limitare tutti i Paesi, inserisci semplicementeALLcome valore. Se vuoi limitare tutti i Paesi tranne uno o alcuni, inserisciALL-seguito dai Paesi che desideri escludere dalla limitazione, separati da barre verticali, ad esempioALL-CA|FR|US. Scopri di più sulla formattazione CSV. Se desideri rimuovere tutti i Paesi soggetti a restrizioni esistenti, inserisciNONEcome valore. - Salva il file come CSV e caricalo in Catalog trascinandolo oppure selezionandolo facendo clic su browse nella stessa pagina da cui hai scaricato il CSV.
- Esamina i prodotti caricati nella schermata di anteprima e fai clic su upload.
Filtrare i prodotti soggetti a restrizioni:
Puoi filtrare i prodotti soggetti a restrizioni direttamente nel catalogo scaricando l'intero catalogo in formato CSV da Dashboard e aprendolo in Excel o Google Sheets. Da lì, puoi utilizzare la funzione di filtro per visualizzare solo i prodotti soggetti a restrizioni. In questo modo puoi individuare e gestire facilmente i prodotti soggetti a restrizioni nel catalogo.
Se devi aggiornare il catalogo dopo aver apportato modifiche al CSV, ricarica il file e tutti i prodotti corrispondenti verranno sostituiti con la versione aggiornata. Questa operazione viene eseguita identificando e associando SKU e/o ID prodotto.
If you're using Checkout, verrà visualizzato un messaggio di restrizione nel checkout quando un prodotto è soggetto a restrizioni nel Paese del cliente. Per impostazione predefinita, il messaggio indicherà: "Questo articolo non può essere importato nel tuo Paese."
Filtrare un prodotto
Puoi cercare i prodotti in Catalog tramite Dashboard o API usando SKU, ID prodotto o nome del prodotto. Per le ricerche per SKU e ID prodotto, verranno restituiti risultati solo per corrispondenze esatte; le corrispondenze parziali non sono supportate. Per la ricerca per nome del prodotto, invece, sono supportate le corrispondenze parziali.
Per filtrare per SKU o ID prodotto:
- Fai clic sulla scheda Products in Dashboard.
- Seleziona SKU o Product ID nell'angolo in alto a sinistra di Catalog.
- Inserisci SKU, ID prodotto o nome del prodotto.
- Fai clic su Apply per visualizzare i prodotti filtrati.
Per cercare il nome di un prodotto:
- Fai clic sulla scheda Products in Dashboard.
- Nell'angolo in alto a destra di Catalog, digita il nome del prodotto nel campo di ricerca.
- Visualizza i prodotti filtrati.
Esportare i prodotti
Se selezioni 50 articoli o meno dalla tabella Catalog, il catalogo verrà scaricato direttamente da Dashboard. Tuttavia, se selezioni Export all o più di 50 articoli, il CSV verrà esportato via email.
Per esportare 50 articoli o meno, segui questi passaggi:
- Seleziona 50 articoli o meno direttamente dalla tabella Catalog.
- Fai clic su Export nell'angolo in alto a destra.
- Individua il file CSV nella posta in arrivo.
Per esportare tutti i prodotti:
- Vai a Dashboard -> Products -> Catalog.
- Fai clic sul menu a discesa Manage Catalog accanto a Add product, quindi fai clic su Export all.
- Trova il file del catalogo nei download.
Problemi nel download dall'email?
Se riscontri problemi nel download del CSV dal link nell'email, il browser potrebbe bloccare il download. In tal caso, segui questi passaggi:
- Fai clic con il pulsante destro del mouse sul pulsante "Download" nell'email.
- Seleziona "Copy link address" per copiare l'URL di download.
- Incolla l'URL copiato nel browser e premi Invio.
- Il catalogo verrà quindi scaricato direttamente dal browser.
Classificare un prodotto
Puoi classificare un prodotto del catalogo tramite API utilizzando catalogItemId nella mutation ClassificationsCreateFromCatalog.
Tieni presente che per classificare un prodotto del catalogo è obbligatorio un name. Consulta il riferimento dell'API GraphQL per un elenco completo dei campi del catalogo e della classificazione.
Per creare e classificare contemporaneamente un prodotto del catalogo, aggiungi la mutation ClassificationsCreateFromCatalog riportata di seguito alla mutation CatalogItemsCreate.
Classificare un prodotto del catalogo a 8+ cifre (specifico per Paese)
Quando il campo shipToCountries è compilato, la classificazione sarà un codice HS a 8+ cifre (specifico per Paese). Se non viene fornito shipToCountries, la classificazione utilizzerà per impostazione predefinita un codice HS a 6 cifre (universale). Scopri di più sulle differenze tra codici HS universali e specifici per Paese.
Nell'esempio seguente, il campo shipToCountries viene fornito per generare un codice specifico per il Canada.
mutation ClassificationsCreateFromCatalog($catalogItemToClassify: [ClassificationFromCatalogInput!]!) { classificationsCalculateFromCatalog(input: $catalogItemToClassify) { id configuration { shipToCountries } hsCode { code } name }}Ecco un esempio di richiesta. Sebbene Zonos Classify generi una classificazione con un solo name, consigliamo vivamente di aggiungere il maggior numero possibile di dettagli per ottenere i migliori risultati di classificazione.
{ "catalogItemToClassify": [ { "catalogItemId": "catalog_item_893jkdkllg03k9khjd9", "configuration": { "shipToCountries": [ "CA" ] } } ]}Errori API e soluzioni
| Errore↕ | Soluzione↕ |
|---|---|
| A SKU or product ID is required to create a product | Per creare, modificare o eliminare un articolo del catalogo è obbligatorio un identificatore (SKU/ID prodotto). Per risolvere il problema, aggiungi uno SKU e/o un ID prodotto. |
| The product you are trying to edit does not exist* | Non puoi modificare un prodotto che non esiste. Per risolvere il problema, crea un nuovo prodotto con lo SKU e/o l'ID prodotto desiderati. |
| Customs description exceeds character limit of 30 characters. | Per impostazione predefinita, le descrizioni doganali sono limitate a 30 caratteri, in linea con il limite più comune per le fatture commerciali. |
| Product type invalid. Catalog supports the following product types: digital_good. For physical goods, leave it blank. | Catalog supporta solo i seguenti tipi di prodotto: digital_good e physical_good. Se il prodotto è un bene fisico, il caso più comune, lascia vuoto questo campo. |
| Packing preference invalid. Catalog supports the following packing preferences: ships_alone and consolidated. If your product can be consolidated with other products, leave blank. | Preferenza di imballaggio non valida. Catalog supporta le seguenti preferenze di imballaggio: ships_alone e consolidated. Se il prodotto può essere consolidato con altri prodotti, puoi lasciare il campo vuoto poiché consolidated è il valore predefinito. |
| Country must be specified when providing an HS code | Se fornisci un codice HS specifico per Paese durante la creazione di un articolo, è obbligatorio indicare il Paese di destinazione. Per risolvere il problema, aggiungi un Paese di destinazione. |
| Price must be greater than 0 | Catalog non supporta valori di prezzo negativi. Per risolvere il problema, aggiungi un prezzo maggiore di zero. |
| Currency code must be provided when a price value is supplied | Se fornisci un prezzo, è obbligatorio un codice valuta. Per risolvere il problema, aggiungi un codice valuta. |
| Price must be provided when a currency code is supplied | Se fornisci un codice valuta, è obbligatorio un prezzo. Per risolvere il problema, aggiungi un prezzo. |
| The accompanying dimensional field cannot be left blank | Se viene fornito un campo dimensionale, sono obbligatori anche gli altri due; ad esempio, se fornisci una larghezza di 8 inches, sono obbligatorie anche altezza e lunghezza. |
| Measurement value must be greater than 0 | Catalog non supporta valori di misura negativi o pari a zero. Per risolvere il problema, aggiungi un valore maggiore di zero. |
| When providing a dimensional value, dimensional units cannot be left empty | Se fornisci un valore dimensionale, è obbligatoria un'unità dimensionale. Per risolvere il problema, aggiungi un'unità dimensionale. |
| When providing a weight value, the weight unit cannot be left empty | Se fornisci un valore di peso, è obbligatoria un'unità di peso. Per risolvere il problema, aggiungi un'unità di peso. |
* Solo errore API
Gestire Catalog
Crea e modifica i prodotti.Scopri come aggiungere, modificare ed eliminare i tuoi prodotti Zonos Catalog in Dashboard o tramite API. Usa Catalog in Dashboard per evitare di scrivere codice o per apportare piccole modifiche. Se vuoi integrare direttamente Catalog nelle implementazioni di produzione, usa l'API.