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

# Sincronizzazione del menu Stream

> Come Stream pubblica i menu in storekit: cosa avvia un import, cosa viene importato, mappatura di varianti e modificatori, e cosa storekit sovrascrive.

Stream è la fonte di verità per il menu di un negozio collegato a Stream. Ogni volta che il menu di un locale viene pubblicato in Stream, Stream lo notifica a storekit, che lo scarica e lo importa. In storekit non c'è alcun pulsante di sync e non esiste una pianificazione da impostare: il menu si aggiorna quando pubblichi in Stream.

## Quando si aggiorna il menu

storekit importa il menu quando Stream invia un evento di **publish** per il locale. L'importazione avviene in background: storekit scarica il file del menu pubblicato, carica eventuali nuove immagini, poi riscrive il menu del negozio per corrispondere. Pubblicare di nuovo mentre l'importazione dello stesso menu è ancora in corso viene ignorato, quindi attendi che la prima importazione termini (viene mantenuto un lock fino a 30 minuti) prima di ri-pubblicare.

### Richiedere una ri-pubblicazione

Se il menu su storekit sembra non aggiornato, [contatta il supporto storekit](/docs/it/getting-started/contact-support). Il supporto clicca **Refresh Menu** sulla pagina **Stream Integration** del negozio, che chiede a Stream di ri-pubblicare il menu più recente del locale: la dashboard conferma con *Menu refresh requested* e *Stream will re-publish the latest menu shortly*. L'importazione vera e propria avviene comunque quando Stream pubblica, quindi lascia trascorrere qualche minuto.

> [!NOTE]
>
> Non esiste un pulsante **Sync** su un menu gestito da Stream nell'editor del menu di storekit e Stream non è mostrato come card su **Stores** → il tuo negozio → **Settings** → **Integrations** per i login merchant. Vedi [Sincronizzazione del menu POS](/docs/it/guides/menu/pos-menu-sync) per un confronto con gli altri provider.

## Cosa viene importato

Ogni menu Stream diventa un menu storekit sul negozio, abbinato tramite il suo Stream ID. La prima pubblicazione crea il menu (con il nome del menu Stream); le pubblicazioni successive aggiornano il menu e il suo nome.

| Stream | storekit | Note |
| - | - | - |
| Menu | Menu | Un menu storekit per ogni menu Stream. La pianificazione del menu diventa gli orari di disponibilità del menu storekit. |
| Categoria | Categoria | L'ordine segue il menu Stream. La pianificazione di una categoria diventa gli orari di disponibilità della categoria e disattiva *always open* per quella categoria. |
| Item family con un solo articolo | Articolo | Nome, descrizione, prezzo, immagine, allergeni e tag alcolico provengono dall'item family; lo Stream ID dell'articolo è memorizzato come SKU storekit. |
| Item family con più articoli | Articolo con un gruppo di *variation* obbligatorio | L'articolo ha prezzo 0 e riceve un primo gruppo di modificatori (con il nome della family, min 1 / max 1) con un'opzione per articolo. L'articolo di default di Stream è preselezionato. |
| Gruppo di modificatori | Gruppo di modificatori | Vengono mantenute le regole di minimo, massimo e selezione singola/multipla, così come le quantità di default. |
| Modificatore | Opzione del modificatore | Prezzo, stato attivo, immagine e traduzioni. I modificatori possono avere gruppi di modificatori annidati, che vengono importati come ulteriori gruppi. |
| Override di prezzo specifico per menu | Prezzo dell'articolo | Se l'articolo ha un override attivo per questo menu Stream, viene usato quel prezzo al posto del prezzo base. |
| Tassa | Aliquota fiscale dell'articolo | Le aliquote Stream vengono memorizzate su ciascun articolo. |
| Traduzioni | Traduzioni di nome e descrizione | Per locale, per menu, categorie, articoli, varianti, gruppi di modificatori e modificatori. |
| Allergeni | Tag dell'articolo | I codici allergene di Stream sono mappati ai tag allergene di storekit. I codici non riconosciuti vengono ignorati. |
| `is_alcohol` | Tag alcolico | Aggiunge o rimuove il tag alcolico sull'articolo. |
| Tempo di preparazione | Tempo di preparazione del negozio | Se la pubblicazione include un tempo di preparazione in minuti, viene scritto sui prep time di consegna e ritiro del negozio. |

Le immagini vengono copiate nello storage immagini di storekit al momento dell'importazione, così continuano a funzionare anche se l'URL Stream cambia.

## Stream sovrascrive il menu storekit

Ogni pubblicazione riscrive il menu da Stream:

* Nomi, descrizioni, prezzi, immagini, disponibilità, tag e traduzioni vengono sostituiti con i valori di Stream.
* Categorie, articoli, varianti e gruppi di modificatori che non sono più nel menu pubblicato vengono eliminati dal menu storekit.
* Poiché il menu è POS-managed, categorie e articoli non possono essere aggiunti nell'editor del menu di storekit: provando ad aggiungerne uno viene mostrato *You can't add a new category here. Please create new items in your POS*. Modifica il menu in Stream e pubblica.

Snooze e giacenze seguono regole proprie: vedi [Scorte e disponibilità](/docs/it/guides/integrations/pos/stream/stock-and-availability).

## Limitazioni

* **Nessuna sottocategoria**: le categorie Stream vengono importate come lista piatta.
* **Nessuna sync manuale o pianificata** da storekit; l'unico trigger è la pubblicazione in Stream (il supporto può richiedere una ri-pubblicazione).
* **L'importazione avviene per menu.** Se un locale pubblica più menu, ognuno viene importato a turno e ciascuno viene bloccato separatamente.
* **Gli articoli assenti dal file pubblicato vengono ignorati**, e qualsiasi Stream ID che storekit non riesce ad abbinare viene registrato invece di far fallire l'importazione: controlla il menu storekit dopo la pubblicazione se qualcosa sembra mancare.

## Prossimi passi

> **[Scorte e disponibilità](/docs/it/guides/integrations/pos/stream/stock-and-availability)**
>
> Cambi di disponibilità e giacenze tra una pubblicazione e l'altra

> **[Ordini](/docs/it/guides/integrations/pos/stream/orders)**
>
> Come compaiono articoli e modificatori importati sugli ordini inviati a Stream


## Related topics

- [Stream](/docs/it/guides/integrations/pos/stream/overview.md)
- [Sincronizzazione del menu POS](/docs/it/guides/menu/pos-menu-sync.md)
- [Sincronizzazione del menu Syrve](/docs/it/guides/integrations/pos/syrve/menu-sync.md)
- [TISSL](/docs/it/guides/integrations/pos/tissl.md)
- [Centegra](/docs/it/guides/integrations/pos/centegra.md)


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