Errori di importazione CSV di Shopify: cause comuni e soluzioni

Come Shopify convalida le importazioni CSV

Quando importi un CSV di prodotti, Shopify fa passare ogni riga attraverso più fasi di convalida:

1. Controllo delle intestazioni: verifica che ci siano le colonne obbligatorie
2. Raggruppamento per handle: riunisce in un unico prodotto le righe con lo stesso Handle
3. Convalida dei campi: controlla tipi di dati, valori obbligatori e valori consentiti
4. Rilevamento dei conflitti: cerca conflitti di handle e SKU con i prodotti esistenti

Un errore in una qualsiasi fase fa fallire delle righe. Shopify spesso importa le righe valide e salta quelle errate: se non correggi prima tutti gli errori, rischi un'importazione parziale.

Errore: colonna obbligatoria mancante

Messaggio: "Your CSV file is missing the following columns: Handle, Title..."

Causa: Una o più colonne obbligatorie mancano nella riga di intestazione, sono scritte male o hanno maiuscole e minuscole sbagliate.

Colonne obbligatorie di Shopify:

| Colonna | Note | |---|---| | Handle | Identificativo adatto agli URL; raggruppa le varianti | | Title | Nome del prodotto | | Variant Price | Prezzo di ogni riga di variante |

Soluzione:

• Confronta la tua riga di intestazione con il modello ufficiale CSV dei prodotti Shopify
• Controlla maiuscole e minuscole: Handle, non handle; Variant Price, non Variant price
• Cerca spazi all'inizio o alla fine dei nomi delle colonne (apri il file in un editor di testo, non in Excel)
• Se la prima colonna compare come Handle (preceduta da un BOM), salva di nuovo il file come UTF-8 senza BOM

Errore: valore booleano non valido

Messaggio: Le righe vengono importate, ma Published, Gift Card o Requires Shipping mostrano il valore sbagliato

Causa: Le colonne booleane di Shopify si aspettano TRUE o FALSE (in maiuscolo). Valori come Yes, yes, 1, true o True non sono accettati in tutti i campi.

Colonne interessate: Published, Gift Card, Requires Shipping, Taxable

Soluzione: sostituisci tutte le varianti con Trova e sostituisci:

| Sostituisci questo | Con questo | |---|---| | Yes, yes, Y, true, 1 | TRUE | | No, no, N, false, 0 | FALSE |

In Excel: Ctrl+H (Trova e sostituisci) e seleziona "Confronta intero contenuto della cella" per non sostituire testo all'interno di valori più lunghi.

Errore: prezzo della variante vuoto o non valido

Messaggio: "Variant Price can't be blank" oppure il prezzo viene importato come 0.00

Causa: Variant Price è vuoto, contiene un simbolo di valuta ($19.99), usa la virgola decimale (19,99) o è un testo.

Soluzione:

• Compila Variant Price in ogni riga (sia principali sia di variante)
• Rimuovi i simboli di valuta: elimina $ con Trova e sostituisci
• Sostituisci la virgola decimale con il punto: 19,99 → 19.99
• Formatta la colonna come Numero in Excel prima di salvare (così i simboli non ricompaiono)

Errore: struttura delle varianti / colonne delle opzioni mancanti

Messaggio: I prodotti vengono importati senza varianti, oppure le varianti compaiono come prodotti separati

Causa: L'Handle è usato correttamente (stesso valore in tutte le righe di un prodotto), ma le colonne delle opzioni sono sbagliate:

• Option1 Name o Option1 Value manca o è vuoto in alcune righe
• I nomi delle colonne delle opzioni non coincidono tra le righe dello stesso gruppo
• L'handle è diverso in righe che dovrebbero essere lo stesso prodotto

Regole per le righe di variante:

• Tutte le righe dello stesso prodotto devono avere esattamente lo stesso Handle
• Ogni riga deve avere Option1 Name e Option1 Value
• Con 3 opzioni, tutte le righe devono avere le colonne Option1, Option2 e Option3
• Option1 Name (ad es. Size) deve essere uguale in tutte le righe del gruppo; cambia solo Option1 Value

Esempio di struttura delle varianti corretta:

Handle,Title,Option1 Name,Option1 Value,Variant Price
blue-shirt,Blue T-Shirt,Size,Small,19.99
blue-shirt,,Size,Medium,21.99
blue-shirt,,Size,Large,21.99

Errore: handle duplicato

Messaggio: I prodotti si sovrascrivono a vicenda oppure il raggruppamento delle varianti si rompe

Causa: Due prodotti senza relazione condividono lo stesso Handle. Shopify raggruppa tutte le righe con lo stesso Handle in un unico prodotto, quindi un Handle duplicato fonde prodotti diversi.

Soluzione: Rendi unico l'Handle di ogni prodotto. Gli handle devono essere adatti agli URL: solo lettere minuscole, numeri e trattini, senza spazi né caratteri speciali.

Se stai aggiornando un prodotto esistente e l'Handle esiste già in Shopify, è voluto: l'importazione aggiornerà quel prodotto. Ma se un nuovo prodotto condivide per errore l'Handle di uno esistente, i dati di quest'ultimo verranno sovrascritti.

Errore: conflitti di SKU

Messaggio: I prodotti vengono importati ma l'inventario è sbagliato, oppure vengono segnalati SKU duplicati

Causa: Lo stesso SKU compare in due righe diverse (o in due prodotti diversi). Shopify usa gli SKU per gestire l'inventario e gli SKU duplicati fanno unire l'inventario in modo errato.

Soluzione: Assicurati che ogni riga di variante abbia uno SKU univoco. Puoi lasciare vuoto lo SKU se non gestisci l'inventario per SKU, ma non deve ripetersi tra le righe.

Errore: immagine non importata

Messaggio: I prodotti vengono importati ma mancano le immagini

Causa:

• L'URL di Image Src non è un URL HTTPS accessibile pubblicamente
• L'URL contiene spazi o caratteri speciali che andrebbero codificati
• Il formato dell'immagine non è supportato (Shopify accetta JPG, JPEG, PNG, GIF e WEBP)

Soluzione: Prova ogni URL di immagine nel browser: deve aprire direttamente l'immagine. Le immagini su Google Drive, Dropbox o localhost vanno spostate su un hosting pubblico prima dell'importazione.

Correggi automaticamente con StriveFormats

Carica il tuo CSV di Shopify su StriveFormats. Il validatore controlla tutte le colonne obbligatorie, i formati booleani, la struttura delle varianti, i campi dei prezzi e l'univocità degli handle, e corregge con un clic i problemi sicuri.

Apri il correttore CSV di Shopify | Vedi il modello di Shopify