Validez votre catalogue CSV avant d'importer dix mille lignes
Vérifiez dix lignes de catalogue : SKU en double, variantes incomplètes, prix mal formatés et texte altéré. Un exercice aux résultats vérifiables.
TL;DR: Pour valider un CSV de catalogue, vérifiez d'abord comment la destination l'interprète ; ensuite, examinez les colonnes, les identifiants, les variantes et les valeurs. Testez un échantillon avec des erreurs connues et validez le fichier complet avant de le charger. Le fait que dix lignes passent ne prouve pas que les autres sont correctes, ni qu'une mise à jour conservera toutes les données.
Sommaire
Valider un CSV de catalogue commence par savoir ce qui changera lors de son importation. Viennent ensuite les colonnes, les identifiants et les valeurs. Une feuille qui s’ouvre sans avertissement peut contenir deux produits avec le même SKU ou une taille sans valeur. Un fichier accepté peut également mettre à jour le mauvais produit.
Le test suivant sert à apprendre à distinguer ces erreurs. Ce sont dix lignes inventées, avec des résultats vérifiables. Ce n’est pas un échantillon d’une vraie boutique ni un fichier préparé pour Shopify ou Frihet : il utilise un schéma conçu pour cet exercice que vous devrez remplacer par celui de la destination.
Commencez par la destination, pas par le fichier du fournisseur
Téléchargez un modèle actuel ou exportez un produit représentatif depuis l’outil qui recevra les données. Notez si vous allez créer, mettre à jour ou combiner les deux opérations ; ce qui identifie un enregistrement ; quels champs sont requis ; et ce que signifie laisser une cellule vide. Conservez cette définition avec le fichier de travail.
Dans Shopify, par exemple, l’écrasement est basé sur l’identifiant d’URL, appelé handle. Sa documentation exige également de revoir les dépendances entre les champs de variante et les options. Notre règle de SKU ne décrit pas comment cet importateur identifie les produits. Format des produits Shopify.
Si vous déplacez des données entre systèmes, distinguez cette vérification de la connexion entre boutique et gestion (en anglais). Un connecteur disponible ne prouve pas qu’il accepte les colonnes de votre fournisseur.
Définissez des règles que vous pouvez vérifier
Dans l’exercice, chaque ligne représente un article à vendre. product_key regroupe ses variantes ; sku doit être présent et unique. name est obligatoire. Une variante nécessite option_name et option_value ; les deux vides signifient que nous ne déclarons pas d’option. S’ils sont complets, leur combinaison avec product_key ne peut pas se répéter.
Le fichier utilise UTF-8, des virgules entre les champs et huit colonnes dans l’ordre affiché. price accepte les nombres non négatifs avec un point et deux décimales, sans séparateur de milliers. Pour currency, nous exigeons EUR pour ce test. Ce sont des conditions choisies pour ce test, non des règles universelles ni des prix commerciaux. Il n’y a pas de conversion de devise ni de calcul fiscal.
Les SKU sont conservés en tant que texte : 001 ne se convertit pas en 1. Microsoft explique comment éviter les conversions automatiques lors du chargement d’identifiants dans Excel. Définissez le type de colonne avant de transformer les données ; changer son apparence après ne reconstitue pas l’original. Conserver les zéros initiaux dans Excel.
Dix lignes, dont une qui semble correcte
Copiez le bloc en tant que texte pour l’examiner. La dernière ligne a délibérément une colonne de moins. row_id est l’identifiant du test ; R01 est sur la deuxième ligne du fichier, car la première contient les en-têtes. Les noms de produits espagnols sont des valeurs fixes, identiques dans toutes les éditions, pour que les résultats restent reproductibles.
row_id,product_key,sku,name,option_name,option_value,price,currencyR01,P01,001,Taza,Color,Natural,19.90,EURR02,P01,002,Taza,Color,Ink,19.90,EURR03,P02,001,Bolsa,,,29.00,EURR04,P03,,Cuaderno,,,8.50,EURR05,P04,005,Café,,,6.00,EURR06,P05,006,Vaso,,,"12,50",EURR07,P06,007,Camiseta,Size,,24.00,EURR08,P01,008,Taza,Color,Natural,19.90,EURR09,P07,009,,,,15.00,EURR10,P08,010,Bandeja,,,25.00| Ligne | Résultat attendu | Points à vérifier |
|---|---|---|
| R01 | Bloquer : SKU et variante dupliqués | Comparer avec R03 et R08 ; cette ligne n’est pas non plus approuvée. |
| R02 | Respecte les règles de l’exercice | Conserver comme contrôle ; ne démontre pas la compatibilité avec la destination. |
| R03 | Bloquer : SKU dupliqué | 001 identifie également la tasse de R01. |
| R04 | Bloquer : SKU manquant | Demander la référence ; ne pas l’inventer à partir du nom. |
| R05 | Revoir le texte | Comparer Café avec l’original du fournisseur. |
| R06 | Bloquer : format de prix | La virgule décimale contredit la règle choisie. |
| R07 | Bloquer : variante incomplète | Il y a Size sans valeur. |
| R08 | Bloquer : variante dupliquée | P01 + Color + Natural apparaît déjà dans R01, même si le SKU change. |
| R09 | Bloquer : nom manquant | Identifier le produit avant de continuer. |
| R10 | Bloquer : structure incomplète | Il y a sept champs ; la colonne de devise était également attendue. |
Le résultat est huit lignes bloquées, une en attente de révision et une qui passe. Il s’agit du statut de chaque ligne, et non de huit erreurs indépendantes : R01 a deux conflits. Vous pouvez vérifier chaque résultat en comparant les clés entre les lignes et les champs avec les règles précédentes.
Un doublon ne se résout pas en choisissant la première ligne
R01 semble complète lorsqu’elle est lue seule. Le conflit apparaît en parcourant l’ensemble : elle partage le SKU avec un sac et la combinaison de variante avec une autre tasse. C’est pourquoi la vérification doit marquer tous les membres du groupe, et non approuver le premier et rejeter le dernier.
Demandez à la personne qui maintient le catalogue de confirmer s’il y a une référence erronée, un produit répété ou une variante mal décrite. Enregistrez la décision avec l’ancienne valeur, la nouvelle et sa raison. Ne supprimez pas R08 juste parce que son nom correspond ; un catalogue réel peut distinguer le matériau, la taille ou d’autres options que cette feuille simplifiée n’inclut pas.
Pour votre lot réel, comparez également avec les références qui existent déjà dans la destination. Un SKU unique dans le CSV peut toujours coïncider avec un autre produit en dehors du fichier. Définissez également comment traiter les espaces et les différences de majuscules avant de normaliser : nettoyer un identifiant peut fusionner des références qui devaient rester séparées.
Séparez format, texte et signification
R06 contient "12,50" : les guillemets maintiennent le prix dans une seule cellule. Compter les virgules à la main donnerait un diagnostic incorrect ; utilisez un lecteur CSV. Le RFC 4180 décrit cette convention de guillemets, mais ne définit pas quelles colonnes un catalogue nécessite ni comment interpréter un prix. La syntaxe CSV de R06 est valide ; c’est la valeur du prix qui ne respecte pas la règle du champ.
N’effectuez pas de remplacement global des virgules par des points : vous changeriez aussi bien les séparateurs que le contenu. Identifiez d’abord le champ, confirmez le format d’origine et convertissez sa valeur de manière contrôlée. Un champ vide n’équivaut pas non plus à zéro ; enregistrer un prix zéro serait une décision commerciale que personne n’a confirmée.
R05 exige une autre vérification. Le texte Café est enregistré avec des octets UTF-8 valides ; cela ne prouve pas que le nom est correct. L’avertissement de cet exercice est préparé pour cette valeur concrète, ce n’est pas un détecteur universel d’encodage. Comparez le nom avec la source et vérifiez à quelle étape il a été déformé. Réenregistrer un texte déjà endommagé en UTF-8 ne récupère pas automatiquement ses caractères.
Avant de mettre à jour, vérifiez ce qui est conservé
Une colonne absente et une cellule vide peuvent produire des changements distincts. Shopify documente que, lors de l’écrasement, un champ facultatif présent mais vide peut effacer sa valeur existante ; omettre sa colonne peut préserver cette valeur. Il avertit également qu’une importation commencée ne peut pas être annulée et recommande une copie préalable. Conditions d’importation de Shopify.
L’identité d’une variante peut également changer : Shopify avertit que la modification des valeurs d’options supprime leurs identifiants précédents et en crée de nouveaux. Revoyez les connexions qui en dépendent avant de corriger une option via CSV. Options et identifiants de variantes.
Préparez une comparaison entre l’état précédent, le changement prévu et le résultat observé. Incluez les champs qui doivent rester identiques. Testez dans un environnement de test disponible et conservez ensemble les lignes liées d’un produit ; dix lignes consécutives ne représentent pas toujours dix produits complets.
Dans une opération réelle, vous choisiriez des cas distincts : produit simple, plusieurs options, caractères accentués, prix vide et mise à jour d’une référence existante. Cet échantillon teste le parcours. Ensuite, appliquez les règles au fichier complet : les doublons peuvent être séparés par des milliers de lignes. Consultez les intégrations pour identifier les outils de votre flux, et vérifiez les règles de données de chaque outil.
Consignez une décision vérifiable
Avant de charger, notez la version du fichier, la destination, le responsable, les règles appliquées, les anomalies résolues et la comparaison du test. S’il manque une confirmation, conservez le lot en attente ; un message « importé » ne remplace pas cette révision.
Frihet prend en charge l’importation CSV de produits, dans le cadre de ses fonctions de gestion. Le schéma et les vérifications manuelles de cet article sont indépendants : ils ne testent pas les champs admis ni les validations automatiques de Frihet. Utilisez le modèle de votre importateur et commencez par clarifier les lignes dont vous ne pouvez pas encore expliquer le résultat.
Cet article vous a-t-il été utile ?
Questions fréquentes
Ces vérifications remplacent-elles les règles de l’outil d’importation ?
Non : le schéma et les vérifications manuelles constituent un exercice indépendant. Utilisez le modèle actuel du système de destination et vérifiez ses règles de création, de mise à jour et de champs vides.
Valider dix lignes garantit-il que le reste du catalogue est correct ?
Non. L’échantillon sert à tester le processus ; appliquez ensuite les règles au fichier entier et comparez-le aux références déjà présentes dans le système de destination, car des doublons peuvent exister hors de l’échantillon.
