# Ordini QR degli ospiti

# Ordini QR degli ospiti e impostazioni

Gli ospiti possono ordinare dal proprio telefono scansionando il **QR del tavolo** — niente account, niente app da installare. Tutto il flusso si configura da `/orders/settings`.

## Modalità di ordinazione

`orders_mode` decide cosa fa davvero il telefono dell'ospite:

| Modalità | Esperienza ospite |
|---|---|
| **Chiama cameriere** | Il telefono segnala solo il tavolo — lo staff prende la comanda di persona. |
| **Lista condivisa** | Gli ospiti compongono una selezione; il cameriere la vede e la conferma in righe reali. |
| **Con approvazione** | Gli ospiti inviano righe vere; restano `queued` sul [monitor cucina](/docs/orders/kitchen-board) finché lo staff le approva. |
| **Diretta in cucina** | Le righe ospiti partono immediatamente — nessun checkpoint umano. |

L'interruttore **QR ospiti** (`orders_guest_qr`) accende o spegne l'intero canale ospite. Quando è spento il QR apre comunque il menu ma nulla può essere inviato.

## Sospendere gli ordini

**Sospendi gli ordini online** (`orders_paused`) nelle impostazioni ordini blocca temporaneamente i nuovi ordini QR, dei membri e della vetrina senza cambiare la modalità di ordinazione. L'ordinazione parte attiva; disattiva la sospensione per riprenderla.

I menu restano visibili, i carrelli restano intatti e le pagine aperte si aggiornano quando cambia la sospensione. Ogni nuovo invio verifica anche il valore attuale nel database: una pagina vecchia non può aggirare il blocco. Gli invii già accettati vengono riutilizzati senza duplicare le righe.

Gli ordini dello staff e degli aggregatori di consegna non sono interessati. Conti esistenti, preparazione, ritiro e pagamenti (anche i tentativi di pagamento anticipato) restano disponibili. La sospensione non modifica gli annunci sui marketplace esterni.

## QR dei tavoli

La pagina impostazioni elenca ogni tavolo con un QR stampabile che punta a `/o/t/{token}` — il token è una capability URL per tavolo: chiunque lo possiede apre la pagina di quel tavolo, quindi tratta le stampe come chiavi. **Ruota** genera un token nuovo e invalida quello stampato (QR perso/rubato, foto trapelata). L'auto-ordinazione dei membri nell'[app](/docs/app/member-app) usa lo stesso conto sotto al cofano.

## Impostazioni di cassa

- **Servizio** — punti base applicati sul subtotale (es. `1000` = 10 %), aggiunti al totale di ogni conto.
- **Mance** — campo mancia su ogni tranche di pagamento quando abilitato.

Gli ospiti possono pagare la loro parte online via Stripe Checkout quando il locale ha un account collegato — valgono le stesse divisioni della [comanda](/docs/orders/order-pad).

## Permessi

Le impostazioni ordini stanno dietro `companies.update` (permesso impostazioni locale). L'ordinazione lato staff segue i [permessi della comanda](/docs/orders/order-pad); gli ospiti non hanno bisogno di alcun account.


---
> Source: https://placeful-app.com/docs/orders/guest-ordering