> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Pré-remplissage du panier via URL

> Pré-remplissez le panier client via des codes PLU dans l'URL. Créez des liens de re-commande, des campagnes marketing et des QR codes avec articles ajoutés.

Vous pouvez construire une URL qui ajoute automatiquement des produits au panier d'un client lorsqu'il ouvre votre magasin. Cela est utile pour les campagnes marketing, les QR codes, les liens de re-commande, ou tout scénario où vous souhaitez envoyer un client directement vers le paiement avec des articles spécifiques.

## Format de l'URL

```
https://{your-store-domain}/{venueSlug}/basket/{products}
```

Le paramètre `{products}` est une liste d'articles séparés par des virgules, où chaque article suit le format :

```
PLU:quantity
```

| Partie     | Description                                                                                                                                   |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `PLU`      | Le code PLU (Price Look-Up) du produit. Il est défini dans la configuration de votre menu et est également utilisé pour les intégrations POS. |
| `quantity` | Le nombre d'unités à ajouter au panier. Doit être un entier positif.                                                                          |

### Exemple

Pour ajouter 2 unités du produit `BURGER01` et 1 unité du produit `FRIES01` :

```
https://order.storekit.com/my-restaurant/basket/BURGER01:2,FRIES01:1
```

## Fonctionnement

1. Le client ouvre l'URL.
2. Le magasin charge le menu comme d'habitude.
3. Chaque PLU dans l'URL est comparé aux produits disponibles.
4. Les articles valides sont ajoutés au panier avec les quantités indiquées.
5. Le client est redirigé vers la page du menu avec le panier pré-rempli et peut passer au paiement.

## Règles de validation

Chaque article de l'URL est validé individuellement. Les articles qui échouent à la validation sont ignorés, et les articles valides restants sont tout de même ajoutés au panier. Le client verra une notification listant les articles qui n'ont pas pu être ajoutés.

| Condition                                          | Résultat                                                                   |
| -------------------------------------------------- | -------------------------------------------------------------------------- |
| PLU introuvable dans le menu                       | Article ignoré                                                             |
| Produit marqué comme indisponible                  | Article ignoré                                                             |
| Produit en rupture de stock (inventaire suivi)     | Article ignoré                                                             |
| Quantité demandée supérieure au stock disponible   | Article ignoré                                                             |
| Le produit comporte des modificateurs obligatoires | Article ignoré (les modificateurs ne peuvent pas être spécifiés via l'URL) |

<Warning>
  Les produits qui comportent des groupes de modificateurs obligatoires (par ex. « Choisissez une taille ») ne peuvent pas être ajoutés via le pré-remplissage par URL, car les modificateurs ne peuvent pas être spécifiés dans le format d'URL. Ces articles seront ignorés.
</Warning>

## Paramètres de requête

Vous pouvez combiner l'URL du panier avec tous les paramètres de requête standards pris en charge par votre magasin. Par exemple, pour appliquer également un code de réduction :

```
https://order.storekit.com/my-restaurant/basket/BURGER01:2?discount=SAVE10
```

## Trouver les codes PLU

Les codes PLU sont configurés par produit dans le tableau de bord storekit, sous les paramètres de menu. Ce sont les mêmes codes que ceux utilisés pour les intégrations POS. Voir [PLU Mapping](/docs/fr/guides/integrations/pos/advanced/plu-mapping) pour plus de détails sur la gestion des codes PLU.


## Related topics

- [Pré-remplissage des coordonnées client via URL](/docs/fr/developers/customer-prefill.md)
- [Paramètres d'exploitation : temps de préparation, acceptation automatique et ventes additionnelles](/docs/fr/guides/store-settings/operations-settings.md)
- [Pré-commandes : planifier retrait et livraison futurs](/docs/fr/guides/orders/advanced/pre-orders.md)
- [Klaviyo](/docs/fr/guides/integrations/marketing/klaviyo.md)
- [Stratégie et bonnes pratiques des stories](/docs/fr/guides/menu-engineering/stories.md)