Importer des donnees depuis Excel et CSV

QuoteNode fournit un assistant d’import guide pour charger des donnees de catalogue produit depuis des fichiers Excel (.xlsx) ou CSV (.csv). Le systeme inclut des modeles telechargeables avec donnees d’exemple et instructions.

Telecharger le modele d’import

Avant de preparer vos donnees, telechargez le modele officiel :

1. Ouvrez Products > Import
2. Cliquez sur Download Template
3. Choisissez Template with examples (inclut 3 lignes d’exemple) ou Empty template

Le modele contient :

• une ligne d’en-tete avec tous les noms de colonnes pris en charge,
• une feuille d’instructions expliquant chaque champ,
• des lignes d’exemple montrant le bon format,
• les champs obligatoires marques par un asterisque (*).

Colonnes du modele

Colonne	Obligatoire	Description
SKU		Identifiant produit. Genere automatiquement si laisse vide.
NAME	*	Nom du produit, affiche dans les offres et les PDF.
UNIT_PRICE	*	Prix unitaire HT. Utilisez le point comme separateur decimal (par ex. 149.99).
UNIT_PRICE_GROSS		Prix unitaire TTC. S’il est fourni, il a priorite pour les calculs gross-first.
VAT_RATE		Pourcentage de TVA (0, 5, 8, 23). Utilise le taux TVA par defaut du tenant si omis.
UNIT		Unite de mesure : pcs, kg, h, m, m2, m3, l, set. Valeur par defaut : pcs.
GROUP_NAME		Nom du groupe / categorie produit. Cree automatiquement s’il n’existe pas.
DESCRIPTION_SHORT		Description courte affichee dans les lignes d’offre.
DESCRIPTION_LONG		Description detaillee pour les vues detail produit.
WEIGHT_KG		Poids du produit en kilogrammes (pour les calculs d’expedition).
MIN_QUANTITY		Quantite minimale de commande.
QUANTITY_STEP		Pas d’incrementation de quantite (par ex. 0.5 pour des demi-unites).
STATUS		active ou inactive (accepte aussi 1 / 0, yes / no).
REFERENCE_URL		Lien externe de specification produit (http/https).
IMAGE_URL		URL de l’image produit. Formats supportes : jpg, png, webp, gif, svg. Max 10 MB.
NOTES		Notes internes (jamais visibles par les clients).

Les colonnes supplementaires dans votre fichier sont ignorees. Vous n’avez pas besoin de les supprimer.

Workflow d’import

Etape 1 — Charger votre fichier

Glissez-deposez votre fichier Excel ou CSV, ou cliquez pour le parcourir. Taille maximale : 10 MB. Nombre maximal de lignes : 5 000.

Pour les fichiers CSV, le systeme detecte automatiquement le separateur (virgule, point-virgule ou tabulation) ainsi que l’encodage.

Etape 2 — Mapping des colonnes

Le systeme analyse les en-tetes de votre fichier et mappe automatiquement les colonnes vers les champs QuoteNode. Verifiez ce mapping et ajustez si necessaire :

• chaque colonne source peut etre mappee a un seul champ cible,
• les colonnes non mappees sont ignorees,
• les champs obligatoires doivent etre mappees avant de continuer.

Vous pouvez sauvegarder votre mapping comme template nomme pour les imports futurs. C’est utile si vous importez regulierement depuis le meme ERP ou le meme format fournisseur.

Etape 3 — Dry run

Avant validation, le systeme verifie vos donnees :

• controle des champs obligatoires (NAME, UNIT_PRICE),
• validation des formats (prix numeriques, URLs valides, unites reconnues),
• detection des doublons (par SKU contre le catalogue existant),
• apercu des 20 premieres lignes avec mise en avant des problemes.

Aucune donnee n’est ecrite en base pendant le dry run. Consultez le rapport de validation et corrigez les erreurs dans votre fichier source si necessaire.

Etape 4 — Executer l’import

Cliquez sur Import pour ecrire les donnees validees :

• les nouveaux produits sont crees pour les SKU non trouves,
• les produits existants (matches par SKU) sont mis a jour avec les valeurs importees,
• les groupes produits sont crees automatiquement lorsqu’ils sont references via GROUP_NAME,
• les images sont telechargees depuis leurs URLs puis stockees localement.

Un indicateur de progression affiche l’etat de l’import. A la fin, un resume indique : lignes importees, lignes mises a jour, lignes ignorees et erreurs eventuelles.

Import des images produit

Les images produit peuvent etre importees de deux manieres :

Via URL dans le modele

Ajoutez une colonne IMAGE_URL avec des liens HTTP/HTTPS vers les images produit. Le systeme telecharge chaque image pendant l’import.

Via upload ZIP (import media en masse)

Pour les gros catalogues, chargez un fichier ZIP contenant les images :

1. Ouvrez Products > Import > Media Import
2. Chargez un fichier ZIP (max 500 fichiers)
3. Nommez chaque fichier avec le SKU produit (par ex. PRD-001.jpg, PRD-002.png)
4. Le systeme associe les fichiers aux produits via le SKU et les upload

Un apercu dry run indique quels fichiers ont match, lesquels ont ete ignores et quelles erreurs eventuelles sont presentes.

Templates de mapping

Si vous importez regulierement depuis le meme format source :

1. Pendant l’etape 2 (mapping des colonnes), cliquez sur Save Mapping Template
2. Donnez-lui un nom (par ex. “Export ERP”, “Format Fournisseur X”)
3. Lors des imports suivants, selectionnez ce template pour reappliquer automatiquement le meme mapping

Les templates de mapping sont stockes par tenant et peuvent etre definis par defaut.

Conseils

• Commencez par le modele — il garantit les bons noms de colonnes et le bon format.
• Utilisez le dry run — validez toujours avant de committer, surtout pour les gros imports.
• Deduplication par SKU — si vous reimportez un fichier, les produits existants sont mis a jour et non dupliques.
• Noms de groupes — utilisez des noms coherents entre imports pour garder une categorisation propre.
• Encodage — pour les CSV avec caracteres speciaux, assurez-vous d’utiliser UTF-8.