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

# Batching degli ordini

> Raggruppa più ordini storekit dallo stesso tavolo in un unico ticket di cucina consolidato. Riduci il rumore dei ticket e offri alla cucina una vista completa del tavolo.

Il batching degli ordini combina più ordini dello stesso tavolo in un unico ordine consolidato prima di inviarlo alla cucina o al POS. Riduce il rumore dei ticket e offre alla cucina una vista completa di ciò che un tavolo ha ordinato.

## Come funziona

Senza batching, ogni volta che un ospite a un tavolo ordina qualcosa, viene stampato un ticket separato in cucina. Con il batching attivato:

1. L'ospite effettua il primo ordine → l'ordine viene tenuto in un batch
2. L'ospite effettua un secondo ordine → aggiunto allo stesso batch
3. Dopo il periodo di timeout, il batch si chiude
4. Tutti gli ordini si uniscono in un solo ticket e vengono inviati a cucina/POS

```
Senza batching:             Con batching:
┌─────────────┐            ┌─────────────┐
│ Ticket #1   │            │ Ticket #1   │
│ 1x Burger   │            │ 1x Burger   │
└─────────────┘            │ 1x Fries    │
┌─────────────┐            │ 2x Beer     │
│ Ticket #2   │            │ 1x Wings    │
│ 1x Fries    │     →      └─────────────┘
└─────────────┘                  
┌─────────────┐            (Ticket unico consolidato
│ Ticket #3   │             dopo il timeout)
│ 2x Beer     │
└─────────────┘
┌─────────────┐
│ Ticket #4   │
│ 1x Wings    │
└─────────────┘
```

## Quando gli ordini vengono raggruppati

Gli ordini vengono raggruppati nello stesso batch quando:

* **Stesso tavolo** — gli ordini devono provenire dallo stesso tavolo
* **All'interno della finestra di timeout** — ordini effettuati entro il periodo di timeout configurato
* **Solo fulfillment in loco** — il batching si applica solo agli ordini al tavolo

<Tip>
  Gli ordini di Ritiro e Consegna non vengono mai raggruppati: vanno sempre direttamente in cucina.
</Tip>

## Chiusura intelligente del batch

storekit usa un algoritmo intelligente per determinare quando chiudere un batch, bilanciando velocità e consolidamento.

### Come funziona

Il sistema monitora se qualcuno al tavolo sta ancora sfogliando il menu o costruendo un ordine:

* **Qualcuno sta ancora ordinando?** → Il batch resta aperto (fino al limite di timeout)
* **Hanno finito tutti?** → Il batch si chiude immediatamente

Ciò significa che se una persona effettua un ordine e nessun altro al tavolo ha il menu aperto, il batch si chiude subito — nessuna attesa inutile. Ma se altri stanno ancora decidendo, il sistema li aspetta.

### Esempio

```
12:00:00 - Alice ordina un burger (il batch si apre)
12:00:05 - Il sistema rileva che Bob ha il menu aperto → il batch resta aperto
12:01:30 - Bob ordina delle patatine (aggiunte al batch)
12:01:35 - Nessun altro sta sfogliando → il batch si chiude immediatamente
12:01:35 - L'ordine unito viene inviato in cucina
```

Confronta questo con un semplice timeout di 5 minuti, in cui la cucina avrebbe aspettato fino alle 12:05:00: oltre 3 minuti risparmiati.

### Limite di timeout

Se gli ospiti continuano a sfogliare, il batch non resta aperto per sempre. C'è un timeout massimo (fino a 5 minuti) dopo il quale il batch si chiude comunque. Questo garantisce che gli ordini raggiungano sempre la cucina in un tempo ragionevole.

| Timeout        | Ideale per                            |
| -------------- | ------------------------------------- |
| 1-2 minuti     | Fast-casual, ordini aggiuntivi rapidi |
| 3 minuti       | Servizio al tavolo standard           |
| 5 minuti (max) | Gruppi che ordinano insieme           |

## Contenuto dell'ordine unito

Quando un batch si chiude, gli ordini vengono uniti in modo intelligente:

| Elemento             | Come viene unito                                             |
| -------------------- | ------------------------------------------------------------ |
| **Articoli**         | Combinati, con le quantità sommate per articoli identici     |
| **Modificatori**     | Gli articoli con modificatori diversi restano separati       |
| **Totali**           | Tutti i totali degli ordini, mance e coperti vengono sommati |
| **Note**             | Incluse solo quando **Includi note d'ordine** è attivo       |
| **Nomi dei clienti** | Elencati solo quando **Includi nomi dei clienti** è attivo   |

### Esempio di unione degli articoli

```
Ordine 1: 1x Burger (senza cipolle)
Ordine 2: 1x Burger (formaggio extra)
Ordine 3: 1x Burger (senza cipolle)

Risultato unito:
- 2x Burger (senza cipolle)    ← quantità combinate
- 1x Burger (formaggio extra)  ← tenuto separato (modificatore diverso)
```

## Configurazione

### Impostazioni a livello di store

Vai su **Stores** → \[il tuo store] → **Impostazioni** → **Operazioni** e trova la sezione **Batching degli ordini**:

| Impostazione                     | Descrizione                                                 | Predefinito |
| -------------------------------- | ----------------------------------------------------------- | ----------- |
| **Attiva batching degli ordini** | Attiva/disattiva il batching                                | Off         |
| **Timeout del batch**            | Minuti prima che il batch si chiuda                         | 5           |
| **Includi note d'ordine**        | Mostra le note individuali dei clienti sul ticket combinato | Off         |
| **Includi nomi dei clienti**     | Elenca chi ha ordinato cosa sul ticket combinato            | Off         |

<Note>
  La sezione **Batching degli ordini** compare solo per gli store con servizio al tavolo — il batching si applica solo agli ordini in loco.
</Note>

### Disattivare il batching per tavoli specifici

Il selettore **Timeout del batch** a livello di store offre solo 1–5 minuti; per disattivare completamente il batching per l'intero store, disattiva **Attiva batching degli ordini**. Per singoli tavoli o sezioni, imposta invece il timeout di batch di quel tavolo a 0 — gli ordini di quei tavoli vanno direttamente in cucina senza attesa, mentre il resto dello store continua con il batching.

Questo è utile per il bancone del bar o le aree quick-service in cui gli ospiti tipicamente ordinano un articolo alla volta.

## Note dei clienti sui ticket in batch

Quando il batching è attivo, le note dei clienti vengono **rimosse dal ticket unito** a meno che non sia attivo **Includi note d'ordine**. Questo è il motivo più comune per cui una cucina o un bar smette di vedere le note dopo aver attivato il batching: il cliente scrive una nota al checkout, la nota viene salvata sull'ordine, ma il ticket consolidato inviato alla cucina, alla stampante o al POS non contiene alcuna nota.

**Includi note d'ordine** controlla entrambi:

* La nota generale sull'ordine scritta dall'ospite al checkout (preceduta dal nome dell'ospite sul ticket unito)
* Le note a livello di articolo, che vengono unite nello stesso blocco note come `Nome articolo: nota`

### Le note d'ordine non arrivano alla cucina o al bar

Procedi in ordine:

<Steps>
  <Step title="Verifica che le note d'ordine siano attive per lo store">
    Vai su **Stores** → \[il tuo store] → **Impostazioni** → **Operazioni** → **Note d'ordine** e assicurati che sia impostato su **Opzionale** o **Obbligatorio**. **Nascosto** disattiva del tutto le note d'ordine, quindi i clienti non vedranno mai un campo note al checkout.
  </Step>

  <Step title="Attiva Includi note d'ordine se usi il batching">
    Nella stessa pagina, in **Batching degli ordini** → **Contenuti del ticket unito**, attiva **Includi note d'ordine**. Con il batching attivo e questo interruttore disattivato, le note vengono rimosse dal ticket unito anche se appaiono sull'ordine nella dashboard.
  </Step>

  <Step title="Per Zonal (Aztec), configura un Order Note Product ID">
    Zonal accetta le note dei clienti solo come voce di linea. Senza un **Order Note Product ID** nelle impostazioni dell'integrazione Zonal, le note vengono scartate prima di arrivare al POS. Consulta [note d'ordine Zonal](/docs/it/guides/integrations/pos/zonal#order-notes).
  </Step>

  <Step title="Controlla che la nota sia arrivata all'ordine stesso">
    Apri l'ordine nella dashboard e verifica che la nota sia presente. Se la nota è sull'ordine ma manca sul ticket, il problema è nei passaggi precedenti; se manca anche dall'ordine, il cliente non ne ha inserita una (o **Note d'ordine** è impostato su **Nascosto**).
  </Step>
</Steps>

<Warning>
  Modificare **Includi note d'ordine** ha effetto solo sugli ordini raggruppati dopo il salvataggio. I ticket già inviati alla cucina non vengono ristampati.
</Warning>

### Note e stampa split

Una nota d'ordine generale non è legata a un articolo specifico, quindi viene stampata su **ogni** ticket di stazione per quell'ordine. Con la stampa split, ogni stampante riceve solo gli articoli delle categorie assegnate, ma la nota d'ordine appare su ciascuno di quei ticket — quindi una nota come "allergia alla frutta a guscio" arriva alla cucina e al bar. Una stampante che non riceve nessuno degli articoli dell'ordine non stampa alcun ticket, quindi non vedrà nemmeno la nota.

## Integrazione con i sistemi POS

Quando un batch si chiude, l'ordine unito viene inviato ai sistemi collegati:

* **Sistemi POS** — Deliverect, Lightspeed, Zonal, Tissl, PointOne, Comtrex, Ikentoo
* **Stampanti** — stampanti compatibili con CloudPRNT

Il POS riceve un unico ordine contenente tutti gli articoli del batch, semplificando la gestione del conto del tavolo.

## Send to Kitchen

Quando il batching è attivo, gli ospiti vedono un pulsante **Send to Kitchen** dopo aver effettuato l'ordine. Questo permette loro di chiudere il batch in anticipo invece di aspettare il timeout.

Il pulsante appare con un timer che mostra quanto manca alla chiusura automatica del batch. Se l'ospite sa di aver finito di ordinare, può toccare il pulsante per inviare immediatamente tutti gli ordini alla cucina.

Questo è utile quando:

* Un ospite sta ordinando da solo e non ha bisogno dell'intero timeout
* Il tavolo ha finito di ordinare e vuole il cibo prima
* Un ordine aggiuntivo rapido che dovrebbe andare direttamente

## Best practice

1. **Adatta il timeout allo stile di servizio** — il fast-casual richiede timeout più brevi rispetto al fine dining
2. **Attiva i nomi dei clienti** — aiuta la cucina a identificare chi ha ordinato cosa nei tavoli grandi
3. **Attiva Includi note d'ordine** — altrimenti le note su allergie e preparazione non arriveranno mai alla cucina
4. **Forma lo staff** — assicurati che il personale di sala sappia che i batch vengono trattenuti prima di andare in cucina
5. **Considera bar vs tavolo** — usa timeout specifici per tavolo per aree con posti a sedere diverse


## Related topics

- [Risolvi i problemi di connettività della stampante Star e di stampa degli ordini](/docs/it/guides/printing/troubleshooting.md)
- [Zonal (Aztec)](/docs/it/guides/integrations/pos/zonal.md)
- [Stati degli ordini](/docs/it/guides/orders/order-statuses.md)
- [Archiviazione degli ordini](/docs/it/guides/orders/archiving-orders.md)
- [Iniezione degli ordini](/docs/it/guides/integrations/pos/order-injection.md)