Importer un fichier de produits au format CSV
L’importation de références via un fichier CSV est une fonctionnalité permettant d’intégrer rapidement des catalogues fournisseurs, des listes de produits, ou des mises à jour massives.
L’import CSV repose désormais sur un ensemble de mécanismes : contrôles de l’entête, validation des données, gestion du stock, traitement en arrière-plan, popup de suivi, annulation et rapport final.
1. Format du fichier CSV attendu
L’importateur repose sur une structure souple mais normalisée.
Les colonnes obligatoires sont :
libelle
prix vente
tva
Les colonnes optionnelles incluent :
id, type_quantite, fournisseur, ref, famille, sous famille, descriptif, info, service, avec stock, poids, largeur, longueur, hauteur
✔ Aliases intelligents
Pour maximiser la compatibilité, Digitrame accepte plusieurs noms possibles pour une même colonne.
Exemples :
Le mapping est automatiquement construit à l’import
- "libelle": ["libelle", "lib"]
- "prix vente": ["prix vente", "prix_vente", "ht"]
- "tva": ["tva", "vat", "code tva"]
"uuid" : ["uuid", "id"],
- "type_quantite" : ["type_quantite", "type"],
- "qte" : ["qte", "quantite","stock"],
- "stock": ["stock","qte","quantite"],
- "descriptif": ["descriptif", "desc"],
- "fournisseur": ["fournisseur", "fou"],
- "ref": ["ref", "reference"],
- "famille": ["fam_id", "famille"],
- "sous famille": ["sfam_id", "sous famille"],
- "prix achat": ["prix achat", "achat"],
- "info": ["info", "information"],
- "service": ["service"],
- "avec stock": ["avec stock"],
- "poids": ["poids", "Poids"],
- "largeur": ["largeur", "Largeur"],
- "longueur": ["longueur", "Longueur"],
- "hauteur": ["hauteur", "Hauteur"],
2. Vérification de l’entête
Avant toute création en base, la première ligne du fichier CSV est analysée : suppression des espaces,, suppression des retours \r, comparaison avec les alias connus
Si l’une d’elles manque, l’import s’arrête immédiatement et un message d’erreur apparaît.
3. Vérification du contenu des lignes
Une seconde validation s’applique ensuite sur les données :
✔ Colonnes obligatoires non vides
Chaque ligne doit contenir :
un libellé
un prix
une TVA
Si une colonne obligatoire est vide → erreur indiquant la ligne concernée.
✔ Vérifications numériques
prix d’achat / prix de vente → un chiffre décimal
TVA → un chiffre décimal
quantité → un chiffre décimal
poids / largeur / longueur / hauteur → un chiffre décimal
Si un chiffre n'est pas reconnu il sera automatiquement remplacé par la valeur 0
4. Mode de gestion du stock
Avant de lancer l’import, un choix est obligatoire pour savoir comment traiter votre stock :
Mettre à jour le stock existant
(le stock existant est conservé, puis ajusté selon la quantité du fichier)
Remettre à zéro et appliquer le stock du fichier
(toutes les références repartent de zéro puis héritent du stock du CSV)
5. Traitement en arrière-plan (CoreData)
Pour garantir la fluidité, le traitement se fait dans un contexte en tâche de fond
Cela évite :
les blocages de l’interface
les incohérences de contexte
les doublons ou écrasements involontaires
6. Popup SwiftUI de suivi : progression + annulation
Pendant l’import :
une popup s’affiche
une barre de progression montre le nombre d’éléments traités
un spinner reste visible pendant les phases de traitement
un bouton “Annuler l’import” permet d’interrompre le traitement
L’annulation déclenche :
un rollback complet : aucune données ne sera enregistrée
la popup se ferme automatiquement
7. Fin de l’import : affichage du résumé et sélection automatique
Une fois l’import terminé, uen fenêtre affiche :
le nombre de nouvelles références créées
le nombre d’erreurs
la fenêtre des références affiche ensuite la liste des produits importées.
8. Exemple de fichier CSV compatible
Un fichier de démonstration, respectant exactement ce format, a été généré :
📥 references_import_exemple.csv
Il contient :
fournisseurs variés
familles et sous-familles aléatoires
prix formatés en 12,34 €
TVA 20,00
quantités valides
données complètes sur 200 lignes
9. Conclusion
Le nouvel import CSV n’est pas une simple lecture de fichier.
C’est un véritable moteur d’intégration professionnel, conçu pour :
absorber de gros volumes (30 000 références ou plus)
garantir l’exactitude des données
s’adapter aux variations de format Excel / fournisseur
fonctionner en multi-thread sans bloquer l’application
offrir une interface claire, transparente et contrôlée
Ce système assure une intégration rapide, fiable et flexible des catalogues, permettant aux artisans, et TPE d’optimiser leur gestion produit en quelques secondes.
Related Articles
Comment créer un contact?
dans Digitrame, vous pouvez créer un contact de deux façons : manuellement en saisissant les informations à partir d'un import de données Créer une fiche contact (manuellement) A partir de la liste, cliquez sur le bouton "Nouveau client" Saisir ...Export des factures au format CSV
Exporter vos données de factures avec les informations suivantes : le numéro de facture la date de facture le type de facture : Facture / acompte / avoir le nom du client le mode de réglement le montant HT le montant TVA le montant TTC À partir du ...Comment importer des photos pour votre base références ?
Import de Photos dans la Base des Références Digitrame vous offre une fonctionnalité pratique pour personnaliser vos fiches produits avec des photos. Suivez ces étapes pour importer efficacement vos images. Préparation des Photos Création du ...Comment transformer un devis en bon de commande ?
Dans la gestion quotidienne d’une entreprise, la conversion rapide d’un devis en bon de commande fournisseur est essentielle pour assurer une fluidité dans les achats et la gestion des stocks. Lorsqu’un devis est validé par un client, il est souvent ...Archiver vos notes de frais avec un accès pour votre comptable
L'archivage de vos notes de frais nécessite l'application Zoho WorkDrive, une solution de gestion de fichiers en ligne conçue pour sécuriser et organiser vos documents. https://www.zoho.com/fr/workdrive/ ⚠️ Vérifier tout même de temps en temps votre ...