Skip to main content
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

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

Exemple

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

Modificateurs

Un produit peut contenir une sélection de modificateurs entre parenthèses, immédiatement après sa quantité. Les modificateurs sont séparés par des points-virgules :
Si le même PLU de modificateur existe dans plusieurs groupes de modificateurs d’un produit, il est résolu vers le premier groupe qui le contient, dans l’ordre d’apparition des groupes sur le produit.

Exemple

Pour ajouter 2 burgers avec fromage (×1) et bacon (×1) :
Les produits avec des groupes de modificateurs obligatoires (par exemple « Choisir une taille ») peuvent désormais être pré-remplis, à condition que l’URL satisfasse chaque groupe obligatoire :
Le même produit avec des sélections de modificateurs différentes crée des lignes de panier distinctes. Le même produit avec une sélection identique est fusionné en une seule ligne avec les quantités additionnées. Le stock suivi est alloué aux lignes dans l’ordre où elles apparaissent dans l’URL : chaque ligne s’intègre dans le stock restant pour son produit et ses modificateurs, ou est ignorée. Les groupes de modificateurs imbriqués dans une autre option de modificateur ne peuvent pas être pré-remplis.

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.
Les groupes de modificateurs avec des sélections par défaut sont appliqués automatiquement lorsque l’URL ne mentionne pas ce groupe.

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 :

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 pour plus de détails sur la gestion des codes PLU.