Problème d'importation de produits WooCommerce ? Voici quoi faire !

Une importation de produits WooCommerce qui ne fonctionne pas est presque toujours un problème avec le fichier CSV plutôt qu'avec votre boutique. L'encodage, les colonnes non mappées, un lien parent brisé sur les lignes de variation, ou une limite de serveur expliquent la grande majorité des échecs, et chacun a une correction spécifique que vous pouvez vérifier en quelques minutes.

Le plus frustrant est la discrétion avec laquelle il échoue. WooCommerce signale souvent une importation réussie alors que la moitié de vos lignes n'ont abouti nulle part, vous laissant deviner quelle étape a échoué.

Ce guide examine les causes dans l'ordre où il convient de les vérifier, du fichier lui-même aux conflits de plugins et aux limites du serveur, avec la solution exacte pour chacune. Alors, commençons !

Table des matières

Problèmes de format CSV : la cause la plus fréquente

Une grande partie des cas « d'importation qui ne fonctionne pas » remonte au fichier, pas au magasin. Trois détails causent la plupart des échecs silencieux, et tous les trois sont visibles si vous ouvrez le CSV dans un éditeur de texte brut plutôt que dans une application tableur.

• Encodage UTF-8 : les fichiers enregistrés depuis Excel utilisent par défaut Windows-1252 ou MacRoman, et chaque caractère accentué, symbole de devise ou guillemet intelligent est corrompu. Réenregistrez en tant que « CSV UTF-8 (délimité par des virgules) », ou utilisez Google Sheets, qui exporte UTF-8 par défaut.
• Champs multi-valeurs non cités : une cellule contenant plusieurs catégories ou URL d'images doit être entourée de guillemets doubles. Sans eux, la virgule est lue comme une séparation de colonne et la ligne se désagrège.
• Lignes de variations sans parent : chaque variation a besoin d'une colonne Parent contenant le SKU du produit parent. Des valeurs manquantes ou incorrectes signifient que les variations sont importées comme des produits simples orphelins.

Exécutez cette liste de contrôle sur le fichier avant de supposer que le problème vient du côté WooCommerce :

1. Ouvrez-le dans un éditeur de texte brut et recherchez les caractères brouillés. « café » affiché comme « café » confirme un problème d'encodage.
2. Vérifiez que les cellules multi-valeurs sont entourées de guillemets doubles.
3. Pour les produits variables, confirmez que quelques lignes de variations font référence au SKU parent correct, sans espaces de fin.
4. Importez d'abord 5 à 10 lignes. Si elles arrivent correctement, augmentez la taille jusqu'au fichier complet.

Pour la description complète des colonnes, des valeurs acceptées et des règles de formatage, consultez notre guide d'importation CSV WooCommerce.

Pourquoi l'importation de vos produits WooCommerce ne fonctionne-t-elle pas ?

Une importation de produits WooCommerce qui ne fonctionne pas se résume à quatre causes : le formatage du fichier, les colonnes laissées non mappées, un plugin interférant avec la création du produit, ou le serveur coupant le processus. Examiner ces causes dans cet ordre permet de trouver la plus rapidement, car les deux premières sont beaucoup plus courantes que les deux dernières.

• Mauvais encodage, ou valeurs non citées contenant des virgules
• Colonnes laissées sur « Ne pas importer » pendant le mappage
• Lignes de variations qui ne référencent pas leur parent
• Temps d'attente dépassés ou épuisement de la mémoire sur les gros fichiers
• Conflits avec des plugins de mise en cache, de sécurité ou de SEO
• URL d'images que le serveur ne peut pas atteindre

Commencez par le fichier. Validez le format et confirmez votre correspondance, puis passez aux vérifications du plugin et du serveur si le problème persiste.

Quel format de fichier est requis pour les importations de produits WooCommerce ?

WooCommerce importe les fichiers CSV en encodage UTF-8, et rien d'autre. D'autres formats comme XLSX, TSV ou JSON doivent d'abord être convertis en CSV, ce que toute application de tableur fait via Enregistrer sous ou Télécharger.

Bon à savoir : beaucoup moins de colonnes sont nécessaires que ce que la plupart des guides prétendent. Seul le Nom est vraiment obligatoire, plus le Type pour tout ce qui n'est pas un produit simple. Le SKU est généré automatiquement lorsqu'il manque, donc une colonne SKU vide n'arrêtera pas une importation, bien que cela vous laisse sans clé pour les mises à jour futures.

• Chaque ligne a-t-elle un Nom ?
• Les types de produits sont-ils correctement orthographiés (simple, variable, variation) ?
• Des espaces de fin ou des caractères cachés dans les colonnes SKU ou Parent ?
• Des lignes complètement vides mélangées aux données ?

Pourquoi les colonnes disparaissent-elles de l'écran de mappage ?

Si les produits ont été importés mais que leurs données sont vides, la colonne a très certainement été laissée sur « Ne pas importer ». WooCommerce affiche un écran de correspondance des colonnes après le téléchargement, et tout ce qu'il ne reconnaît pas est ignoré par défaut plutôt que deviné.

Cela signifie également que vos en-têtes n'ont jamais eu besoin de correspondre aux noms de WooCommerce. Une colonne appelée « Code article » ou « SKU produit » correspond parfaitement à partir de la liste déroulante, donc renommer les colonnes de votre fournisseur est un effort perdu. Lisez l'écran de correspondance plutôt que de cliquer dessus, et définissez toute colonne que vous souhaitez réellement.

Les colonnes non reconnues peuvent également être envoyées à un champ personnalisé en les faisant correspondre à une clé meta:, c'est ainsi que les codes fournisseur et les prix de gros sont transférés.

Quels conflits de plugins affectent l'importation de produits WooCommerce ?

Les plugins qui s'intègrent à la création de produits peuvent ralentir une importation ou rejeter des lignes. Les outils de mise en cache, de sécurité et de SEO sont les suspects habituels, car chacun exécute un travail supplémentaire à chaque fois qu'un produit est enregistré.

• Plugins de mise en cache (WP Rocket, W3 Total Cache)
• Plugins de sécurité et pare-feu (Wordfence)
• Outils SEO qui s'intègrent aux métadonnées des produits
• Autres outils d'importation et d'exportation

Testez sur un site de staging avec les plugins non essentiels désactivés et un thème par défaut comme Twenty Twenty-Four actif. Si l'importation se déroule sans problème, réactivez un plugin à la fois jusqu'à ce qu'elle échoue à nouveau.

Comment vérifier les limites de ressources du serveur pour les importations de produits ?

Les catalogues volumineux peuvent dépasser le temps d'exécution ou la mémoire de PHP avant que l'importation ne se termine, et lorsque cela se produit, le processus s'arrête sans erreur utile. Le manuel PHP indique une max_execution_time par défaut de 30 secondes via un serveur web, ce que quelques milliers de lignes dépasseront rapidement.

• max_execution_time, augmenté à 300 secondes ou plus pour les gros fichiers
• memory_limit, avec 512 Mo un point de départ raisonnable
• upload_max_filesize et post_max_size, qui limitent ce que vous pouvez télécharger via le navigateur

Ils résident dans votre configuration PHP, et l'hébergement mutualisé limite souvent ce que vous êtes autorisé à modifier. La solution de contournement fiable consiste à utiliser des lots plus petits de 500 à 1 000 lignes, ce qui évite complètement les limites.

Quels messages d'erreur apparaissent lorsqu'une importation échoue ?

WooCommerce signale les échecs au niveau de la ligne plutôt que de les expliquer. Le résumé de l'importation vous indique combien de lignes ont été importées, mises à jour, ignorées et échouées, et le nombre d'échecs est le chiffre qui mérite d'être lu, car une importation « réussie » peut quand même avoir ignoré la moitié de votre fichier.

Une barre de progression bloquée sans aucun résumé signifie généralement un délai d'attente plutôt qu'un problème de données. Si rien n'apparaît à l'écran, vérifiez le journal d'erreurs de votre serveur et confirmez que WordPress et WooCommerce sont tous deux à jour.

Comment éviter les doublons ou les produits manquants ?

Les doublons signifient presque toujours que la case Mettre à jour les produits existants a été laissée décochée. Avec cette option activée, WooCommerce fait correspondre chaque ligne à votre catalogue par ID de produit ou SKU et met à jour la correspondance au lieu de créer une deuxième copie. Les lignes sans correspondance sont ignorées plutôt qu'ajoutées.

Le symptôme inverse, des produits ignorés silencieusement alors que vous attendiez des mises à jour, signifie que la case était cochée mais qu'aucune correspondance n'a été trouvée. Vérifiez la colonne SKU pour les espaces de fin et les différences de casse, deux problèmes courants dans les fichiers fournisseurs et suffisants pour casser une correspondance.

• Utilisez des SKU uniques pour les produits et les variations
• Laissez la colonne ID de côté, sauf si vous mettez à jour délibérément par ID
• N'incluez que les colonnes que vous avez l'intention de modifier lors d'une exécution de mise à jour
• Sauvegardez avant toute mise à jour, car elle s'applique immédiatement à votre catalogue en direct

Que faire lorsque l'importation ne démarre toujours pas ?

Si le fichier est propre et que votre importation de produits WooCommerce ne fonctionne toujours pas, le problème est presque toujours la taille. Trois approches permettent de contourner ce problème sans toucher à votre plan d'hébergement.

• Utilisez un chemin de fichier serveur. Téléchargez le CSV via FTP, puis ouvrez Options avancées sur l'écran d'importation et entrez le chemin. La limite de téléchargement du navigateur ne s'applique plus du tout.
• Divisez le fichier. Les lots de 500 à 1 000 lignes se terminent bien dans les délais impartis, et un échec ne vous coûte qu'un seul lot.
• Exécutez-le depuis la ligne de commande. WP-CLI contourne les délais d'attente du navigateur et du serveur web, ce qui convient aux migrations ponctuelles très volumineuses.

Testez l'ensemble du processus sur un site de staging d'abord lorsque le catalogue est volumineux. Une importation qui se termine à moitié sur une boutique en direct demande considérablement plus de travail pour être défaite qu'une qui échoue en toute sécurité ailleurs.

Comment exporter des produits pour le dépannage ?

L'exportation de vos produits existants vous donne un fichier que WooCommerce accepte déjà, ce qui transforme les conjectures en comparaison. Placez votre exportation à côté de votre fichier d'importation et l'inadéquation devient généralement évidente : une colonne nommée différemment, une valeur de forme incorrecte, une référence parent manquante.

Store Exporter Deluxe gère l'exportation, en CSV, TSV, XLS, XLSX, XML ou JSON :

• Exporter les produits, les variations, les tags et les niveaux de stock
• Repérez les termes de taxonomie ou les champs personnalisés manquants
• Créez un modèle de travail pour construire votre fichier d'importation
• Archivez un instantané avant tout changement majeur

Quelles sont les meilleures pratiques pour éviter les échecs d'importation ?

Quelques habitudes permettent d'éviter la plupart des problèmes récurrents. Elles demandent un peu de temps au départ et évitent le travail de reprise qui découle de la découverte d'un mauvais import deux semaines plus tard.

• Sauvegardez votre boutique avant tout import important
• Testez d'abord avec un petit fichier d'exemple, à chaque fois
• Enregistrez en CSV UTF-8 plutôt qu'en CSV simple
• Maintenez WordPress et WooCommerce à jour
• Utilisez un site de staging pour les opérations en masse
• Vérifiez quelques produits après coup au lieu de faire confiance au résumé

Réflexions finales

Un import de produit WooCommerce qui ne fonctionne pas est rarement dû à une boutique défaillante. C'est un fichier qui ne dit pas tout à fait ce que vous pensez qu'il dit, et la correction est généralement à un réglage ou une colonne près.

Voici un récapitulatif rapide de ce qu'il faut vérifier, dans l'ordre :

• Encodage et mise entre guillemets du fichier, la cause de loin la plus fréquente.
• L'écran de mappage des colonnes, où les données disparaissent silencieusement.
• Conflits de plugins, testés sur staging avec un thème par défaut.
• Limites du serveur, ou simplement des lots plus petits.
• La case à cocher Mettre à jour les produits existants, qui décide des doublons.

Si vous dépannez un fichier que vous n'avez pas construit, commencez par un que WooCommerce accepte déjà. Exportez votre catalogue actuel avec Store Exporter Deluxe et comparez-le au fichier qui échoue.

Questions fréquemment posées

Que signifient les « exigences du format CSV » pour l'importation WooCommerce ?

Cela signifie un fichier délimité par des virgules, enregistré en UTF-8 avec une ligne d'en-tête. Seule la colonne Nom est réellement requise, et vos en-têtes n'ont pas besoin de correspondre aux noms de champs de WooCommerce car l'écran de mappage des colonnes vous permet de les assigner chacun. La spécification complète se trouve dans notre guide d'importation CSV.

Pourquoi mon importation CSV WooCommerce réussit mais les produits n'apparaissent pas ?

Trois causes expliquent presque toutes ces situations. Les produits ont été importés comme brouillons, vérifiez donc le filtre d'état sur la liste des produits. Une colonne Publié a été définie sur 0 ou -1, ce qui les rend privés ou brouillons. Ou un produit parent variable a été importé alors que ses variations ont échoué, ce qui apparaît comme un produit sans options achetables.

Pourquoi mon importation de produits WooCommerce ne fonctionne-t-elle pas ?

Les raisons les plus courantes sont un fichier enregistré dans le mauvais encodage, des colonnes laissées sur « Ne pas importer » lors du mappage, des lignes de variations sans valeur Parent, et des timeouts serveur sur les gros fichiers. Vérifiez-les dans cet ordre, car les deux premières expliquent la plupart des échecs et toutes deux sont visibles avant de lancer l'importation.

Comment corriger les erreurs « URL d'image 404 » lors de l'importation CSV ?

L'importateur télécharge chaque URL d'image pendant l'importation, donc chaque URL doit renvoyer une vraie image sans redirection ni mur de connexion. Testez-les avec curl -I, ou collez-en une dans une fenêtre de navigation privée. Les images derrière une authentification ou une protection hot-link échoueront toujours, téléchargez-les donc d'abord dans votre médiathèque et référencez leurs URL finales.

Pourquoi mes variations ont-elles été importées comme produits séparés ?

La colonne Parent est manquante, mal orthographiée, ou ne correspond pas exactement au SKU du parent. Chaque ligne de variation doit avoir le Type défini sur variation et une valeur Parent contenant le SKU du parent ou id: suivi de son ID de produit. Les espaces de fin sont le coupable habituel, car ils sont invisibles dans une feuille de calcul mais brisent la correspondance.

Pourquoi mon importation s'arrête-t-elle en cours de route ?

Ceci est un délai d'attente, pas un problème de données. PHP arrête tout script exécuté plus longtemps que max_execution_time, qui est par défaut de 30 secondes sur la plupart des serveurs. Divisez le fichier en lots de 500 à 1 000 lignes, ou placez-le sur le serveur et utilisez l'option chemin d'accès au fichier sous Options avancées.

Puis-je annuler une importation de produits WooCommerce ?

Non, WooCommerce n'a pas d'option d'annulation pour les importations, c'est pourquoi une sauvegarde avant toute opération importante est essentielle. Pour corriger une mauvaise importation, corrigez le fichier source et exécutez-le à nouveau en cochant Mettre à jour les produits existants afin que les lignes soient corrigées sur place plutôt que dupliquées.