products-.csv

Fichier modèle à télécharger, cliquer ici.
Fichier d'exemple rempli à télécharger, cliquer ici.

Description

Avec products-.csv, un fournisseur transmet les données de base de ses articles : par exemple le nom de l’article, la catégorie, les valeurs nutritionnelles, les ingrédients, l’origine, les allergènes ou les informations relatives au vin et à la viande. Ce type de données contient le plus grand nombre de champs et constitue la base de tous les autres fichiers liés aux produits.

Les informations suivantes doivent obligatoirement être fournies pour chaque article :

Nom dans toutes les langues requises (product_name_<LOCALE>)
Numéro d’article (abstract_sku)
Catégorie (category_key)
Taux de TVA (tax_code)
Unité de base, soit comme unité d’emballage (base_packaging_code), soit comme unité de mesure (base_measurement_code)
Quantité de l’unité de base pour l’affichage du prix de base (base_price_quantity)

Tous les autres champs (par ex. valeurs nutritionnelles, allergènes, origine, informations sur le vin et la viande) sont facultatifs et ne doivent être remplis que s’ils s’appliquent à l’article concerné.

Dépendances avec d’autres types de données :

Les unités d’emballage et leurs prix sont définis séparément dans products_packaging-.csv et products_prices-.csv et sont liés à l’article via le champ commun abstract_sku. Un abstract_sku doit obligatoirement être créé au préalable (ou dans le même import) dans products-.csv avant de pouvoir être utilisé dans ces fichiers.
Les éventuelles autorisations et restrictions de commande spécifiques au client pour l’article sont définies dans product_restrictions-.csv.
Si l’article est utilisé dans une liste de commande, le sku doit exister comme article actif dans products-.csv (voir shopping_list_items-.csv).
La category_key doit correspondre à une catégorie valide définie dans Mercanto.

Colonnes disponibles

Champ (* = Obligatoire)	Description
`product_name_<LOCALE>`* Localized String (10000)	Nom de l’article dans la langue correspondante. **
`abstract_sku`* String (100)	Stock keeping unit de l’article (numéro d’article). Caractères autorisés : chiffres `0-9`, lettres `A-Z a-z`, tirets `–`, tirets bas `_`, 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/definierte-werte#artikelkategorie
`tax_code`* String (enum)	Taux de TVA de l’article. Valeurs autorisées : https://my.mercanto.ch/fr/definierte-werte#mwstsatz
`base_measurement_code`* String (enum)	Définit l’unité de mesure de base de l’article. Ce champ ou `base_packaging_code` doit être rempli. Valeurs autorisées : https://my.mercanto.ch/fr/definierte-werte#einheit
`base_packaging_code`* String (enum)	Définit l’unité d’emballage de base de l’article. Ce champ ou `base_measurement_code` doit être rempli. Valeurs autorisées : https://my.mercanto.ch/fr/definierte-werte#verpackungseinheit
`base_price_quantity`* Number (1, 10000000)	Quantité de l’unité de base pour l’affichage du 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)
`availability_status`* String (enum)	Statut de disponibilité actuel de l’article. Valeurs autorisées : https://my.mercanto.ch/fr/definierte-werte#verfugbarkeitsstatus
`delivery_product_group` String (100)	Groupe de livraison de produit pour lequel les données de livraison enregistrées s’appliquent. valeur par défaut = `DEFAULT`
`status` String (enum)	Définit le statut actuel de l’article. Les articles inactifs ne sont pas affichés dans Mercanto (exception : inventaire). Valeurs autorisées : `active`, `inactive` valeur par défaut = `active`
`no_public_listing` boolean (0, 1)	Indique si un article doit être affiché dans le catalogue public, où `0` = affiché, `1` = non affiché. valeur par défaut = `0`
`no_public_price` boolean (0, 1)	Indique si le prix de l’article doit être affiché dans le catalogue public, où `0` = affiché, `1` = non affiché. valeur par défaut = `1`
`novelty` boolean (0, 1)	Indique si un article doit recevoir l’étiquette « NOUVEAU », où `0` = étiquette non affichée, `1` = étiquette affichée. valeur par défaut = `0`
`promotion_date_start` String (DD.MM.YYYY)	Date « valable à partir de » en cas de promotion sur le produit. Les deux dates doivent toujours être renseignées.
`promotion_date_end` String (DD.MM.YYYY)	Date « valable jusqu’à » en cas de promotion sur le produit. Les deux dates doivent toujours être renseignées.
`promotion_key` String (100)	Code de promotion.
`promotion_name_<LOCALE>` Localized String (10000)	Désignation de la promotion dans la langue correspondante. **
`search_keywords_<LOCALE>` Localized String (10000)	Liste de mots-clés séparés par des virgules relatifs à l’article, pris en compte lors de la recherche dans le catalogue - dans la langue correspondante. **
`tier_level` Integer (1, 999999999)	Définit la priorité de l’article au sein du catalogue du fournisseur. Plus la valeur est élevée, plus l’article est affiché en haut du catalogue. Attention : n’a aucune influence sur la position dans le catalogue global ou dans « Mon assortiment » du client !
`quantity_selection_type` String (enum)	Définit le type de sélection de l’article. Valeurs autorisées : `default`, `measurement_per_item`, `open_measurement` `default` = quantité selon la définition de l’article `measurement_per_item` = indication en `pièces` par <`kg`, `m`, `l`> `open_measurement` = quantité libre en <`kg`, `m`, `l`>
`alternative` Array (sku)	Liste de numéros d’articles alternatifs séparés par des virgules.
`complementary` Array (sku)	Liste de numéros d’articles apparentés séparés par des virgules.
`successor` Array (sku)	Liste de numéros d’articles successeurs séparés par des virgules.
`order_deadline_date` String (DD.MM.YYYY)	Dernier jour où le produit peut être commandé. Doit être renseigné si `availability_status` = `preorder`.
`order_deliverable_` `from_date` String (DD.MM.YYYY)	Date la plus proche à laquelle le produit peut être livré. Doit être renseignée si `availability_status` = `delivery_delay` ou `preorder`.
`availability_` `information_<LOCALE>` Localized String (10000)	Information complémentaire sur la disponibilité dans la langue correspondante. **
`certifications` Array (String)	Liste de certifications de l’article séparées par des virgules. Valeurs autorisées : https://my.mercanto.ch/fr/definierte-werte#label
`technical_` `description_<LOCALE>` Localized String (10000)	Désignation technique selon la législation alimentaire de base, indiquant le type de denrée alimentaire - dans la langue correspondante. **
`short_name_<LOCALE>` Localized String (10000)	Nom d’article raccourci - dans la langue correspondante. **. Utilisé pour la navigation « fil d’Ariane » dans le catalogue.
`gtin` String (8, 14)	Global Trade Item Number de l’article.
`gpc_code` Integer (10000000, 10009999)	Code brique GS1 Global Product Classification (GPC). Code à 8 chiffres commençant toujours par 1000.
`net_content` Number (0, 10000000)	Contenu net de l’unité de base de l’article. Doit être rempli si `net_content_unit` est rempli.
`net_content_unit` String (enum)	Unité du contenu net. Doit être remplie si `net_content` est rempli. Valeurs autorisées : https://my.mercanto.ch/fr/definierte-werte#einheit
`drained_weight` Number (0, 10000000)	Poids égoutté de l’article en kilogrammes.
`weight_per_` `consumer_unit` Number (0, 10000000)	Contenu net en kg.
`warehousing_type` String (enum)	Plage de température pour l’article. Valeurs autorisées : https://my.mercanto.ch/fr/definierte-werte#lagerungsart
`warehousing_` `environment_<LOCALE>` Localized String (10000)	Description des instructions de stockage dans la langue correspondante. **
`shelf_life_days` Integer (0, 10000000)	Durée de conservation en jours à compter de la livraison.
`product_` `description_<LOCALE>` Localized String (10000)	Description de l’article dans la langue correspondante. **
`ingredients_<LOCALE>` Localized String (10000)	Ingrédients de l’article (denrée alimentaire) dans la langue correspondante. **
`brand_name` String (1000)	Marque de l’article.
`producer_name` String (1000)	Fabricant de l’article.
`origin_country` Array (enum)	Liste séparée par des virgules des pays d’origine des matières premières de l’article. Valeurs autorisées : https://my.mercanto.ch/fr/definierte-werte#landercode
`origin_locality` Localized String (10000)	Détails supplémentaires sur le lieu d’origine.
`production_country` Array (enum)	Liste séparée par des virgules des pays où l’article est fabriqué. Valeurs autorisées : https://my.mercanto.ch/fr/definierte-werte#landercode
`production_locality` Localized String (10000)	Détails supplémentaires sur le lieu de production.
`convenience_level` String (enum)	Dans le domaine culinaire, les « niveaux de convenience » décrivent le degré de transformation ou de préparation qu’une denrée alimentaire nécessite avant de pouvoir être consommée. Valeurs autorisées : https://my.mercanto.ch/fr/definierte-werte#convenience-grad
`nutrition_score` String (enum)	Classification nutritionnelle de l’article. S’applique uniquement aux articles alimentaires. Valeurs autorisées : https://my.mercanto.ch/fr/definierte-werte#nutriscore
`energy_label` String (enum)	Classe d’efficacité énergétique de l’article. S’applique uniquement aux articles non alimentaires. Valeurs autorisées : https://my.mercanto.ch/fr/definierte-werte#energieetikette
`beelong_score` String (enum)	Évaluation de l’impact environnemental de l’article selon Beelong. Valeurs autorisées : https://my.mercanto.ch/fr/definierte-werte#beelongscore
`energy_kj` Number (0,10000000)	Valeurs nutritionnelles : teneur en énergie en kilojoules par 100g/ml.
`energy_kcal` Number (0,10000000)	Valeurs nutritionnelles : teneur en énergie en kilocalories par 100g/ml.
`protein` Number (0,100)	Valeurs nutritionnelles : protéines en grammes par 100g/ml.
`carbs` Number (0,100)	Valeurs nutritionnelles : glucides en grammes par 100g/ml.
`fat` Number (0,100)	Valeurs nutritionnelles : matières grasses en grammes par 100g/ml.
`saturated_fat` Number (0,100)	Valeurs nutritionnelles : acides gras saturés en grammes par 100g/ml.
`sugar` Number (0,100)	Valeurs nutritionnelles : sucre en grammes par 100g/ml.
`fibres` Number (0,100)	Valeurs nutritionnelles : fibres alimentaires en grammes par 100g/ml.
`salt` Number (0,100)	Valeurs nutritionnelles : sel en grammes par 100g/ml.
`allergen_celery` String (enum)	Indique si l’article contient cet allergène. Valeurs autorisées : `contains` (= contient l’allergène), `freeOf` (= ne contient pas l’allergène), `mayContain` (= peut contenir l’allergène)
`allergen_crustaceans` String (enum)	Indique si l’article contient cet allergène. Valeurs autorisées : `contains`, `freeOf`, `mayContain`
`allergen_egg` String (enum)	Indique si l’article contient cet allergène. Valeurs autorisées : `contains`, `freeOf`, `mayContain`
`allergen_fish` String (enum)	Indique si l’article contient cet allergène. Valeurs autorisées : `contains`, `freeOf`, `mayContain`
`allergen_gluten` String (enum)	Indique si l’article contient cet allergène. Valeurs autorisées : `contains`, `freeOf`, `mayContain`
`allergen_lactose` String (enum)	Indique si l’article contient cet allergène. Valeurs autorisées : `contains`, `freeOf`, `mayContain`
`allergen_lupins` String (enum)	Indique si l’article contient cet allergène. Valeurs autorisées : `contains`, `freeOf`, `mayContain`
`allergen_milk` String (enum)	Indique si l’article contient cet allergène. Valeurs autorisées : `contains`, `freeOf`, `mayContain`
`allergen_molluscs` String (enum)	Indique si l’article contient cet allergène. Valeurs autorisées : `contains`, `freeOf`, `mayContain`
`allergen_mustard` String (enum)	Indique si l’article contient cet allergène. Valeurs autorisées : `contains`, `freeOf`, `mayContain`
`allergen_nuts` String (enum)	Indique si l’article contient cet allergène. Valeurs autorisées : `contains`, `freeOf`, `mayContain`
`allergen_peanuts` String (enum)	Indique si l’article contient cet allergène. Valeurs autorisées : `contains`, `freeOf`, `mayContain`
`allergen_sesame` String (enum)	Indique si l’article contient cet allergène. Valeurs autorisées : `contains`, `freeOf`, `mayContain`
`allergen_soy` String (enum)	Indique si l’article contient cet allergène. Valeurs autorisées : `contains`, `freeOf`, `mayContain`
`allergen_sulfites` String (enum)	Indique si l’article contient cet allergène. Valeurs autorisées : `contains`, `freeOf`, `mayContain`
`diet` Array (diet)	Liste séparée par des virgules des classifications du régime alimentaire de l’article. Valeurs autorisées : https://my.mercanto.ch/fr/definierte-werte#ernahrungsform
`alcohol_percentage` Number (0, 100)	Teneur en alcool en pourcentage volumique.
`alcohol_` `drinking_temperature` String (100)	Température de service recommandée.
`alcohol_vintage_year` Number (100)	Millésime.
`alcohol_winery_<LOCALE>` Localized String (10000)	Domaine viticole dans la langue correspondante. **
`alcohol_grape_<LOCALE>` Localized String (10000)	Cépage(s) dans la langue correspondante. **
`alcohol_` `drinking_period_<LOCALE>` Localized String (10000)	Période de consommation recommandée du vin, par ex. en années après la récolte, dans la langue correspondante. **
`alcohol_` `degustation_<LOCALE>` Localized String (10000)	Description du goût du vin dans la langue correspondante. **
`alcohol_culinary_ recommendation_<LOCALE>` Localized String (10000)	Recommandations pour servir la boisson, les plats avec lesquels elle s’accorde, etc. dans la langue correspondante. **
`alcohol_label_<LOCALE>` Localized String (10000)	Mention supplémentaire telle que « Gran Reserva » ou similaire, dans la langue correspondante. **
`alcohol_wine_region` Array (enum)	Liste séparée par des virgules des régions dont provient le vin. Valeurs autorisées : https://my.mercanto.ch/fr/definierte-werte#weinregion
`color_text_<LOCALE>` Localized String (10000)	Informations spécifiques sur l’apparence de la couleur dans la langue correspondante. Remarque** : ce champ est obsolète et ne doit plus être utilisé.
`color` String (enum)	Classification générale des couleurs pour le filtrage dans le catalogue.
`migel_number` String (1000)	Numéro de l’article figurant dans la « Liste des moyens et appareils » (LiMA).
`meat_body_part_<LOCALE>` Localized String (255)	Morceau de viande dans la langue correspondante. **
`fishing_area` Array (enum)	Liste séparée par des virgules des zones de pêche de l’animal selon la FAO. Valeurs autorisées : https://my.mercanto.ch/fr/definierte-werte#fangzone
`fish_latin_name` String (1000)	Nom latin du poisson.
`fish_method_` `of_capture_<LOCALE>` Localized String (10000)	Méthode de pêche du poisson dans la langue correspondante. **
`fish_production_` `type_<LOCALE>` Localized String (10000)	Type d’élevage piscicole dans la langue correspondante. **
`advance_order_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é.
`order_comments_allowed` boolean (0, 1)	Indique si un commentaire relatif à l’article est autorisé. valeur par défaut = `0`
`clothing_size` String (enum)	Indications de taille EU (par ex. EU_38, EU_42/44) pour les vêtements, ainsi que les tailles en lettres S/M/L et « taille unique ». Valeurs autorisées : https://my.mercanto.ch/fr/definierte-werte#kleidergrosse
`shoe_size` String (enum)	Indications de taille pour tous les modèles de chaussures. Valeurs autorisées : https://my.mercanto.ch/fr/definierte-werte#schuhgrosse
`size_sml` String (enum)	Tailles générales telles que XXS, M, L ou XL. Valeurs autorisées : https://my.mercanto.ch/fr/definierte-werte#grosse

Cas d’utilisation typique : Un fournisseur lance un nouvel article « Jus de pomme bio 1L ». Le nom, le numéro d’article, la catégorie, le taux de TVA et l’unité de base sont saisis, ainsi que le pays d’origine, les ingrédients et les valeurs nutritionnelles, afin que l’article soit affiché correctement dans le catalogue.

** = <LOCALE> doit être remplacé par le code de langue de, fr, it ou en, la langue par défaut enregistrée étant obligatoire.