Importer des produits et services depuis un CSV

Télécharger le modèle, téléverser le fichier, contrôler l'aperçu et les erreurs de ligne, puis lancer l'import

À quoi ça sert

L'import CSV alimente le catalogue d'achats en une fois, à partir d'un fichier. C'est la voie à privilégier pour constituer un catalogue au démarrage ou pour ajouter un lot d'articles fourni par un fournisseur.

La page se parcourt en quatre étapes : télécharger le modèle, téléverser votre fichier rempli, contrôler l'aperçu et les erreurs détectées, puis lancer l'import.

Concepts clés

Modèle CSV — le fichier d'exemple à télécharger. Il porte les en-têtes attendus et une ligne d'exemple à remplacer.
Aperçu — le tableau des cinq premières lignes lues, affiché avant l'import pour contrôle.
Erreur de ligne — une valeur qui ne respecte pas les règles d'une colonne. La ligne concernée est signalée avant l'import.
Import partiel — un import qui aboutit alors que certaines lignes ont échoué. Les lignes valides sont créées, les autres sont listées.

Comment faire

Ouvrir la page d'import

Dans le menu, ouvrez « Achats » puis « Administration ».
Cliquez sur « Gérer mes produits et services ».
Cliquez sur « Import CSV ».

La page « Import de produits et services » s'ouvre.

Télécharger le modèle

Sous « 1. Télécharger le modèle », cliquez sur « Télécharger le modèle CSV ».

Le fichier template_import_produits.csv est téléchargé. Ses colonnes sont séparées par des points-virgules et il est encodé en UTF-8. Conservez la ligne d'en-tête telle quelle et remplacez la ligne d'exemple par vos articles.

Téléverser son fichier

Sous « 2. Uploader votre fichier », cliquez sur le champ de fichier ou sur « Parcourir... » et choisissez votre fichier CSV.

Le nom du fichier retenu s'affiche et l'analyse démarre immédiatement. Le message « Fichier analysé avec succès. Prêt pour l'import. » confirme qu'aucune erreur n'a été détectée.

Contrôler l'aperçu et les erreurs

Sous « 3. Aperçu des données », vérifiez le nombre d'éléments trouvés et les cinq premières lignes affichées.
Si le bloc « Erreurs détectées » apparaît, dépliez-le avec « Afficher N erreur(s) » et lisez les lignes signalées, au format « Ligne … : … ».

Les dix premières erreurs sont listées, suivies de « ... et N autre(s) erreur(s) ». Corrigez votre fichier et téléversez-le à nouveau.

Lancer l'import

Sous « 4. Lancer l'import », cliquez sur « Lancer l'import (N éléments) ».
Si des erreurs subsistent, confirmez la question « Des erreurs ont été détectées. Voulez-vous continuer l'import en ignorant les lignes avec des erreurs? ».
Suivez la barre de progression, « Import en cours : … % ».

Le message « Import réussi : N élément(s) importé(s) avec succès ! » clôt un import sans incident. En cas d'échec partiel, le message « Import terminé avec des erreurs : … » s'affiche et le bloc « Résultat de l'import : » liste les lignes en échec avec leur nom et leur erreur.

Référence

Colonnes du fichier

Colonne	Obligatoire	Valeurs attendues
Nom	Oui	Au moins 3 caractères
Description	Non	Texte libre
Image URL	Non	Adresse d'une image à récupérer
Type	Oui	« Produit » ou « Service »
Catégorie	Non	Nom d'une catégorie
Fournisseur	Non	Nom d'un fournisseur
PrixHT	Oui	Nombre positif, virgule ou point décimal
TVA %	Non	Nombre entre 0 et 100 ; 20 par défaut
PrixTTC	Non	Nombre positif
GestionStock	Non	« Oui » pour activer le suivi du stock
StockDisponible	Non	Entier positif
StockMinimum	Non	Entier positif
Délai	Non	Entier positif
DélaiPériode (jours, semaines, mois)	Non	« jours », « semaines », « mois » ou vide
Actif	Non	« Oui » ou « Non » ; « Oui » par défaut
SKU	Non	Référence libre
Tags	Non	Mots-clés séparés par des virgules

Le fichier doit comporter au minimum les colonnes « Nom » et « Type », sans quoi le message « Format de fichier invalide. Veuillez utiliser le template fourni. » s'affiche.

Messages de validation des lignes

« Le nom est requis » et « Le nom doit contenir au moins 3 caractères »
« Le type doit être "Produit" ou "Service" »
« Le prix HT doit être positif » et « Le prix TTC doit être positif »
« Le taux de TVA doit être entre 0 et 100% »
« Le stock doit être un entier positif » et « Le stock minimum doit être un entier positif »
« Le délai doit être un entier positif »
« Le délai de livraison doit avoir la valeur "jours", "semaines" ou "mois" ou être vide »
« Le stock est requis quand la gestion de stock est activée pour un produit »

Messages sur le fichier

« Aucune donnée trouvée dans le fichier. »
« Format de fichier invalide. Veuillez utiliser le template fourni. »
« N erreur(s) détectée(s) dans le fichier. »
« Erreur lors de la lecture du fichier CSV. »
« Erreur lors du traitement du fichier. Vérifiez son format. »
« Aucune ligne valide à importer. »

Comportements automatiques

Une catégorie nommée dans le fichier mais absente du catalogue est créée automatiquement, active, avec le type déduit de l'article : « Produit » pour un produit, « Service » pour un service.
Un fournisseur nommé dans le fichier mais absent est créé automatiquement, à l'état actif, avec son seul nom.
Le rapprochement des catégories et des fournisseurs se fait sur le nom, sans tenir compte des majuscules.
L'image indiquée dans « Image URL » est récupérée et attachée à l'article. Si la récupération échoue, la ligne est comptée en échec avec le message « Erreur lors de l'upload de l'image : … » et l'article n'est pas créé.
L'import crée toujours de nouveaux articles : il ne met pas à jour les articles existants, même en cas de nom ou de SKU identique.