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

# Risoluzione dei problemi Syrve

> Risolvi i problemi comuni di Syrve POS in storekit: errori di connessione, sync del menu, prezzi a £0, scorte disallineate, terminali e ordini falliti.

Problemi comuni dell'integrazione Syrve e come risolverli. Se sei ancora bloccato, [contatta il supporto storekit](/docs/it/getting-started/contact-support).

## Connessione

### «Syrve» non compare nel mio elenco Integrations

L'integrazione non è abilitata per il tuo account. [Contatta il supporto](/docs/it/getting-started/contact-support) per farla attivare.

### «We could not reach Syrve's API with the configured API key»

L'**API Login** salvato non funziona — è digitato male, revocato o non ancora rilasciato per l'accesso API. Reinseriscilo in **Syrve API Settings** (usa l'icona a matita per sostituirlo). storekit valida la credenziale con Syrve prima di salvarla, quindi un valore che si salva con successo è un valore che funziona.

### Non riesco a salvare le impostazioni

Prima di poter salvare le impostazioni occorre selezionare un'**Organization** — la pagina ti chiede di selezionarne una.

## Sincronizzazione del menu

### Il pulsante Sync menu è disabilitato

* Occorre selezionare un **External Menu**.
* Il negozio deve avere un menu storekit attivo.

### Il menu a tendina External Menu è vuoto

Gli external menu vengono creati in Syrve Office. Creane uno lì (e assicurati che la tua **Organization** sia quella giusta), poi riapri la pagina.

### Gli articoli mostrano £0

Syrve non ha restituito un prezzo per quegli articoli — una lacuna nota in alcuni external menu di Syrve. Correggi i prezzi in Syrve Office ed esegui di nuovo **Sync menu**. Impostare il prezzo in storekit non è una soluzione duratura: la prossima sync lo sostituisce con quanto restituito da Syrve.

### Mancano articoli o modificatori

Vengono importati solo i contenuti **visibili** nell'external menu di Syrve — articoli, dimensioni e gruppi di modificatori nascosti in Syrve vengono saltati, così come i gruppi di modificatori senza opzioni visibili. Controlla l'external menu in Syrve Office e risincronizza.

### Un articolo disponibile risulta esaurito (o viceversa)

La disponibilità segue la **stop list** di Syrve per il tuo **Terminal Group** — vedi [Scorte e disponibilità](/docs/it/guides/integrations/pos/syrve/stock-and-availability) per le regole esatte (incluso il motivo per cui un articolo in stop list con scorta rimanente resta in vendita). I webhook consegnano le modifiche della stop list in tempo reale; senza di essi, l'elenco viene riletto solo alla sync del menu — esegui **Sync menu** per forzare una riconciliazione, e [configura i webhook](/docs/it/guides/integrations/pos/syrve/connect#set-up-webhooks) affinché resti aggiornato.

## Ordini

### Gli ordini non arrivano in cassa

Un ordine fallito viene contrassegnato come **failed** in storekit con l'errore Syrve sull'ordine; l'ordine del cliente si conclude comunque. Cause comuni:

* **Il terminal group è dormiente** — l'errore menziona un timeout. Questo è il fallimento più comune e ha [una guida dedicata](/docs/it/guides/integrations/pos/syrve/till-offline): sveglia la cassa e nota che Syrve rifiuta un rinvio di un ordine andato in timeout come duplicato — battilo manualmente.
* **Nessun tipo d'ordine per il metodo di evasione** — imposta **Delivery Order Type**, **Pickup Order Type** o **Table Order Type** in **Syrve Order Complications**, poi apri l'ordine e usa **Resend order to POS**.
* **L'integrazione è configurata solo in parte** — sia **Organization** che **Terminal Group** devono essere impostati; correggi e rinvia.
* **Un articolo non può essere abbinato sul POS** — il menu in cassa è cambiato dall'ultima importazione. Esegui **Sync menu**, poi rinvia.

### Il pagamento non è sull'ordine Syrve

Imposta **Cash Payment Type** e **Card Payment Type** in **Syrve Order Complications**. Gli ordini effettuati mentre uno dei due manca vengono inviati senza pagamento — lo staff deve chiuderli in cassa.

### Il coperto sullo scontrino non corrisponde all'ordine

La **Service Charge** selezionata è una maggiorazione percentuale in Syrve, che ricalcola la propria percentuale sul POS e ignora l'importo inviato da storekit. Usa invece una maggiorazione a **somma flessibile** da Syrve Office. Ricorda che il costo di consegna viene incorporato nella stessa maggiorazione, quindi sugli ordini di consegna la cifra combinata è quella attesa.

### Gli stati degli ordini non si aggiornano in storekit

Gli aggiornamenti di stato arrivano via webhook. Controlla **Syrve Webhooks** nella pagina **Syrve Settings** — se il pannello dice **Webhooks not configured**, clicca **Setup webhooks**. Se hai cambiato **Organization**, salva e riconfigura i webhook.

### Syrve dice che l'ordine è stato annullato, ma è ancora attivo in storekit

È voluto: uno scontrino stornato in cassa **non** annulla un ordine storekit pagato alle tue spalle. storekit segnala l'ordine; annullalo (e rimborsalo) in storekit se è ciò che deve accadere.

### Un ordine storekit annullato è ancora in cassa

* L'annullamento raggiunge Syrve solo per gli ordini di ritiro e consegna — i conti al tavolo devono essere stornati in cassa.
* Occorre selezionare una **Cancel Cause** in **Syrve Order Complications**; Syrve rifiuta gli annullamenti che ne sono privi.

## Correlati

* [Collegare Syrve](/docs/it/guides/integrations/pos/syrve/connect)
* [Sincronizzazione del menu](/docs/it/guides/integrations/pos/syrve/menu-sync)
* [Ordini e pagamenti](/docs/it/guides/integrations/pos/syrve/orders)


## Related topics

- [Risoluzione dei problemi](/docs/it/guides/integrations/pos/comtrex/troubleshooting.md)
- [Risoluzione dei problemi Deliverect](/docs/it/guides/integrations/pos/deliverect/troubleshooting.md)
- [Risoluzione dei problemi Toast](/docs/it/guides/integrations/pos/toast/troubleshooting.md)
- [Risoluzione dei problemi Stream](/docs/it/guides/integrations/pos/stream/troubleshooting.md)
- [Risoluzione dei problemi Lightspeed](/docs/it/guides/integrations/pos/lightspeed/troubleshooting.md)


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