> ## 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.

# Precompilazione del carrello tramite URL

> Precompila il carrello del cliente con codici PLU nell'URL: crea link di riordino, URL per campagne marketing e QR code con articoli già aggiunti.

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

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

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

```
PLU:quantity
```

| Parte      | Descrizione                                                                                                                         |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `PLU`      | Il codice PLU (Price Look-Up) del prodotto. Viene impostato nella configurazione del menu ed è usato anche per le integrazioni POS. |
| `quantity` | Il numero di unità da aggiungere al carrello. Deve essere un intero positivo.                                                       |

### Esempio

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

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

## 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.

| Condizione                                         | Risultato                                                                     |
| -------------------------------------------------- | ----------------------------------------------------------------------------- |
| PLU non trovato nel menu                           | Articolo ignorato                                                             |
| Prodotto contrassegnato come non disponibile       | Articolo ignorato                                                             |
| Prodotto esaurito (inventario tracciato)           | Articolo ignorato                                                             |
| La quantità richiesta supera le scorte disponibili | Articolo ignorato                                                             |
| Il prodotto ha modificatori obbligatori            | Articolo ignorato (i modificatori non possono essere specificati tramite URL) |

<Warning>
  I prodotti che hanno gruppi di modificatori obbligatori (ad es. «Scegli una taglia») non possono essere aggiunti tramite precompilazione URL, perché i modificatori non possono essere specificati nel formato URL. Questi articoli verranno ignorati.
</Warning>

## 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:

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

## 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](/docs/it/guides/integrations/pos/advanced/plu-mapping) per maggiori dettagli sulla gestione dei codici PLU.


## Related topics

- [Precompilazione dei dati cliente tramite URL](/docs/it/developers/customer-prefill.md)
- [Zonal (Aztec)](/docs/it/guides/integrations/pos/zonal.md)
- [Crea e condividi link di pagamento storekit](/docs/it/guides/payments/payment-links.md)
- [Strategia e best practice per le Stories](/docs/it/guides/menu-engineering/stories.md)
- [Crea stories del menu con contenuti video e CTA](/docs/it/guides/marketing/stories.md)