---
title: "shopping_list"
url: "https://wiki.merchant.mercanto.ch/fr/article/shopping-list"
language: "fr"
last_updated: "2026-05-11T12:45:20.110Z"
---
# shopping_list
Exemple de fichier dans [gitlab](https://gitlab.com/mercanto/iocanto-spec/-/blob/master/examples/shopping_list.iocanto.json).
## Description
Chaque fournisseur a la possibilité de transmettre des listes d'achats à ses clients.
Il peut définir si le client peut modifier la liste ou non (`readonly`).
Il est également possible d’ajouter des informations supplémentaires soit au niveau de l’en-tête (`additional_info_field`, valable pour toutes les positions), soit individuellement pour chaque article (`additional_info`).
## Champs disponibles
| **Champ**
(\* = Obligatoire) | **Description** |
| --- | --- |
| `customer_keys` \*
*Array (String)* | Liste de numéros de client, séparés par des virgules, auxquels s'applique la liste de commandes.Liste de numéros de client, séparés par des virgules, auxquels s'applique la liste de commandes. |
| `shopping_list_key` \*
*String (100)* | Identifiant unique de la liste d'achats du point de vue du fournisseur. |
| `name` \*
*String (100)* | Nom de la liste d'achats tel qu’il apparaît dans Mercanto pour le client. |
| `readonly`
*boolean (true, false)* | Définit si le client peut modifier la liste dans Mercanto.
défaut = `true` |
| `description`
*String (1000)* | Description de la liste d'achats affichée dans Mercanto. |
| `additional_info_field/ label`
*Localized String (10000)* | Champ d’informations supplémentaires appliqué à toute la liste, utilisé pour transmettre des informations spécifiques valables pour tous les articles. |
| `items/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 `.`. |
| `items/packaging`
*String (enum)* | Unité d’emballage du produit. Un même produit peut apparaître plusieurs fois avec différentes unités d’emballage.
Valeurs autorisées : [https://my.mercanto.ch/fr/valeurs-definies#unitedemballage](https://my.mercanto.ch/fr/valeurs-definies#unitedemballage) et [https://my.mercanto.ch/fr/valeurs-definies#unite](https://my.mercanto.ch/fr/valeurs-definies#unite) |
| `items/quantity`
*Integer (0, 100000)* | Quantité de l’article selon l’unité d’emballage (`packaging`). |
| `items/sort_order`
*Integer (0, 100000)* | Ordre d’affichage de l’article dans la liste. |
| `items/additional_info`
*Localized String (10000)* | Informations supplémentaires au niveau de l’article. Si `additional_info_field/label` est utilisé, ces informations s’y réfèrent. |
| `items/additional_fields/ measurement_amount_ per_item`
*Number (0, 100000)* | Utilisé uniquement pour les articles vendus « x pièces à y kg ». Définit la valeur « à y kg ». |
| `deleted`
*boolean (true, false)* | Indique si l’entrée doit être supprimée.
défaut = `false` |