Come compilare correttamente il CSV di Zonos Catalog in Dashboard?

Quando compili il modello CSV di Catalog, l'unico campo obbligatorio è `sku` o `productId`, in base al tuo `itemKeyPreference`. Se il file contiene duplicati dello stesso prodotto in base alla preferenza della chiave articolo, viene creato un prodotto la prima volta e poi aggiornato con dettagli nuovi o aggiuntivi, se applicabile. Dopo aver compilato il modello con i dettagli dei prodotti, carica il CSV in Catalog.

Quali sono le descrizioni dei campi del CSV di Catalog?

I campi del CSV di Catalog includono SKU, ID prodotto, nome, descrizione, unità di peso, peso, unità dimensionali, lunghezza, larghezza, altezza, Paesi con restrizioni, bene digitale, Paese di origine, codice HS, Paese di destinazione del codice HS, URL immagine, materiale, marchio, prezzo e valuta.

Quali errori potrei riscontrare quando importo i prodotti del catalogo?

Potresti riscontrare errori relativi alle dimensioni e al formato del file, intestazioni di colonna mancanti o non riconosciute, SKU o ID prodotto mancanti, unità di peso o dimensionali non valide, valori di peso, lunghezza, larghezza o altezza non validi, unità di peso o dimensionali mancanti quando vengono forniti valori, Paese di destinazione mancante per un codice HS specifico per Paese, Paesi di destinazione o codici valuta non validi e campi dimensionali mancanti quando ne viene fornito uno.

HomeEcommerce globale Catalog Importazione CSV prodotti

Importazione CSV Catalog

Importa in blocco i tuoi prodotti in Catalog.

L'importazione in blocco di Zonos Catalog consente di importare l'intero catalogo in una sola volta. Quando compili il modello CSV di Catalog, l'unico campo obbligatorio per ogni prodotto è uno SKU o ID prodotto. Se il file contiene duplicati dello stesso prodotto in base allo SKU e all'ID prodotto, Catalog crea il prodotto la prima volta e poi, se pertinente, i dettagli del prodotto vengono aggiornati con informazioni nuove o supplementari per i prodotti duplicati.

Importa prodotti

Vai a Dashboard -> Prodotti -> Catalog.
Fai clic su Gestisci Catalog nell'angolo in alto a destra. Quindi, seleziona Importa prodotti dal menu a discesa.
Scarica il modello CSV di Catalog facendo clic su modello CSV di esempio.
Abbina i dettagli dei tuoi prodotti ai campi del modello CSV di Zonos. Usa la tabella seguente per assicurarti di utilizzare i valori e le informazioni corretti nei campi più adatti.
1. Per i campi/le colonne che non utilizzi, lasciali vuoti. Puoi anche eliminarli, ma non è necessario.
Salva il file come CSV.
Carica il nuovo file CSV in Catalog trascinandolo oppure facendo clic su sfoglia per trovare e selezionare il file. Tieni presente che la dimensione massima del file per il caricamento in Catalog è 50 MB.
Segui le istruzioni per esaminare i prodotti caricati e correggere i campi in caso di errori.
Fai clic su Importa.

Requisiti dei campi

È necessario un solo campo per importare un prodotto: uno SKU o un ID prodotto, a seconda della tua preferenza di chiave articolo. Tutte le altre colonne possono essere lasciate vuote.

Tuttavia, più dettagli fornisci sul prodotto, migliori saranno i risultati. Dati di prodotto completi migliorano l'accuratezza del Landed cost, la classificazione del codice HS e lo sdoganamento, e riducono le probabilità di ritardi o addebiti imprevisti per i tuoi clienti. Ti consigliamo di compilare ogni campo per cui disponi di dati, anche se è richiesto solo un identificatore.

Campi condizionalmente obbligatori

Alcuni campi sono facoltativi di per sé, ma diventano obbligatori non appena utilizzi un campo correlato.

Se fornisci↕	Devi fornire anche↕
Peso	Unità di peso
Unità di peso	Peso
Lunghezza, larghezza o altezza	Tutte e tre le dimensioni e un'unità dimensionale
Unità dimensionale	Lunghezza, larghezza e altezza
Prezzo	Valuta
Volume o gradazione alcolica	Volume e unità volumetrica
Codice HS specifico per Paese	Il Paese a cui si applica, nel formato `Country code=HS code`

Nota: il peso predefinito è pound e le dimensioni predefinite sono inch, ma questi valori predefiniti si applicano solo se lasci vuoti sia il valore sia la relativa unità. Se fornisci un peso o una dimensione senza la relativa unità, l'importazione non riesce.

Nota: se utilizzi inclusive pricing, per ogni prodotto sono richiesti un prezzo e una valuta, e la valuta deve corrispondere alla valuta nativa della tua organizzazione.

Descrizioni dei campi CSV

La colonna Obbligatorio indica se un campo è obbligatorio, facoltativo o condizionalmente obbligatorio in base ad altri campi che fornisci.

Colonna↕	Obbligatorio↕	Descrizione↕
SKU	Obbligatorio*	Il codice che identifica il prodotto all'interno della tua azienda, ad esempio GRLS-GRPHC-BBT-T-S
ID prodotto	Obbligatorio*	L'identificatore del prodotto, comunemente l'ID della tua piattaforma di e-commerce, ad esempio 254678901
Nome	Facoltativo	Il nome del prodotto, ad esempio T-shirt grafica da bambina
Descrizione	Facoltativo	La descrizione dettagliata completa del prodotto, ad esempio Scopri un comfort e una raffinatezza senza pari con la nostra camicia Premium in poliestere, realizzata meticolosamente per valorizzare gli elementi essenziali del tuo guardaroba. Progettata per le persone moderne, questa camicia vanta un'estetica elegante e versatile, perfetta sia per contesti informali sia formali.
Descrizione doganale	Facoltativo	Breve descrizione del prodotto per la fattura commerciale. Limite di 30 caratteri, ad esempio Camicia da bambina, 100% poliestere
Unità di peso	Condizionale	L'unità di peso del prodotto. Se non viene fornita un'unità, il valore predefinito sarà `pound`. I valori validi sono `gram`, `kilogram`, `pound` e `ounce`.
Peso	Condizionale	Il peso del prodotto. Il valore del peso deve essere un numero positivo.
Unità dimensionale	Condizionale	L'unità dimensionale del prodotto. Se non viene fornita un'unità, il valore predefinito sarà `inch`. I valori validi sono `inch`, `foot`, `yard`, `millimeter`, `centimeter` e `meter`.
Lunghezza	Condizionale	La lunghezza del prodotto. Il valore della lunghezza deve essere un numero positivo.
Larghezza	Condizionale	La larghezza del prodotto. Il valore della larghezza deve essere un numero positivo.
Altezza	Condizionale	L'altezza del prodotto. Il valore dell'altezza deve essere un numero positivo.
Preferenza di imballo	Facoltativo	Indica se il prodotto viene spedito da solo `ships_alone` o può essere `consolidated`. Se il prodotto può essere consolidato con altri prodotti durante la spedizione (caso più comune), puoi lasciare vuoto questo campo.
Paesi con restrizioni	Facoltativo	Limita la spedizione del prodotto verso determinati Paesi. I valori sono codici ISO a 2 cifre separati da una barra verticale. Se desideri limitare tutti i Paesi, inserisci `ALL`. Se desideri limitare tutti i Paesi tranne uno o alcuni, inserisci `ALL-` seguito dai Paesi per cui desideri rimuovere la restrizione, separati da barre verticali, ad esempio `ALL-CA\|AU\|US`. Se desideri limitare solo Paesi specifici, inserisci i Paesi da limitare separati da barre verticali, ad esempio `AU\|KR\|MY\|SG`. Se desideri rimuovere tutti i Paesi con restrizioni esistenti, inserisci `NONE` come valore.
Tipo di prodotto	Facoltativo	Determina la natura del prodotto. I valori sono `physical_good`, `digital_good`, `service`, `subscription`, `bundle` e `partial_item`. Se il prodotto è un bene fisico (caso più comune), puoi lasciare vuoto questo campo.
Paese di origine	Facoltativo	Il Paese in cui è stato fabbricato il prodotto. I valori sono codici ISO a 2 cifre, ad esempio `JP, GB, KR`.
Codice HS universale	Facoltativo	Il codice HS universale a 6 cifre del prodotto, ad esempio 9506.62
Codici HS specifici per Paese	Facoltativo	I codici HS specifici per Paese del prodotto, separati da barre verticali in presenza di più codici, ad esempio IT=6109.10.0010\|DE=6109.10.0010\|GB=6109.10.0010\|JP=6109.10.020
URL immagine	Facoltativo	L'URL dell'immagine del prodotto, ad esempio `https://www.exampleclothingstore.com/images/girls-graphic-baby-tee-pink-unicorn-001.jpg`
Materiale	Facoltativo	Il materiale o la composizione principale del prodotto, ad esempio poliestere
Marchio	Facoltativo	Il marchio del prodotto, ad esempio Nike
Prezzo	Facoltativo	Il prezzo applicato al prodotto.
Prezzo al dettaglio	Facoltativo	Il prezzo originale del prodotto prima degli sconti. Visualizzarlo insieme al prezzo di vendita evidenzia il risparmio per i clienti. Il prezzo al dettaglio deve essere superiore al prezzo base del prodotto (sopra).
Valuta	Condizionale	La valuta del prezzo. I valori sono codici valuta a 3 cifre, ad esempio `USD`, `CAD` o `AUD`.

*È richiesto uno SKU o un ID prodotto, ma non sono necessari entrambi. Quale si applica dipende dalla tua preferenza di chiave articolo.

Per i commercianti di bevande alcoliche: se vendi prodotti del Capitolo 22 del Sistema Armonizzato (bevande alcoliche), sono necessari campi di misurazione aggiuntivi per i calcoli delle accise. Consulta la nostra documentazione sulle accise e utilizza il modello CSV specializzato per questi prodotti.

Colonna↕	Obbligatorio↕	Descrizione↕
Unità volumetrica	Obbligatorio per le bevande alcoliche	L'unità di misura del volume. I valori validi sono milliliter, liter, fluid_ounce, ecc.
Volume	Obbligatorio per le bevande alcoliche	Il volume del prodotto, utilizzato per i calcoli delle accise.
Gradazione alcolica	Obbligatorio per le bevande alcoliche	La percentuale di alcol. Il valore deve essere inserito come percentuale, ad esempio 12 per 12% ABV.

Errori di importazione CSV

Potresti riscontrare errori durante l'importazione dei prodotti del catalogo. L'elenco seguente descrive gli errori di importazione e come risolverli. Dopo aver risolto gli errori, puoi reimportare il CSV.

Errori di importazione

Errore↕	Descrizione↕
Il file deve essere inferiore a 1 GB.	Il file è troppo grande. Deve essere inferiore a 1 GB.
Il file deve essere in formato CSV.	Catalog supporta solo il formato file CSV. Per risolvere il problema, assicurati che il formato del file sia CSV.
Intestazione/i di colonna mancante/i.	Catalog supporta solo file nel formato esatto del modello Catalog. Assicurati che le intestazioni CSV corrispondano a quelle del file modello CSV.
Intestazione/i di colonna non riconosciuta/e.	Sono presenti intestazioni di colonna non riconoscibili. Catalog supporta solo intestazioni nel formato esatto del modello Catalog. Rimuovi le intestazioni non riconosciute e verifica che le intestazioni CSV corrispondano al modello CSV.
Manca uno SKU o un ID prodotto. Assicurati che tutti i prodotti abbiano uno SKU o un ID prodotto.	Per creare un prodotto del catalogo è richiesto un identificatore (SKU/ID prodotto). Per risolvere il problema, aggiungi uno SKU o un ID prodotto per ogni prodotto.
La descrizione doganale supera il limite di 30 caratteri.	Per impostazione predefinita, le descrizioni doganali sono limitate a 30 caratteri, in linea con il limite più comune per le fatture commerciali.
Tipo di prodotto non valido.	I valori sono `physical_good`, `digital_good`, `service`, `subscription`, `bundle` e `partial_item`.
Preferenza di imballo non valida. Catalog supporta le seguenti preferenze di imballo: ships_alone e consolidated. Se il prodotto può essere consolidato con altri prodotti, lasciare vuoto.	Preferenza di imballo non valida. Catalog supporta le seguenti preferenze di imballo: `ships_alone` e `consolidated`. Se il prodotto può essere consolidato con altri prodotti, puoi lasciare vuoto il campo poiché `consolidated` è l'impostazione predefinita.
Unità di peso non valida. Catalog supporta solo le seguenti unità di peso: gram, kilogram, pound e ounce.	Catalog supporta solo le seguenti unità senza abbreviazioni: `gram`, `kilogram`, `pound` o `ounce`.
Il peso deve essere maggiore di zero e non può contenere lettere o simboli.	Assicurati che il valore del peso sia un numero positivo valido, senza simboli o lettere. Catalog supporta pesi con un massimo di due decimali, ad esempio 5.85
Unità dimensionale non valida. Catalog supporta solo le seguenti unità dimensionali: inch, foot, yard, millimeter, centimeter e meter.	Catalog supporta solo le seguenti unità senza abbreviazioni: `inch`, `foot`, `yard`, `millimeter`, `centimeter` o `meter`.
La lunghezza deve essere maggiore di zero e non può contenere lettere o simboli.	Assicurati che la lunghezza sia un numero positivo valido, senza simboli o lettere. Catalog supporta lunghezze con un massimo di due decimali, ad esempio 5.29
La larghezza deve essere maggiore di zero e non può contenere lettere o simboli.	Assicurati che la larghezza sia un numero positivo valido, senza simboli o lettere. Catalog supporta larghezze con un massimo di due decimali, ad esempio 2.44
L'altezza deve essere maggiore di zero e non può contenere lettere o simboli.	Assicurati che l'altezza sia un numero positivo valido, senza simboli o lettere. Catalog supporta altezze con un massimo di due decimali, ad esempio 8.02
È richiesta un'unità di peso quando fornisci un valore di peso.	Fornisci un'unità di peso per i prodotti che hanno un valore di peso. Catalog supporta le seguenti unità di peso: `gram`, `kilogram`, `pound` e `ounce`.
È richiesta un'unità dimensionale se fornisci valori dimensionali.	Fornisci un'unità dimensionale per i prodotti che hanno un valore dimensionale. Catalog supporta le seguenti unità dimensionali: `inch`, `foot`, `yard`, `millimeter`, `centimeter` e `meter`.
Il codice HS deve essere compreso tra 6 e 16 caratteri.	Il codice HS deve essere compreso tra 6 e 16 caratteri, poiché i codici HS universali sono di 6 cifre e il codice HS specifico per Paese più lungo è di 16 cifre.
I codici HS specifici per Paese devono avere il formato 'Codice Paese=Codice HS`	I codici HS specifici per Paese devono avere il formato Codice Paese=Codice HS, ad esempio `KR=8518.30.9000`. Se sono presenti più codici HS, separali con una barra verticale, ad esempio `KR=8518.30.9000\|CA=8518.30.9010`.
Il [codice Paese] non è un codice Paese valido.	I Paesi di destinazione devono essere in formato ISO, ad esempio `KR or BR`. Assicurati che i Paesi di destinazione siano in formato ISO a 2 cifre.
I valori del Paese di origine devono essere in formato ISO.	Assicurati che il Paese di origine sia in formato ISO a 2 cifre.
Il prezzo non può includere valori negativi, lettere o simboli.	Assicurati che il prezzo sia un valore positivo e valido. Catalog supporta prezzi con un massimo di tre decimali, ad esempio 104.399
Se fornisci un prezzo, è richiesto un codice valuta.	Fornisci un codice valuta per i prodotti che hanno un prezzo.
I codici valuta devono essere in formato ISO, ad esempio AUD o THB.	Assicurati che i codici valuta siano in formato ISO a 3 cifre.
Se viene fornito un campo dimensionale, sono obbligatori tutti e tre.	Assicurati di aver fornito tutti e tre i campi dimensionali per i prodotti con valori dimensionali.

Esempio di importazione non riuscita

Prenota una demo