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

# Iniezione degli ordini

> Scopri come storekit inietta automaticamente gli ordini online nel tuo terminale POS entro pochi secondi dal checkout, eliminando la doppia digitazione per lo staff.

L'iniezione degli ordini è il processo di invio automatico degli ordini online al tuo sistema POS. Quando un cliente completa il checkout, l'ordine viene trasmesso al tuo POS in pochi secondi, comparendo sui terminali e sulle stampanti di cucina proprio come qualsiasi altro ordine.

## Come funziona l'iniezione degli ordini

```
Il cliente completa il checkout
           ↓
    Pagamento elaborato
           ↓
  Ordine salvato in storekit
           ↓
   Ordine inviato alla API del POS
           ↓
  Il POS conferma la ricezione
           ↓
 L'ordine compare sul terminale
           ↓
  Il ticket di cucina stampa
```

L'intero processo si completa in genere in 2-5 secondi.

## Tempistica degli ordini

Quando gli ordini vengono iniettati dipende dal tipo di fulfillment e dalla tua configurazione.

### Ordini ASAP

Gli ordini per fulfillment immediato vengono iniettati non appena il pagamento è completato. L'ordine compare subito nel tuo POS.

### Pre-ordini / ordini programmati

Per gli ordini programmati per un orario futuro, la tempistica di iniezione dipende dalle tue impostazioni:

| Impostazione            | Comportamento                                       |
| ----------------------- | --------------------------------------------------- |
| **Iniezione immediata** | Ordine inviato al POS subito dopo il pagamento      |
| **Iniezione ritardata** | Ordine inviato X minuti prima dell'orario richiesto |

L'iniezione ritardata è utile se non vuoi che i pre-ordini intasino la coda della cucina con ore di anticipo.

<Tip>
  Per cucine con volumi elevati, considera di iniettare i pre-ordini 15-30 minuti prima dell'orario richiesto. Questo dà tempo di preparazione sufficiente senza sovraccaricare la coda.
</Tip>

## Cosa è incluso negli ordini

Ogni ordine inviato al tuo POS contiene:

### Dettagli ordine

* ID univoco dell'ordine
* Timestamp dell'ordine
* Orario di fulfillment richiesto

### Articoli

* Nomi dei prodotti e quantità
* Modificatori e personalizzazioni
* Note a livello di articolo
* Codici PLU/prodotto (per integrazioni linkate)

### Informazioni sul cliente

* Nome
* Numero di telefono
* Indirizzo email

### Dettagli di fulfillment

* Metodo (delivery, pickup, dine-in)
* Indirizzo di consegna (se applicabile)
* Numero di tavolo (per dine-in)
* Istruzioni speciali

### Pagamento

* Stato del pagamento (pagato/in sospeso)
* Metodo di pagamento
* Importo della mancia (se applicabile)

Gli ordini in contanti vengono inviati senza un pagamento allegato, così che lo scontrino resti aperto per lo staff da chiudere — a meno che nell'integrazione POS sia abilitata l'impostazione cash-as-paid. Vedi [ordini in contanti e pay-on-collection](/docs/it/guides/payments/cash-payments).

## Gestione degli errori

storekit è progettato per gestire in modo elegante i fallimenti di comunicazione con il POS.

### Retry automatico

Se il POS è temporaneamente irraggiungibile:

1. storekit mette l'ordine in coda
2. Riprova automaticamente con backoff esponenziale
3. Continua a riprovare fino al successo
4. L'ordine alla fine compare nel POS

<Warning>
  Se un ordine non riesce a sincronizzarsi dopo tutti i tentativi di retry, riceverai una notifica email con il motivo specifico dell'errore, i dettagli dell'ordine e un link diretto per visualizzare l'ordine nella tua dashboard.
</Warning>

### Esperienza cliente

Gli ordini si completano sempre con successo per il cliente, anche se l'iniezione POS è ritardata:

* Il pagamento viene elaborato
* Il cliente riceve la conferma
* L'ordine compare nella dashboard storekit
* Puoi inserire l'ordine manualmente se necessario

<Info>
  I clienti non vengono mai impattati dai problemi POS temporanei. Il loro ordine è confermato e tu lo avrai sempre nella tua dashboard storekit.
</Info>

### Errori di connessione POS

In caso di problemi persistenti di connessione, i clienti potrebbero vedere un messaggio che chiede di contattare lo staff. Questo accade solo in scenari specifici come il pay-at-table, dove la connettività POS è critica.

## Modifiche agli ordini

### Prima dell'iniezione POS

Se devi modificare un ordine prima che venga inviato al POS:

1. Trova l'ordine nella tua dashboard storekit
2. Apporta le modifiche necessarie
3. L'ordine modificato viene inviato al POS

### Dopo l'iniezione POS

Una volta che un ordine è stato iniettato:

* Le modifiche in storekit non aggiornano automaticamente il POS
* Modifica l'ordine direttamente nel tuo POS
* Elabora i rimborsi tramite storekit se necessario

## Comportamento specifico dell'integrazione

Diverse integrazioni POS gestiscono gli ordini in modo leggermente diverso.

### Zonal

* Gli ordini compaiono come ordini online in Aztec
* Pieno supporto dei modificatori
* Gli sconti della loyalty Zonal vengono registrati
* Le note dell'ordine compaiono sui ticket

### Lightspeed K-Series

* Gli ordini compaiono sul terminale configurato
* L'instradamento in cucina segue la tua configurazione Lightspeed
* Le assegnazioni delle portate vengono rispettate (se configurate)

### TISSL (basato su PLU)

* I prodotti vengono abbinati per codice PLU
* Assicurati che tutti i prodotti abbiano PLU validi
* Articoli non abbinati possono causare il fallimento dell'ordine

## Troubleshooting dell'iniezione ordini

### Ordini non compaiono nel POS

1. **Controlla lo stato dell'integrazione**: verifica che la connessione POS sia attiva in Store Settings
2. **Controlla lo stato del POS**: assicurati che il tuo terminale POS sia online
3. **Rivedi l'ordine nella dashboard**: cerca eventuali messaggi di errore sull'ordine
4. **Controlla i codici PLU**: per le integrazioni con linking manuale, verifica che i PLU siano corretti
5. **Controlla le notifiche email**: se l'ordine non è riuscito a sincronizzarsi, riceverai un'email con i dettagli dell'errore

### Ordini ritardati

* Controlla la tua connettività di rete
* Verifica che la API del POS stia rispondendo
* Rivedi eventuali messaggi di errore nella dashboard

### Articoli o modificatori mancanti

* Assicurati che tutti i prodotti siano mappati correttamente
* Controlla i codici PLU dei modificatori (per TISSL/linking manuale)
* Verifica che i prodotti esistano nel POS

### Prezzi sbagliati

* Controlla le impostazioni tax-inclusive vs tax-exclusive
* Verifica che i prezzi corrispondano tra i sistemi
* Ri-sincronizza il menu se usi la sync automatica

## Best practice

### Testa prima del go-live

Testa sempre a fondo l'iniezione degli ordini:

1. Effettua un ordine di test con vari articoli
2. Includi modificatori e richieste speciali
3. Verifica che tutto compaia correttamente nel POS
4. Testa diversi metodi di fulfillment

### Monitora il flusso ordini

* Controlla regolarmente che gli ordini fluiscano al POS
* Imposta avvisi per i fallimenti di iniezione (se disponibili)
* Rivedi tempestivamente eventuali ordini falliti

### Mantieni i sistemi sincronizzati

* Sincronizza regolarmente i menu se usi integrazioni pull
* Aggiorna i codici PLU quando aggiungi nuovi articoli
* Testa dopo aver apportato modifiche al menu

Per ulteriore assistenza, [contatta il supporto](/docs/it/getting-started/contact-support).


## Related topics

- [Lightspeed K-Series](/docs/it/guides/integrations/pos/lightspeed-k-series.md)
- [TISSL](/docs/it/guides/integrations/pos/tissl.md)
- [Zonal (Aztec)](/docs/it/guides/integrations/pos/zonal.md)
- [Centegra](/docs/it/guides/integrations/pos/centegra.md)
- [PointOne](/docs/it/guides/integrations/pos/pointone.md)