Importer des produits

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 manuel pour un petit catalogue ou lorsque vous devez d’abord apprendre les champs.

Disponibilité et conditions préalables

Si les cartes de configuration apparaissent à la place du menu administrateur, terminer la configuration du magasin d’abord, puis sélectionnez Ouvrir Opérations de la boutique.

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 Product Handle et Product Title sont obligatoires ; les lignes de variantes utilisent les champs d’options du modèle et Variant SKU est facultatif.
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 → choisissez un magasin → Opérations de la boutique → Produits → Importer

Les captures et vidéos de cette page montrent l’interface en anglais.

Annotations en anglais : Boîte de dialogue Importer des produits

Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.

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’import	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

Sélectionnez Importer, puis Modèle.
Ouvrez le CSV téléchargé dans un éditeur de feuille de calcul qui préserve le formatage CSV.
Conservez les en-têtes du modèle. Renseignez Product Handle et Product Title pour les produits, ainsi que les valeurs d’options affichées pour les variantes. Ajoutez Variant SKU si votre catalogue utilise des SKU.
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.
Retournez à la boîte de dialogue et choisissez ou glissez-déposez le CSV dans la zone de téléchargement.
Attendez que le fichier affiche Prêt à importer.
Sélectionnez Démarrer l’importation une seule fois.
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.

Pour découvrir le flux de travail sans modifier le catalogue, téléchargez Modèle, examinez ses en-têtes, puis ouvrez Historique. Revenez avec Retour à l’import et fermez la boîte de dialogue. La sélection d’un fichier le prépare ; seul Démarrer l’importation soumet une modification de catalogue.

L’enregistrement inspecte les exigences d’importation et l’historique vide, puis revient aux versions préliminaires des produits. Aucun CSV n’est soumis ou importé.

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 en cours	Runner traite le fichier	Gardez la boîte de dialogue ouverte ou retournez à l’Historique plus tard.
Terminée	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.
Échec	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.
Échec de l’importation : Vérifiez que la préparation à la publication a créé le canal de catalogue de la vitrine en ligne. Utilisez ensuite le modèle fourni, restaurez les colonnes obligatoires et vérifiez les valeurs d’options des variantes ainsi que les éventuelles valeurs Variant SKU.
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.