Tous les cours

Importer votre catalogue

Comment téléverser vos produits, quelles colonnes Bruxel reconnaît et ce qui arrive à ce qui était déjà chargé.

Ce tutoriel a une vidéo dans d'autres langues : en espagnol · en anglais

Formats et taille

Deux formats sont acceptés, et le fichier est validé par son contenu, pas seulement par son extension :

  • CSV en UTF-8.
  • Excel (.xlsx).
  • CSV jusqu'à 256 Mo et XLSX jusqu'à 10 Mo, avec jusqu'à 50 000 lignes et 512 colonnes.

Colonnes

Vous n'avez rien à renommer : Bruxel reconnaît plusieurs noms pour chaque colonne clé.

ColonneNoms reconnusObligatoire ?
SKUsku, upc, ean, gtin, codigo, id, product_id, id_productoOui
Nomname, nombre, title, titulo, product_name, name_mejorado, nombre_mejorado, nombre_originalOui
Marquebrand, marcaNon
Catégoriecategory, categoria, categories, categoria_especifica, subcategoria, departamentoNon

Les autres colonnes de votre fichier ne sont pas perdues. Avant toute écriture, la simulation les liste une par une et vous cochez celles à conserver : les cochées deviennent des données d'origine et alimentent la génération ; les autres restent dans votre fichier.

Et si votre fichier contient deux colonnes valables

Un catalogue enrichi contient souvent la même donnée deux fois : le nom brut de l'ERP et un nom rédigé, ou le rayon et la catégorie fine. Bruxel en choisit une, toujours la même :

  • Nom : l'enrichi l'emporte. Si votre fichier contient name_mejorado et nombre_original, c'est le premier qui est utilisé — il est généralement plus propre, le brut incluant souvent la description dans le nom.
  • Catégorie : la plus précise l'emporte. Entre categoria_especifica (« perforateur ») et departamento (« Outillage et Quincaillerie »), c'est la précise qui sert : elle décrit le produit, pas le rayon.
La colonne qui ne l'emporte pas n'est PAS perdue : elle reste comme donnée d'origine et peut devenir un attribut filtrable. Et vous n'avez pas à deviner : la simulation montre quelle colonne a alimenté chaque champ avant toute écriture.

Comment vos attributs entrent

Les attributs filtrables — couleur, taille, matière — entrent avec l'import lui-même, pas depuis un autre écran. C'est dans « Vérifier avant d'importer » que cela se décide : sous « Quelles colonnes conserver », Bruxel liste chaque colonne de votre fichier et vous dit ce qu'il en ferait. Trois cas possibles :

  • La colonne correspond à un attribut que vous avez déjà : elle se remplit toute seule, gratuitement. Ni crédits ni IA — c'est votre propre donnée, elle était déjà dans le fichier.
  • La colonne n'est pas encore un attribut : si vous la laissez cochée, elle est créée avec ses valeurs pendant ce même import et devient filtrable. Et si ses cellules portent plusieurs valeurs à la fois (« Sans cruauté,Vegan »), il est créé en sélection multiple : chaque produit reçoit ses valeurs séparées, pas la combinaison collée.
  • La colonne ne convient pas comme attribut, et la raison s'affiche : « texte long », « une valeur différente par produit », « une seule valeur », « vide » ou « presque vide ». Une colonne avec une valeur différente par produit ne deviendra pas un attribut même cochée : elle ne servirait à rien comme filtre.
Remplir un attribut depuis votre fichier n'écrase JAMAIS ce qui existait. Si quelqu'un de votre équipe a corrigé une valeur à la main, un import ultérieur la respecte et ne comble que les trous. C'est pourquoi vous pouvez réimporter le même fichier autant de fois qu'il le faut.
Un attribut est créé avec au maximum 500 valeurs, les plus fréquentes de votre fichier. Si une colonne en compte davantage, les produits ayant une valeur rare n'auront pas cet attribut. La simulation vous prévient : elle indique combien de valeurs a la colonne et combien seront créées.

Ce que vous ne cochez pas n'est pas perdu : c'est conservé comme donnée d'origine et cela alimente toujours la génération des descriptions. Simplement, vous ne pourrez pas filtrer dessus dans votre boutique.

Ce qui arrive à l'existant

Le SKU est la clé. Importer deux fois le même fichier ne duplique rien :

  • Nouveau SKU : le produit est créé.
  • SKU existant : nom, marque, catégorie et données source sont mis à jour.
  • SKU que vous aviez supprimé : le produit revient.
La mise à jour REMPLACE les données source du produit par celles du nouveau fichier. Si votre second fichier comporte moins de colonnes, celles qui manquent sont perdues.

Le parcours d’un chargement

Dans l’historique des imports, « Voir le parcours » indique où en est chaque chargement : importé, fiche générée, contrôle qualité, publié, livré à votre système et en boutique. Chaque étape affiche sa date, « En cours » (certains produits y sont déjà), « En attente » ou « Sans donnée », avec la raison.

On compte les produits que le chargement a modifiés et ce qui s’est passé après : une fiche qui existait déjà ne compte pas comme générée par ce chargement. Avec plusieurs langues configurées, un produit compte quand il l’est dans toutes.

Si vous envoyez deux fois le même fichier, le second chargement indique qu’aucun produit n’a changé : il n’y a pas de fiches à suivre. Les chargements antérieurs au 12 septembre 2026 indiquent « Sans donnée » : Bruxel ne conservait pas encore l’historique des modifications.

« Livré » n’est connu que si un système écoute les avis de fiches (webhooks), et pendant 30 jours. « En boutique » indique toujours « Sans donnée » : Bruxel ne sait pas quand votre boutique publie chaque produit.

Variantes dans le même fichier

Si vous vendez des tailles ou des couleurs, ajoutez une colonne parent_sku avec le SKU du produit parent. Bruxel crée le lien à l'import, et vous pouvez apporter parents et enfants dans le même fichier.