---
title: "shopping_lists-.csv"
url: "https://wiki.merchant.mercanto.ch/fr/article/shopping-list-headercsv"
language: "fr"
last_updated: "2026-08-11T09:20:03.224Z"
---
# shopping_lists-.csv
Fichier modèle à télécharger, [cliquez ici](https://merchant.mercanto.ch/templates/shopping_lists-template.csv).
Fichier d'exemple rempli à télécharger, [cliquer ici](https://merchant.mercanto.ch/templates/product_restrictions-template-with-examples.csv).
## Description
Avec **shopping\_lists-.csv**, un fournisseur transmet à ses clients des listes de commande prédéfinies : par exemple un modèle pour la commande hebdomadaire habituelle, un assortiment partiel prédéfini pour une succursale donnée, ou une liste personnelle que le client pourra ensuite compléter lui-même.
**shopping\_lists-.csv** ne contient que « l'en-tête de liste » (nom = `name`, description = `description`, quels clients voient la liste = `customer_keys`, si elle est modifiable = `readonly`).
Les positions d'articles proprement dites de la liste sont définies séparément dans [**shopping\_lists\_items-.csv**](https://wiki.merchant.mercanto.ch/fr/article/shopping-list-itemscsv) et reliées à l'en-tête de liste correspondant via la clé commune `shopping_list_key`. Une liste de commande se compose donc toujours de deux fichiers liés, qui doivent être importés lors du même processus d'import. Une `shopping_list_key` utilisée dans [**shopping\_lists\_items-.csv**](https://wiki.merchant.mercanto.ch/fr/article/shopping-list-itemscsv) doit impérativement avoir été créée au préalable (ou dans le même import) comme en-tête de liste dans **shopping\_lists-.csv**, sinon les positions ne peuvent être rattachées à aucune liste.
Dépendances avec d'autres types de données :
- Le fichier **shopping\_lists-.csv** doit être importé en même temps que le fichier [**shopping\_lists\_items.csv**](https://wiki.merchant.mercanto.ch/fr/article/shopping-list-itemscsv) correspondant.
- Les numéros de client indiqués dans `customer_keys` doivent exister en tant que relations client valides et actives dans [**merchant\_relationships-.csv**](https://wiki.merchant.mercanto.ch/fr/article/merchant-relationshipscsv).
- Les articles de la liste (voir [**shopping\_lists\_items-.csv**](https://wiki.merchant.mercanto.ch/fr/article/shopping-list-itemscsv)) doivent exister en tant que `sku` actives dans [**products-.csv**](https://wiki.merchant.mercanto.ch/fr/article/productscsv) / [**products\_packaging-.csv**](https://wiki.merchant.mercanto.ch/fr/article/products-packagingcsv).
## Colonnes disponibles
| **Champ**
(\* = Obligatoire) | **Description** |
| --- | --- |
| `import_type` \*
*String (enum)* | Définit si cet enregistrement doit être créé/actualisé ou supprimé. Valeurs autorisées : `create_update` ou `delete` |
| `customer_keys` \*
*Array (String)* | Liste séparée par des virgules des numéros de client. |
| `shopping_list_key` \*
*String (100)* | Identifiant unique de la liste de commande du point de vue du fournisseur. |
| `name` \*
*String (100)* | Nom de la liste de commande affiché au client dans Mercanto. |
| `readonly`
*boolean (0, 1)* | Détermine si un client peut modifier la liste de commande dans Mercanto ou non. `1` = ne peut pas être modifiée. `0` = peut être modifiée. défaut = `1` |
| `description`
*String (1000)* | Description de la liste de commande, affichée au client dans Mercanto. |
Cas d'utilisation typique : un fournisseur souhaite que les succursales d'une chaîne puissent toujours recommander en un clic le même « assortiment de base ». Pour cela, une liste en lecture seule (`readonly` = `1`) « Assortiment standard boulangerie » est créée et attribuée à tous les `customer_keys` concernés.