> ## 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 dei dati cliente tramite URL

> Precompila nome, email e telefono del cliente con parametri URL: link di checkout senza attriti per loyalty, campagne marketing e integrazioni CRM.

Puoi costruire un URL che compila automaticamente i dati di contatto di un cliente (nome, email, telefono, ecc.) quando apre il tuo negozio. È utile per campagne di marketing, link a programmi fedeltà, portali Wi-Fi captive, codici QR o qualsiasi integrazione in cui conosci già il cliente e vuoi risparmiargli l'inserimento manuale dei dati.

## Formato dell'URL

```
https://{your-store-domain}/{venueSlug}?firstName={value}&lastName={value}&email={value}&phone={value}&postCode={value}
```

Tutti i parametri sono facoltativi: includi solo quelli che vuoi precompilare.

## Parametri supportati

| Parametro   | Descrizione                    | Esempio                  |
| ----------- | ------------------------------ | ------------------------ |
| `firstName` | Nome del cliente               | `firstName=Jane`         |
| `lastName`  | Cognome del cliente            | `lastName=Smith`         |
| `email`     | Indirizzo email del cliente    | `email=jane@example.com` |
| `phone`     | Numero di telefono del cliente | `phone=%2B447700900000`  |
| `postCode`  | Codice postale di consegna     | `postCode=SW1A%201AA`    |

<Note>
  I valori che contengono caratteri speciali devono essere codificati in URL. Ad esempio, `+447700900000` diventa `%2B447700900000` e gli spazi diventano `%20`.
</Note>

## Esempi

Precompilare solo l'indirizzo email:

```
https://order.storekit.com/my-restaurant?email=jane@example.com
```

Precompilare i dati completi del cliente:

```
https://order.storekit.com/my-restaurant?firstName=Jane&lastName=Smith&email=jane@example.com&phone=%2B447700900000
```

Combinare con un codice sconto:

```
https://order.storekit.com/my-restaurant?email=jane@example.com&discount=WELCOME10
```

## Come funziona

1. Il cliente apre l'URL contenente i parametri di query.
2. Il negozio carica il menu normalmente.
3. Ogni parametro riconosciuto viene letto e utilizzato per popolare il campo corrispondente nel modulo di checkout.
4. I parametri di query vengono rimossi dall'URL in modo che non appaiano nella barra degli indirizzi e non vengano condivisi accidentalmente.
5. Il cliente vede i propri dati precompilati al checkout e può rivederli o modificarli prima di effettuare l'ordine.

## Combinare con la precompilazione del carrello

Puoi combinare i parametri dei dati cliente con un [URL di precompilazione del carrello](/docs/it/developers/basket-prefill) per inviare un cliente direttamente a un carrello precompilato con i suoi dati già inseriti:

```
https://order.storekit.com/my-restaurant/basket/BURGER01:2,FRIES01:1?firstName=Jane&email=jane@example.com
```

## Visibilità dei campi

I valori precompilati appaiono solo se il campo corrispondente è abilitato nelle **User Information Settings** del tuo negozio nella dashboard. Ad esempio, se il campo del numero di telefono è disattivato per il tuo negozio, il parametro `phone` verrà accettato ma non sarà visibile al cliente al checkout.

<Warning>
  I parametri di query vengono rimossi dall'URL dopo essere stati applicati. Se il cliente aggiorna la pagina, i valori non verranno riapplicati dall'URL. Tuttavia, i campi rimangono compilati per la durata della sessione.
</Warning>


## Related topics

- [Precompilazione del carrello tramite URL](/docs/it/developers/basket-prefill.md)
- [Dati dei clienti](/docs/it/guides/marketing/customer-data.md)
- [Crea e condividi link di pagamento storekit](/docs/it/guides/payments/payment-links.md)
- [Acquisire i dati degli ospiti](/docs/it/guides/guest-data/overview.md)
- [Shipday per dispatch e ottimizzazione dei percorsi](/docs/it/guides/integrations/delivery/shipday.md)