Importer des articles

Importez des produits en masse depuis un fichier CSV ou Excel. Associez vos colonnes aux champs produits et validez les données avant d'importer. Les catégories manquantes sont créées automatiquement et les produits dont le code-barres existe déjà sont mis à jour.

Accessible parAdministrateurGérant

Formats supportés

  • CSV (.csv)
  • Excel (.xlsx et .xls) — la première feuille est lue

Colonnes du modèle

Colonne obligatoire :

  • name — Nom du produit (seul champ obligatoire)

Colonnes optionnelles :

  • price — Prix de vente, numérique, 0 par défaut (alias accepté : selling_price)
  • purchase_price — Prix d'achat, numérique, 0 par défaut
  • margin_rate — Taux de marge % : sert à calculer le prix de vente quand price est vide et purchase_price est renseigné
  • stock_quantity — Quantité en stock, entier, 0 par défaut
  • barcode — Code-barres : s'il existe déjà, le produit est mis à jour
  • description — Description
  • category — Nom de catégorie : créée automatiquement si elle n'existe pas (comparaison insensible à la casse)
  • cost_price — Prix de revient (ancienne colonne, optionnelle)
  • is_available — Disponible : true/1/yes/oui (sinon non disponible) ; true par défaut
  • low_stock_threshold — Seuil de stock bas, entier, 10 par défaut
L'étape « Mapper les champs » propose : Nom du produit, Prix, Quantité en stock, Code-barres, Description, Catégorie, Prix de revient, Disponible et Seuil de stock bas. Une colonne du fichier qui n'est associée à aucun champ n'est pas importée — c'est le cas, dans cette version, des colonnes purchase_price et margin_rate du modèle, que l'écran de mapping ne propose pas encore.

Procédure d'import (4 étapes)

  1. 1Ouvrez « Importer des articles ». L'icône « Aide » ouvre le « Guide du modèle d'import » (en-têtes, exemple de ligne, catégories disponibles, notes sur les champs) ; l'icône « Télécharger le modèle » fournit le fichier import_template.xlsx.
  2. 2Remplissez vos produits dans le tableur (ex : « Jus d'orange 1L », « Shampoing 250 ml », « Câble USB-C ») et enregistrez.
  3. 3Étape 1 — Charger le fichier : glissez-déposez le fichier sur la zone ou cliquez pour le sélectionner.
  4. 4Étape 2 — Mapper les champs : cliquez sur « Mapper automatiquement » pour associer les colonnes reconnues, puis corrigez ou complétez avec les listes déroulantes.
  5. 5Étape 3 — Aperçu : les lignes valides et invalides sont comptées ; les lignes en erreur sont surlignées en rouge (Nom manquant, Prix invalide, Stock invalide).
  6. 6Étape 4 — Importer : seules les lignes valides sont importées. Le résumé indique les réussites (nouveaux / mis à jour) et les échecs.
La virgule comme le point sont acceptés comme séparateur décimal (4,500 ou 4.500).
Renseignez un code-barres pour pouvoir mettre à jour vos produits par un nouvel import.
Vérifiez l'orthographe des catégories : « Boissons » et « Boisson » créeraient deux catégories différentes.

Erreurs fréquentes

Les lignes en rouge sont ignorées, sans interrompre l'import des autres lignes. Corrigez-les dans le fichier puis relancez l'import.
  • Nom manquant → ligne ignorée
  • Prix, prix d'achat ou stock négatif ou non numérique → ligne ignorée
  • Code-barres déjà présent dans le catalogue → le produit existant est mis à jour (pas de doublon créé)

FAQ