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

> Risolvi i problemi comuni di Toast POS in storekit: errori di connessione, sync del menu, prezzi a £0, modificatori mancanti e iniezione ordini.

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

## Connessione

### "Toast POS" non è nel mio elenco Integrations

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

### Il Connect fallisce

* Verifica che il **Restaurant GUID** sia corretto per questo ristorante — un GUID errato o digitato male è la causa più comune.
* Conferma che il tuo ristorante Toast abbia l'ordine online abilitato.

### Non riesco a salvare le impostazioni

Quando **Enable Toast POS** è attivo, **Alternate Payment Type** e **Check Discount** sono obbligatori. Il salvataggio fallisce con "Please fill in all required fields" finché entrambi (sotto **Additional Settings**) non sono impostati.

## Sync del menu

### Non viene importato niente, o la sync si interrompe

* **Enable Toast POS** deve essere attivo e il locale deve avere un menu storekit attivo prima che tu possa eseguire **Sync Menu**. Vedi ["This venue has no active menu to sync into"](#this-venue-has-no-active-menu-to-sync-into).
* I contenuti del menu devono essere **visibili agli ordering partner** in Toast. Se tutto ciò che è selezionato è nascosto agli ordering partner, storekit interrompe la sync (deliberatamente, per non cancellarti il menu). Rendi il menu visibile agli ordering partner in Toast e ri-sincronizza.
* Se hai impostato uno specifico **Toast Menu** che non esiste più in Toast, la sync si interrompe — svuota o aggiorna **Toast Menu**.

### "This venue has no active menu to sync into"

Il locale non ha ancora un menu storekit. È una condizione di storekit, non di Toast. Il tuo menu Toast va bene e non c'è nulla da controllare in Toast. **Sync Menu** importa *in* un menu storekit esistente, quindi un locale appena creato (ad esempio il secondo, terzo o quarto punto vendita di un gruppo che condivide un unico menu Toast) ha bisogno di un menu prima della prima sync. Per risolvere:

1. Vai su **Stores** → il nuovo locale e clicca su **Create a menu**.
2. Scegli **Enter Manually** e clicca su **Create a menu**. Questo crea un menu vuoto sul locale; non devi aggiungerci nulla.
3. Collega il locale a Toast se non lo è già. Segui [Collegare Toast](/docs/it/guides/integrations/pos/toast/connect) (**Restaurant GUID** → **Connect** → **Enable Toast POS** → **Alternate Payment Type** e **Check Discount** → **Save**).
4. Clicca su **Sync Menu** sotto **Sync Actions**.

Ripeti per ogni locale che vuoi far servire il menu Toast. Vedi [Usare un unico menu Toast su più locali](/docs/it/guides/integrations/pos/toast/menu-sync#usare-un-unico-menu-toast-su-piu-locali).

### I prodotti mostrano £0

Il pricing Toast basato su taglia e sequenza non può essere rappresentato come un prezzo unico, quindi quei prodotti vengono importati a £0. Imposta il prezzo in storekit o ristruttura il prodotto in Toast.

### Mancano modificatori

I gruppi di **pre-modificatori** Toast non sono supportati e vengono saltati. I gruppi di modificatori standard e annidati vengono importati normalmente.

### Un prodotto in stock risulta esaurito (o viceversa)

Lo stock segue Toast. storekit mette in snooze i prodotti che Toast riporta out-of-stock e li ripristina quando Toast li riporta in stock. Riesegui **Sync Menu** per forzare una riconciliazione.

## Ordini

### Gli ordini non arrivano a Toast

Un ordine fallito viene marcato **failed** in storekit con il messaggio di errore Toast; l'ordine del cliente si completa comunque. Re-inviato dalla dashboard una volta risolta la causa. Cause comuni:

* **Nessuna dining option per il metodo di fulfillment** — imposta la dining option corrispondente (o la **Default Dining Option**) sotto **Dining Options**.
* **Un prodotto non può essere abbinato a un menu group Toast** — riesegui **Sync Menu** in modo che i prodotti portino i loro identificatori Toast.
* **Alternate Payment Type mancante** — impostalo sotto **Additional Settings**.

### Sconti o service charge non compaiono sulla check Toast

* Gli sconti richiedono che **Check Discount** sia impostato sotto **Additional Settings**.
* La service charge dell'ordine richiede **Service Charge**, e le delivery fee richiedono **Delivery Fee Service Charge**.

### Le mance degli ordini appaiono come service charge (o viceversa)

Controlla **Send Order Tips as Service Charge** sotto **Additional Settings**. Quando attivo, le mance degli ordini vengono aggiunte alla **Service Charge** sulla check invece di essere registrate come mancia Toast; quando disattivo, vengono registrate come mancia sul pagamento. Riguarda solo gli ordini online — le mance in pay-at-table sono sempre mance Toast.

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

Gli aggiornamenti di stato dipendono da Toast che invia a storekit gli eventi di stato dell'ordine ospite, configurati durante il setup. Se Preparing/Ready/Complete non arrivano, contatta il supporto per verificare la tua sottoscrizione ai webhook.

## Dine-in e planimetria

### Nessun tavolo importato dopo Sync Floorplan

I tavoli vengono importati solo se appartengono a una **service area** Toast. Se Toast non ha service area, non viene importato nulla — aggiungi service area in Toast, poi esegui **Sync Floorplan** di nuovo.

### Gli ordini dine-in non si agganciano al tavolo giusto

Un ordine dine-in si collega a un tavolo Toast solo se storekit ha un tavolo sincronizzato corrispondente. Riesegui **Sync Floorplan** dopo aver aggiunto o rinominato tavoli in Toast.

## Pay at Table

### Un pagamento pay-at-table è fallito

* **Alternate Payment Type** deve essere impostato sotto **Additional Settings**.
* Il pay-at-table supporta solo ordini a **check singola**. Se lo staff divide la check in più check sul terminale Toast, storekit non può applicare il pagamento.

### L'add-to-bill viene rifiutato

Gli ordini aggiunti devono essere **non pagati / contanti**, a check singola e senza sconti, service charge o delivery fee. Gli ordini con carta o gift card già addebitati non possono essere aggiunti a una check.

## Correlati

* [Collegare Toast](/docs/it/guides/integrations/pos/toast/connect)
* [Sync del menu](/docs/it/guides/integrations/pos/toast/menu-sync)
* [Ordini e instradamento](/docs/it/guides/integrations/pos/toast/orders)
* [Pay at Table](/docs/it/guides/integrations/pos/toast/pay-at-table)


## 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 Syrve](/docs/it/guides/integrations/pos/syrve/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.