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

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

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

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. Complétez handle et title pour les produits, plus le sku affiché et les valeurs d’option pour les variantes.
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.

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.