Importer un catalogue fournisseur dans Shopify avec Claude : du PDF au fichier CSV prêt à importer

Un catalogue fournisseur en PDF, un modèle de colonnes Shopify, deux prompts à copier et une vérification en trois points : la méthode pour obtenir un CSV importable sans erreur.

Oui, Claude sait transformer un catalogue fournisseur en PDF en fichier CSV que Shopify accepte. Tu lui envoies le PDF et la liste des colonnes du modèle Shopify, il produit le tableau, puis tu vérifies trois choses avant l'import : des Handles uniques, des prix sans symbole monétaire et des URLs d'images publiques. C'est une des tâches concrètes qu'on voit dans apprendre à utiliser Claude au quotidien, et elle ne demande aucun code.

En bref :

  • Un CSV Shopify est un fichier UTF-8 où chaque ligne correspond à une variante, le champ Handle regroupant les variantes d'un même produit.
  • Seule la colonne Title est obligatoire pour un nouveau produit, et Handle le devient dès qu'il y a des variantes (aide officielle Shopify).
  • Traiter le PDF par petits lots évite les troncatures et permet de comparer l'extraction au document d'origine.
  • Les trois causes d'échec les plus courantes sont les Handles en doublon, les prix mal formatés et les URLs d'images inaccessibles.
  • Claude accélère l'extraction et le mapping, mais marge et TVA se contrôlent à la main sur un échantillon avant publication.

Comment passer d'un catalogue PDF fournisseur à un CSV Shopify avec Claude ?

Tu envoies le PDF dans une conversation, tu demandes d'abord un tableau brut pour vérifier l'extraction, puis tu fournis le gabarit des colonnes Shopify pour qu'il génère le CSV. Tu contrôles un petit lot, puis tu importes. Le point de départ est le fichier modèle que Shopify te laisse télécharger dans l'admin, sur lequel tu alignes tout le reste.

Voici la correspondance habituelle entre ce qu'un fournisseur met dans son catalogue et les colonnes Shopify :

Dans le PDF fournisseurColonne ShopifyRemarque
Nom du produitTitleUne seule fois par produit
RéférenceVariant SKUGarder zéros initiaux et tirets tels quels
PrixVariant PriceUn nombre seul, jamais vide
Taille, couleurOption1 Name / Option1 ValueUne ligne par variante
MarqueVendorSouvent le nom du fournisseur
Texte descriptifBody (HTML)Première ligne du produit uniquement
Lien ou nom de photoImage SrcURL publique et directe

Quelles colonnes le fichier CSV de Shopify exige-t-il vraiment ?

Pour créer un nouveau produit, seule la colonne Title est obligatoire. Dès que tu as des variantes, URL handle (le Handle) le devient aussi. C'est ce que précise l'aide officielle Shopify, qui reste la référence à jour pour la liste complète des colonnes.

Le Handle est l'identifiant unique d'un produit. Pour un produit à trois tailles, tu écris trois lignes avec le même Handle. Title, description, vendeur et tags ne se remplissent que sur la première ligne : les lignes suivantes ne portent que le Handle, les valeurs d'option, le SKU et le prix de leur variante.

Deux détails qui font perdre du temps :

  • Les colonnes de variante (SKU, poids) exigent Option1 name et Option1 value. Sans elles, Shopify crée une variante par défaut et supprime les variantes existantes lors d'une mise à jour.
  • La colonne Status vaut active par défaut. Pour un premier import, mets draft : tu relis les produits dans l'admin avant de les publier.

Comment extraire proprement les données d'un PDF avec Claude ?

Envoie le PDF et demande une extraction brute, sans aucune transformation. Tu compares quelques lignes avec le document d'origine avant d'aller plus loin : si l'extraction est fausse ici, tout ce qui suit le sera aussi. La documentation d'Anthropic indique les types de fichiers acceptés et les limites de taille et de contexte à garder en tête pour un gros catalogue.

Pour un gros catalogue, découpe par plages de pages plutôt que de tout envoyer d'un coup. Un lot plus petit limite les troncatures et te laisse corriger au fur et à mesure.

Voici le catalogue fournisseur (pages 1 à 8 du PDF joint).
Extrais UNIQUEMENT les produits des pages 1 à 8, sous forme de tableau avec ces colonnes :
référence, nom du produit, taille, couleur, prix, description.
Règles :
- Ne reformule rien, recopie les valeurs telles qu'elles sont écrites.
- Garde les références exactement comme dans le PDF (tirets, zéros initiaux).
- Si une valeur est illisible ou absente, écris A_VERIFIER.
- Si un tableau continue sur la page suivante, regroupe les lignes d'un même produit.
Termine par la liste des lignes où tu as un doute.

Les cas qui piègent le plus : un tableau coupé sur deux pages, un prix barré à côté d'un prix remise (précise lequel garder), des références avec zéros initiaux que le tableur transformera en nombres. La consigne A_VERIFIER est utile : Claude te signale lui-même ce qu'il a deviné au lieu de le masquer.

Comment mapper et nettoyer les données avant de générer le CSV ?

Une fois l'extraction validée, tu donnes à Claude le gabarit de colonnes Shopify et le tableau brut, et tu lui demandes de produire le CSV final. C'est dans cette étape que se règlent les formats : Handles propres, prix avec un point, variantes regroupées, descriptions en HTML simple.

Voici le tableau validé et l'en-tête du CSV Shopify :
Handle,Title,Body (HTML),Vendor,Option1 Name,Option1 Value,Variant SKU,Variant Price,Image Src,Status

Génère le CSV complet en respectant ces règles :
- Handle : minuscules, sans accents, mots séparés par des tirets, unique par produit.
- Un même produit avec plusieurs tailles = plusieurs lignes avec le même Handle ; Title, Body et Vendor uniquement sur la première ligne.
- Variant Price : nombre avec un point décimal, sans symbole monétaire (12.50).
- Prix de vente = prix fournisseur x 2, arrondi à 0.90 près. Applique ce calcul, ne le déduis pas.
- Body (HTML) : 2 phrases en balises p, sans inventer de caractéristique absente du tableau.
- Status : draft.
- Image Src : laisse vide si aucune URL n'est fournie.
Renvoie le CSV dans un bloc de code, puis liste les doublons de Handle et les lignes sans prix.

Ce que tu ne délègues pas à l'aveugle : la marge et la TVA. Claude applique la règle que tu écris, mais c'est à toi de vérifier qu'elle est juste. Reprends 5 lignes au hasard et refais le calcul à la main. Pour passer d'un prix HT à un prix TTC, contrôle le taux de TVA en vigueur (l'Insee les publie) et rappelle-toi que Service-Public.fr cadre l'affichage des prix TTC sur une boutique destinée aux particuliers.

Quand le CSV est prêt, copie-le dans un tableur et enregistre-le en UTF-8. Si tu construis ta boutique de zéro, la page sur Claude pour l'e-commerce rassemble les autres étapes (fiches, emails, automatisations).

Pourquoi Shopify rejette-t-il mon CSV et comment corriger les erreurs d'import ?

Shopify rejette un CSV le plus souvent pour un encodage mauvais, un Handle répété, un prix mal formaté ou une URL d'image inaccessible. Le message d'erreur indique la ligne : colle-le à Claude avec la ligne concernée, il te renvoie la correction.

Message ou symptômeCause probableCorrection
Accents illisibles, « Illegal quoting on line »Encodage autre qu'UTF-8Réenregistrer le fichier en UTF-8 (fins de ligne LF), puis relancer
« Missing or stray quote on line »Guillemets courbes ajoutés par le tableur, ou guillemet en tropRemplacer par des guillemets droits
« Ignored line... because handle already exists »Même Handle réutilisé pour deux produits différentsRendre chaque Handle unique, ou cocher l'écrasement si c'est une mise à jour
« Options are not unique »Deux variantes avec les mêmes valeurs d'optionDifférencier les valeurs d'option
Image non téléchargéeURL non publique ou non directeUtiliser une URL publique commençant par http://
Ligne rejetée sur le prixColonne Price vide (l'aide Shopify la déclare obligatoire)Un nombre seul, jamais de cellule vide

Fais toujours un import test sur 5 produits avant le lot complet. Tu repères les erreurs de format sans toucher à la boutique en production, et tu importes en draft pour relire les fiches dans l'admin. L'aide Shopify précise qu'avec l'option « Overwrite products with matching handles », une cellule vide non obligatoire efface la valeur existante : prudence si tu réimportes pour corriger quelques champs.

Questions fréquentes

Claude peut-il lire n'importe quel PDF de catalogue fournisseur ?

Il traite en général mieux les PDF textuels aux tableaux bien structurés. Les PDF scannés ou très mal mis en page demandent un contrôle plus serré : on vérifie l'extraction brute avant toute transformation, et on traite le fichier par petits lots.

Faut-il un abonnement payant pour importer un catalogue de plusieurs centaines de produits ?

Pas forcément pour le principe, mais un catalogue volumineux consomme vite les limites de la formule gratuite. Découper le travail en lots et utiliser un projet Claude pour conserver les consignes limite la consommation, une formule payante devenant utile dès que les imports sont réguliers.

Comment gérer les produits avec plusieurs tailles ou couleurs dans le CSV ?

On donne le même Handle à toutes les lignes du produit, on renseigne Option1 Name (par exemple Taille) et Option1 Value sur chaque ligne, avec un SKU et un prix par variante. Le titre, la description et l'image principale ne figurent que sur la première ligne du produit.

Que faire si Shopify affiche des accents illisibles après l'import ?

C'est presque toujours un problème d'encodage : le fichier a été enregistré dans un encodage autre que l'UTF-8. Il faut réenregistrer le CSV en UTF-8 (option disponible à l'export de Google Sheets ou d'Excel) puis relancer l'import.

Peut-on mettre à jour les prix existants avec un CSV sans créer de doublons ?

Oui, en important un CSV qui reprend les mêmes Handles et en cochant l'option d'écrasement des produits existants. Pour ne modifier que quelques champs, on peut aussi passer par l'export de la boutique, ajuster les prix avec Claude puis réimporter.

Et quand le fournisseur envoie un nouveau catalogue chaque saison ?

Ne recommence pas de zéro. Garde le prompt d'extraction, le prompt de mapping et le gabarit de colonnes dans un projet Claude : tu les retrouves à chaque envoi, et la configuration de Claude au quotidien t'explique comment organiser ce genre de projet.

Pour la mise à jour, envoie l'ancien CSV et le nouveau catalogue extrait, et demande à Claude de ne lister que les lignes dont le prix ou la référence a changé, plus les produits disparus ou ajoutés. Tu importes ensuite uniquement ces lignes avec l'option d'écrasement. Les fiches créées avec un site construit avec Claude ou une boutique Shopify restent ainsi à jour sans refaire tout le travail, et chaque lot passe par une relecture humaine avant d'être publié.

Si tu veux apprendre à monter ce genre de routine de bout en bout, de l'extraction à l'automatisation, la formation pour travailler avec Claude chaque jour couvre ces étapes en cohorte, avec des projets concrets.

Pilier 5 · Mastery

Claude pour l'e-commerce : fiches produits, emails, automation

Générer des fiches produits qui vendent, des séquences email post-achat, et automatiser les opérations e-commerce avec Claude.

Découvrir le pilier complet →