Runner AI
DocumentationOpérations de la boutique

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

Boîte de dialogue Importer des produits

Contrôles principaux

ContrôlePourquoi vous l'utilisezCe qui se passe lorsqu'il est sélectionné
ImporterOuvrez le flux de travail d'importation en masseOuvre la boîte de dialogue Importer des produits sans démarrer une tâche.
ModèleCommencez par les colonnes attendues de RunnerTélécharge le fichier product-import-template.csv actuel.
HistoriqueVérifiez les tâches d'importation antérieuresBascule vers une liste de fichiers d'importation et leurs derniers états.
Zone de téléchargementChoisissez le CSV préparéLit le fichier localement et l'affiche comme prêt lorsque le contenu est disponible.
Contrôle de suppression de fichierCorrigez une sélection incorrecteEfface le fichier sélectionné pour que vous puissiez en choisir un autre.
Démarrer l'importationSoumettez le CSV sélectionnéDémarre une tâche d'importation, puis passe à l'Historique lorsque Runner l'accepte.
AnnulerQuittez sans soumettreFerme la boîte de dialogue et efface le fichier sélectionné.
Actualiser dans l'HistoriqueDemandez le dernier état de la tâcheRecharge l'historique d'importation visible.
Retour à l'importationPréparez un autre fichierRevient de l'Historique à la vue de téléchargement.
FermerQuittez l'HistoriqueFerme 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

ÉtatSignificationQue faire
En attenteLa tâche attend de démarrerLaissez-la en place et vérifiez à nouveau plus tard ; ne soumettez pas immédiatement un doublon.
TraitementRunner traite le fichierGardez la boîte de dialogue ouverte ou retournez à l'Historique plus tard.
TerminéRunner a fini de remettre le fichier à l'importateur de catalogueLe 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'importationLa 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