Knowledge base
Guide
Accademia
Tutorial video
Prova a cercare:
Articoli visualizzati di recente:

Sommario

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.

Se i prodotti si esportano da un negozio sulla nostra piattaforma, il file CSV ha già il formato corretto.

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.

Format_guidelines_for_the_CSV_file__3_.png

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":

Format_guidelines_for_the_CSV_file__2_.png

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")
Se tutte le righe del file conterranno i prodotti (type="product"), è possibile omettere l'intera colonna "type". A meno che non sia specificato diversamente, tutte le righe sono considerate righe "product".

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.:

Format_guidelines_for_the_CSV_file__1_.png

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:

Format_guidelines_for_the_CSV_file__4_.png

  • 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.

Per conoscere gli ID dei prodotti o delle categorie, esportare il catalogo e vedere le colonne "product_internal_id" e "category_internal_id" rispettivamente. Per conoscere gli ID dei reindirizzamenti, esportare i reindirizzamenti (in inglese).
Se i Cod. Art. utilizzati nel negozio non sono univoci o sono vuoti, è possibile identificare i prodotti solo per ID.

File CSV di esempio

Dai un'occhiata alla nostra raccolta di file CSV di esempio precompilati per vari casi di utilizzo:

È 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.

Per maggiori informazioni su come compilare file per scopi specifici, consultare i casi di studio dettagliati (in inglese).
Questo articolo ti è stato utile?

Fantastico! Grazie per il tuo feedback!

Grazie per il tuo feedback!

Ci dispiace molto! Cosa è andato storto?
Utenti che ritengono sia utile: 13 su 24
10
Utilizziamo i cookie e tecnologie simili per ricordare le tue preferenze, misurare l'efficacia delle nostre campagne e analizzare i dati non personalizzati per migliorare le prestazioni del nostro sito. Scegliendo "Accetta", acconsenti all'utilizzo dei cookie.
Accetta i cookie Rifiuta