--- title: "product_abstract" url: "https://wiki.merchant.mercanto.ch/fr/article/product-abstract" language: "fr" last_updated: "2026-01-20T09:01:55.205Z" --- # product_abstract Exemple de fichier dans [gitlab](https://gitlab.com/mercanto/iocanto-spec/-/blob/master/examples/product_abstract.iocanto.json). ## Description Vous trouverez ici toutes les données applicables à un article donné. Cela inclut notamment les noms d’articles, valeurs nutritionnelles, ingrédients, origine et bien plus. Ce type de données contient la majorité des champs d’article. Pour chaque `product_abstract`, il faut obligatoirement fournir un nom (`name`), une SKU (`abstract_sku`), une clé de catégorie (`category_key`), un statut (`status`), le taux de TVA (`tax_code`), l’unité de base d’emballage (`base_packaging_code` pour les unités d’emballage ou `base_measurement_code` pour les unités de masse), ainsi que la quantité de base pour l’affichage du prix de base (`base_price_quantity`). ## Champs disponibles | **Champ**
(\* = Obligatoire) | **Description** | | --- | --- | | `name` \*
*Localized String (10000)* | Nom de l’article. | | `abstract_sku` \*
*String (100)* | Unité de gestion des stocks de l’article (numéro d’article). 
Caractères autorisés : chiffres `0-9`, lettres `A-Z a-z`, tirets `–`, traits de soulignement `_`, parenthèses `()`, points `.`. | | `category_key` \*
*String (enum)* | Attribution de l’article à une catégorie Mercanto spécifique. 
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#categoriesdarticles](https://my.mercanto.ch/fr/valeurs-definies#categoriesdarticles) | | `status` \*
*String (enum)* | Définit le statut actuel de l’article. Les articles inactifs ne sont pas affichés (exception: Inventaire). 
Valeurs autorisées : `active`, `inactive` | | `tax_code` \*
*String (enum)* | Taux de TVA de l’article. 
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#tva](https://my.mercanto.ch/fr/valeurs-definies#tva) | | `base_measurement_code` \*
*String (enum)* | Définit l’unité de base du produit (unités de masse). L’un de `base_packaging_code` ou `base_measurement_code` doit être rempli. 
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#unite](https://my.mercanto.ch/fr/valeurs-definies#unite) | | `base_packaging_code` \*
*String (enum)* | Définit l’unité d’emballage de base. L’un de `base_packaging_code` ou `base_measurement_code` doit être rempli. 
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#unitedemballage](https://my.mercanto.ch/fr/valeurs-definies#unitedemballage) | | `base_price_quantity` \*
*Integer (0,10000000)* | Quantité de base utilisée pour afficher le prix de base. 
Exemple 1 : Valeur 20 → CHF 16.50/**20** pièces
Exemple 2 : Valeur 1 → CHF 16.50/pièce (1 n'est pas affiché dans ce cas) | | `no_public_listing`
*boolean (true,false)* | Indique si l’article doit apparaître dans le catalogue public.
défaut = `false` | | `no_public_price`
*boolean (true,false)* | Indique si le prix doit être visible dans le catalogue public. 
défaut = `true` | | `novelty`
*boolean (true,false)* | Indique si l’article doit être marqué comme «NOUVEAU».
défaut = `false` | | `alternative`
*Array (sku)* | Liste des références d'articles alternatifs. | | `complementary`
*Array (sku)* | Liste des références d’articles complémentaires. | | `successor`
*Array (sku)* | Liste des références d’articles successeurs. | | `search_keywords`
*Array (String)* | Liste des mots-clés relatifs à l'article qui sont pris en compte lors de la recherche dans le catalogue. | | `tier_level`
*Integer (1,999999999)* | Priorité de l’article dans le catalogue. Plus la valeur est élevée, plus l'article apparaîtra en haut du catalogue. **Remarque:** *N’affecte pas la position dans le «Catalogue général» ou dans «Mon assortiment» du client.* | | `quantity_selection_type`
*String (enum)* | Type de sélection des quantités. 
Valeurs autorisées : `default`, `measurement_per_item`, `open_measurement`
`default` = spécification dans la quantité correspondante telle que définie sur l'article
`measurement_per_item` = spécification en unités par <`kg`, `m`, `l`\>
`open_measurement` = quantité ouverte en <`kg`, `m`, `l`\> | | `certifications`
*Array (String)* | Liste des certifications de l’article.
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#label](https://my.mercanto.ch/fr/valeurs-definies#label) | | `technical_description`
*String (10000)* | Désignation selon la loi sur les denrées alimentaires. | | `short_name`
*Localized String (10000)* | Nom abrégé du produit. Utilisé pour la navigation par fil d'Ariane dans le catalogue. | | `gtin`
*String (8,14)* | Numéro global d’article commercial (GTIN) de l’article. | | `net_content`
*Number (0,10000000)* | Contenu net de l'article. Doit être rempli si `net_content_unit` est renseignée. | | `net_content_unit`
*String (enum)* | Unité du contenu net. Doit être renseignée si `net_content` est renseignée.
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#unite](https://my.mercanto.ch/fr/valeurs-definies#unite) | | `drained_weight`
*Number (0,10000000)* | Poids égoutté de l'article en kilogrammes. | | `warehousing/type`
*String (enum)* | Plage de température pour l'article.
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#typedestockage](https://my.mercanto.ch/fr/valeurs-definies#typedestockage) | | `warehousing/environment`
*Localized String (10000)* | Description des conditions de stockage. | | `warehousing/ shelf_life_days`
*Number (0,10000000)* | Durée de conservation en jours à partir de la livraison. | | `description`
*Localized String (10000)* | Description de l’article. | | `ingredients`
*Localized String (10000)* | Ingrédients de l’article (denrées alimentaires). | | `brand`
*String (1000)* | Marque de l’article. | | `producer`
*String (1000)* | Producteur de l'article. | | `origin_country`
*Array (enum)* | Liste des pays d'origine des matières premières utilisées dans la fabrication de l'article.
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#codepays](https://my.mercanto.ch/fr/valeurs-definies#codepays) | | `origin_locality`
*Localized String (10000)* | Détails supplémentaires sur l’origine. | | `production_country`
*Array (enum)* | Liste des pays où l'article est fabriqué.
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#codepays](https://my.mercanto.ch/fr/valeurs-definies#codepays) | | `production_locality`
*Localized String (10000)* | Détails supplémentaires sur le lieu de production. | | `nutrition_score`
*String (enum)* | Indication de la classification nutritionnelle de l’article. S'applique uniquement aux articles alimentaires.
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#nutriscore](https://my.mercanto.ch/fr/valeurs-definies#nutriscore) | | `energy_label`
*String (enum)* | Étiquette énergétique. S'applique uniquement pour les articles non alimentaires.
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#etiquetteenergetique](https://my.mercanto.ch/fr/valeurs-definies#etiquetteenergetique) | | `beelong_score`
*String (enum)* | Indice d’impact environnemental Beelong.
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#beelongscore](https://my.mercanto.ch/fr/valeurs-definies#beelongscore) | | `nutrition_values/ energy_kj`
*Number (0,10000000)* | Information nutritionnelle : Valeur énergétique en kJ/100g ou 100ml. | | `nutrition_values/ energy_kcal`
*Number (0,10000000)* | Information nutritionnelle : Valeur énergétique en kcal/100g ou 100ml. | | `nutrition_values/protein`
*Number (0,100)* | Information nutritionnelle : Protéines (g/100g ou ml). | | `nutrition_values/carbs`
*Number (0,100)* | Information nutritionnelle : Glucides (g/100g ou ml). | | `nutrition_values/fat`
*Number (0,100)* | Information nutritionnelle : Lipides (g/100g ou ml). | | `nutrition_values/ saturated_fat`
*Number (0,100)* | Information nutritionnelle : Acides gras saturés (g/100g ou ml). | | `nutrition_values/sugar`
*Number (0,100)* | Information nutritionnelle : Sucre (g/100g ou ml). | | `nutrition_values/fibres`
*Number (0,100)* | Information nutritionnelle : Fibres alimentaires (g/100g ou ml). | | `nutrition_values/salt`
*Number (0,100)* | Information nutritionnelle : Sel (g/100g ou ml). | | `allergens_food/contains`
*Array (enum)* | Liste des allergènes présents dans cet article.
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#allergenes](https://my.mercanto.ch/fr/valeurs-definies#allergenes) | | `allergens_food/freeOf`
*Array (enum)* | Liste des allergènes absents du produit.
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#allergenes](https://my.mercanto.ch/fr/valeurs-definies#allergenes) | | `allergens_food/ mayContain`
*Array (enum)* | Liste des allergènes potentiellement présents.
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-](https://my.mercanto.ch/fr/valeurs-) [definies#allergenes](https://my.mercanto.ch/fr/valeurs-definies#allergenes) | | `diet`
*Array (enum)* | Classification nutritionnelle.
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#modedalimentation](https://my.mercanto.ch/fr/valeurs-definies#modedalimentation) | | `alcohol/ alcohol_percentage`
*Number (0,100)* | Teneur en alcool (% vol). | | `alcohol/ drinking_temperature`
*String (100)* | Température de service recommandée. | | `alcohol/vintage`
*Localized String (10000)* | Millésime. | | `alcohol/winery`
*Localized String (10000)* | Producteur / domaine. | | `alcohol/grape`
*Localized String (10000)* | Cépage(s). | | `alcohol/drinking_period`
*Localized String (10000)* | Temps de consommation recommandé du vin, par exemple en années après la récolte. | | `alcohol/degustation`
*Localized String (10000)* | Description gustative. | | `alcohol/recommendation`
*Localized String (10000)* | Recommandations d’accord mets-vins. | | `alcohol/label`
*Localized String (10000)* | Labels supplémentaires (ex. « Gran Reserva »). | | `alcohol/wine_region`
*Array (enum)* | Régions viticoles.
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#regionviticole](https://my.mercanto.ch/fr/valeurs-definies#regionviticole) | | `care/migel`
*String (1000)* | Numéro MIGEL. | | `meat/body_part`
*Localized String (255)* | Partie du corps de l’animal. | | `seafood/fishing_area`
*Array (enum)* | Liste des zones de pêche (FAO).
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#zonedepeche](https://my.mercanto.ch/fr/valeurs-definies#zonedepeche) | | `seafood/latin_name`
*String (1000)* | Nom latin du poisson. | | `seafood/ method_of_capture`
*Localized String (10000)* | Méthode de capture. | | `seafood/production_type`
*Localized String (10000)* | Type d’élevage. | | `wearable/size_sml`
*String (enum)* | Taille de l’article.
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#taille](https://my.mercanto.ch/fr/valeurs-definies#taille) | | `ordering/advance/days`
*Integer (0,10000000)* | Indique combien de jours à l'avance l'article doit être commandé ou combien de jours de traitement sont nécessaires avant qu'il puisse être livré. | | `ordering/ comments_allowed`
*boolean (true,false)* | Indique si un commentaire peut être ajouté.
défaut = `false` |