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

# Ordini Stream

> Come gli ordini storekit arrivano a Stream: invio e buffering dei pre-ordini, contenuto, aggiornamenti di stato, annullamenti e gestione degli errori.

Una volta collegato un negozio a Stream, ogni ordine effettuato viene messo in coda verso Stream automaticamente. Stream passa l'ordine al tuo POS e ne riporta l'avanzamento.

## Come un ordine arriva a Stream

1. Il cliente completa il checkout e l'ordine viene creato in storekit.
2. storekit mette l'ordine in coda verso Stream: immediatamente per un ordine ASAP, o in ritardo per un preordine quando **Buffer Orders** è attivo.
3. storekit costruisce l'ordine Stream e lo invia. Se Stream rifiuta la richiesta, storekit riprova fino a sei volte in pochi secondi.
4. Stream comunica **accepted**: l'ordine viene contrassegnato come **Accepted** in storekit e la timeline registra il cambio di stato dal POS.
5. Stream comunica un cambio di stato o un annullamento man mano che l'ordine procede.

> [!NOTE]
>
> Gli ordini vanno a Stream non appena vengono effettuati: non c'è un passaggio di accettazione preliminare in storekit. Gli ordini multi-vendor vengono uniti in un unico ordine Stream prima dell'invio, così un cliente che ordina da più vendor contemporaneamente appare al POS come un unico ticket.

## Cosa contiene l'ordine

| storekit | Stream |
| - | - |
| Articoli, varianti e modificatori | Inviati con i loro Stream ID (gli ID importati durante la [sincronizzazione del menu](/docs/it/guides/integrations/pos/stream/menu-sync)), quantità, prezzi e note per articolo. I modificatori annidati vengono inviati sotto il loro modificatore genitore. |
| Metodo di evasione | **Pickup** → `pickup`, **Delivery** → `merchant_managed_delivery`, **Curbside** → `curbside`, **In Store** e **Add to Bill** → `dine_in`. |
| Cliente | Nome, email e telefono. Un nome mancante viene inviato come *Placeholder*, e un telefono mancante come il numero placeholder `+447700900000`, così il POS riceve sempre un contatto. |
| Orario richiesto | Inviato come orario di ready stimato, e l'ordine viene contrassegnato come future order quando si tratta di un preordine. |
| Mancia e service charge | Per default entrambi vengono inviati insieme come mancia al negozio. Se il supporto storekit ha abilitato la gestione del service charge sul negozio, vengono invece inviati come service charge. |
| Costo di consegna e indirizzo | Inviati sugli ordini di consegna, insieme alle note di consegna del cliente come istruzioni di evasione. |
| Sconti | L'importo dello sconto, con il codice sconto se ne è stato usato uno. |
| Posate | La scelta del cliente sulle posate viene inviata come *include utensils*. |
| Pagamento | Gli ordini vengono sempre inviati come pagati: Stream non incassa mai il pagamento per gli ordini storekit. |

Le tasse non sono dettagliate sull'ordine Stream; i prezzi vengono inviati come compaiono sul menu storekit.

## Note d'ordine

**Order Note Template** nella pagina **Stream Integration** controlla la nota inviata con ogni ordine. Il supporto può cliccare **Insert Variable** per vedere le variabili disponibili e **Preview** per verificare il risultato con dati d'esempio. Le note del cliente vengono aggiunte in coda al template, separate da un trattino.

Senza template, la nota è quella del cliente. Per gli ordini in negozio senza template, storekit fa precedere la nota da *Table \<table name>* e invia il nome del cliente come *\<table name> (\<customer name>)*, così il ticket mostra a chi appartiene: vedi [Sala](/docs/it/guides/integrations/pos/stream/dine-in).

## Buffering dei preordini

Per default un preordine viene inviato a Stream immediatamente, il che può ingombrare la cucina con ore di anticipo. Per ritardarlo, chiedi al [supporto storekit](/docs/it/getting-started/contact-support) di:

1. Attivare **Buffer Orders**.
2. Impostare **Buffer Value**: l'ordine viene inviato quel numero di minuti prima dell'orario di evasione richiesto. Deve essere almeno 1 (*Buffer value must be greater than 0*).

Con **Buffer Orders** attivo e nessun **Buffer Value** salvato, storekit usa il normale calcolo del prep time del negozio per decidere quando inviare. Gli ordini senza orario richiesto non vengono mai bufferizzati.

> [!TIP]
>
> 15-30 minuti è un buon punto di partenza per una cucina intensa.

## Aggiornamenti da Stream

Stream può cambiare l'ordine in storekit dopo che è stato accettato:

* **Cambi di stato**: `ready_for_pickup`, `out_for_delivery` e `completed` da Stream spostano l'ordine su **Ready for Pickup**, **Out for Delivery** o **Completed** in storekit e attivano le consuete notifiche cliente per quegli stati. Gli altri stati di Stream vengono ignorati.
* **Annullamento da Stream**: l'ordine viene annullato in storekit, con la sorgente registrata come Stream.
* **Annullamento da storekit**: annullare un ordine dalla dashboard invia una richiesta di annullamento a Stream così il ticket POS viene stornato. Gli annullamenti originati da Stream non vengono rimandati indietro.

## Quando un ordine fallisce

Ci sono due modi in cui un ordine Stream può fallire:

* **Stream rifiuta la richiesta.** Se l'API Stream rifiuta l'ordine dopo i tentativi di storekit, l'ordine viene contrassegnato come **Failed** e il team storekit viene avvisato. In questo caso non viene memorizzato alcun motivo di fallimento sull'ordine, quindi la pagina dell'ordine mostra solo lo stato **Failed**.
* **Stream comunica un fallimento.** Se Stream accetta la richiesta ma il POS fa poi fallire l'ordine, Stream invia un evento di fallimento con un motivo. storekit contrassegna l'ordine come **Failed**, memorizza il motivo di Stream parola per parola sull'ordine e invia un'email al negozio.

### L'email di ordine fallito

L'email viene inviata quando Stream comunica il fallimento, con oggetto `Stream Issue: Order #<order number> for store: <store name>` e il motivo del fallimento nel corpo. Va alla lista **Email address** del negozio su **Stores** → il tuo negozio → **Settings** → **General**: il primo indirizzo come destinatario, gli altri in copia nascosta. Se la lista è vuota, non viene inviata alcuna email. Quando storekit riconosce il motivo, l'email include anche indicazioni sui passi successivi.

### Reinviare un ordine fallito

Apri l'ordine nella dashboard e scegli **More actions** → **Resend order to POS**. storekit rimette l'ordine in coda verso Stream (rispettando il buffer dei preordini). L'opzione viene offerta solo finché l'ordine non ha una ricevuta POS, e il reinvio viene rifiutato con *This order has already been sent to the POS. Resending it would create a duplicate POS order.* una volta che Stream ha accettato l'ordine, anche se il POS lo ha poi fatto fallire. In tal caso controlla il POS invece di reinviare.

## Prossimi passi

> **[Sala](/docs/it/guides/integrations/pos/stream/dine-in)**
>
> Come gli ordini al tavolo arrivano a Stream

> **[Risoluzione dei problemi](/docs/it/guides/integrations/pos/stream/troubleshooting)**
>
> Ordini che non arrivano a Stream, o che falliscono una volta arrivati


## Related topics

- [Sala Stream: tavoli](/docs/it/guides/integrations/pos/stream/dine-in.md)
- [Stream](/docs/it/guides/integrations/pos/stream/overview.md)
- [Risoluzione dei problemi Stream](/docs/it/guides/integrations/pos/stream/troubleshooting.md)
- [Collegare Stream](/docs/it/guides/integrations/pos/stream/connect.md)
- [Sincronizzazione del menu Stream](/docs/it/guides/integrations/pos/stream/menu-sync.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.