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

# Collegare Syrve

> Collega Syrve POS a storekit: inserisci il Syrve API Login, scegli l'organizzazione, abilita l'integrazione e registra i webhook di aggiornamento.

Collegare Syrve associa il tuo account storekit alla tua organizzazione Syrve. Inserisci una sola volta il tuo **API Login** Syrve, poi configuri ciascun negozio: scegli l'**Organization**, abiliti l'integrazione e mappi come devono arrivare gli ordini sul POS.

## Prerequisiti

* Un account Syrve Cloud con accesso API
* Il tuo **API Login** Syrve — la credenziale API della tua organizzazione, rilasciata da Syrve o dal tuo rivenditore Syrve
* L'integrazione Syrve abilitata sul tuo account storekit

> [!NOTE]
>
> Se **Syrve** non compare nel tuo elenco **Integrations**, l'integrazione non è ancora abilitata per il tuo account — [contatta il supporto storekit](/docs/it/getting-started/contact-support).

## Collega la tua organizzazione

**1. Apri l'integrazione Syrve**

Vai su **Stores** → il tuo negozio → **Settings** → **Integrations**, quindi seleziona **Syrve**.

**2. Inserisci il tuo API Login**

Nella pagina **Syrve Settings**, in **Syrve API Settings**, inserisci la tua credenziale in **API Login** e clicca **Save**. storekit la verifica con Syrve prima di memorizzarla — se non riesce a contattare Syrve con quella credenziale, vedrai un errore e nulla viene salvato.

**3. Abilita l'integrazione**

Attiva **Enable Syrve**.

**4. Scegli la tua organizzazione**

Seleziona l'**Organization** Syrve a cui appartiene questo negozio. storekit carica poi i terminal group, i tipi d'ordine, i tipi di pagamento, gli sconti, i tipi di mancia, le cause di annullamento e gli external menu di quell'organizzazione, così puoi mapparli.

**5. Salva**

Clicca **Save**. Prima di poter salvare le impostazioni, occorre selezionare un'organizzazione.

Una volta collegato, la sezione **Syrve API Settings** si comprime in uno stato **Connected** con la credenziale mascherata (mostrati solo gli ultimi caratteri). Clicca **Edit** per rivedere la sezione, e usa l'icona a matita per sostituire l'API Login.

> [!NOTE]
>
> L'**API Login** viene memorizzato una sola volta per l'intero account storekit — tutti i negozi dell'account si collegano a Syrve con esso. L'**Organization** e tutto ciò che sta sotto sono per negozio.

## Configura i webhook

I webhook consentono a Syrve di inviare gli aggiornamenti degli ordini a storekit, così gli ordini avanzano automaticamente mentre la cucina li lavora (e le variazioni delle scorte arrivano nel momento in cui avvengono).

**1. Salva prima le impostazioni**

I webhook vengono registrati per l'**Organization** salvata — salva le impostazioni prima di configurarli.

**2. Setup webhooks**

In **Syrve Webhooks**, clicca **Setup webhooks**. storekit si registra presso Syrve e poi rilegge le impostazioni da Syrve per confermare — il pannello verde **Webhooks enabled** mostra la destinazione e gli eventi abilitati.

> [!WARNING]
>
> Senza webhook, storekit continua a confermare che ogni ordine sia arrivato in cassa (controlla per circa 5 minuti dopo l'invio), ma gli stati successivi della cucina e le variazioni di scorte in tempo reale non arriveranno — il pannello giallo **Webhooks not configured** avverte che gli ordini dovranno essere fatti avanzare manualmente in storekit.

Per fermare gli aggiornamenti da Syrve, clicca **Disable webhooks** (lo stesso pulsante, una volta configurati i webhook).

> [!NOTE]
>
> Se cambi l'**Organization**, il pannello dei webhook mostra **Organization changed** — salva le impostazioni per vedere lo stato dei webhook per la nuova organizzazione, e riconfigurali se necessario.

## Cosa cambia dopo aver collegato

* Abilitando Syrve, il provider POS di questo negozio viene impostato su Syrve. Gli ordini vengono inviati solo una volta impostati **Organization** e un **Terminal Group**.
* Dopo aver selezionato un'organizzazione, il resto della pagina **Syrve Settings** diventa disponibile: **Syrve Menu**, **Syrve Order Complications** e **Syrve Webhooks**.

## Prossimi passi

> **[Sincronizza il menu](/docs/it/guides/integrations/pos/syrve/menu-sync)**
>
> Importa il tuo external menu di Syrve in storekit

> **[Configura gli ordini](/docs/it/guides/integrations/pos/syrve/orders)**
>
> Mappa tipi d'ordine, pagamenti e maggiorazioni

## Correlati

* [Panoramica Syrve POS](/docs/it/guides/integrations/pos/syrve/overview)
* [Risoluzione dei problemi](/docs/it/guides/integrations/pos/syrve/troubleshooting)


## Related topics

- [Syrve POS](/docs/it/guides/integrations/pos/syrve/overview.md)
- [Ordini e pagamenti Syrve](/docs/it/guides/integrations/pos/syrve/orders.md)
- [Risoluzione dei problemi Syrve](/docs/it/guides/integrations/pos/syrve/troubleshooting.md)
- [Sincronizzazione del menu Syrve](/docs/it/guides/integrations/pos/syrve/menu-sync.md)
- [Collegare Toast](/docs/it/guides/integrations/pos/toast/connect.md)


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