Pour les grands catalogues

Générer des GARAN-Labels pour un grand catalogue : CSV ou API

Vous souhaitez générer des GARAN-Labels en masse pour quelques centaines ou quelques milliers de produits, et il vous faut trois réponses avant de commencer : l'outil peut-il absorber mon catalogue, combien cela va-t-il coûter, et combien de temps cela va-t-il prendre ? Cette page répond aux trois avec des chiffres concrets.

Quelle méthode pour votre catalogue ?

La bonne méthode dépend de deux choses : combien de produits ont besoin d'un label, et à quelle fréquence ces données changent.

Méthode	Taille du catalogue	Fréquence des changements	Idéal pour
Saisie manuelle	Moins de 10 labels	Rarement	Petites boutiques, une poignée de produits sous garantie, ajouts ponctuels.
Import CSV	De 10 à 10 000 labels	Plutôt stable, une mise à jour tous les quelques mois	Distributeurs et marques avec un catalogue large mais stable. Aucune programmation nécessaire.
API	Toute taille	Changements fréquents, nouveaux produits chaque semaine	Boutiques pilotées par un PIM ou un ERP, agences, et tous ceux qui veulent que le label soit créé automatiquement à la création du produit.

Vous pouvez combiner les deux : la plupart des grands catalogues commencent par un import CSV pour la gamme existante, puis passent à l'API pour les nouveautés. Les détails techniques des deux se trouvent sur la page de référence API & CSV.

Filtrer d'abord, générer ensuite : quelles références ont vraiment besoin d'un label

Le levier le plus efficace pour réduire le coût d'un traitement en masse intervient avant l'import. Le GARAN-Label n'est requis que pour les produits pour lesquels un fabricant propose une garantie commerciale de durabilité gratuite, couvrant l'ensemble du produit, d'une durée supérieure à deux ans. Tous les autres produits ont besoin de la mention légale de garantie gratuite, mais pas du GARAN-Label.

Passez votre export produits au crible de trois questions :

S'agit-il d'un bien physique ? Les contenus numériques et les services ne sont pas concernés.
Existe-t-il une garantie fabricant de plus de deux ans ? Une garantie de deux ans ou moins ne déclenche pas le label.
Est-elle gratuite et couvre-t-elle l'ensemble du produit ? Les extensions de garantie payantes et les garanties limitées à un composant ne comptent pas.

En pratique, un catalogue de 5 000 références se réduit souvent à quelques centaines de produits réellement concernés. Tout le reste peut sortir du CSV avant l'import. Qui est concerné par l'obligation : les détails →

Ce qu'il vous faut par référence : marque, modèle, durée

Le label lui-même est simple. Il porte trois valeurs, et le CSV a besoin d'exactement ces trois colonnes :

brand

La marque, telle qu'elle figure sur le produit.

model

L'identifiant du modèle. Les déclinaisons qui le partagent partagent aussi le label.

duration

La durée de garantie en années, entières ou par demi-année, par exemple 3 ou 2.5, avec un point comme dans l'exemple.

La vraie difficulté : la durée de garantie

La marque et le modèle existent dans tous les systèmes de boutique. La durée de garantie du fabricant, en général, non. La plupart des bases produits ont au mieux un champ « garantie », et ce champ contient souvent les conditions du revendeur plutôt que la garantie du fabricant. Où l'information se cache habituellement :

Les tarifs fournisseurs et les fiches techniques produit, souvent sous forme de remarque en texte libre.
Les conditions de garantie sur le site du fabricant ou dans la notice glissée dans l'emballage.
Un attribut PIM ou ERP renseigné une fois pour quelques marques et jamais maintenu.

Raccourci pratique : les fabricants fixent rarement la durée par référence. Elle est généralement constante par marque ou par gamme de produits. Relevez la durée une fois par marque et par gamme, puis rapprochez-la de votre export de références. Un travail de recherche sur des milliers de lignes se transforme ainsi en une liste de quelques dizaines d'entrées.

Exemple chiffré : un catalogue de 1 000 références

Les chiffres ci-dessous sont une illustration avec des nombres ronds, pas une mesure relevée chez un client précis. Ils montrent comment fonctionne le calcul, pour que vous puissiez y reporter votre propre catalogue.

Références dans la boutique	1 000	Export complet, toutes catégories.
Références avec une garantie fabricant de plus de deux ans	380	Après les trois questions de filtrage ci-dessus. Les 620 autres n'ont besoin que de la mention gratuite.
Combinaisons uniques marque + modèle + durée	240	Les tailles et les coloris partagent un identifiant de modèle, donc un label.
Crédits consommés	240	Un crédit par label généré. Les lignes avec une combinaison en double réutilisent le label existant.
Pack de crédits	500 crédits pour 49 €	Il reste 260 crédits pour les nouveautés. Ou bien deux packs de 100 crédits pour 38 € si vous savez que la gamme n'évoluera pas.
Votre temps	Une demi-journée	Presque tout passe dans la collecte des durées de garantie. L'import prend quelques minutes, la génération tourne sans surveillance.

Le résultat est un fichier avec une ligne par ligne d'entrée et l'URL du label correspondant. Vous téléchargez ensuite les images et les placez dans votre boutique, voir ci-dessous.

Préparer le fichier CSV

N'importe quel tableur peut produire le fichier. Ce qui compte :

Colonnes : brand, model, duration et, en option, force_regeneration (1 force une nouvelle génération, vide ou 0 réutilise un label existant).
Séparateur : virgule ou point-virgule. L'import détecte celui que vous avez utilisé à partir de la ligne d'en-tête. Excel en français enregistre par défaut avec des points-virgules, ce qui convient parfaitement.
Encodage : UTF-8, pour que les accents, cédilles et caractères spéciaux des noms de marque et de modèle arrivent intacts.
Limite de lignes ou de taille de fichier : aucune. Le fichier est lu ligne par ligne, quelle que soit sa taille.
Format : avant l'import, vous choisissez PNG, EPS ou PDF pour l'ensemble du fichier. Le PNG est celui qu'il vous faut pour la boutique, l'EPS et le PDF servent à l'impression.
Traitement : en arrière-plan, avec un indicateur de progression. Vous pouvez fermer l'onglet, vous déconnecter et revenir ; le traitement continue.

brand;model;duration;force_regeneration
Bosch;GSR 18V-55;3;
Bosch;GSR 18V-55;3;
Makita;DHP486;3;
Miele;W1 WCD 120;5;

Les deux lignes Bosch sont volontaires : elles montrent ce que fait la déduplication. Les deux lignes reçoivent la même URL de label, un seul crédit est consommé.

Entrée : une ligne par produit ou par modèle.

Fichier de résultat d'un traitement en masse de GARAN-Labels avec une colonne Label-URL supplémentaire par ligne

Sortie : les mêmes lignes, plus l'URL du label pour chacune.

Déduplication : le levier de coût des traitements en masse

Un crédit paie un label généré, pas une ligne de votre fichier. La règle est simple : marque + modèle + durée identiques = un seul label, quel que soit le nombre de lignes ou de déclinaisons qui y renvoient. Trois conséquences pour un grand catalogue :

Les déclinaisons sont gratuites. Dix coloris d'un même modèle consomment un seul crédit.
Relancer le même fichier ne coûte rien tant que les labels existent encore sur notre serveur. Vous récupérez les URL existantes.
Seuls les vrais changements coûtent des crédits. Une durée de garantie modifiée est une nouvelle combinaison, donc un nouveau label. Passer force_regeneration à 1 relance aussi la génération et consomme un crédit : laissez-le vide, sauf si vous avez besoin d'un nouveau fichier.

Le calcul de l'exemple ci-dessus : 1 000 lignes, 240 combinaisons uniques, 240 crédits. La tarification est au label généré, pas au mois ni au poste utilisateur : un catalogue qui ne bouge pas ne continue pas à coûter de l'argent.

Packs de crédits

Crédits	Prix	Prix par label
100	19,00 €	0,19 €
500	49,00 €	0,10 €
2 000	144,00 €	0,07 €
10 000	569,00 €	0,06 €

Tous les prix s'entendent hors TVA légale. 1 crédit équivaut à 1 label nouvellement généré. Les répétitions identiques (même marque, même modèle, même durée de garantie) ne consomment pas de crédit supplémentaire. Sans abonnement, sans achat minimum.

Intégrer les fichiers dans votre boutique : URL hébergées ou auto-hébergement

Chaque label généré est accessible via l'URL de votre fichier de résultat. Pour un grand catalogue, vous avez deux façons de l'utiliser :

URL hébergée (court terme)

Liez l'image directement. Convient pour tester et remplir rapidement la boutique, mais les labels sont archivés 30 jours après leur génération. Passé ce délai, le lien casse et une nouvelle demande régénère le label, en consommant un crédit.

Auto-hébergement (recommandé)

Téléchargez les images dans les 30 jours, téléversez-les dans votre propre médiathèque ou CDN et associez-les à vos produits via la référence ou le modèle. C'est un travail ponctuel, et le label reste en ligne aussi longtemps que vous en avez besoin.

La façon de faire l'association dépend de votre plateforme : un metafield dans Shopify, un attribut produit dans Magento 2, un champ personnalisé dans WooCommerce. Chaque guide décrit la méthode en masse. Guides par canal de vente →

Erreurs et cas particuliers dans les gros fichiers

Situation	Ce qui se passe	Que faire
Une ligne n'a pas de modèle (ou pas de marque, ou pas de durée)	Seule cette ligne est marquée en erreur dans le fichier de résultat. Toutes les autres sont traitées.	Corrigez la ligne et réimportez-la dans un petit fichier complémentaire.
Une colonne obligatoire manque dans l'en-tête	Tout le traitement s'arrête avec le message « Missing required column ».	Vérifiez les noms d'en-tête : exactement `brand`, `model`, `duration`.
L'en-tête semble correct, mais le traitement signale quand même une colonne `brand` manquante	Le fichier commence très probablement par une marque d'ordre des octets (BOM) invisible. Excel en ajoute une quand vous enregistrez en « CSV UTF-8 ».	Enregistrez en CSV simple, ou supprimez la marque avec un éditeur de texte. Les noms de colonnes doivent commencer dès le tout premier octet.
Lignes avec une durée de deux ans ou moins	Elles sont générées comme les autres et consomment un crédit. L'outil ne décide pas à votre place si un label est requis.	Filtrez-les avant l'import ; ces produits n'ont pas besoin de GARAN-Label.
Tailles et coloris sur des lignes séparées	Les lignes avec les mêmes marque, modèle et durée partagent un label et un crédit.	Rien. Gardez les lignes si cela facilite le rapprochement du résultat avec vos références.
Virgules ou points-virgules dans un nom de modèle	Les règles standard de guillemets CSV s'appliquent.	Entourez la valeur de guillemets doubles, comme tout tableur le fait automatiquement.
Les accents s'affichent mal sur le label	Le fichier a été enregistré dans un ancien encodage.	Réenregistrez-le en UTF-8 et réimportez-le avec `force_regeneration` à `1` pour les lignes concernées.

Testez d'abord la structure de votre fichier : le mode bac à sable fonctionne aussi pour les imports CSV et génère des exemples PNG filigranés sans consommer de crédit.

Prêt à étiqueter l'ensemble de votre catalogue ?

Inscrivez-vous gratuitement, importez un fichier de test en mode bac à sable et vérifiez le résultat avant d'acheter le moindre crédit.

Essai gratuit

Besoin des paramètres techniques et d'exemples de code ? Référence API & CSV →

Qui a réellement besoin du GARAN-Label →
Guides d'intégration par canal de vente →

FAQ

Questions sur la génération de GARAN-Labels en masse

Combien de temps faut-il pour générer 1 000 GARAN-Labels ?

Environ deux à quatre minutes. Vous importez le fichier une seule fois et la génération s'exécute en arrière-plan sur nos serveurs, par lots, même si vous fermez le navigateur. Vous téléchargez ensuite le fichier de résultats. Pour un catalogue de cette taille, prévoyez une après-midi pour préparer les données, pas pour la génération elle-même.

Y a-t-il une limite de lignes ou de taille pour l'import CSV ?

Non, ni pour le nombre de lignes ni pour la taille du fichier. Le fichier est lu ligne par ligne et traité en arrière-plan, les très gros catalogues passent donc sans découper le fichier. Si vous préférez, vous pouvez tout de même importer un fichier par marque ou par fournisseur pour garder des fichiers de résultat faciles à exploiter.

Est-ce que je paie pour chaque ligne de mon CSV ?

Non. Un crédit n'est consommé que lorsqu'un label est réellement généré. Les lignes avec une combinaison identique de marque, modèle et durée de garantie partagent un seul label, et une ligne qui ne fait que redemander un label existant dans sa fenêtre de 30 jours ne coûte rien.

Les déclinaisons comme les tailles ou les coloris ont-elles chacune besoin de leur propre label ?

En général, non. Le label indique la marque, le modèle et la durée de garantie. Si vos déclinaisons partagent le même identifiant de modèle et la même garantie, un seul label les couvre toutes. C'est précisément là que la déduplication vous fait économiser des crédits.

Quelle est la différence entre cette page et la page API ?

Cette page vous aide à décider comment étiqueter un grand catalogue et ce que cela coûte. La page API est la référence technique, avec les paramètres et des exemples de code pour cURL, PHP, Python et Node.js. Référence API & CSV →

D'autres questions ? Voir toutes les FAQ →