> ## 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 e pagamenti Syrve

> Invia gli ordini storekit a un terminal group Syrve, mappa tipi d'ordine e pagamento, applica mance e sconti, e ricevi gli aggiornamenti di stato.

Quando un cliente effettua un ordine, storekit lo invia al tuo terminal group Syrve. Questa pagina spiega come vengono mappati gli ordini e cosa devi configurare — tutto ciò che è qui si trova sotto **Syrve Order Complications** nella pagina **Syrve Settings**.

## Quando gli ordini vengono inviati

Gli ordini vengono inviati a Syrve **non appena vengono effettuati**. L'ordine appare in sincronizzazione mentre storekit attende la conferma dalla cassa, e viene contrassegnato come **Accepted** solo quando Syrve ha ricevuto l'ordine — quindi un ordine accettato è un ordine che si trova davvero sul POS.

I preordini vengono inviati immediatamente per impostazione predefinita, così compaiono in cassa non appena vengono effettuati. Attiva **Buffer Orders** per trattenere invece i preordini e inoltrarli più vicino all'orario programmato. Un preordine trattenuto può essere inviato alla cassa in anticipo con **Resend order to POS** — la conferma avverte che questo annulla l'invio programmato.

## Terminal Group

Gli ordini arrivano sul **Terminal Group** che selezioni — questa è la cassa (o il gruppo di casse) della tua organizzazione Syrve.

> [!WARNING]
>
> Un terminal group la cui cassa è offline mostra il suffisso **(asleep)** nel menu a tendina. Gli ordini inviati a un terminal group dormiente non vengono ritirati: Syrve va in timeout dopo qualche minuto e l'ordine viene contrassegnato come **failed** in storekit. Questo è il fallimento più comune per gli ordini Syrve — vedi [Ordini falliti: cassa dormiente](/docs/it/guides/integrations/pos/syrve/till-offline).

## Tipi di ordine

Syrve richiede un tipo d'ordine su ogni ordine. Ne mappi uno per ciascun metodo di evasione — ogni menu a tendina offre solo i tipi d'ordine Syrve del tipo corrispondente:

* **Delivery Order Type** — usato per gli ordini di consegna (il tipo consegna con corriere di Syrve)
* **Pickup Order Type** — usato per gli ordini di ritiro (il tipo ritiro cliente di Syrve)
* **Table Order Type** — usato per gli ordini al tavolo, che aprono un conto sul POS (vedi [Sala](/docs/it/guides/integrations/pos/syrve/dine-in)); impostalo su **Not used** se il negozio non accetta ordini al tavolo

## Pagamenti

storekit registra il pagamento sull'ordine Syrve così la cassa non lo richiede di nuovo:

| Impostazione | Cosa fa |
| - | - |
| **Cash Payment Type** | Il tipo di pagamento Syrve usato per gli ordini in contanti — la cassa incassa il contante normalmente. |
| **Card Payment Type** | Il tipo di pagamento Syrve usato per i pagamenti online. storekit ha già incassato il denaro, quindi viene registrato su questo tipo come processato esternamente. |

> [!NOTE]
>
> Se il tipo di pagamento per il metodo di pagamento di un ordine non è configurato, l'ordine viene comunque inviato — semplicemente senza pagamento, quindi lo staff deve chiudere il pagamento in cassa. Imposta entrambi i tipi prima di andare in produzione.

## Mance

Imposta **Tips Type** perché le mance arrivino a Syrve come mance, registrate separatamente dal pagamento. Senza un tipo mancia, la mancia resta all'interno del totale del pagamento — i conti quadrano comunque, semplicemente non viene evidenziata come mancia sul POS.

## Sconti, coperti e costi di consegna

| Impostazione | Cosa fa |
| - | - |
| **Discount** | Gli sconti a livello di ordine vengono riportati a Syrve sotto questo sconto. Imposta su **Not sent** per lasciare gli sconti fuori dall'ordine Syrve. |
| **Service Charge** | I coperti **e i costi di consegna** vengono inviati a Syrve come un unico importo combinato sotto questa maggiorazione. |

> [!WARNING]
>
> Usa una maggiorazione a **somma flessibile** da Syrve Office come **Service Charge**. Le maggiorazioni percentuali di Syrve ricalcolano la loro percentuale sul POS e ignorano l'importo inviato da storekit, quindi la cifra sullo scontrino non corrisponderà all'ordine. Syrve consente inoltre una sola maggiorazione di questo tipo per ordine — motivo per cui coperto e costo di consegna arrivano combinati.

## Cosa riceve Syrve

Ogni ordine porta con sé il nome e l'email del cliente, il suo numero di telefono (convertito in formato internazionale; quando quello del cliente non è utilizzabile, viene usato il numero del negozio), il codice ordine storekit, tutti gli articoli con le loro dimensioni e i modificatori, eventuali note d'ordine come commento dell'ordine, l'indirizzo di consegna (per gli ordini di consegna), il pagamento, la mancia, lo sconto e le maggiorazioni come configurati sopra, e l'orario programmato per i preordini.

## Aggiornamenti di stato dell'ordine

Con i [webhook abilitati](/docs/it/guides/integrations/pos/syrve/connect#set-up-webhooks), Syrve invia gli aggiornamenti della cucina a storekit, che li mappa sullo stato del tuo ordine:

| Stato Syrve | Stato storekit |
| - | - |
| Cottura iniziata | Preparing |
| Cottura completata / In attesa | Ready for pickup (ordini di ritiro); Preparing altrimenti |
| In viaggio | Out for delivery |
| Consegnato | Complete |
| Chiuso | Complete |

Gli stati avanzano solo in avanti — un aggiornamento in ritardo o duplicato non riporta mai un ordine indietro.

> [!NOTE]
>
> Un ordine **stornato in cassa** *non* viene annullato in storekit: un ordine pagato deve essere annullato (e rimborsato) in storekit, da te. storekit segnala l'ordine così lo staff può risolverlo in modo consapevole.

## Annullare un ordine

Annullare un ordine di ritiro o consegna in storekit lo annulla anche sul POS, usando la **Cancel Cause** che hai selezionato (Syrve richiede una causa di annullamento; scegline una in **Syrve Order Complications**). I conti al tavolo non possono essere annullati tramite l'API — storna il conto in cassa.

## Quando un ordine non arriva alla cassa

Se Syrve rifiuta un ordine — o la cassa non lo conferma mai — l'ordine viene contrassegnato come **failed** in storekit con il motivo mostrato sull'ordine. L'ordine del cliente si conclude comunque, quindi non lo perdi mai.

Una volta risolta la causa, apri l'ordine, usa **Resend order to POS** e conferma. Un tipo di errore non può essere recuperato in questo modo: un ordine andato in **timeout** su un [terminal group dormiente](/docs/it/guides/integrations/pos/syrve/till-offline) esiste già dentro Syrve in uno stato di errore, e Syrve rifiuta il rinvio come duplicato — battilo in cassa manualmente.

Cause comuni e soluzioni sono in [Risoluzione dei problemi](/docs/it/guides/integrations/pos/syrve/troubleshooting).

## Correlati

* [Collegare Syrve](/docs/it/guides/integrations/pos/syrve/connect)
* [Gestire gli ordini in tempo reale](/docs/it/guides/orders/managing-live-orders)
* [Sala: ordini al tavolo](/docs/it/guides/integrations/pos/syrve/dine-in)


## Related topics

- [Syrve POS](/docs/it/guides/integrations/pos/syrve/overview.md)
- [Sala Syrve: ordini al tavolo](/docs/it/guides/integrations/pos/syrve/dine-in.md)
- [Collegare Syrve](/docs/it/guides/integrations/pos/syrve/connect.md)
- [Risoluzione dei problemi Syrve](/docs/it/guides/integrations/pos/syrve/troubleshooting.md)
- [5. Configura i pagamenti](/docs/it/getting-started/launch/set-up-payments.md)


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