Importare con file CSV (Import with CSV Files)
Panoramica IA
Spiega come usare la CSV Import nell'app Tipo Sync per creare o aggiornare prodotti e inventario nel tuo negozio Shopify da un file di foglio di calcolo. Una procedura guidata in tre passaggi gestisce il caricamento, la mappatura dei campi e le impostazioni di importazione. Il tuo CSV deve avere le intestazioni di colonna nella prima riga e una chiave univoca, preferibilmente Handle.
Mostra altroMostra meno
- Prepara un CSV con le intestazioni e una chiave univoca come Handle.
- In Apps > Tipo Sync, fai clic su CSV uploads > Add csv file.
- Passaggio 1: scegli l'origine del caricamento, il separatore e i CSV Data (Product o Inventory).
- Passaggio 2: imposta la Primary Key e mappa le colonne del CSV sui campi Shopify; una chiave non corrispondente può creare duplicati o impedire l'aggiornamento.
- Passaggio 3: scegli abbinamento, intervallo di importazione, filtri, gestione delle immagini, e-mail e pianificazione, poi fai clic su Save.
Riepilogo generato dall'IA. Può contenere errori, quindi consulta la guida completa qui sotto.
Usa l’importazione CSV per creare o aggiornare rapidamente prodotti (e inventario) nel tuo negozio Shopify tramite un file foglio di calcolo.
✅ Prima di iniziare (requisiti)
Sezione intitolata “✅ Prima di iniziare (requisiti)”📌 Prepara il tuo file CSV
Sezione intitolata “📌 Prepara il tuo file CSV”Assicurati che il tuo CSV abbia:
- Intestazioni di colonna nella prima riga (ad es.
Handle,Title,Vendor) - Una chiave univoca da usare per abbinare i record (consigliata: Handle)
- Il formato corretto (file CSV)
🔑 Chiave primaria consigliata
Sezione intitolata “🔑 Chiave primaria consigliata”- Handle del prodotto (Product Handle) (la scelta migliore per la maggior parte delle importazioni)
- A seconda dei tuoi dati, potresti vedere anche altre chiavi (ad es. ID prodotto, SKU della variante)
🛠️ Passaggi per caricare il file
Sezione intitolata “🛠️ Passaggi per caricare il file ”Apri i caricamenti CSV nell’app Tipo
Sezione intitolata “Apri i caricamenti CSV nell’app Tipo”
- In Shopify Admin, apri App → Tipo Sync
- Fai clic su Caricamenti CSV (CSV uploads)
- Fai clic su Aggiungi file CSV (Add csv file)
Verrai portato alla procedura guidata di importazione (avanzamento 1/3).
📤 Passaggio 1/3 — Carica il CSV
Sezione intitolata “📤 Passaggio 1/3 — Carica il CSV ”
Scegli l’origine del caricamento
Sezione intitolata “Scegli l’origine del caricamento”Puoi caricare il CSV da:
- Importazione CSV (CSV Import) (carica un file dal tuo computer)
- Importa da link web (URL) (Import from Web Link)
- Caricamento da server FTP (FTP Server Upload)
- Caricamento da server SFTP (SFTP Server Upload)
Scegli le opzioni del CSV
Sezione intitolata “Scegli le opzioni del CSV”Separatore (Separator)
- Virgola (la più comune)
- Punto e virgola
- Altro
Dati CSV (CSV Data)
- Prodotto (Product) (per i campi del prodotto come titolo, descrizione, fornitore…)
- Inventario (Inventory) (per le quantità di inventario)
Poi fai clic su Passaggio successivo (Next Step).
🧩 Passaggio 2/3 — Mappa i campi
Sezione intitolata “🧩 Passaggio 2/3 — Mappa i campi ”
A) Mappatura della chiave primaria
Indica all’app come abbinare le righe del tuo CSV ai prodotti in Shopify.
- Chiave primaria (Primary Key): scegli in base a cosa il tuo negozio Shopify effettuerà l’abbinamento
Esempio: Handle del prodotto - Intestazione della colonna (Column heading): scegli la colonna del tuo CSV
Esempio: Handle
Se la tua chiave primaria non corrisponde, l’app potrebbe creare duplicati o non riuscire ad aggiornare il prodotto corretto.
B) Mappa le colonne del CSV ai campi di Shopify
Vedrai schede come:
- Prodotto
- Variante (Variant)
- Immagine (Image)
- Metafield
- Inventario
Per ogni riga:
- Importa in Shopify (Import to Shopify) = campo di Shopify (ad es. Title)
- Intestazione della colonna = colonna del CSV (ad es. Title)
Puoi fare clic su ➕ Aggiungi mappatura (Add mapping) per importare più campi.
Poi fai clic su Passaggio successivo (Next Step).
⚙️ Passaggio 3/3 — Impostazioni di importazione
Sezione intitolata “⚙️ Passaggio 3/3 — Impostazioni di importazione ”
Passaggio 3.1. Abbinamento e importazioni (come aggiornare Shopify)
Sezione intitolata “Passaggio 3.1. Abbinamento e importazioni (come aggiornare Shopify)”Scegli una opzione:
✅ Crea nuovi elementi (Create new items)
- Crea solo nuovi prodotti (nessun aggiornamento di quelli esistenti)
✅ Aggiorna solo gli elementi attuali con la stessa chiave primaria (Only update current items that have the same primary key)
- Aggiorna solo i prodotti esistenti
- NON ne crea di nuovi
✅ Crea nuovi elementi se non esistono e aggiorna gli elementi attuali con la stessa chiave primaria (Create new items if not exist and update current items that have the same primary key) (scelta più comune)
- Crea i prodotti mancanti
- Aggiorna i prodotti esistenti che corrispondono (per Handle/SKU/ecc.)
Passaggio 3.2. Specifiche di caricamento (quanto importare)
Sezione intitolata “Passaggio 3.2. Specifiche di caricamento (quanto importare)”- Importa tutto (Import All): importa tutto il contenuto del file
- Specifica importazione (Specify import): importa solo un intervallo selezionato di righe (utile per i test)
Passaggio 3.3. Filtra i dati (facoltativo)
Sezione intitolata “Passaggio 3.3. Filtra i dati (facoltativo)”- Importa solo i dati contenenti … (Only import data containing …) (regola di inclusione)
- Escludi i dati contenenti … (Exclude data containing …) (regola di esclusione)
Usa questa opzione se vuoi importare solo alcune righe (ad es. solo le righe che includono SYNC).
Passaggio 3.4. Dati delle immagini (se il tuo CSV include immagini)
Sezione intitolata “Passaggio 3.4. Dati delle immagini (se il tuo CSV include immagini)”Scegli una opzione:
- Aggiungi nuove immagini (Add new images) (aggiunge immagini senza rimuovere quelle vecchie)
- Solo alla creazione del prodotto (Upon creation product only) (aggiunge immagini solo per i nuovi prodotti)
- Sovrascrivi le immagini attuali (Overwrite current images) (sostituisce le immagini esistenti)
Passaggio 3.5. Notifiche e-mail (facoltativo)
Sezione intitolata “Passaggio 3.5. Notifiche e-mail (facoltativo)”Scegli quando vuoi ricevere le e-mail:
- All’avvio del caricamento
- Al completamento del caricamento
- In caso di errore del caricamento
Passaggio 3.6. Pianifica il caricamento
Sezione intitolata “Passaggio 3.6. Pianifica il caricamento ”- Esegui ora (Run now) (importa immediatamente)
(A seconda del tuo piano e delle tue impostazioni, potrebbero comparire altre opzioni di pianificazione.)
Infine fai clic su Salva (Save) (in alto a destra).
🧪 Esempio: aggiornare i prodotti esistenti + crearne di nuovi
Sezione intitolata “🧪 Esempio: aggiornare i prodotti esistenti + crearne di nuovi”CSV di esempio
| Handle | Title | Vendor |
|---|---|---|
| ceramic-table-lamp | Ceramic Table Lamp | ModernHome |
| wooden-floor-mirror | Wooden Floor Mirror | ModernHome |
Impostazioni da scegliere
- Chiave primaria: Handle del prodotto
- Intestazione della colonna: Handle
- Abbinamento e importazioni: Crea nuovi elementi se non esistono e aggiorna gli elementi attuali con la stessa chiave primaria
Risultato
- Se
ceramic-table-lampesiste già → verrà aggiornato - Se
wooden-floor-mirrornon esiste → verrà creato
🙋 Hai ancora bisogno di assistenza?
Se hai ancora bisogno di aiuto, scrivici pure a hi@tipo.io. Saremo felici di aiutarti.