product_abstract

Exemple de fichier dans gitlab.

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 
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 
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 
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 
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 
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 
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 
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  
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 
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  
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 
beelong_score
String (enum)
Indice d’impact environnemental Beelong.
Valeurs autorisées : 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  
allergens_food/freeOf
Array (enum)
Liste des allergènes absents du produit.
Valeurs autorisées : 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- definies#allergenes 
diet
Array (enum)
Classification nutritionnelle.
Valeurs autorisées : 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 
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  
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   
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