Linee guida per il formato dei file CSV
Per importare correttamente i file CSV nel proprio negozio, è necessario assicurarsi che siano in linea con determinati requisiti di formattazione descritti nel presente articolo.
Regole generali
Ecco alcune linee guida generali per compilare un file CSV:
- Ogni file deve avere un'intestazione con i nomi delle colonne. Consultare l'Elenco delle colonne supportate →
- L'ordine delle colonne non è importante a condizione che si utilizzino nomi corretti per le colonne.
- È possibile aggiungere liberamente qualsiasi colonna necessaria per importare i dati ed eliminare quelle che non servono.
Ad esempio, per aggiornare alcuni dettagli dei prodotti esistenti, è possibile avere solo le colonne a cui apportare modifiche oltre alle colonne degli identificatori. - Prestare attenzione alle colonne obbligatorie. Esse dipendono dal tipo di articolo e dallo scopo di importazione (creare nuovi articoli o aggiornare quelli esistenti). Per maggiori informazioni, consultare le informazioni di riferimento per le colonne dei file CSV.
- Salvare i file CSV con la codifica UTF-8 (è la codifica consigliata).
Intestazione
La parte più importante del file CSV è l'intestazione. È la prima riga che contiene i nomi di tutte le colonne. I nomi delle colonne indicano che tipo di dati contengono le rispettive colonne.
Non è possibile importare un file se non c'è l'intestazione.
Tipi di dati
Ogni riga del file, tranne l'intestazione, è dedicata a uno specifico set di dati. Per specificare a cosa esattamente di riferisce la riga, si usa la colonna "type":
In base al tipo, le righe possono contenere i dati relativi a:
- un prodotto (type = "product")
- un'opzione di prodotto o un campo di immissione (type = "product_option")
- una variante del prodotto (type = "product_variation")
- un file di prodotto (type = "product_file")
- una categoria del negozio (type = "category")
- un reindirizzamento del Sito istantaneo (type ="site_redirect")
Colonne
Tutte le colonne del file di importazione, tranne la colonna "type", sono dedicate a informazioni specifiche come nome del prodotto, Cod. Art., prezzo, ecc.:
Le informazioni possono riferirsi a un prodotto, opzione di prodotto (o campo di immissione), variante del prodotto, file di prodotto, categoria del negozio o reindirizzamento del Sito istantaneo, a seconda della riga.
Consultare l'Elenco completo delle colonne supportate. L'ordine delle colonne può variare, ma è necessario assicurarsi che i nomi delle colonne siano specificati esattamente come indicato nella guida di riferimento.
Identificatori
Per associare i dati contenuti in una determinata riga a prodotti o categorie specifici, si usano gli identificatori. Ad esempio, quando bisogna indicare a quale prodotto si riferisce l'opzione:
- Per aggiornare i prodotti esistenti, specificare l'ID del prodotto o il Cod. Art. univoco del prodotto.
- Per aggiungere opzioni, campi di immissione, varianti o file, specificare il Cod. Art. o l'ID univoco del prodotto a cui devono essere associati.
- Per aggiornare le categorie del negozio esistenti, specificare l'ID della categoria o il percorso completo della categoria.
- Per aggiornare o eliminare i reindirizzamenti del Sito istantaneo esistenti, specificare gli ID dei reindirizzamenti.
Per maggiori informazioni sui nomi delle tabelle, consultare l'Elenco delle colonne CSV supportate.
File CSV di esempio
Dai un'occhiata alla nostra raccolta di file CSV di esempio precompilati per vari casi di utilizzo:
- Aggiungere un nuovo prodotto →
- Aggiungere un nuovo prodotto con opzioni →
- Aggiungere un nuovo prodotto con opzioni e varianti →
- Aggiungere un nuovo prodotto con file →
- Aggiungere nuove categorie del negozio →
- Aggiungere attributi ai prodotti esistenti →
- Aggiungere traduzioni ai prodotti esistenti →
- Abilitare il tracciamento delle scorte per un prodotto esistente →
- Aggiornare la disponibilità in magazzino di un prodotto esistente →
- Creare reindirizzamenti del Sito istantaneo →
È possibile usare i file come modelli e vedere come funzionano combinazioni di righe e colonne. Gli articoli di esempio si possono sostituire con i propri prodotti o categorie e si possono aggiungere altre colonne delle proprietà se necessario.