Des guides pratiques pour vos données produit WooCommerce.
Préparez des exports plus propres, des migrations plus sûres et des workflows réutilisables.
Préparez des exports plus propres, des migrations plus sûres et des workflows réutilisables.

Réponse courte
Choisissez d'abord la destination. Prenez le CSV WooCommerce pour l'importeur WooCommerce, le CSV Shopify pour Shopify, le CSV standard pour travailler dans un tableur ou préparer un mapping, et le JSON lorsqu'un script doit conserver la structure du catalogue. Trois fichiers portent l'extension .csv, mais leurs colonnes ne sont pas interchangeables.
Un export peut s'ouvrir sans erreur dans Excel et rester inutilisable à l'étape suivante. WooCommerce cherche des types de produits, des SKU parents et des colonnes d'attributs numérotées. Shopify s'appuie sur les handles, les options et des lignes dédiées aux images. Un CSV standard est plus simple à relire, mais il ne prétend pas respecter le schéma de l'une de ces plateformes.
Nous avons comparé les quatre formats générés par les exporteurs actuels de ScrapeWoo. Tous les fichiers proviennent du même catalogue contrôlé. Les différences observées viennent donc du format de destination, pas des produits sources.
Notre catalogue contenait deux produits. Le premier était une chaussure variable avec deux tailles, deux images de galerie, des SKU de variantes, des stocks distincts et un prix promotionnel. Le second était un sac simple. Au total, le test portait sur deux produits, deux variantes et trois images produit.
| Format | Résultat du test | Destination prévue |
|---|---|---|
| CSV WooCommerce | 30 colonnes et 4 lignes de données | Importeur produit WooCommerce |
| CSV Shopify | 34 colonnes et 4 lignes de données | Importeur produit Shopify |
| CSV standard | 23 colonnes et 4 lignes de données | Tableur et mapping personnalisé |
| JSON | 2 objets produit avec 2 variantes imbriquées | Code, automatisations et outils internes |
Les trois CSV contenaient chacun quatre lignes de données, mais pas les mêmes lignes. Les en-têtes, les relations entre produits et variantes, et la gestion des images changeaient selon la destination. Un nombre de lignes identique ne rend pas les fichiers compatibles.
Un CSV destiné à une plateforme ressemble davantage à une fiche d'instructions qu'à un tableau neutre. Les noms de colonnes et les lignes répétées indiquent à la destination comment reconstruire le catalogue.
Le fichier WooCommerce généré contenait une ligne parent pour la chaussure variable, puis une ligne par variation. La colonne Parent reliait les deux tailles au SKU du produit parent. Les attributs utilisaient des groupes numérotés comme Attribute 1 name et Attribute 1 value(s).
Le fichier comportait aussi les champs WooCommerce liés au type, à la publication, à la visibilité dans le catalogue et au prix promotionnel. Les URLs d'images partageaient une même cellule, séparées par des virgules. Ces choix suivent le schéma CSV produit de WooCommerce.
Le fichier Shopify utilisait le handle ridge-trail-shoe pour relier le produit variable, ses variantes et son image supplémentaire. Chaque taille conservait son SKU, ses options, son prix et sa quantité en stock. La deuxième image de galerie occupait une ligne séparée avec le même handle.
ScrapeWoo a produit 34 colonnes Shopify avec l'encodage demandé par la documentation actuelle du CSV produit Shopify : UTF-8 sans marque d'ordre des octets et fins de ligne LF. Les fichiers WooCommerce et CSV standard comportaient une marque d'ordre des octets et des fins de ligne CRLF, plus pratiques pour les tableurs.
Même extension, contrat différent
Renommer woocommerce-products.csv en shopify-products.csv ne modifie pas le contenu. L'importeur lit les en-têtes et les relations entre les lignes, pas le nom du fichier.
Le CSV standard de ScrapeWoo est fait pour être lu et remappé. Chaque produit et chaque variante disposait de sa propre ligne. Les colonnes Row type et Parent SKU rendaient leur relation explicite. Les catégories, tags, attributs et URLs d'images restaient dans des cellules faciles à parcourir.
Choisissez ce format pour auditer un catalogue dans Excel ou Google Sheets, transmettre un tableau propre, retirer des colonnes, comparer les stocks ou préparer les données pour une destination dotée de son propre outil de mapping. Ce n'est pas un fichier d'import universel. Le système qui le reçoit doit encore comprendre la signification de chaque colonne.
L'export JSON contenait deux objets produit. Les deux variantes de la chaussure restaient dans le tableau variants du produit parent au lieu d'être transformées en lignes indépendantes. Les images, attributs, catégories et dimensions restaient eux aussi sous forme de tableaux ou d'objets imbriqués.
Cette structure convient à un script, un service catalogue interne ou une automatisation qui doit parcourir les produits et leurs variantes. Le JSON représente directement les objets et les tableaux, comme le définit la RFC 8259. Pour un travail manuel, le CSV standard sera généralement plus confortable. Pour du code, le JSON évite de reconstruire les relations parent-enfant depuis des lignes à plat.
Les importeurs produit de WooCommerce et Shopify n'acceptent pas automatiquement ce JSON. Utilisez-le lorsque l'outil suivant lit explicitement ce format ou lorsque vous contrôlez le code d'intégration.
| Votre prochaine action | Format conseillé | Contrôle à effectuer |
|---|---|---|
| Importer ou mettre à jour des produits dans WooCommerce | CSV WooCommerce | SKU, variations parentes, attributs et chemins de catégories |
| Préparer les produits pour Shopify | CSV Shopify | Handles, options, URLs d'images, poids et taxonomie |
| Relire ou modifier le catalogue dans un tableur | CSV standard | Types de lignes, SKU parents et séparateurs |
| Alimenter un script, une automatisation ou un outil interne | JSON | Schéma attendu par le code et champs qu'il ignore |
Si la destination fournit un modèle ou un schéma d'import, utilisez ce schéma. Un CSV standard propre constitue une bonne copie de travail, mais il ne doit pas être envoyé aveuglément dans un importeur de plateforme.
Nous avons généré et inspecté les quatre fichiers avec les exporteurs actuels de ScrapeWoo. Nous ne les avons pas envoyés dans toutes les configurations WooCommerce, toutes les boutiques Shopify ou chaque outil catalogue tiers. Des extensions peuvent ajouter des champs inconnus du noyau de la plateforme, et un importeur non documenté peut imposer ses propres colonnes.
Effectuez un import sur un petit lot lorsque la destination modifie des données en production. Pour une simple vérification, travaillez sur un duplicata et conservez l'export original. Si votre destination est Shopify, poursuivez avec le guide consacré à la migration des produits WooCommerce vers Shopify avec un CSV. Si vous devez encore récupérer les produits sources, commencez par l'extraction WooCommerce sans accès administrateur.