Caractéristiques à liste multivlaeurs

Comment remplir les attributs à valeurs multiples (multi-valeurs)

Certains attributs de votre fichier produits peuvent accepter plusieurs valeurs pour un même produit (par exemple : couleurs, matières, tailles…).
Sur notre plateforme, ces attributs sont de type « Liste de valeurs multiples » (LIST_MULTIPLE_VALUES).

1. Séparateur à utiliser

Pour indiquer plusieurs valeurs dans une seule cellule (ou un seul champ en API), vous devez les séparer avec le caractère suivant :

| (pipe)

Ne mettez pas d'espace avant ou après le séparateur.

Exemple correct :
red|blue|green
Exemple incorrect :
red | blue | green (espaces interdits)

Ce séparateur est le même :

  • pour les imports par fichier (CSV / Excel),
  • pour les imports par API.

2. Exemples

Exemple en fichier (CSV / Excel)

category sku color
TSHIRT SKU01 black|red
TSHIRT SKU02 blue|white|red

Exemple en API (JSON)

{
  "product_sku": "SKU01",
  "color": "black|red"
}

3. Important

Si vous utilisez un autre séparateur que |, ou si vous ajoutez des espaces, vos produits pourront être rejetés ou les valeurs mal interprétées.

Si vous ne savez pas si un attribut accepte plusieurs valeurs, référez-vous au modèle de fichier fourni par la marketplace ou à votre contact support.

Groupe de variantes produits

Créer et gérer des groupes de variantes produits (taille, couleur, capacité…)

Un groupe de variantes permet de regrouper plusieurs produits très proches (ex. même article en différentes tailles, couleurs, capacités, etc.) sur une seule fiche produit.
Vous pouvez créer des variantes en renseignant un code de groupe commun dans l'attribut « group_code » de vos imports produits. Attention, les variantes ne sont prises en compte qu'à la création des produits, il est possible de les modifier ensuite uniquement sur demande à votre opérateur RDC.

1) Créer un groupe de variantes

Pour qu'un groupe soit exploité et affiché sur une page produit Rue du Commerce, toutes les règles suivantes doivent être respectées.

A. Code de groupe commun (VGC)

  • Utilisez le même VGC pour toutes les variantes d'un même produit.
  • Chaque variante doit avoir un EAN produit unique.
Attribut à renseigner :
group_code
Règle :
▸ Même code pour toutes les variantes d'un même article.

B. Cohérence du groupe

  • Jusqu'à 24 variantes produits par groupe.
  • EAN unique pour chaque variante.
  • Une seule marque par groupe (identique pour toutes les variantes).
  • Une seule catégorie par groupe (identique pour toutes les variantes).

C. Attributs de variante

Exemples : taille, couleur, capacité, matériaux…

  • Le groupe doit avoir au moins 1 attribut de variante.
  • Jusqu'à 3 attributs de variante (recommandé).

Attributs exhaustifs (obligatoires sur chaque produit)

Pour chaque attribut de variante utilisé :

  • Il doit être renseigné pour tous les produits du groupe (aucune valeur vide), sauf dans le cas où vous déclarez uniquement 2 attributs de variante, et qu'un 3e attribut varie de façon exclusive (sans créer de valeur manquante sur les 2 attributs déclarés).
  • Il doit être réellement variable (pas la même valeur partout), sinon ce n'est pas un attribut de variante.

D. Combinaisons exclusives (unicité)

  • Chaque produit doit correspondre à une combinaison unique d'attributs.
  • Il est interdit d'avoir deux produits avec exactement la même combinaison.
Exemple accepté (2 attributs : couleur + taille)
  • Bleu / S
  • Bleu / M
  • Rouge / S
✅ Toutes les combinaisons sont uniques
Exemple refusé (doublon)
  • Bleu / M
  • Bleu / M
❌ Combinaison dupliquée

2) En résumé

Pour qu'un groupe de variantes soit valide :

  • ✅ même VGC sur toutes les lignes
  • ✅ EAN unique par variante
  • ✅ jusqu'à 24 variantes
  • ✅ 1 marque et 1 catégorie pour tout le groupe
  • ✅ au moins 1 attribut de variante (maximum 3)
  • ✅ aucune combinaison dupliquée

Catalog transformer

Catalog Transformer : comprendre et utiliser l'outil de transformation de catalogue

Le Catalog Transformer est l'outil d'intelligence artificielle intégré à la marketplace qui transforme automatiquement votre fichier catalogue pour qu'il corresponde au format attendu par la plateforme. Ce guide résume son fonctionnement et les bonnes pratiques à connaître. Il ne remplace pas la documentation officielle, disponible dans votre espace vendeur.

1) Le principe

À partir de votre fichier catalogue tel que vous l'exportez de votre système, l'outil réalise automatiquement trois choses à votre place :

  • Catégorisation : il range chaque produit dans la bonne catégorie de la marketplace.
  • Extraction d'attributs : il repère les informations utiles dans vos données (y compris dans une description en texte libre) et les place dans les bons champs.
  • Conversion des valeurs : il traduit vos valeurs (couleurs, tailles, matières…) vers les valeurs autorisées par la marketplace.
Objectif : réduire le travail de mapping manuel et accélérer la mise en ligne de votre catalogue.

2) Comment ça fonctionne

À chaque import, le traitement suit ces étapes :

  1. Analyse du fichier envoyé.
  2. Repérage des informations clés (titre, description, images, identifiants).
  3. Catégorisation automatique du produit.
  4. Extraction des attributs à partir de vos données (et de vos images, quand c'est pertinent).
  5. Vérification des valeurs par rapport aux listes autorisées par la marketplace.
  6. Amélioration des titres/descriptions si l'option de réécriture est activée.
  7. Restitution d'un aperçu que vous pouvez vérifier avant validation finale.
Ce que l'IA ne modifie jamais :
vos identifiants produits, vos prix et stocks, les informations réglementaires/sécurité (allergènes, danger, certifications), et vos titres/descriptions tant que vous n'avez pas choisi l'option de réécriture. Si une information n'existe pas dans votre fichier, l'IA ne l'invente pas : le champ reste vide.

3) Bien préparer son fichier

La qualité du résultat dépend directement de la qualité du fichier envoyé : l'IA ne peut pas corriger une information absente ou ambiguë.

  • Un seul en-tête : une seule ligne de titres de colonnes (deux lignes uniquement si vous utilisez le template fourni par l'opérateur).
  • Des libellés clairs, pas de codes : préférez « Noir » à « BLK », « Large » à « L ».
  • Du contexte dans les en-têtes : si vos tailles suivent une norme UK, nommez la colonne Size_UK plutôt que Size.
  • Des données complètes : plus votre fiche produit est détaillée (y compris dans la description), plus l'extraction sera fiable.
  • Un fichier propre : corrigez les erreurs (typos, colonnes mal placées) avant l'envoi ; l'outil ne les corrige pas de lui-même.
  • Formats acceptés : CSV, XLSX (un seul onglet) ou XML, 100 Mo maximum.
  • Un seul fichier groupé : pour les gros catalogues, préférez un import unique ou des fichiers d'environ 100 000 produits plutôt qu'un fichier par catégorie.

4) Les options disponibles à l'import

Réécriture
Réécrit titres et descriptions pour respecter les longueurs et mots interdits de l'opérateur, retire le HTML et optimise pour le référencement (SEO).
Traduction
Traduit automatiquement titres/descriptions dans toutes les langues requises par la marketplace (langues supportées : EN, FR, IT, ES, PT, DE, PL, TR, NL, CS, HU, RO).
Enrichissement (BETA)
Complète les informations manquantes de votre fiche produit à partir de sources externes.
Règles « exact match »
Permettent de forcer une valeur précise sur un champ, si l'IA ne l'a pas extraite correctement : ajoutez dans votre fichier source une colonne dont l'en-tête est exactement le code attribut de l'opérateur (attention, la casse compte). Cette méthode ne fonctionne pas pour forcer un champ vide (sauf avec « - ») ni pour changer la catégorie choisie.

5) Mode d'emploi

  1. Back office : Catalog > Product imports > Import products.
  2. Sélectionnez votre fichier.
  3. Dans la section Catalog Transformer, cochez les options souhaitées (Réécriture, Traduction).
  4. Cliquez sur Confirmer.
  5. Un aperçu (preview) est généré : il indique le nombre de produits valides et invalides.
  6. Cliquez sur Importer pour envoyer les produits valides dans le catalogue.
En cas d'erreur : téléchargez le rapport d'erreurs depuis l'aperçu, corrigez votre fichier source, puis réimportez. Si les produits sont déjà importés, vous pouvez aussi corriger directement dans la fiche produit du catalogue : la donnée corrigée manuellement est alors verrouillée et ne sera plus écrasée par un futur import automatique.

2) En résumé

  • ✅ l'IA catégorise, extrait et convertit vos données au format marketplace
  • ✅ elle n'invente jamais une information absente de votre fichier
  • ✅ un fichier propre, clair et détaillé donne un meilleur résultat
  • ✅ options disponibles : réécriture, traduction, enrichissement, exact match
  • ✅ vérifiez toujours l'aperçu avant de valider l'import