# Importer avec des fichiers CSV

Utilisez l’import CSV pour créer ou mettre à jour rapidement des produits (et l’inventaire) dans votre boutique Shopify à l’aide d’un fichier de tableur.

## ✅ Avant de commencer (prérequis)

#### 📌 Préparez votre fichier CSV

Assurez-vous que votre CSV contient :

* Des **en-têtes de colonnes** dans la première ligne (ex : `Handle`, `Title`, `Vendor`)
* Une **clé unique** permettant d’associer les enregistrements (recommandé : **Handle**)
* Un format correct (fichier CSV)

#### 🔑 Clé primaire recommandée

* **Handle du produit (Product Handle)** (idéal pour la plupart des imports)
* Vous pouvez aussi voir d’autres clés selon vos données (ex : Product ID, Variant SKU)

***

## 🛠️ Étapes pour téléverser le fichier&#x20;

### Ouvrir les imports CSV dans l’application Tipo

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

1. Dans Shopify Admin, ouvrez **Applications (Apps) → Tipo Sync**
2. Cliquez sur **Imports CSV (CSV uploads)**
3. Cliquez sur **Ajouter un fichier CSV (Add csv file)**

Vous accédez à l’assistant d’import (**progression 1/3**).

***

### 📤 Étape 1/3 — Téléverser le CSV&#x20;

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

#### **Choisissez votre source de téléversement**

Vous pouvez téléverser un CSV depuis :

* **Import CSV (CSV Import)** (téléverser un fichier depuis votre ordinateur)
* Importer depuis un lien web (URL)
* Téléversement depuis un serveur FTP
* Téléversement depuis un serveur SFTP

#### **Choisissez les options du CSV**

**Séparateur (Separator)**

* Virgule (le plus courant)
* Point-virgule
* Autre

**Données CSV (CSV Data)**

* **Produit (Product)** (pour les champs produit comme le titre, la description, le fournisseur…)
* **Inventaire (Inventory)** (pour les quantités d’inventaire)

Cliquez ensuite sur **Étape suivante (Next Step)**.

<figure><span class="missing-media" role="note">Cette capture d’écran n’est pas disponible dans la documentation d’origine.</span><figcaption></figcaption></figure>

***

### 🧩 Étape 2/3 — Mapper les champs&#x20;

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

**A) Mappage de la clé primaire**

Cela indique à l’application comment associer les lignes de votre CSV aux produits de Shopify.

* **Clé primaire (Primary Key)** : choisissez le critère d’association de votre boutique Shopify\
  Exemple : **Handle du produit**
* **En-tête de colonne (Column heading)** : choisissez la colonne de votre CSV\
  Exemple : **Handle**

> Si votre clé primaire ne correspond pas, l’application peut créer des doublons ou ne pas mettre à jour le bon produit.

**B) Mapper vos colonnes CSV aux champs Shopify**

Vous verrez des onglets tels que :

* **Produit**
* **Variante (Variant)**
* **Image**
* **Métachamp (Metafield)**
* **Inventaire**

Pour chaque ligne :

* **Importer vers Shopify (Import to Shopify)** = champ Shopify (ex : Title)
* **En-tête de colonne** = colonne du CSV (ex : Title)

Vous pouvez cliquer sur **➕ Ajouter un mappage (Add mapping)** pour importer d’autres champs.

Cliquez ensuite sur **Étape suivante (Next Step)**.

***

### ⚙️ Étape 3/3 — Paramètres d’import&#x20;

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

#### **Étape 3.1. Correspondance et imports (comment mettre à jour Shopify)**

Choisissez une option :

✅ **Créer de nouveaux éléments (Create new items)**

* Crée uniquement de nouveaux produits (sans mettre à jour les existants)

✅ **Mettre à jour uniquement les éléments existants ayant la même clé primaire (Only update current items that have the same primary key)**

* Met à jour uniquement les produits existants
* Ne crée PAS de nouveaux produits

✅ **Créer de nouveaux éléments s’ils n’existent pas et mettre à jour les éléments existants ayant la même clé primaire (Create new items if not exist and update current items that have the same primary key)** *(choix courant)*

* Crée les produits manquants
* Met à jour les produits existants qui correspondent (par Handle/SKU/etc.)

***

#### **Étape 3.2. Spécification du téléversement (quantité à importer)**

* **Tout importer (Import All)** : importe tout le contenu du fichier
* **Importer une sélection (Specify import)** : importe uniquement une plage de lignes sélectionnée (utile pour tester)

***

#### **Étape 3.3. Filtrer les données (facultatif)**

* **Importer uniquement les données contenant … (Only import data containing …)** (règle d’inclusion)
* **Exclure les données contenant … (Exclude data containing …)** (règle d’exclusion)

Utilisez-le si vous souhaitez importer uniquement certaines lignes (ex : uniquement les lignes qui contiennent `SYNC`).

***

#### **Étape 3.4. Données d’image (si votre CSV contient des images)**

Choisissez une option :

* **Ajouter de nouvelles images (Add new images)** (ajoute des images sans supprimer les anciennes)
* **Uniquement à la création du produit (Upon creation product only)** (ajoute des images uniquement pour les nouveaux produits)
* **Remplacer les images actuelles (Overwrite current images)** (remplace les images existantes)

***

#### **Étape 3.5. Notifications par e-mail (facultatif)**

Choisissez quand vous souhaitez recevoir des e-mails :

* Au début du téléversement
* À la fin du téléversement
* En cas d’erreur de téléversement

***

#### **Étape 3.6. Planifier le téléversement (Schedule upload)**

* **Exécuter maintenant (Run now)** (importer immédiatement)\
  (D’autres options de planification peuvent apparaître selon votre forfait/vos paramètres.)

Cliquez enfin sur **Enregistrer (Save)** (en haut à droite).

***

## 🧪 Exemple : mettre à jour des produits existants + en créer de nouveaux

**Exemple de CSV**

| Handle              | Title               | Vendor     |
| ------------------- | ------------------- | ---------- |
| ceramic-table-lamp  | Ceramic Table Lamp  | ModernHome |
| wooden-floor-mirror | Wooden Floor Mirror | ModernHome |

**Paramètres à choisir**

* **Clé primaire** : Handle du produit
* **En-tête de colonne** : Handle
* **Correspondance et imports** : Créer de nouveaux éléments s’ils n’existent pas et mettre à jour les éléments existants ayant la même clé primaire

**Résultat**

* Si `ceramic-table-lamp` existe déjà → il sera mis à jour
* Si `wooden-floor-mirror` n’existe pas → il sera créé

***

**🙋 Besoin d’aide ?**

Si vous avez encore besoin d’aide, n’hésitez pas à nous écrire à <hi@tipo.io>. Nous serons ravis de vous accompagner.
