---
title: Importer des produits
description: Utilisez le modèle CSV de Runner pour démarrer une importation de catalogue et suivre son historique de traitement.
---

Importez des produits à partir d'un CSV préparé lorsque l'entrée des mêmes informations de catalogue structurées un produit à la fois serait inefficace.

## Pourquoi et quand utiliser l'importation

Utilisez Importer lorsque vous avez déjà des données de produit dans une feuille de calcul ou un autre système et que vous pouvez les mapper au modèle CSV de Runner. Utilisez le formulaire [Produits](./products) manuel pour un petit catalogue ou lorsque vous devez d'abord apprendre les champs.

## Disponibilité et conditions préalables

- Ouvrez **Opérations de la boutique → Produits** dans un magasin prêt.
- Complétez la configuration de publication/préparation du magasin qui crée son canal de catalogue de vitrine en direct ; la tâche d'importation ne peut pas continuer sans ce canal.
- La liste de produits de bureau remplie affiche **Importer**. Dans un catalogue vide, utilisez d'abord **Ajouter le premier produit** ; la vue mobile met l'accent sur la création manuelle.
- L'importation accepte uniquement les fichiers CSV.
- Utilisez le modèle actuel de Runner. Les colonnes requises sont `handle` et `title` ; les lignes de variante doivent inclure le `sku` requis et les valeurs d'option affichées par le modèle.
- Le démarrage d'une importation modifie le catalogue du magasin. Examinez le fichier avant de le soumettre.

## Ouvrir Importer des produits

**Chemin d'accès :** **Espace de travail → choisir un magasin → Opérations de la boutique → Produits → Importer**

![Boîte de dialogue Importer des produits](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgObeFKMJCcW62zHrU8smjSnqvixd1twlAf4uK)

## Contrôles principaux

| Contrôle | Pourquoi vous l'utilisez | Ce qui se passe lorsqu'il est sélectionné |
| --- | --- | --- |
| **Importer** | Ouvrez le flux de travail d'importation en masse | Ouvre la boîte de dialogue Importer des produits sans démarrer une tâche. |
| **Modèle** | Commencez par les colonnes attendues de Runner | Télécharge le fichier `product-import-template.csv` actuel. |
| **Historique** | Vérifiez les tâches d'importation antérieures | Bascule vers une liste de fichiers d'importation et leurs derniers états. |
| Zone de téléchargement | Choisissez le CSV préparé | Lit le fichier localement et l'affiche comme prêt lorsque le contenu est disponible. |
| Contrôle de suppression de fichier | Corrigez une sélection incorrecte | Efface le fichier sélectionné pour que vous puissiez en choisir un autre. |
| **Démarrer l'importation** | Soumettez le CSV sélectionné | Démarre une tâche d'importation, puis passe à l'Historique lorsque Runner l'accepte. |
| **Annuler** | Quittez sans soumettre | Ferme la boîte de dialogue et efface le fichier sélectionné. |
| **Actualiser** dans l'Historique | Demandez le dernier état de la tâche | Recharge l'historique d'importation visible. |
| **Retour à l'importation** | Préparez un autre fichier | Revient de l'Historique à la vue de téléchargement. |
| **Fermer** | Quittez l'Historique | Ferme la boîte de dialogue sans modifier la tâche déjà soumise. |

## Préparer et soumettre un CSV

1. Sélectionnez **Importer**, puis **Modèle**.
2. Ouvrez le CSV téléchargé dans un éditeur de feuille de calcul qui préserve le formatage CSV.
3. Conservez les en-têtes du modèle. Complétez `handle` et `title` pour les produits, plus le `sku` affiché et les valeurs d'option pour les variantes.
4. Examinez les poignées de produit, les titres, les prix, les variantes et toutes les lignes répétées avant d'exporter en CSV.
5. Retournez à la boîte de dialogue et choisissez ou glissez-déposez le CSV dans la zone de téléchargement.
6. Attendez que le fichier affiche **Prêt à importer**.
7. Sélectionnez **Démarrer l'importation** une seule fois.
8. Dans **Historique**, suivez le fichier soumis jusqu'à ce qu'il atteigne un état terminal, puis actualisez la liste Produits et inspectez les lignes résultantes.

## Comprendre les états de l'Historique

| État | Signification | Que faire |
| --- | --- | --- |
| **En attente** | La tâche attend de démarrer | Laissez-la en place et vérifiez à nouveau plus tard ; ne soumettez pas immédiatement un doublon. |
| **Traitement** | Runner traite le fichier | Gardez la boîte de dialogue ouverte ou retournez à l'Historique plus tard. |
| **Terminé** | Runner a fini de remettre le fichier à l'importateur de catalogue | Le traitement des produits peut continuer après cet état. Actualisez Produits et inspectez les noms, les variantes, les prix, le statut et l'inventaire. |
| **Échoué** | Runner n'a pas pu terminer la tâche d'importation | La carte Historique actuelle enregistre l'état d'échec mais pas une cause détaillée. Vérifiez les conditions préalables et le CSV source avant de soumettre un nouveau fichier. |
| **Annulé** | La tâche n'a pas continué | Confirmez si des produits ont été créés avant de décider ce qu'il faut soumettre ensuite. |

L'Historique peut également afficher la taille du fichier, le nombre total de lignes et un ID de transaction lorsque Runner a ces valeurs. Ces détails identifient la tâche ; ils ne remplacent pas la vérification des enregistrements de produit.

## Limites et dépannage

- **Démarrer l'importation est désactivé :** Sélectionnez un fichier `.csv` et attendez que Runner finisse de lire le contenu non vide.
- **Type de fichier invalide :** Exportez la feuille de calcul en CSV ; renommer un autre format de fichier ne le convertit pas.
- **Erreur de lecture de fichier :** Réexportez le CSV, confirmez qu'il s'ouvre normalement sur votre appareil et choisissez-le à nouveau.
- **Importation échouée :** Confirmez que la configuration de publication/préparation du magasin a créé le canal de catalogue de vitrine en direct, puis utilisez le modèle fourni, restaurez les colonnes requises et vérifiez les variantes `sku` et les valeurs d'option.
- **La tâche semble bloquée :** Ouvrez l'Historique et sélectionnez **Actualiser**. En attente et Traitement ne sont pas la preuve de l'achèvement.
- **Des lignes de produit inattendues apparaissent :** Ne répétez pas aveuglément la même importation. Comparez les poignées CSV avec la liste Produits et corrigez les enregistrements délibérément.

## Guides connexes

- [Produits](./products)
- [Inventaire et variantes](./inventory-and-variants)
- [Intégration et paramètres généraux](./onboarding-and-general-settings)
- [Aperçu des opérations de la boutique](./)