# Importare con file CSV (Import with CSV Files)

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)

#### 📌 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

* **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&#x20;

### Apri i caricamenti CSV nell'app Tipo

<figure><img src="/media/2a19292f386ccfa6c516.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

1. In Shopify Admin, apri **App → Tipo Sync**
2. Fai clic su **Caricamenti CSV (CSV uploads)**
3. 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&#x20;

<figure><img src="/media/e3560f7f8a801b3726ec.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

#### **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**

**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)**.

<figure><span class="missing-media" role="note">Questo screenshot non è disponibile nella documentazione originale.</span><figcaption></figcaption></figure>

***

### 🧩 Passaggio 2/3 — Mappa i campi&#x20;

<figure><img src="/media/5beb2e9d9f197c6c8f0e.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

**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&#x20;

<figure><img src="/media/0982d902faf55aaf2e59.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

#### **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)**

* **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)**

* **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)**

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)**

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**&#x20;

* **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

**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-lamp` esiste già → verrà aggiornato
* Se `wooden-floor-mirror` non esiste → verrà creato

***

**🙋 Hai ancora bisogno di assistenza?**

Se hai ancora bisogno di aiuto, scrivici pure a <hi@tipo.io>. Saremo felici di aiutarti.
