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.
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.
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 esiste un campo Dashboard né una colonna CSV per essi.
Solo DHL
Il contrassegno delle merci pericolose riguarda solo le spedizioni DHL. Il contrassegno viene ignorato per gli altri corrieri.
Chiave attributo supportata
DANGEROUS_GOODS è una chiave attributo supportata per contrassegnare le merci pericolose DHL. Non è ancora elencata tra le chiavi approvate nel riferimento ItemAttributeInput, ma è accettata dall'API.
Per contrassegnare un prodotto, aggiungi un attributo con la chiave DANGEROUS_GOODS e un valore di una delle categorie supportate riportate di seguito.
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.
Applica automaticamente i contrassegni alle etichette
Contrassegnare un prodotto è il primo passaggio. Per fare in modo che Zonos applichi automaticamente la categoria alle etichette DHL, attiva Ship dangerous goods nelle impostazioni delle etichette. Puoi anche selezionare manualmente una categoria su una singola etichetta; consulta dichiarare merci pericolose.
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.
Le app Zonos Duty & Tax non supportano restrizioni a livello di articolo che rimuovono prodotti specifici dagli ordini internazionali. Se nel carrello è presente un articolo soggetto a restrizioni, l'intero carrello deve essere bloccato per la spedizione verso quel Paese. Questo viene gestito tramite una regola di restrizione a livello di carrello, che deve essere configurata in anticipo durante l'onboarding. Sebbene Catalog sia compatibile con le app Duty & Tax, le restrizioni a livello di articolo sono supportate solo quando utilizzi Zonos Checkout.
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.
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 semplicemente ALL come valore. Se vuoi limitare tutti i Paesi tranne uno o alcuni, inserisci ALL- seguito dai Paesi che desideri escludere dalla limitazione, separati da barre verticali, ad esempio ALL-CA|FR|US. Scopri di più sulla formattazione CSV. Se desideri rimuovere tutti i Paesi soggetti a restrizioni esistenti, inserisci NONE come 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.
Se utilizzi 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.
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 mutationCatalogItemsCreate.
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.
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.
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
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Gestire i prodotti
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.
Creare un prodotto
Crea un prodotto in Catalog:
Crea più prodotti in Catalog:
Carica più prodotti o l'intero catalogo prodotti in una sola volta.
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/valuesul prodotto. Gli attributi vengono impostati tramite API (catalogItemsCreateocatalogItemsUpdate); non esiste un campo Dashboard né una colonna CSV per essi.Il contrassegno delle merci pericolose riguarda solo le spedizioni DHL. Il contrassegno viene ignorato per gli altri corrieri.
DANGEROUS_GOODSè una chiave attributo supportata per contrassegnare le merci pericolose DHL. Non è ancora elencata tra le chiavi approvate nel riferimentoItemAttributeInput, ma è accettata dall'API.Per contrassegnare un prodotto, aggiungi un attributo con la chiave
DANGEROUS_GOODSe 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 }idnameskuattributeskeyvalueValori delle merci pericolose supportati
NOT_RESTRICTED_A70NOT_RESTRICTED_A67NOT_RESTRICTED_A02LIMITED_QUANTITYEXCEPTED_QUANTITYCONSUMER_COMMODITYMAGNETIZED_MATERIALBIOLOGICAL_SUBSTANCEContrassegnare un prodotto è il primo passaggio. Per fare in modo che Zonos applichi automaticamente la categoria alle etichette DHL, attiva Ship dangerous goods nelle impostazioni delle etichette. Puoi anche selezionare manualmente una categoria su una singola etichetta; consulta dichiarare merci pericolose.
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.
Catalog sovrascriverà i campi esistenti con nuovi valori.
Catalog non sovrascriverà i valori esistenti con campi vuoti.
Per modificare un prodotto:
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:
Per eliminare tutti i prodotti:
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.
Le app Zonos Duty & Tax non supportano restrizioni a livello di articolo che rimuovono prodotti specifici dagli ordini internazionali. Se nel carrello è presente un articolo soggetto a restrizioni, l'intero carrello deve essere bloccato per la spedizione verso quel Paese. Questo viene gestito tramite una regola di restrizione a livello di carrello, che deve essere configurata in anticipo durante l'onboarding. Sebbene Catalog sia compatibile con le app Duty & Tax, le restrizioni a livello di articolo sono supportate solo quando utilizzi Zonos Checkout.
Per limitare un singolo prodotto in Catalog:
Per limitare più prodotti in Catalog:
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.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.
Se utilizzi 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:
Per cercare il nome di un prodotto:
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:
Per esportare tutti i prodotti:
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:
Classificare un prodotto
Puoi classificare un prodotto del catalogo tramite API utilizzando
catalogItemIdnella mutationClassificationsCreateFromCatalog.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
ClassificationsCreateFromCatalogriportata di seguito alla mutationCatalogItemsCreate.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 fornitoshipToCountries, 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
shipToCountriesviene fornito per generare un codice specifico per il Canada.mutation ClassificationsCreateFromCatalog($catalogItemToClassify: [ClassificationFromCatalogInput!]!) {classificationsCalculateFromCatalog(input: $catalogItemToClassify) {idconfiguration {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
digital_goodephysical_good. Se il prodotto è un bene fisico, il caso più comune, lascia vuoto questo campo.ships_aloneeconsolidated. Se il prodotto può essere consolidato con altri prodotti, puoi lasciare il campo vuoto poichéconsolidatedè il valore predefinito.ItemAttributeInput
Questa pagina è stata utile?