Skip to main content
Puoi costruire un URL che aggiunge automaticamente prodotti al carrello di un cliente quando apre il tuo negozio. È utile per campagne di marketing, codici QR, link di riordino o qualsiasi scenario in cui vuoi inviare un cliente direttamente al checkout con articoli specifici.

Formato dell’URL

Il parametro {products} è un elenco di articoli separati da virgola, dove ogni articolo segue il formato:

Esempio

Per aggiungere 2 unità del prodotto BURGER01 e 1 unità del prodotto FRIES01:

Modificatori

Un prodotto può includere una selezione di modificatori tra parentesi, immediatamente dopo la quantità. I modificatori sono separati da punto e virgola:
Se lo stesso PLU modificatore è presente in più gruppi modificatori del prodotto, viene risolto al primo gruppo che lo contiene, nell’ordine in cui i gruppi compaiono nel prodotto.

Esempio

Per aggiungere 2 burger con formaggio (×1) e bacon (×1):
I prodotti con gruppi modificatori obbligatori (ad esempio “Scegli una dimensione”) possono ora essere precompilati, a condizione che l’URL soddisfi ogni gruppo obbligatorio:
Lo stesso prodotto con selezioni di modificatori diverse crea righe carrello separate. Lo stesso prodotto con una selezione identica viene unito in un’unica riga con le quantità sommate. Il magazzino tracciato viene assegnato alle righe nell’ordine in cui appaiono nell’URL: ogni riga rientra nel magazzino rimanente per il suo prodotto e modificatori, oppure viene ignorata. I gruppi modificatori annidati all’interno di un’altra opzione modificatore non possono essere precompilati.

Come funziona

  1. Il cliente apre l’URL.
  2. Il negozio carica il menu normalmente.
  3. Ogni PLU nell’URL viene abbinato ai prodotti disponibili.
  4. Gli articoli validi vengono aggiunti al carrello con le quantità specificate.
  5. Il cliente viene reindirizzato alla pagina del menu con il carrello precompilato e può procedere al checkout.

Regole di validazione

Ogni articolo nell’URL viene validato individualmente. Gli articoli che non superano la validazione vengono ignorati, mentre gli altri articoli validi vengono comunque aggiunti al carrello. Il cliente vedrà una notifica che elenca eventuali articoli che non è stato possibile aggiungere.
I gruppi modificatori con selezioni predefinite vengono applicati automaticamente quando l’URL non menziona quel gruppo.

Parametri di query

Puoi combinare l’URL del carrello con qualsiasi parametro di query standard supportato dal tuo negozio. Ad esempio, per applicare anche un codice sconto:

Trovare i codici PLU

I codici PLU sono configurati per prodotto nella dashboard storekit, nelle impostazioni del menu. Sono gli stessi codici utilizzati per le integrazioni POS. Consulta Mappatura PLU per maggiori dettagli sulla gestione dei codici PLU.