Gérer les variantes, les options et les métadonnées d'un produit

Pourquoi c'est utile

Un même modèle se vend souvent en plusieurs tailles, couleurs ou contenances, et chacune a son prix et son stock. Sans variantes, on crée dix produits presque identiques, ou on ne sait plus quelle taille reste en rayon. Les variantes rangent ces déclinaisons sous un seul produit.

Résumé

Les options décrivent ce qui change d'un exemplaire à l'autre (Couleur, Taille…) ; chaque combinaison de valeurs donne une variante, avec son propre prix, son stock, son SKU et son code-barres. Les métadonnées sont des paires clé / valeur libres, à ajouter sur le produit ou sur une variante, pour votre propre usage.

Prérequis

• Permission products.create ou products.update.

Étapes — options et variantes

1. Ouvrez la fiche produit (/products/:productId) ou la création (/products/create).
2. Dans Options du produit (« Ajoutez des options comme la couleur, la taille, etc. »), saisissez le nom de l'option puis ses valeurs (une valeur par champ ; un champ vide s'ajoute automatiquement).
3. La section Variantes liste les combinaisons. Pour chacune : prix, prix de revient, prix barré, stock.
4. Raccourcis : « Appliquer le même prix à toutes les variantes », « Appliquer le même stock à toutes les variantes », et « Basculer le masquage des variantes inutilisées » pour cacher les combinaisons que vous ne vendez pas.
5. Enregistrez.

Sans option, le produit a une seule variante par défaut : son prix, son SKU et son code-barres se saisissent directement sur la fiche. Avec plusieurs variantes, ces champs s'ouvrent variante par variante, depuis le bouton Stocks de chaque ligne.

Champs d'une variante

Les métadonnées : à quoi servent-elles ?

La carte Métadonnées (« Ajouter des métadonnées ») existe à deux niveaux :

• sur le produit, en bas de la fiche ;
• sur chaque variante, avec la mention « Ajoutez des métadonnées à votre variante pour votre propre usage ».

Chaque ligne est une paire clé / valeur en texte libre (par exemple matière = coton, fournisseur_ref = A-1290). Genuka les enregistre et les renvoie telles quelles ; aucune fonctionnalité ne les interprète, sauf un cas : sur un service, une métadonnée du produit dont la clé suit le format order_<nom>_<type> devient une question posée au client sur la page de réservation publique (la valeur est le texte de la question).

Usages typiques : garder une information interne qui n'a pas de champ dédié, ou transmettre une donnée à un site ou une intégration qui lit l'API Genuka.

Cas limites & erreurs fréquentes

• Les métadonnées ne sont pas privées. L'API publique de la boutique renvoie les métadonnées des produits et des variantes avec le reste de la fiche (seul un lien de téléchargement de produit numérique est retiré pour les visiteurs). N'y mettez jamais d'information confidentielle (prix d'achat, coordonnées fournisseur…).
• Métadonnées ou champs personnalisés ? Les champs personnalisés se définissent une fois pour toute l'entreprise (Paramètres généraux › onglet Produits › Champs personnalisés) et apparaissent sur chaque fiche ; les métadonnées sont libres, produit par produit.
• Import Excel. La colonne metadata du fichier d'import remplit les métadonnées du produit (pas d'une variante), au format clé=valeur;clé2=valeur2.
• Variantes importées sans options. Si plusieurs lignes d'un même produit donnent un variant_title sans variant_composition, l'import crée une option Variante avec une valeur par titre (deux titres identiques deviennent « Titre » et « Titre (2) »), pour que chaque variante reste distincte.
• Les libellés « Key » / « Value » des lignes de métadonnées s'affichent en anglais dans l'interface française.

FAQ

À quoi servent les paires clé-valeur des variantes ? À stocker des informations libres pour votre propre usage. Elles ne changent ni le prix, ni le stock, ni l'affichage en caisse.

Mes clients voient-ils les métadonnées ? Votre site ou une intégration peut les lire via l'API publique. Considérez-les comme publiques.

Comment vendre un T-shirt en plusieurs tailles et couleurs ? Créez deux options (Couleur, Taille) avec leurs valeurs : Genuka génère une variante par combinaison, chacune avec son prix et son stock.

Voir aussi

• Créer un produit et le publier (creer-produit)
• Codes-barres et SKU (codes-barres-sku)
• Importer des produits (importer-produits)