Importer des produits depuis un fichier Excel ou CSV

Essentiel10 minVérifiée le 02/11/2026

Ce que vous aurez : Votre catalogue Excel est chargé dans Genuka, avec ses variantes, ses prix et son stock de départ.

Vous démarrez avec tout votre catalogue au lieu de ressaisir chaque article à la main.

Écrans montrés pour :

Pourquoi c'est utile

Saisir un catalogue de plusieurs centaines d'articles à la main prend des jours et multiplie les fautes de frappe. Si vos produits sont déjà dans un tableur, l'import les charge en une fois, et sert ensuite à mettre à jour prix et stocks en masse.

Résumé

Depuis la liste des produits, vous importez un fichier .xlsx, .xls ou .csv construit sur le modèle Genuka : chaque ligne est une variante, les lignes consécutives qui ont le même titre forment un produit. L'import crée les nouveaux produits et met à jour ceux qui existent déjà ; il tourne en arrière-plan, avec une barre de progression.

Prérequis

Le bouton d'import n'apparaît qu'avec le droit products.create (ou products.*), et le serveur refuse l'import sans lui ; l'export demande products.export. Le profil Coursier n'a aucun de ces droits.
Choisissez d'abord la boutique active : les produits importés sont rattachés à cette boutique uniquement (et détachés des autres boutiques s'ils existaient déjà).

Étapes

Ouvrez Catalogue › Produits & Services (/products).
Ouvrez Importer des produits (directement, ou dans le menu Plus d'options quand l'import et l'export sont tous deux disponibles).
Cliquez sur Télécharger le modèle de fichier ici et remplissez le modèle.
Déposez votre fichier (« Glissez et déposez un fichier ici ou cliquez pour sélectionner un fichier »).
Cochez ou non Écraser les données existantes (voir plus bas), puis Enregistrer.
Suivez la progression sur la liste (par exemple « 120 lignes sur 300 »), puis Import terminé ou L'import a échoué. Les lignes refusées sont listées avec leur numéro (les 5 premières affichées).

Vous recevez aussi une notification « Import terminé » ou « Import échoué » si vous avez activé ces événements dans Mon compte › Notifications.

Colonnes du modèle

Colonne	Contenu attendu
Parent ID	Non lu par l'import (le rapprochement d'un produit existant se fait par titre)
Product Title	Titre du produit — obligatoire. Les lignes consécutives de même titre = un produit
Product Description	Description
Product Published	`1`, `published` ou `true` = publié ; vide ou autre valeur = brouillon
Product Options	Options et valeurs : `Couleur: Blanc,Marron \| Taille: S,M,L,XL` (options séparées par `\|`, valeurs par des virgules)
Product Images	URLs des images du produit, séparées par des virgules
Variant Title	Nom de la variante (ex. `Blanc / S`)
Variant Composition	Valeurs de la variante : `Couleur: Blanc,Taille: S`
Variant Price	Prix de vente (0 si vide)
Variant Comparison Price	Prix barré
Variant Cost	Prix de revient (prix fournisseur)
Variant Stock Warehouse Name	Entrepôt du stock (sinon : premier entrepôt de la boutique)
Variant Stock Expiration Date	Date de péremption du lot (date Excel)
Variant Stock Production Date	Date de production du lot (date Excel)
Variant Stock Batch Number	Numéro de lot
Variant Stock Quantity	Quantité en stock ; remplir cette colonne active le suivi de stock de la variante
Variant Image	Lu mais sans effet actuellement : utilisez `Product Images`
Variant SKU	Référence interne
Variant Barcode	Code-barres
Collections	Noms de collections séparés par des virgules ; une collection inconnue est créée
Duration Minutes / Buffer Minutes	Pour les services : durée et temps tampon
Variant Professionals Emails	Pour les services : e-mails des professionnels (membres de l'équipe), séparés par des virgules
Type	`services` pour un service ; toute autre valeur donne un produit classique

Une colonne metadata facultative (absente du modèle) est aussi lue : clé=valeur;clé2=valeur2, enregistrée dans les métadonnées du produit. Les champs personnalisés produits de l'entreprise sont lus dans les colonnes qui portent leur clé.

Il n'y a pas de colonne pour les tags.

Images par URL

Mettez plusieurs URLs dans la même cellule Product Images, séparées par une virgule : https://exemple.com/a.jpg,https://exemple.com/b.jpg. L'ordre des URLs donne l'ordre des images.
Les URLs doivent commencer par http:// ou https:// et être accessibles publiquement : Genuka télécharge chaque image et la stocke dans ses propres médias, en arrière-plan. Pendant ce traitement, la liste affiche un indicateur de chargement à la place de la vignette.
Une URL inaccessible ou invalide est ignorée sans message : le produit est importé sans cette image. Vérifiez vos fiches après l'import.
Aucune limite de nombre d'images n'est imposée.

Créer ou mettre à jour ?

Produit : retrouvé par son titre exact dans votre entreprise ; s'il existe, il est mis à jour, sinon créé.
Variante : rapprochée d'une variante existante par SKU, puis code-barres, puis combinaison d'options, puis titre.
Écraser les données existantes décoché : « Ajoute ou met à jour uniquement les données du fichier. Les variantes et les stocks d'entrepôt absents du fichier sont conservés. »
Écraser les données existantes coché : « Les produits existants seront entièrement remplacés par le fichier. Les variantes et les stocks d'entrepôt absents du fichier seront supprimés. »

Cas limites & erreurs fréquentes

Les lignes d'exemple du modèle sont de type services avec un professionnel [email protected] : importées telles quelles, elles échouent (« Professionals not found for emails »). Supprimez-les avant d'importer.
Dates : les dates de production et de péremption doivent être de vraies dates Excel (cellules au format date), pas du texte.
Produits en brouillon après import : la colonne Product Published était vide. Corrigez-la et réimportez, ou changez le statut en masse depuis la liste (action Changer le statut).
Un fichier CSV : le séparateur (virgule, point-virgule, tabulation ou barre verticale) est détecté automatiquement depuis la première ligne.

Exporter, puis réimporter ?

L'export (Exporter, formats xlsx, csv ou pdf) produit des colonnes proches du modèle. À partir de 500 produits, le lien de téléchargement est envoyé par e-mail au lieu d'un téléchargement direct. Un export n'est pas un modèle d'import fiable : il n'a pas de colonne Type (les services redeviendraient des produits classiques), et une variante stockée dans plusieurs entrepôts y occupe plusieurs lignes. Partez du modèle d'import. Le prix barré, lui, survit à l'aller-retour : la colonne Variant Comparison Price de l'export porte bien le prix barré de chaque variante. La colonne Total donne, ligne par ligne, le prix unitaire × la quantité en stock. La dernière ligne de l'export, Total, additionne le prix, le coût, la quantité en stock et cette colonne : son total est la valeur au prix de vente du stock exporté. L'import ignore la colonne Total et saute cette dernière ligne. L'export peut aussi se limiter à certains numéros de lot (seules les lignes de ces lots sortent) ou regrouper les variantes : une seule ligne par produit, au nom du produit parent, avec la quantité de toutes ses variantes additionnée et le prix de sa première variante ; le total multiplie alors le prix et le coût par la quantité (valeur du stock). Un export regroupé ne se réimporte jamais : ses variantes y sont fusionnées.

FAQ

Comment mettre plusieurs images à un produit dans le fichier Excel ? Dans la colonne Product Images, listez les URLs séparées par des virgules.

L'import met-il à jour mes produits existants ? Oui : un produit de même titre est mis à jour. Cochez « Écraser les données existantes » seulement si le fichier doit remplacer complètement les variantes et les stocks.

Puis-je importer des tags ? Non, le modèle n'a pas de colonne pour les tags. Les collections, si.

Mes produits sont déjà importés : comment les ranger dans une collection sans réimporter ? Depuis la page de la collection (Lier des produits existants), ou en demandant à l'assistant Genuka d'y ajouter tous les produits qui répondent à un critère (fournisseur, prix, période de création, lot) : voir « Étiquettes et collections » (etiquettes-tags).

Voir aussi

Créer un produit et le publier (creer-produit)
Variantes, options et métadonnées (variantes-produit)
Codes-barres et SKU (codes-barres-sku)

Connectez-vous pour garder la trace des leçons terminées.

Ouvrir dans Genuka

Leçon suivanteCodes-barres et SKU — générer, télécharger, scannerContinuer Une question sur cette leçon ?Demander à l'assistantIl répond à partir des leçons et vous montre où regarder.