In questo articolo:
Aspetti fondamentali dei file CSV
Formato dei file CSV
Importazione di un file CSV
Esempio di file CSV
Importazione di prodotti
Importare i prodotti è il modo più veloce per caricare o modificare il suo catalogo. L’importazione dei prodotti si basa su file CSV (Comma Separated Values), che possono essere elaborati come fogli elettronici.
Aspetti fondamentali dei file CSV
Un file CSV contiene valori testuali separati da caratteri di separazione. Ogni valore rappresenta una cella in un foglio elettronico, ogni linea rappresenta una nuova riga e ogni separatore (virgola, punto e virgola o scheda) indica il punto in cui un valore finisce e un altro inizia.
È possibile visualizzare ed elaborare i file CSV in editor di testo semplici (ad es. Notepad per Windows, Sublime Text, TextEdit per Mac), oppure in programmi per l’elaborazione dei fogli di calcolo (ad es. OpenOffice, LibreOffice, Google Sheets). Questi ultimi sono generalmente più comodi.
Contenuto
Ogni riga in un file di importazione dei prodotti rappresenta un elenco di attributi (nome, SKU (codice articolo), descrizione, prezzo, ecc.) che sono associati a un prodotto specifico nel suo shop MyCOMMERCE. Ogni attribuito è separato da un carattere di separazione (virgola, punto e virgola o scheda), che deve essere lo stesso in tutto il file.
La prima riga nel file può contenere i titoli delle colonne.
Nota: se il suo file contiene titoli delle colonne, nelle impostazioni dell’importazione attivi l’opzione Salta la prima linea, in modo che questa non venga compresa negli attributi dei prodotti.
Per visualizzare le impostazioni di importazione nel suo shop MyCOMMERCE, entri nel suo account MyCOMMERCE → Catalogo → Prodotti e clicchi su Importa prodotti. Cerchi l’opzione Salta la prima linea:
Separatori
I caratteri di separazione indicano il punto in cui un attributo del prodotto finisce e inizia quello successivo. MyCOMMERCE supporta tre caratteri di separazione nei file CSV: virgola, punto e virgola e tabulazione.
Nota: quando importa il suo file CSV, si assicuri che il separatore all’interno del file e nelle impostazioni di importazione sia lo stesso.
Codifica
MyCOMMERCE supporta più di dieci codifiche di caratteri, tra cui UTF-8, UTF-16 e US-ASCII. Affinché l’importazione avvenga correttamente, quando importa il suo file CSV selezioni la stessa codifica che viene usata in tale file.
Consiglio: se non sa come è codificato il suo file CSV provi con UTF-8. È la codifica di caratteri più comune.
Formato numeri
Per le importazioni di file CSV in MyCOMMERCE:
- Utilizzi un punto (un punto) per separare le cifre decimali (ad es. 3,5 o 10,99)
- Non utilizzi alcun separatore per i grandi numeri (ad es. 1350, non 1.350)
Consiglio: qui trova le domande più frequenti sul tema importazione.
Formato dei file CSV
Per visualizzare le impostazioni di importazione nel suo shop MyCOMMERCE, entri nel suo account MyCOMMERCE → Catalogo → Prodotti e clicchi su Importa prodotti.
L’importazione del prodotto in MyCOMMERCE riconosce 21 attributi. Questo significa che il suo file CSV può contenere fino a 21 colonne. Di seguito trova una breve descrizione dei singoli attributi:
Nome colonna nella finestra di importazione | Nome colonna nel file CSV | Obbligatorietà | Tipo | Limitazioni |
---|---|---|---|---|
SKU | sku | Codice art. o nome del campo obbligatorio | Stringa | 255 caratteri |
Nome | name | SKU o nome del campo obbligatorio | Stringa | 255 caratteri |
Descrizione | description | Opzionale | Stringa | Nessuna |
Attivato | enabled | Opzionale | Booleano | "true", "yes", "on", "Y", "1" per attivato, tutti gli altri valori per disattivato |
Peso | weight | Opzionale | Numero float | Qualsiasi numero float valido per il peso, valore vuoto per prodotti digitali o servizi. |
Prezzo | price | Opzionale | Numero float | Qualsiasi numero float valido |
Prezzo "Confronta con" | recommended_price | Opzionale | Numero float | Qualsiasi numero float valido |
Quantità | quantity | Opzionale | Numero intero | Qualsiasi numero intero valido, valore vuoto per quantità illimitate |
Immagine | image | Opzionale | Stringa | URL http:// o https:// |
Categoria 1 | category1 | Opzionale | Stringa | 255 caratteri |
Categoria 2 | category2 | Opzionale | Stringa | 255 caratteri |
Categoria 3 | category3 | Opzionale | Stringa | 255 caratteri |
Front page dello shop | showOnFrontpage | Opzionale | Booleano | "1" per vero, "0" o valore vuoto per falso |
Costi di spedizione fissi | shipping_freight | Opzionale (legacy) | Numero float | Qualsiasi numero float valido |
Solo costi di spedizione fissi | fixed_shipping_rate_only | Opzionale (legacy) | Booleano | "true", "yes", "on", "Y", "1" per vero, tutti gli altri valori per falso |
Tipo di costi di spedizione | shippingType | Opzionale | Stringa | Uno di questi valori: GLOBAL_METHODS, SELECTED_METHODS, FLAT_RATE, FREE_SHIPPING |
Supplemento di spedizion | shippingMethodMarkup | Opzionale Viene applicato con il tipo di costi di spedizione GLOBAL_METHODS. | Numero float | Qualsiasi numero float valido |
Forfait spedizione | shippingFlatRate | Opzionale Viene applicato con il tipo di costi di spedizione FLAT_RATE. | Numero float | Qualsiasi numero float valido |
Metodi di spedizione disattivati | shippingDisabledMethods | Opzionale Viene applicato con il tipo di costi di spedizione SELECTED_METHODS. | Elenco di stringhe di caratteri separate dal simbolo | . | Una stringa di caratteri è l’*ID di un metodo di spedizione**. |
Metodi di spedizione attivati | shippingEnabledMethods | Opzionale Viene applicato con il tipo di costi di spedizione SELECTED_METHODS. | Elenco di stringhe di caratteri separate dal simbolo | . | Una stringa di caratteri è l’*ID di un metodo di spedizione**. |
UPC | upc | Opzionale | Stringa | 255 caratteri |
Marchio | brand | Opzionale | Stringa | 255 caratteri |
Titolo pagina | seo_title | Opzionale | Stringa | 55 caratteri |
Meta descrizione | seo_description | Opzionale | Stringa | 160 caratteri |
Larghezza | width | Opzionale | Numero float | 5 caratteri |
Altezza | height | Opzionale | Numero float | 5 caratteri |
Lunghezza | lenght | Opzionale | Numero float | 5 caratteri |
**Per individuare l’ID del metodo di spedizione che vorrebbe attivare/disattivare per un prodotto durante l’importazione, clicchi sul nome del metodo di spedizione in account MyCOMMERCE → Spedizioni e ritiro personale e copi l’ID dalla barra degli indirizzi del browser. Esempio:
In alternativa può configurare un prodotto manualmente nella maniera desiderata, esportarlo, individuare gli ID del tipo di spedizione attivato/disattivato nel file CSV scaricato e utilizzarli nel suo file di importazione.
Importazione di un file CSV
Una volta preparato il suo file CSV, entri nel suo account MyCOMMERCE → Catalogo → Prodotti e clicchi su Importa prodotti.
Nella finestra di dialogo dell’importazione:
1. Clicchi su Scegli file e selezioni il file CSV dal suo computer.
2. Selezioni il separatore utilizzato nel suo file (virgola, punto e virgola o scheda).
3. Selezioni la codifica utilizzata nel suo file:
4. Ordini le colonne tramite drag-and-drop (clicca e trascina), in modo che appaiano nella stessa sequenza in cui appaiono nel file:
5. Disattivi le colonne che non sono utilizzate nel file.
6. Utilizzi l’opzione Salta la colonna per escludere fino a tre colonne:
7. Attivi l’opzione Elimina tutti i prodotti e le categorie prima di importare se desidera cancellare il catalogo prima dell’importazione.
Nota: questa operazione cancella tutti i prodotti che si trovano nel suo shop MyCOMMERCE, i quali verranno sostituiti dai prodotti contenuti nel file CSV che sta importando.
Download di un file CSV esempio per l’importazione
Scarichi un esempio di file CSV di prodotti, che può utilizzare come modello per la creazione dei suoi file CSV. Il file contiene un prodotto esempio con valori separati da virgole.
Errori frequenti
Durante l’importazione si può incorrere nei seguenti errori:
In MyCOMMERCE la profondità massima delle categorie è limitata a 50. Il suo file di importazione contiene la categoria /Category1/Category2/.../Category80, quindi ha una profondità di 80. Riduca il numero di categorie complessive e riprovi. | Ha troppe categorie nidificate e deve ridurre il percorso della categoria. |
Il nome della categoria è troppo lungo (400 caratteri). La lunghezza massima consentita è 255 simboli. | I nomi delle categorie possono avere un numero massimo di 255 caratteri. Accorci il nome. |
Numero di colonne errato. Nella finestra di importazione ha selezionato 10 colonne, ma il file ne contiene solamente 8. | Se seleziona 10 colonne per l’importazione, ogni riga deve contenere 10 valori. Selezioni il numero di colonne corretto. |
Formato immagine non supportato (http://www.example.com/image.psd). | MyCOMMERCE supporta i formati di immagini JPG, BMP, PNG e GIF. La preghiamo di utilizzare uno di questi formati. |
L’immagine http://www.example.com/image.jpg è più grande di 4 Mb. | |
La colonna «SKU» o la colonna «nome» devono contenere un valore. | Ogni linea di prodotto deve contenere almeno un valore: l’SKU (codice art.) o il nome. Verifichi che ogni linea di prodotto nel file contenga un cod. art. e/o un nome. |
Il codice articolo (SKU) è troppo lungo (300 caratteri). La lunghezza massima consentita è 255 simboli. | In MyCOMMERCE il codice articolo ha un limite di 255 simboli. Accorci il codice articolo. |
Il nome è troppo lungo (350 simboli). La lunghezza massima consentita è 255 simboli. | I valori dei nomi hanno un limite di 255 simboli. Inserisca un nome più breve. |
Valore di «Prezzo»/«Peso»/ecc. errato. | Il valore inserito nella colonna ha un formato errato. Ad esempio contiene alcune lettere, ma sono supportate solo le cifre. Verifichi che in ogni colonna sia utilizzato il formato supportato. |
URL immagine non corretto htp://example.com/image.jpg. | L’URL è formattato in modo errato. Usi il formato seguente: :///. Ad esempio: https://www. example.com/image.jpg |
Impossibile caricare l’immagine http://www.example.com/image.jpg. | MyCOMMERCE non può caricare l’immagine dal server example.com, perché il server è fuori servizio, si sono verificati errori di timeout o altri problemi di connessione. Verifichi che i file delle immagini siano disponibili online per il download. |
MyCOMMERCE prevede un limite di 1000 categorie per shop. | MyCOMMERCE consente 1000 categorie univoche per shop. Riduca il numero di categorie presenti nel file di importazione. |
Esempio di file CSV
Scarichi un esempio di file CSV di prodotti, che può utilizzare come modello per la creazione dei suoi file CSV. Il file contiene un prodotto esempio con valori separati da punto e virgola.