Aller au contenu

Importer des produits depuis un fichier CSV ou Excel

Le modèle, les colonnes, les variantes, les limites, les erreurs.


Vous pouvez ajouter tout votre catalogue depuis un fichier CSV ou Excel, d'où qu'il vienne. Un fichier est le seul import qui reprend les stocks. Vous le trouvez dans Produits, puis « Importer », sous « ou ».

Envoyer le fichier

  1. Ouvrez Produits et appuyez sur « Importer ».
  2. Appuyez sur « Télécharger le modèle » pour obtenir un fichier avec les noms de colonnes et une ligne d'exemple.
  3. Remplissez vos produits et enregistrez le fichier.
  4. Déposez le fichier sur la zone, ou cliquez dessus et choisissez le fichier. Sur un téléphone, appuyez sur « Choisir un fichier ».
  5. Nous vérifions le fichier tout de suite. S'il est correct, la page d'import s'ouvre et vous pouvez la quitter.

Nous acceptons uniquement le CSV (séparé par des virgules ou des points-virgules) et l'Excel .xlsx, jusqu'à 10 Mo et 2 000 produits par fichier. Un produit à plusieurs variantes compte pour un seul, quel que soit le nombre de lignes qu'il prend. Un seul import tourne à la fois.

Les colonnes

Voici la première ligne du modèle :

handle,title_ar,title_en,description_ar,description_en,price,compare_at_price,currency,sku,stock,brand,tags,sections,option1_name,option1_value,option2_name,option2_value,option3_name,option3_value,images,variant_image,requires_shipping
  • Il n'y a pas d'écran de correspondance. Nous reconnaissons chaque colonne par son nom en anglais ou en arabe (par exemple اسم المنتج, السعر, الكمية, الأقسام) et ignorons les colonnes que nous ne connaissons pas.
  • Seul le nom du produit est obligatoire, en arabe ou en anglais. Un produit sans prix arrive en « Brouillon ».
  • price est en riyals, par exemple 49.00. currency est vide ou SAR.
  • stock est un nombre entier. Un produit avec un nombre en stock démarre avec le suivi de stock activé ; sans nombre, il démarre sans suivi.
  • tags et sections sont séparés par des points-virgules. Une collection citée dans sections qui n'existe pas est créée sous ce nom.
  • images contient des liens publics de photos, séparés par des espaces ou des points-virgules. Nous téléchargeons les photos et les gardons sur Uqail.
  • requires_shipping accepte yes ou no (ou نعم ou لا).

Variantes

Un produit avec des variantes prend une ligne par variante, toutes avec le même handle. La première ligne porte les informations propres au produit : noms, description, marque, tags et sections. Chaque ligne porte ses valeurs d'options dans option1_name et option1_value, jusqu'à trois options. Chaque ligne doit utiliser les noms d'options de la première ligne du produit, et une ligne de variante sans prix prend le prix du produit.

Renvoyer le fichier

Nous reconnaissons un produit à son handle. Envoyez un fichier corrigé avec les mêmes handles et nous mettons à jour les mêmes produits au lieu d'ajouter des copies. Un handle vide est créé à partir du nom du produit. Le stock n'est écrit qu'au premier import d'un produit et n'est jamais modifié par un import suivant.

Si ça ne marche pas

Si une seule ligne pose problème, rien n'est importé. Nous listons les trois premières par leur numéro de ligne dans le tableur, par exemple « Ligne 4 : Le prix n'est pas un nombre », et terminons par « Corrige-les dans ton fichier et envoie-le à nouveau. » Les problèmes de ligne sont « Sans titre », « Le prix n'est pas un nombre », « Le prix avant remise n'est pas supérieur au prix », « Le lien de la photo n'est pas valide », « Ses options ne correspondent pas à la première ligne du produit », « La devise n'est pas le riyal saoudien », « Le stock doit être un nombre entier » et « Même lien court qu'un autre produit ».

  • « Le fichier dépasse 10 Mo. Coupe-le en deux. »
  • « On lit uniquement les fichiers CSV ou Excel. » : également affiché quand l'extension d'un fichier ne correspond pas à son contenu.
  • « On n'a pas trouvé les noms de colonnes. Télécharge le modèle et copie tes produits dedans. » : il nous faut au moins deux colonnes que nous connaissons dans les cinq premières lignes.
  • « Le fichier ne contient aucun produit. »
  • « Le fichier contient plus de 2000 produits. Coupe-le en plusieurs fichiers. »
  • « On n'a pas pu lire les caractères du fichier. Enregistre-le depuis Excel en .xlsx et envoie-le. »

Plus dans Migrer vers Uqail