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

> Come storekit invia gli ordini a Comtrex come guest check: sales type, ordini pianificati, mance, sconti, note, cover count e gestione dei rifiuti.

Ogni ordine effettuato su storekit viene inviato a Comtrex come un nuovo guest check nel momento in cui viene pagato. Il check porta ogni prodotto e modificatore tramite POS ID, il numero di tavolo per il dine-in, il sales type che hai configurato, qualsiasi sconto, mancia o service charge, una nota d'ordine e una riga di pagamento in modo che il check sia già saldato sulla cassa.

## Come un ordine arriva alla cassa

**1. Ordine effettuato**

Il cliente paga. storekit mette in coda l'ordine per l'invio immediatamente — non devi accettarlo prima nella dashboard.

**2. Check costruito**

storekit costruisce una richiesta `CreateNewOrder` per la cassa a partire dall'ordine, usando le impostazioni in **Order handling** e **Media mapping**.

**3. Inviato al server Comtrex**

La richiesta viene inviata all'indirizzo del server che hai configurato. Ogni tentativo attende fino a due minuti per una risposta, e storekit riprova automaticamente se il server non risponde o restituisce un errore.

**4. Risultato registrato**

Se la cassa accetta, l'ordine appare come **Accepted** in **Orders** e il numero del guest check della cassa viene memorizzato su di esso come ricevuta POS. Se la cassa rifiuta, o non è raggiungibile dopo i retry, l'ordine viene marcato come failed e ricevi una notifica — vedi [Quando un ordine fallisce](#when-an-order-fails).

> [!NOTE]
>
> Se l'ospite ha già aperto il conto del tavolo in storekit (pay at table) e poi ordina altro, storekit aggiunge gli articoli a quel check Comtrex invece di aprirne uno nuovo. Gli ordini effettuati senza un conto aperto in storekit aprono sempre un nuovo check — un check aperto dallo staff sulla cassa non viene rilevato automaticamente. Vedi [Pay at Table](/docs/it/guides/integrations/pos/comtrex/pay-at-table#adding-orders-to-an-open-check).

## Cosa c'è sul check

| storekit | Sul check Comtrex |
| - | - |
| Prodotti e modificatori | Sale item e ingredienti tramite **POS ID**, con quantità e il prezzo che il cliente ha pagato. Gli articoli senza POS ID vengono esclusi — vedi [Collegamento del menu](/docs/it/guides/integrations/pos/comtrex/menu-sync). |
| Nome cliente | `CustomerName` sul check |
| ID ordine | `VendorOrderID`, in modo che Zonal possa risalire da un check all'ordine storekit |
| Tavolo | `TableNumber`, preso dal **POS ID** del tavolo |
| Delivery, pickup e in-store | Usano tutti il **Sales Type Number** da **Media mapping** |
| Indirizzo di consegna e telefono | Inviati sugli ordini di delivery come dettagli di consegna del check |
| Sconti (codici promo, fedeltà) | Una riga di sconto sul media **Discount ID**, per il valore dello sconto |
| Service charge | Una riga di service charge per l'importo |
| Mancia | Una riga di service charge sul media **Tip ID** — solo quando **Send Gratuity Amount** è attivo |
| Nota d'ordine | `Instructions`, costruita da **Order Note Template** (max 255 caratteri) |
| Numero di commensali | `CoverCount`, secondo l'impostazione **Cover Count** |
| Pagamento | Una riga di pagamento sul media **Payment Type ID** per il totale dell'ordine, con nome `storekit`, in modo che il check venga chiuso come pagato sulla cassa |

> [!WARNING]
>
> Una mancia e un service charge sullo stesso ordine finiscono entrambi nelle righe di service charge del check, e la riga della mancia sostituisce quella del service charge. Se accetti entrambi, chiedi al supporto storekit la configurazione corretta per la tua cassa prima di andare live.

> [!NOTE]
>
> Anche gli ordini in contanti vengono inviati con una riga di pagamento `storekit` per il totale completo. Se preferisci che gli ordini in contanti restino aperti sulla cassa in modo che lo staff li chiuda, contatta il supporto storekit.

## Impostazioni di gestione degli ordini

Vai su **Stores** → il tuo locale → **Settings** → **Integrations** → **Comtrex** e scorri fino a **Order handling**. Clicca su **Save** dopo aver cambiato qualsiasi cosa qui.

![The Order handling section showing the disabled Buffer Orders toggle, Send Gratuity Amount switched on, the Order Note Template editor with Insert Variable and Preview buttons, and Cover Count set to Automatic (number of diners)](https://mintcdn.com/storekit/ESLFABunh773fqh0/images/comtrex/order-handling.png?fit=max\&auto=format\&n=ESLFABunh773fqh0\&q=85\&s=6bc49b1acf9a6eb6d9959bc1c6873b09)

### Buffer Orders

Il toggle **Buffer Orders** è mostrato ma disabilitato per Comtrex — non puoi cambiarlo dalla dashboard. Gli ordini pianificati sono invece gestiti dalla cassa stessa come future order Comtrex (sotto). Se ti serve che storekit trattenga gli ordini pianificati fino a più vicino all'orario, [contatta il supporto storekit](/docs/it/getting-started/contact-support) per far configurare il buffering.

### Send Gratuity Amount

Quando è attivo, una mancia aggiunta al checkout viene inviata alla cassa come riga di service charge sul tuo media **Tip ID**. Quando è disattivato, le mance restano solo in storekit e il check della cassa non le include. Le mance pay-at-table vengono sempre inviate, indipendentemente da questa impostazione.

### Order Note Template

Controlla il testo inviato come `Instructions` del check. Lascialo vuoto e storekit invia le note del cliente. Per includere dettagli dell'ordine, digita un template e usa **Insert Variable** per aggiungere segnaposto come `{{orderCode}}`, `{{fullName}}`, `{{phone}}`, `{{customerNotes}}`, `{{tableName}}` o `{{deliveryFullAddress}}`; **Preview** mostra come apparirà sulla cassa. Comtrex consente 255 caratteri — le note più lunghe vengono troncate.

### Cover Count

Imposta con quanti covers viene aperto il check. Le opzioni sono fisse:

* **Do not send** — nessun cover count sul check
* **Automatic (number of diners)** — il numero di commensali che l'ospite ha scelto quando ha ordinato al tavolo; `0` se non gli è stato chiesto
* **Fixed value** — il numero che inserisci in **Cover Count Value** (che appare quando questa opzione è selezionata); `0` è consentito

## Ordini pianificati

Gli ordini effettuati per più tardi vengono inviati alla cassa immediatamente come *future order* Comtrex, invece di essere trattenuti in storekit. Il check porta:

* **PickupDateTime** — l'orario che il cliente ha scelto, nel fuso orario del tuo locale
* **TriggerDateTime** — quell'orario meno il **Preparation time** del tuo locale (il valore **Pickup** per gli ordini di pickup, altrimenti il prep time di default del locale), in modo che la cassa rilasci il check alla cucina quando deve iniziare

Anche gli ordini di delivery ASAP vengono inviati come future order con l'orario stimato di consegna come orario di ritiro e un trigger immediato, così la cassa mostra quando l'ordine dovrebbe essere pronto.

Se un ordine pianificato viene annullato in storekit prima del suo orario, storekit invia un `CancelOrder` alla cassa per quel check.

## Quando un ordine fallisce

Se la cassa rifiuta l'ordine o non è raggiungibile, storekit riprova diverse volte con intervalli crescenti tra i tentativi. Se ogni tentativo fallisce:

* L'ordine viene marcato come **Failed** in **Orders**, con il testo di errore della cassa mostrato sulla pagina dell'ordine dopo *Something went wrong sending this order to the POS:*
* Un'email con oggetto *Comtrex Issue* viene inviata all'indirizzo email del tuo locale
* Se il locale ha una stampante storekit, l'ordine viene stampato in modo che la cucina lo riceva comunque
* Il cliente ha già pagato, quindi evadi l'ordine manualmente e risolvi la causa

Una volta risolta la causa, apri l'ordine in **Orders** e scegli **Resend order to POS** dal menu azioni — è disponibile su qualsiasi ordine che non abbia ancora una ricevuta POS. Vedi [Risoluzione dei problemi](/docs/it/guides/integrations/pos/comtrex/troubleshooting) per le cause comuni.

> [!NOTE]
>
> storekit non verifica il carrello contro la cassa prima del checkout, e non mette in snooze i prodotti dopo un ordine fallito. Se un articolo continua a fallire, mettilo tu in snooze in **Menus** finché la cassa non viene sistemata.

## Correlati

> **[Iniezione ordini](/docs/it/guides/integrations/pos/order-injection)**
>
> Come funziona l'iniezione degli ordini tra tutti i provider POS

> **[Risoluzione dei problemi](/docs/it/guides/integrations/pos/comtrex/troubleshooting)**
>
> Risolvi gli ordini falliti


## Related topics

- [Ordini Stream](/docs/it/guides/integrations/pos/stream/orders.md)
- [Ordini Deliverect](/docs/it/guides/integrations/pos/deliverect/orders.md)
- [Panoramica degli ordini](/docs/it/guides/orders/overview.md)
- [Batching degli ordini](/docs/it/guides/orders/advanced/order-batching.md)
- [Archiviazione degli ordini](/docs/it/guides/orders/archiving-orders.md)


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