Errori CSV prodotti Shopify: intestazione non valida e righe saltate

Il CSV prodotti di Shopify è spietato in un modo particolare: accetta il file, annuncia l'import completato, e ti lascia con prodotti senza varianti, prezzi a zero o metà catalogo assente. Gli errori che invece segnala sono laconici.

Ecco cosa significa ciascuno.

«Invalid header» — un nome di colonna non riconosciuto

Shopify individua le colonne dal testo esatto della loro intestazione. Variant price, variant_price e Price sono tutti sbagliati; la colonna si chiama Variant Price. Maiuscole e spazi contano.

La soluzione. Esporta un prodotto esistente da Prodotti → Esporta e usa la riga di intestazione di quel file come modello. È sempre l'insieme di nomi corretto e aggiornato per il tuo negozio.

L'handle è ciò che lega le righe delle varianti

URL handle è lo slug URL del prodotto: minuscole, numeri e trattini. Se lo ometti su un prodotto nuovo, Shopify lo ricava dal Title, quindi un handle vuoto non è ciò che fa sparire i prodotti.

Dove decide tutto è sulle varianti. Ogni riga di variante deve ripetere lo stesso handle del prodotto padre, perché è l'unica cosa che le collega. Una riga di variante con handle vuoto o digitato male diventa un prodotto separato: la vera causa del «il prodotto è stato importato, ma ogni taglia è un articolo a sé».

E quando aggiorni prodotti esistenti invece di crearli, la documentazione di Shopify è esplicita: URL handle e Title sono le colonne obbligatorie.

Varianti non create, o fuse in un unico prodotto

È la parte del formato che inganna quasi tutti. Le varianti non sono colonne: sono righe aggiuntive.

Un prodotto con tre taglie occupa quattro righe nel file:

• Riga 1 porta il prodotto completo: Handle, Title, Body (HTML), Vendor, Type, Tags, più Option1 Name (Taglia), Option1 Value (S), e prezzo e SKU di quella variante.
• Righe 2-4 ripetono lo stesso Handle, lasciano Title e tutte le altre colonne di livello prodotto vuote, e compilano solo Option1 Value (M, L) con il proprio prezzo, SKU e giacenza.

Da un errore qui derivano due esiti:

• Ripetere il Title su ogni riga fa sì che Shopify tratti ciascuna come un prodotto separato.
• Compilare Option1 Value lasciando Option1 Name vuoto sulla prima riga fa ignorare del tutto le opzioni.

Prezzi importati a 0, o rifiutati

Variant Price e Variant Compare At Price devono essere numeri puri con il punto come separatore decimale. Nessun simbolo di valuta, nessun separatore delle migliaia, nessuno spazio.

1 299,00 € fallisce. 1299.00 funziona.

È un problema sistematico con gli export di strumenti europei, dove 1.299,00 è il modo normale di scrivere l'importo — ed Excel riapplicherà volentieri quel formato a ogni apertura del file.

La soluzione. Imposta la colonna prezzo in formato Testo e scrivi il valore grezzo, oppure fai la conversione al momento dell'export. Attenzione: cambiare come Excel visualizza il numero non basta — conta ciò che finisce nel CSV salvato.

Accenti rovinati

Il file deve essere UTF-8. Un CSV salvato da un Excel italiano è in Windows-1252, quindi Caffè arriva come Caffè.

La soluzione. Salva con nome → CSV UTF-8 (delimitato da virgole) — la voce distinta nell'elenco dei formati di Excel. Il CSV semplice non basta.

Immagini non importate

Image Src deve essere un URL completo e pubblicamente raggiungibile — https://…, non un percorso locale né un link dietro autenticazione. Shopify scarica ogni immagine durante l'import; tutto ciò che non riesce a recuperare viene saltato in silenzio.

Per un prodotto con più immagini, aggiungi righe extra che condividono l'Handle, compilando solo Image Src e Image Position.

Altri punti utili

• Published accetta TRUE o FALSE; Status accetta active, draft o archived.
• Variant SKU dovrebbe essere univoco in tutto il negozio — i duplicati rendono la gestione delle giacenze imprevedibile.
• Importare un Handle che esiste già aggiorna quel prodotto invece di crearne uno nuovo. Molto comodo di proposito, distruttivo per sbaglio.

Checklist prima dell'import

• Riga di intestazione copiata da un vero export Shopify
• URL handle indicato quando aggiorni prodotti esistenti (per i nuovi lo ricava Shopify)
• Le righe di variante ripetono l'handle e lasciano vuote le colonne prodotto
• Option1 Name compilato sulla prima riga di ogni prodotto
• Prezzi come numeri puri con punto decimale
• File salvato in CSV UTF-8
• URL immagini pubblici e assoluti

Quando è lo stesso file fornitore ogni settimana

Costruirlo a mano una volta, per una migrazione di catalogo, è un pomeriggio ragionevole.

Rifarlo ogni settimana su un listino fornitore, no. Importly prende l'export grezzo, rinomina le colonne con i nomi di Shopify (Title, Variant SKU, Variant Price, Variant Grams, Image Src…), toglie i simboli di valuta e converte i separatori decimali, normalizza pesi, quantità e codici a barre, corregge la codifica ed elimina le righe vuote. Salvalo come profilo e il file della settimana successiva passa per le stesse regole — l'Handle e le righe delle varianti restano a te, perché Importly pulisce nomi di colonne e valori, non ristruttura le righe.

Pulisci il tuo primo export gratis →