Store Platforms

Import massif de produits depuis Excel : nettoyez d’abord le fichier

Un import massif depuis Excel échoue souvent à cause de l’encodage, des variantes ou des cellules vides. Nettoyez le fichier pour Shopify et WooCommerce.

Photo de profil de Long Nguyen

Long Nguyen

Développeur fullstack · Ingénieur IA · Chercheur

• • 4 min de lecture •

Pourquoi un import massif de produits depuis Excel échoue

Un import massif de produits depuis Excel échoue presque jamais parce que la plateforme est défaillante. Le problème vient du fait qu’Excel est un espace de travail permissif, tandis qu’un importateur est un analyseur strict. Excel accepte volontiers un code-barres enregistré comme nombre, une apostrophe typographique, un espace final ou une taille écrite de trois façons différentes. L’importateur interprète chacun de ces éléments à la lettre.

En bref : enregistrez la feuille au format CSV UTF-8, faites correspondre exactement les en-têtes de colonnes de la plateforme cible, nettoyez les colonnes d’identifiants et de variantes, puis importez un échantillon de 5 à 10 lignes avant de traiter le fichier complet. Le reste de ce guide explique la marche à suivre, en s’appuyant sur le guide d’importation des CSV de produits de Shopify et la documentation de l’importateur CSV de produits de WooCommerce comme références pour les règles à respecter.

Les deux importateurs intégrés acceptent des fichiers CSV, et non des classeurs .xlsx. Tout import depuis Excel est donc en réalité une conversion d’Excel vers CSV, à laquelle s’ajoute un problème de qualité des données. Les marketplaces et les autres plateformes e-commerce ont chacune leurs propres modèles ; les principes de nettoyage restent valables, mais les noms de colonnes changent.

Transformer un fichier produit Excel en CSV importable

  1. Conservez le classeur Excel comme fichier maître et générez le CSV d’importation à partir de celui-ci. Ne modifiez jamais directement le CSV ensuite, sinon les deux fichiers finiront par diverger.
  2. Utilisez Fichier, Enregistrer sous, CSV UTF-8 (délimité par des virgules). Le format CSV (délimité par des virgules) classique peut utiliser un encodage ancien, alors que Shopify et WooCommerce exigent l’UTF-8. Google Sheets enregistre par défaut en UTF-8, ce qui en fait une étape intermédiaire fiable.
  3. Vérifiez le séparateur. Excel suit le séparateur de liste défini par les paramètres régionaux du système d’exploitation. Lorsque le séparateur décimal est une virgule, le séparateur de colonnes est souvent un point-virgule. Un fichier séparé par des points-virgules apparaîtra comme une seule colonne dans un importateur qui attend des virgules.
  4. Ouvrez le fichier enregistré dans un éditeur de texte brut, et non dans Excel. Vérifiez la ligne d’en-têtes, le séparateur et quelques lignes contenant des virgules ou des guillemets.

La plupart des problèmes de corruption proviennent d’une courte liste d’habitudes liées à Excel :

Comportement d’Excel Ce qui arrive dans l’importateur Solution
SKU et codes-barres enregistrés comme nombres Les zéros initiaux disparaissent ; les nombres longs s’affichent en notation scientifique, par exemple 8.9E+12 Formatez les colonnes d’identifiants en Texte avant de coller les données, puis vérifiez-les à nouveau après l’enregistrement
Guillemets typographiques ajoutés par la correction automatique ou par un texte collé Shopify renvoie une erreur de guillemets non valides Remplacez-les par des guillemets droits et enregistrez le fichier en UTF-8
Tri du fichier après sa création Shopify avertit qu’un fichier trié peut dissocier les produits de leurs liens d’images Ne triez pas le fichier d’importation ; réorganisez plutôt le fichier maître, puis vérifiez que les lignes de chaque produit restent regroupées
Formules, symboles monétaires et colonnes réservées au fournisseur Des valeurs que l’importateur ne peut pas analyser ; WooCommerce recommande de les supprimer avant l’envoi Collez les données en tant que valeurs, gardez les prix sous forme de nombres simples et supprimez les colonnes inutilisées
Espaces finaux et espaces insécables Des valeurs qui semblent identiques mais ne correspondent pas, comme Large et Large Exécutez la formule de nettoyage de la section suivante

Checklist de nettoyage des données produits avant l’import

Le nettoyage représente les 80 % les moins visibles d’un projet d’import massif. C’est à cette étape que les règles des plateformes précédentes se transforment en contrôles concrets sur vos colonnes.

Colonne Points à vérifier Pourquoi c’est important
SKU / identifiant Unique pour chaque variante, enregistré comme texte, avec un identifiant parent stable répété sur chaque ligne de variante WooCommerce associe les lignes aux produits existants via l’ID ou le SKU ; les doublons sont ignorés ou fusionnés
Handle / clé produit Un handle par produit, identique sur chaque ligne de ce produit Shopify regroupe les lignes par handle et identifie les produits existants grâce à celui-ci
Valeurs d’options et d’attributs Une seule orthographe par valeur : L, l et Large deviennent Large ; le même nom d’attribut doit apparaître sur chaque ligne Une orthographe différente entre les lignes parent et variation empêche la création correcte des variations
Catégories Noms cohérents et un seul format de hiérarchie (WooCommerce utilise Home goods > Audio) Des noms de catégories presque identiques créent des catégories en double ou quasi identiques dans la boutique
Prix, poids et stock Nombres simples, sans symbole monétaire ni unité L’importateur n’analyse que les nombres
Images URL publiques et accessibles directement ; la première image est l’image principale dans WooCommerce Les liens passant par des scripts de redirection, comme certains liens de partage de stockage cloud, ne sont pas pris en charge
Statuts et valeurs booléennes WooCommerce utilise 1 ou 0 pour oui/non, et 1, 0, -1, 2 pour publié, privé, brouillon et en attente Un mauvais code de statut peut publier ou masquer des produits sans avertissement évident

Deux formules Excel couvrent la majeure partie du travail mécanique. La première supprime les caractères non imprimables, les espaces insécables et les espaces doubles ; la seconde signale les SKU en double dans la colonne A (TRUE signifie que le SKU apparaît plus d’une fois) :

=TRIM(CLEAN(SUBSTITUTE(A2,CHAR(160)," ")))
=COUNTIF($A:$A,A2)>1

Les URL d’images méritent une vérification spécifique. Avant l’import, appelez chaque URL et confirmez qu’elle renvoie bien une image. Un seul lien mort est peu coûteux à corriger dans la feuille, mais peut devenir très coûteux à réparer sur des centaines de produits déjà importés.

Importer des produits dans Shopify depuis un CSV créé avec Excel

L’importateur de Shopify repose sur la colonne Handle. Les lignes partageant un même handle appartiennent à un seul produit : c’est ainsi que sont représentées les variantes et les images supplémentaires. Les noms d’en-têtes sont sensibles à la casse : Handle fonctionne, mais pas handle. Cet extrait montre la structure attendue ; téléchargez le modèle CSV actuel de Shopify et conservez sa ligne complète d’en-têtes, car les modèles évoluent au fil du temps.

Handle,Title,Option1 Name,Option1 Value,Variant SKU,Variant Price,Image Src
ceramic-mug,Ceramic Mug,Size,Small,MUG-S,12.00,https://example.com/mug.jpg
ceramic-mug,,,Large,MUG-L,15.00,

Les comportements les plus problématiques sont ceux que Shopify documente, mais que l’on néglige souvent :

  • Le remplacement s’applique à toute la colonne. Lorsque l’option Overwrite products with matching handles est sélectionnée, chaque colonne présente dans le fichier remplace la valeur correspondante dans la boutique. Sans cette option, les produits correspondant à un handle existant sont ignorés.
  • Une cellule vide signifie vide. Si une colonne figure dans le fichier mais qu’une cellule est vide, la valeur existante est remplacée par rien. Une cellule Vendor vide efface le fournisseur.
  • Les colonnes absentes sont sans danger. Une colonne qui ne figure pas dans le fichier laisse la valeur existante de la boutique intacte.
  • Les ID de variantes sont fragiles. Modifier la valeur d’une option supprime l’ID de variante existant et en crée un nouveau, ce qui peut interrompre les applications et intégrations qui avaient enregistré l’ancien ID.
  • Il n’y a pas d’annulation. Un import CSV ne peut pas être annulé une fois lancé et il n’existe pas d’historique des imports ; les modifications apparaissent dans le journal d’activité de la boutique. Exportez d’abord une sauvegarde.
  • 15 Mo par fichier. Si l’envoi échoue ou expire, divisez le CSV et importez chaque partie séparément.

Lorsqu’un import échoue, le message d’erreur concerne généralement le fichier, et non la boutique :

Symptôme Cause
Caractères étranges dans les titres ou descriptions Le fichier n’a pas été enregistré en UTF-8
Network error: Unexpected token in JSON at position 0 Les noms d’en-têtes ne correspondent pas exactement au modèle, y compris la casse
Illegal quoting error Des guillemets ou apostrophes typographiques ont été utilisés à la place de caractères droits
Line is invalid (No details) Une valeur d’option existante a été déplacée vers une autre position d’option

Importer des produits dans WooCommerce : le SKU est la clé

WooCommerce n’utilise pas de handle. La plateforme associe les lignes aux produits existants via l’ID ou le SKU, et elle ne permet pas d’attribuer un ID choisi à un nouveau produit : les nouveaux produits reçoivent toujours le prochain ID disponible. Si les ID du système source sont importants, conservez-les dans une colonne personnalisée et utilisez le SKU comme clé de correspondance entre les systèmes.

Colonne Règle à connaître
SKU Permet d’identifier les produits existants lors d’une mise à jour ; chaque variation doit avoir un SKU unique
Type simple, variable, grouped, external ou variation pour les lignes enfants
Parent Sur une ligne de variation, le SKU du parent ou un ID écrit sous la forme id:100
Categories Les virgules séparent les catégories, > crée des sous-catégories ; une virgule présente dans un nom doit être échappée avec une barre oblique inverse
Images URL séparées par des virgules, la première devient l’image principale ; l’importateur natif ne peut pas définir le texte alternatif
Attribute 1 name, Attribute 1 value(s) Ensembles de colonnes numérotés ; le parent répertorie toutes les valeurs et chaque variation en répertorie exactement une
Préfixe meta: Importe les champs personnalisés ; par défaut, les colonnes non reconnues ne sont pas importées

Un produit variable se compose d’une ligne parent et d’une ligne par variation, le parent devant apparaître avant ses enfants :

Type,SKU,Name,Parent,Attribute 1 name,Attribute 1 value(s),Attribute 1 visible,Attribute 1 global
variable,mug,Ceramic Mug,,Size,"Small, Large",1,0
variation,mug-s,Ceramic Mug - Small,mug,Size,Small,1,0
variation,mug-l,Ceramic Mug - Large,mug,Size,Large,1,0

Le paramètre de mise à jour explique le résultat WooCommerce le plus déroutant : un import qui se termine, mais semble ne rien faire. Lorsque Update existing products est sélectionné, les lignes correspondant à un ID ou à un SKU sont mises à jour et celles qui ne correspondent à rien sont ignorées. Lorsque l’option n’est pas sélectionnée, les lignes dont l’ID ou le SKU existe déjà sont ignorées. Relancer un fichier complet sur une boutique qui contient déjà ces SKU ne modifie donc rien, sauf si vous choisissez le bon mode. Le journal des lignes ignorées de l’importateur est le premier élément à consulter.

Importer des variantes sans les détériorer

Les variantes sont le point où le modèle mental « une ligne par produit » d’un tableur cesse de fonctionner, et où le nettoyage apporte le plus de bénéfices.

  • Shopify : chaque ligne de variante répète le handle du produit et les noms d’options doivent rester identiques. Pour renommer une option ou la déplacer vers une autre position, effectuez d’abord un import avec un nom d’option temporaire (l’exemple de Shopify ajoute un point, Size.), puis importez à nouveau avec le nom définitif. L’importateur vérifie les doublons de noms d’options avant d’écrire les nouvelles valeurs, ce qui explique pourquoi un remplacement direct échoue.
  • WooCommerce : les noms d’attributs et l’orthographe des valeurs doivent être identiques dans les lignes parent et variation. Depuis WooCommerce 11.1, un seul import de mise à jour peut créer de nouvelles variations lorsque la ligne parent précède les variations et que chaque variation possède un SKU unique. Dans les versions antérieures, ou si vous ne pouvez pas garantir l’ordre des lignes, effectuez deux imports : le parent d’abord, puis les variations.
  • Les deux plateformes : vérifiez qu’aucune paire de variantes d’un même produit ne partage la même combinaison d’options. Une formule COUNTIFS appliquée à la clé produit et à chaque colonne d’option permet de repérer les conflits en quelques secondes.

Mettre à jour des produits en masse sans effacer les données

  1. Exportez d’abord le catalogue actuel et modifiez cet export afin que les identifiants et les en-têtes correspondent déjà à la boutique. Il vous servira également de sauvegarde.
  2. Supprimez toutes les colonnes que vous ne souhaitez pas modifier volontairement. Dans Shopify, une colonne absente est sans danger, tandis qu’une colonne vide peut entraîner une suppression.
  3. N’oubliez pas ce que le CSV ne peut pas faire dans Shopify : il ne permet pas de supprimer des produits en masse ni de modifier en masse leur disponibilité sur d’autres canaux de vente.
  4. Testez la mise à jour sur un ou deux produits. Ouvrez-les et vérifiez les champs modifiés ainsi que ceux que vous n’aviez pas prévu de modifier.

Catalogues volumineux et fichiers fournisseurs : divisez, testez, puis importez

Shopify limite un CSV de produits à 15 Mo. WooCommerce n’impose pas de nombre fixe : la limite dépend de la taille d’envoi, de la mémoire et du temps de traitement autorisés par votre serveur ; l’écran d’import indique le maximum défini par votre hébergeur. Dans les deux cas, le conseil est le même : divisez le fichier en lots afin qu’une éventuelle erreur soit limitée et facile à localiser, puis effectuez une sauvegarde avant de commencer. Pour les partenaires réalisant des imports volumineux, Shopify recommande de tester un petit sous-ensemble sur une boutique de développement ; l’équivalent dans WooCommerce est un site de préproduction.

Un lot de test utile comprend un produit parent avec plusieurs variations, un produit dont le nom de catégorie contient une virgule, un titre avec des caractères accentués et un produit avec plusieurs URL d’images. Après l’import test, ouvrez chaque produit et vérifiez les variantes, les attributs, les prix, le stock et les images avant de traiter le reste. Effectuez ensuite un rapprochement final : comparez les lignes du fichier aux produits et variantes présents dans la boutique.

Lorsque la source est un fichier fournisseur contenant des milliers de lignes, des noms de colonnes différents selon les fournisseurs et des valeurs d’options incohérentes, le nettoyage devient le projet principal et l’envoi n’en représente que la plus petite partie. C’est généralement à ce moment que confier le fichier à un service d’importation et de migration de données produits fait gagner davantage de temps qu’une nouvelle série d’imports échoués.

Ce que doit couvrir un service de nettoyage des données produits

Si vous hésitez à effectuer ce travail vous-même, voici ce qu’un nettoyage et un import correctement réalisés doivent comprendre, dans l’ordre :

  1. Auditer le fichier source : nombre de lignes, SKU en double, champs obligatoires manquants, problèmes d’encodage et URL d’images mortes.
  2. Normaliser les données : espaces supprimés, une seule orthographe par valeur d’option, catégories cohérentes, prix sous forme de nombres simples et identifiants conservés comme texte.
  3. Mapper les données vers le schéma cible : handle et colonnes d’options Shopify, colonnes Type, Parent et attributs de WooCommerce, ou modèle de la plateforme ou marketplace vers laquelle vous migrez.
  4. Effectuer un import test sur une boutique de développement ou un site de préproduction, puis vérifier les variantes, les images et le stock.
  5. Importer par lots en respectant les limites de taille de la plateforme, après avoir effectué une sauvegarde.
  6. Rapprocher et documenter : comparer les volumes entrants et sortants, avec un journal des modifications répertoriant chaque valeur modifiée afin qu’aucun changement ne soit effectué en silence.

Ce qu’il faut envoyer : le ou les fichiers sources, la plateforme cible et l’export actuel de la boutique si vous mettez à jour des produits existants. Le prix est défini selon le périmètre de la mission, principalement en fonction du nombre de lignes, du nombre de fichiers sources et de leur niveau de désordre.

Quelques centaines de lignes propres peuvent être traitées vous-même avec la checklist ci-dessus. Un service devient rentable pour des données fournisseurs volumineuses, désordonnées ou récurrentes. Si cela correspond à votre fichier, envoyez-nous le fichier et la plateforme cible pour obtenir un devis gratuit.

FAQ

Questions fréquentes

Shopify ou WooCommerce peuvent-ils importer directement un fichier Excel .xlsx ?

Non. Les importateurs intégrés des deux plateformes lisent les fichiers CSV. Vous devez donc d’abord enregistrer la feuille Excel au format CSV UTF-8. Certaines applications d’import tierces acceptent les fichiers .xlsx, mais elles dépendent malgré tout de données propres et correctement structurées.

Pourquoi les caractères spéciaux s’affichent-ils mal après un import de produits ?

Le fichier n’a presque certainement pas été enregistré en UTF-8. Enregistrez-le à nouveau au format CSV UTF-8 dans Excel, ou exportez-le depuis Google Sheets, qui utilise l’UTF-8 par défaut, puis relancez l’import.

Quelle est la taille maximale d’un CSV de produits Shopify ?

15 Mo par fichier. Si le CSV est plus volumineux ou si l’envoi expire, divisez-le en plusieurs fichiers plus petits et importez-les séparément.

Comment mettre à jour des produits en masse sans écraser les autres données ?

Exportez d’abord les produits, modifiez uniquement les colonnes que vous souhaitez changer et supprimez toutes les autres colonnes du fichier. Dans Shopify, une cellule vide d’une colonne présente dans le fichier remplace la valeur de la boutique par rien, tandis qu’une colonne absente reste inchangée.

Pourquoi certaines lignes ont-elles été ignorées lors de mon import dans WooCommerce ?

La cause la plus fréquente est un SKU ou un ID correspondant, associé au mauvais mode de mise à jour : lorsque l’option Update existing products n’est pas sélectionnée, les SKU existants sont ignorés ; lorsqu’elle est sélectionnée, les lignes sans correspondance sont ignorées. D’autres causes possibles sont des valeurs incompatibles avec le schéma CSV, une valeur Published inattendue ou un fichier trop volumineux pour le serveur. Le journal de l’importateur répertorie les lignes ignorées.

Quand est-il rentable de payer un service de nettoyage de données produits ?

Lorsque le fichier est volumineux, provient de plusieurs fournisseurs aux formats différents, contient de nombreuses variantes ou doit être importé régulièrement. Quelques centaines de lignes propres sont généralement faciles à traiter soi-même avec la checklist de ce guide.

Restez informé avec Netalith

Recevez des ressources de développement, des mises à jour produit et des offres spéciales directement dans votre boîte mail.