Mapper les colonnes du fournisseur aux champs produit WooCommerce

Comment mapper les colonnes du fournisseur aux champs produit WooCommerce

Mapper les colonnes du fournisseur aux champs produit WooCommerce consiste à décider quelle information du tarif devient le nom, le SKU, le prix, la catégorie, l’image ou l’attribut du catalogue. Le fichier du grossiste arrive avec ses propres libellés : code article, description commerciale, famille, EAN. WooCommerce attend des noms de colonnes différents et des types de produits distincts. Sans tableau de correspondance, l’import crée des fiches incomplètes, des doublons et des flux refusés par les canaux.

Un crawler lit le titre visible, le texte de la fiche, les images et les données structurées que WooCommerce expose déjà sur la page. Si la colonne de description du fournisseur arrive dans le nom, le titre devient un paragraphe. Si le SKU manque, la synchronisation suivante ne dispose d’aucune clé. Si l’EAN se trouve dans une note libre, le GTIN n’entre pas dans les flux. Le mécanisme est visible : des champs vides ou placés au mauvais endroit, et non un algorithme mystérieux.

Pourquoi le fichier du fournisseur n’est jamais prêt pour WooCommerce

Le tarif du fournisseur est un outil de vente en gros, pas un schéma de catalogue : les noms de colonnes, les décimales et les familles de produits ne correspondent pas aux champs natifs de WooCommerce.

Le grossiste optimise son tableau pour la prise de commande : code interne, description abrégée, prix par paliers, pièces par carton. WooCommerce optimise la fiche pour l’acheteur et l’indexation : nom lisible, SKU stable, prix avec un seul séparateur décimal, catégories de la boutique, attributs visibles dans les filtres, images avec URL publique. Les deux objets partagent les faits, article, prix, code-barres, mais pas la forme.

Un exemple illustratif : une boutique qui gère quarante références reçoit un CSV avec les colonnes COD, DESCR, PZ, FAM, BARCODE. La ligne DESCR contient « VASO SMALTO BLU D20 H18 PZ/CT 6 ». Ce texte n’est ni un titre, ni une description, ni un ensemble d’attributs. Ce sont trois champs compressés en un seul. Tant qu’ils ne sont pas séparés, l’import publie une fiche qu’un assistant aura du mal à citer et que Google Shopping lit comme un titre confus.

Le texte de la page et les données structurées fonctionnent ensemble : le balisage confirme le prix et la disponibilité lorsqu’ils correspondent à la page.

Champs obligatoires et facultatifs d’un produit WooCommerce

Pour créer une fiche, un nom suffit ; pour la vendre, il faut un prix et, si vous gérez les stocks, une quantité ; pour éviter les doublons, il faut un SKU ; le reste détermine si la fiche est complète pour la boutique et les flux.

Dans son fichier CSV natif, WooCommerce reconnaît des libellés anglais fixes. Vous ne pouvez pas laisser les noms du fournisseur dans l’en-tête en espérant que le plugin d’import les « comprenne ». Vous devez renommer les colonnes ou utiliser l’écran de correspondance dans Produits, Importer. Les champs utilisés presque systématiquement sont les suivants.

• Name : titre de la fiche, visible sur la page et dans les résultats.
• SKU : clé unique de la boutique ; sans SKU, chaque nouvel import risque de créer un doublon.
• Type : simple, variable, variation, grouped ou external.
• Regular price : prix catalogue au format de la boutique, généralement avec un point décimal.
• Description et Short description : texte long de la page et résumé dans les listes.
• Categories et Tags : chemins déjà existants ou à créer avant l’import.
• Images : URL publiques, une ou plusieurs, séparées selon les règles du CSV.
• Attribute n name / Attribute n value(s) : attributs globaux ou locaux (couleur, taille, matière).
• Parent : SKU du produit parent, uniquement sur les lignes de type variation.
• Stock et In stock? : quantité et indicateur de disponibilité, si la gestion des stocks est activée.

Le poids, les longueurs, la classe d’expédition, la classe de TVA et l’identifiant global (GTIN, si vous le trouvez dans les documents du fournisseur) sont facultatifs pour publier, mais leur absence se voit immédiatement dans les flux et sur la fiche. Selon Google Search Central, il existe deux grandes catégories de données structurées pour les produits : le balisage déjà produit par WooCommerce confirme les faits uniquement s’ils correspondent au titre, au prix et à la disponibilité indiqués sur la page.

Pour ceux qui importent les tarifs de plusieurs fournisseurs dans la même boutique

Ceux qui importent les tarifs de plusieurs fournisseurs dans la même boutique doivent traiter le SKU comme un espace de noms. Deux grossistes peuvent utiliser le même code « 1001 ». Préfixez le SKU (FORN1-1001) ou conservez une colonne fournisseur comme attribut masqué, jamais comme élément du titre. Le GTIN, s’il est présent et valide, reste l’identité de la pièce physique ; le SKU reste l’identité de la ligne dans votre logiciel de gestion.

Comment lire et mapper les colonnes du fournisseur une par une

Ouvrez le CSV du fournisseur, répertoriez chaque en-tête et inscrivez à côté le champ WooCommerce de destination, avec une règle pour les valeurs à séparer ou à écarter.

Ne commencez pas par l’import. Commencez par une feuille de mapping avec trois colonnes à vous : en-tête d’origine, champ WooCommerce, règle de nettoyage. Cette règle évite qu’une même colonne arrive dans deux champs ou dans aucun.

1. Ouvrez le fichier dans un tableur avec l’encodage UTF-8. Si Excel en français a utilisé le point-virgule, ne le convertissez pas au hasard : notez le séparateur avant l’enregistrement.
2. Figez la première ligne et parcourez les en-têtes. Marquez CODICE, ART, ITEM, REF comme candidats au SKU. Marquez DESCRIZIONE, NOME, ITEM NAME comme candidats au titre. Marquez EAN, GTIN, BARCODE, UPC comme candidats à l’identifiant global.
3. Ouvrez WooCommerce, Produits, Importer et comparez les libellés natifs (Name, SKU, Regular price, Categories, Images, Attribute 1 name). Lorsque les noms ne correspondent pas, renommez l’en-tête du CSV ou faites la correspondance manuellement dans le menu déroulant de l’écran d’import.
4. Pour chaque colonne ambiguë, écrivez la règle. Exemple : FAMIGLIA va dans Categories uniquement après la création des mêmes catégories dans la boutique ; COLORE et TAGLIA vont dans les attributs globaux (Produits, Attributs), et non dans le titre.
5. Choisissez le Type. Une ligne, un article vendable : simple. Même modèle, plusieurs tailles ou couleurs : un parent variable et des lignes variation avec un Parent identique au SKU du parent.
6. Normalisez les nombres. Un prix avec une virgule décimale doit être converti au format attendu par la boutique. Les quantités doivent être entières. Le poids doit utiliser l’unité définie dans WooCommerce, Réglages, Produits.
7. Enregistrez un CSV de test avec dix lignes, importez-le comme brouillon, ouvrez une fiche et vérifiez le nom, le SKU, le prix, les stocks, les attributs et l’image avant de toucher à l’ensemble du catalogue.

Un exemple illustratif de situation avant et après, présenté comme tel. Avant, une seule cellule : « MAGLIA COTONE UOMO BLU M 19,90 8001234567897 ». Après le mapping : SKU issu du code article ; Name « Maglia in cotone blu, uomo » ; attribut Materiale coton, attribut Colore bleu, attribut Taglia M ; Regular price 19.90 ; GTIN uniquement si le code-barres apparaît dans les documents du fournisseur et passe le chiffre de contrôle. La mention du carton n’est pas le titre.

Pour ceux qui ont peu de temps pour la routine quotidienne

Ceux qui ont peu de temps pour la routine quotidienne ne mappent pas chaque nouvelle ligne à la main. Figez le tableau de correspondance dans une feuille modèle et, à chaque nouveau tarif, ne renommez que l’en-tête. Si le fournisseur ajoute une colonne, traitez-la comme une exception : ignorez-la ou rattachez-la à un attribut déjà existant. Le coût caché n’est pas l’import, mais le fait de refaire les règles chaque lundi.

Erreurs courantes

Les erreurs de mapping qui dégradent le SEO et les flux sont toujours les mêmes : titre mal nettoyé, catégorie du grossiste utilisée à la place de celle de la boutique, GTIN inventé ou placé dans le mauvais champ, variantes séparées en produits simples.

Titre identique à la description du fournisseur. Le problème se manifeste ainsi : une fiche affiche un nom entièrement en majuscules, avec les pièces par carton, les codes internes et les dimensions collés les uns aux autres. Cela arrive parce que la colonne DESCR est la seule colonne textuelle et finit dans Name. Pour résoudre le problème, extrayez un titre court (produit, matière, caractéristique distinctive) et déplacez le reste dans Description ou dans les attributs. La casse de type Title Case s’applique ensuite, et non à la place du nettoyage.

Catégorie du fournisseur copiée comme catégorie de la boutique. Le problème se manifeste ainsi : dans Produits, Catégories, des dizaines d’entrées en double apparaissent (« CERAMICA », « Ceramica », « ceramiche ») et les filtres du thème ne regroupent rien. Cela arrive parce que FAMIGLIA ne correspond pas à la taxonomie que vous avez définie. Pour résoudre le problème, créez d’abord l’arborescence des catégories dans WooCommerce et effectuez la correspondance avec un tableau d’équivalences (FAMIGLIA « CER-VAS » → Catégorie « Vasi »). La catégorie de la taxonomie Google est un champ distinct : ce n’est pas le slug de la boutique et elle ne s’improvise pas dans le CSV si elle n’a pas été confirmée.

GTIN mal placé ou inventé. Le problème se manifeste ainsi : le flux signale des identifiants absents, en double ou non valides ; sur la fiche, le code se trouve dans les notes. Cela arrive parce que BARCODE a été placé dans Description ou parce que quelqu’un a copié un EAN depuis un site tiers. Pour résoudre le problème, copiez le code uniquement depuis les documents du fournisseur (colonne, photo de l’emballage, PDF) et laissez le champ vide s’il manque. Un GTIN ne se recherche pas sur le Web et ne se fabrique pas.

Variantes importées comme produits simples. Le problème se manifeste ainsi : trois fiches « même pull, trois tailles », trois URL et trois prix qui divergent lors de la première mise à jour. Cela arrive parce que le tarif contient une ligne pour chaque SKU enfant et que l’import utilise le type simple partout. Pour résoudre le problème : une ligne parent avec Type variable et les attributs utilisés pour les variations ; des lignes enfants avec Type variation, Parent égal au SKU du parent et une seule valeur d’attribut par ligne. Selon le blog des développeurs WooCommerce, à partir de la version WooCommerce 11.1, les galeries de variations seront activées pour chaque boutique : il est donc pertinent de mapper aussi les images par variante, et pas uniquement celle du parent.

Pour un artisan qui vend des céramiques et gère un catalogue de taille modeste

Un artisan qui vend des céramiques reçoit souvent de l’atelier une feuille où l’émail, le diamètre et les pièces par caisse se trouvent dans la même cellule. Ici, le mapping est court et doit être effectué une seule fois : SKU propre, nom avec la forme et la couleur, attributs Diamètre et Émail, poids pour l’expédition. Il n’est pas nécessaire de créer un produit variable si chaque vase est une pièce unique : Type simple, images différentes, aucun Parent.

Importer le CSV de la feuille du fournisseur vers le catalogue publié

L’import CSV natif de WooCommerce ne publie que ce qui a déjà été mappé : chargez un fichier de test, associez les colonnes, vérifiez une fiche en brouillon et importez le catalogue complet uniquement ensuite.

Le chemin dans le logiciel de gestion est Produits, Importer. WooCommerce demande le fichier, puis affiche chaque en-tête du CSV à côté d’un menu de champs connus. Si vous avez renommé les colonnes avec les noms natifs (Name, SKU, Regular price), la correspondance est presque automatique. Si vous avez conservé COD et DESCR, vous devez la faire manuellement. L’option de mise à jour des produits existants utilise le SKU comme clé : sans SKU, la mise à jour crée de nouvelles lignes.

1. Exportez d’abord le CSV d’un produit déjà publié (Produits, Exporter) et utilisez-le comme modèle de colonnes. C’est le vocabulaire que l’import comprend sans ambiguïté.
2. Copiez les valeurs du fournisseur sous ces en-têtes, et non l’inverse. Le tarif d’origine reste une archive ; le fichier d’import est un dérivé nettoyé.
3. Définissez Published sur -1 (brouillon) au premier passage. Les fiches ne seront ainsi pas publiées avec des titres mal nettoyés.
4. Chargez le fichier, contrôlez la correspondance colonne par colonne, lancez l’import et ouvrez trois fiches au hasard : une simple, une variante et une sans image.
5. Corrigez la feuille, et non les fiches une par une, puis réimportez en mettant à jour par SKU. Lorsque le nom, le prix, les stocks et les attributs correspondent, passez Published à 1.

Si le fournisseur ne vous transmet pas un CSV mais un tarif mis en page, le travail d’extraction se situe en amont du mapping. Dans ce cas, passez du PDF aux données produit, puis alignez les colonnes sur les champs WooCommerce. Il en va de même pour une photo d’étiquette : commencez par les faits visibles, puis associez-les au SKU, au nom et aux attributs.

Comment accélérer le mapping des grands catalogues sans tout refaire manuellement

Pour les grands catalogues, accélérez le mapping en figeant les règles de correspondance, les attributs globaux et les catégories avant l’import, puis en ne mettant à jour que les colonnes réellement modifiées par le fournisseur.

La tentation est d’ouvrir deux mille lignes et de nettoyer les titres à la main. Cette méthode ne passe pas à l’échelle. Préparez la boutique : dans Produits, Attributs, créez Couleur, Taille, Matière et Marque comme attributs globaux, avec les valeurs déjà utilisées dans la boutique. Dans Produits, Catégories, définissez l’arborescence. Dans la feuille de mapping, fixez les équivalences entre le fournisseur et ces listes. L’import écrit les valeurs connues ; les nouvelles valeurs restent visibles parce qu’elles ne correspondent pas à la liste.

• Mettez à jour par SKU uniquement le prix, les stocks et la disponibilité lorsque le tarif est un renouvellement.
• Excluez Name et Description du renouvellement automatique si vous les avez déjà réécrits dans un français lisible.
• Séparez les fichiers : un pour les nouveaux SKU, un pour les mises à jour et un pour les variations.
• Ne mélangez pas dans le même CSV les produits simples et les variations tant que la colonne Parent n’est pas remplie et cohérente.
• Écartez du fichier d’import les colonnes qui ne possèdent aucun champ correspondant (remises par paliers, commande minimale, notes internes du grossiste).

Un GTIN se lit uniquement dans les documents du marchand, sur une photo de l’emballage, dans un PDF ou dans une colonne du CSV, et doit passer le chiffre de contrôle : il ne s’invente pas et ne se recherche pas sur le Web.

Pour ceux qui alignent le même tarif sur plusieurs canaux de vente

Ceux qui alignent le même tarif sur plusieurs canaux de vente (Amazon, eBay, Etsy) doivent désigner une source de référence pour les faits. WooCommerce conserve le SKU, le titre de la boutique, le prix et les stocks. Les marketplaces reçoivent un export dérivé, et non le CSV brut du fournisseur. Si vous mappez le titre Amazon sur le Name de la boutique, vous perdez la formulation utile dans la vitrine. Préférez un attribut ou une colonne d’export par canal, et un seul Name conçu pour la fiche du site.

Pour un éventuel flux destiné aux assistants d’achat, la spécification OpenAI prévoit neuf champs obligatoires (item_id, title, description, url, brand, seller_name, image_url, availability, price avec devise). GTIN et MPN sont facultatifs, et le GTIN ne s’invente jamais. Ces champs sont remplis après le mapping WooCommerce, et non à la place de Name et SKU. Les noms link et image_link appartiennent à Merchant Center, et non à ce flux.

Comment Katapic aide à placer le tarif dans les bons champs

Katapic importe les données depuis des CSV, des PDF et des photos, complète uniquement les champs vides avec des faits vérifiés et renvoie les fiches vers WooCommerce avec la synchronisation bidirectionnelle.

Si le fournisseur vous envoie une feuille, l’import CSV l’intègre au catalogue de travail ; s’il vous envoie un tarif mis en page, la lecture page par page extrait les textes et les images intégrées, puis les associe aux produits. Une photo, une fiche : à partir de la photo, Katapic reconnaît le produit, la marque, la catégorie et les attributs, et tout reste modifiable avant de publier. Le remplissage des champs vides est une action distincte, demandée explicitement, avec une source.

Le scan gratuit d’un catalogue WooCommerce public, sans compte et en lecture seule, affiche deux scores par fiche (recherche classique et préparation pour les assistants), ainsi qu’une vérification de la préparation des données sur les champs manquants ou incorrects ; Pertinence et Complétude s’ajoutent avec un compte gratuit. La catégorie de la taxonomie Google est proposée pour chaque catégorie de la boutique : vous la confirmez, puis l’identifiant confirmé entre dans les flux. Les variantes probables (même titre avec taille, couleur ou conditionnement) sont proposées comme variantes d’un seul produit et regroupées uniquement après confirmation.

La synchronisation WooCommerce est bidirectionnelle, avec le plugin gratuit. La réécriture des fiches passe par un vérificateur d’affirmations : les marques, certifications et histoires de marque ne sont pas inventées ; si une dimension trouvée sur le Web contredit le titre du marchand, le fait du marchand est conservé. Les corrections gratuites (Title Case sur les titres entièrement en majuscules, nettoyage du HTML, état, déclaration sans GTIN fabricant, regroupement des variantes, confirmation de la catégorie Google) sont appliquées uniquement après confirmation explicite et restent annulables. Pour mettre de l’ordre dans le catalogue WooCommerce, partez des faits dont vous disposez déjà, et non d’un texte généré à votre place.

Questions fréquentes sur le mapping CSV dans WooCommerce

Quels champs sont obligatoires pour un produit WooCommerce lors d’un import CSV ?

Pour créer la fiche, le champ Name suffit au minimum. Pour la vendre, il faut Regular price et, si les stocks sont activés, Stock avec In stock?. Le SKU n’est pas imposé par le formulaire de création, mais sans SKU l’import ne peut pas effectuer de mise à jour et crée des doublons. Type devient nécessaire dès qu’il y a des variations. Les catégories, images, attributs et GTIN ne bloquent pas la publication, mais une fiche dépourvue de ces informations reste pauvre pour la boutique et les flux.

Comment mapper les colonnes du fichier fournisseur aux champs produit WooCommerce ?

Créez un tableau de correspondance : chaque en-tête du tarif possède un champ de destination (SKU, Name, Regular price, Categories, Images, Attribute) et une règle de nettoyage. Renommez ensuite l’en-tête du CSV avec les noms natifs ou faites la correspondance manuellement dans Produits, Importer. Effectuez un test sur dix lignes en brouillon. Importez le reste en mettant à jour par SKU uniquement lorsque le titre, le prix et les attributs correspondent.

Où placer le code EAN du fournisseur dans une fiche WooCommerce ?

L’EAN va dans l’identifiant global du produit (GTIN), et non dans le titre ou la description. Copiez-le uniquement s’il apparaît dans les documents du fournisseur et passe le chiffre de contrôle. Si la colonne est vide, laissez le champ vide : ne recherchez pas un code sur le Web et n’en inventez pas. Un EAN placé dans les notes n’entre pas dans les flux et n’aide pas la fiche.

Comment importer un CSV de produits WooCommerce sans dupliquer les SKU ?

Chaque ligne doit avoir un SKU unique dans la boutique. Lors de l’import, choisissez la mise à jour des produits existants : WooCommerce utilise le SKU comme clé. Préfixez les SKU si deux fournisseurs partagent le même code. N’importez pas deux fois un fichier sans SKU. Vérifiez d’abord Produits, Tous les produits, recherchez le SKU, puis lancez la mise à jour des prix et des stocks.

Comment attribuer la catégorie Google aux produits WooCommerce ?

La catégorie de la boutique (Produits, Catégories) n’est pas la catégorie de la taxonomie Google. Définissez d’abord l’arborescence interne, mappez la famille du fournisseur sur celle-ci, puis associez séparément l’identifiant Google confirmé à utiliser dans les flux. Ne collez pas la chaîne FAMIGLIA du grossiste dans le champ Google. Sans confirmation, vous disposez d’une catégorie de vitrine utile au thème, mais pas d’un identifiant de taxonomie pour les canaux.

Que se passe-t-il si les variantes du fournisseur arrivent sur des lignes distinctes ?

Si chaque taille ou couleur occupe une ligne et que vous les importez comme produits simples, vous obtenez des fiches jumelles et des URL distinctes. Le mapping correct consiste à créer un parent variable avec les attributs de variation et des enfants variation avec un Parent identique au SKU du parent. Une seule valeur d’attribut doit figurer sur chaque ligne enfant. Les images par variante sont liées à la ligne enfant, et non uniquement au parent, afin que la galerie affiche la bonne pièce.

Peut-on traiter un tarif PDF comme un CSV à mapper ?

Oui, mais en deux étapes. Commencez par extraire des pages et des tableaux les faits (code, nom, prix et éventuelles images intégrées) afin d’obtenir une grille. Cette grille suit ensuite les mêmes règles de mapping que le CSV : SKU, Name, prix, catégories et attributs. Sauter l’extraction et copier manuellement un PDF de cent pages est la méthode qui produit des titres mal nettoyés et des champs vides.