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

# TISSL

> Collega TISSL POS a storekit per iniezione ordini e pay-at-table tramite linking manuale dei prodotti. Invia gli ordini online direttamente alle tue casse TISSL esistenti.

L'integrazione TISSL abilita l'iniezione automatica degli ordini nel tuo POS TISSL e la funzionalità completa di pay-at-table. A differenza delle integrazioni con sync del menu, TISSL utilizza il linking manuale dei prodotti tramite Product ID (PLU): costruisci il menu in storekit e colleghi i prodotti ai loro corrispettivi TISSL.

## Prerequisiti

Prima di configurare TISSL:

* Sistema POS TISSL attivo
* API Key TISSL
* Organisation ID TISSL
* Elenco dei Product ID per gli articoli del tuo menu
* Accesso admin alla tua dashboard storekit

<Note>
  Contatta il supporto TISSL per ottenere la tua API Key e l'Organisation ID. Sono necessari per l'integrazione.
</Note>

## Configurazione della connessione

### Passo 1: connettere TISSL

1. Vai su **Store Settings > Integrations** nella tua dashboard storekit
2. Trova **TISSL** e clicca su **Connect**
3. Inserisci le tue credenziali TISSL:
   * **API Key** — la tua chiave di autenticazione API TISSL
   * **Organisation ID** — il tuo identificatore di organizzazione TISSL
4. Clicca su **Connect**

storekit verifica le credenziali controllando lo stato live di TISSL prima di salvare.

### Passo 2: selezionare il tuo site

Dopo l'autenticazione:

1. storekit può recuperare i site disponibili dalla tua organizzazione TISSL
2. Seleziona il site che corrisponde a questo locale storekit
3. Il Site ID viene salvato per l'instradamento degli ordini

### Passo 3: configurare le impostazioni di integrazione

Configura le impostazioni TISSL richieste:

| Impostazione             | Descrizione                                |
| ------------------------ | ------------------------------------------ |
| **Order Type**           | Tipo di ordine TISSL per gli ordini online |
| **Payment Type**         | Tipo di pagamento per gli ordini pagati    |
| **Course**               | Portata di default per tutti gli articoli  |
| **Delivery Fee Product** | Product ID per le commissioni di consegna  |
| **Discount Product**     | Product ID/nome per le voci di sconto      |
| **Service Charge**       | Importo o percentuale del service charge   |

<Warning>
  Order Type, Payment Type, Course e i Product ID devono esistere nel tuo sistema TISSL. Verifica queste impostazioni prima del go-live.
</Warning>

### Passo 4: collegare i prodotti

Per ogni prodotto nel tuo menu storekit:

1. Vai su **Menu** e seleziona un prodotto
2. Trova il campo **POS ID**
3. Inserisci il Product ID esatto da TISSL
4. Salva il prodotto

Ripeti per tutti i prodotti e modificatori.

## Come funziona il linking dei prodotti

TISSL utilizza il **linking manuale** — i prodotti non vengono sincronizzati automaticamente:

1. Crei il tuo menu in storekit
2. Inserisci il Product ID TISSL per ogni articolo
3. Quando vengono effettuati ordini, storekit invia i Product ID
4. TISSL abbina gli ID ai prodotti ed elabora l'ordine

Questo ti dà pieno controllo sulla presentazione del menu online mantenendo la compatibilità POS.

### Collegare i modificatori

I modificatori richiedono sia il Product ID sia il Group ID:

1. Vai ai tuoi gruppi di modificatori in storekit
2. Per ogni gruppo di modificatori, inserisci il **Group Name/ID** TISSL
3. Per ogni opzione di modificatore, inserisci il **Product ID** TISSL
4. Salva le modifiche

storekit invia i modificatori nel formato che TISSL si aspetta:

* `modifierGroups`: array di nomi di gruppo
* `modifiers`: array con coppie group name/modifier name

## Iniezione degli ordini

Quando un cliente effettua un ordine, storekit lo invia all'endpoint `/order` di TISSL.

### Canali d'ordine

| Fulfillment | Canale TISSL    |
| ----------- | --------------- |
| Dine-in     | Pay At Table    |
| Pickup      | Click & Collect |
| Delivery    | Delivery        |

### Cosa riceve TISSL

Ogni ordine include:

* Organisation ID e Site ID
* ID esterno dell'ordine (ID ordine storekit)
* Descrizione dell'ordine (codice ordine o numero di tavolo)
* Numero di persone
* Tipo di ordine
* Impostazioni di service charge
* Tutti gli articoli con:
  * Product ID
  * Quantità
  * Prezzi lordo e netto
  * Assegnazione portata
  * Note sull'articolo
  * Gruppi di modificatori e modificatori
* Voci di pagamento (per ordini non in contanti)
* Dettagli del cliente con indirizzo
* Note dell'ordine

### Buffering dei pre-ordini

Per gli ordini programmati, puoi abilitare il buffering:

* **Buffer Orders** — abilita per ritardare l'iniezione dell'ordine
* Gli ordini vengono trattenuti fino ad avvicinarsi all'orario di fulfillment
* Viene aggiunto jitter per evitare fallimenti di ordini simultanei

<Info>
  TISSL può scartare ordini simultanei con lo stesso importo. Il jitter (ritardo randomizzato basato sull'ID dell'ordine) aiuta a prevenire questo problema.
</Info>

### Commissione di consegna e sconti

Quando applicabile, storekit aggiunge voci di riga per:

* **Delivery fee**: usa il Product ID configurato per la commissione di consegna
* **Sconti**: usa il Product ID configurato per gli sconti con prezzo negativo

### Aggiungere a un conto esistente

Per gli ordini dine-in, storekit controlla se esiste un conto sul tavolo:

* Se trovato, l'ordine viene aggiunto al conto esistente
* In caso contrario, viene creato un nuovo conto

Configura **All Orders Add To Bill** per controllare questo comportamento.

## Pay at Table

TISSL supporta l'integrazione completa pay-at-table:

### Come funziona

1. Il cliente scansiona il QR code al tavolo
2. storekit recupera il conto aperto da TISSL tramite `/order/table/{tableId}/{orgId}/{siteId}`
3. Il cliente visualizza gli articoli e seleziona cosa pagare
4. Il pagamento viene elaborato e inviato a TISSL tramite `/order/payment`
5. Lo stato del conto si sincronizza in tempo reale

### Sincronizzazione dei conti

storekit mantiene i conti sincronizzati con TISSL:

* Articoli aggiunti/rimossi in TISSL si aggiornano automaticamente
* I pagamenti effettuati sul POS vengono tracciati
* I conti spostati tra tavoli vengono seguiti
* Service charge e sconti si sincronizzano correttamente
* Le righe fiscali sono sincronizzate per articolo

### Configurazione

| Impostazione               | Descrizione                                                   |
| -------------------------- | ------------------------------------------------------------- |
| **Payment Type**           | Tipo di pagamento per i pagamenti storekit                    |
| **Ignore Free Items**      | Non mostrare gli articoli a prezzo zero sul conto             |
| **Auto-close Bills Delay** | Tempo prima di controllare se il conto è completamente pagato |

## Sync tavoli

Recupera il layout dei tavoli da TISSL:

1. Vai su **Stores** → il tuo store → **Settings** → **Integrations** → **Tissl**
2. Clicca su **Sync floorplan** e conferma
3. Le trading zone e i posti vengono importati come aree e tavoli

I tavoli includono:

* Nome e ID della zona/area
* Nome e ID del tavolo
* Capienza
* Stato attivo

## Riferimento impostazioni di integrazione

| Impostazione               | Descrizione                                          | Default                  |
| -------------------------- | ---------------------------------------------------- | ------------------------ |
| **Order Type**             | Oggetto tipo di ordine TISSL                         | Richiesto                |
| **Payment Type**           | Tipo di pagamento per gli ordini online              | Richiesto                |
| **Course**                 | Portata di default per gli articoli                  | No Course                |
| **Delivery Fee**           | Prodotto per le commissioni di consegna              | Richiesto per delivery   |
| **Discount**               | Prodotto/nome per gli sconti                         | Richiesto per gli sconti |
| **Service Charge**         | Importo o percentuale                                | 0                        |
| **Buffer Orders**          | Ritarda l'iniezione dei pre-ordini                   | false                    |
| **Remove Email**           | Non inviare l'email del cliente                      | false                    |
| **All Orders Add To Bill** | Aggiungi ordini dine-in al conto esistente           | false                    |
| **Ignore Free Items**      | Nascondi gli articoli gratuiti nella vista del conto | false                    |
| **Order Note Template**    | Template personalizzato per le note dell'ordine      | Nessuno                  |

## Testare l'integrazione

### Checklist pre-lancio

1. **Connessione**
   * [ ] API Key e Organisation ID verificati
   * [ ] Site selezionato correttamente

2. **Configurazione**
   * [ ] Order Type esiste in TISSL
   * [ ] Payment Type configurato
   * [ ] Course assegnato
   * [ ] Prodotto Delivery Fee creato (se usi delivery)
   * [ ] Prodotto Discount creato (se usi sconti)

3. **Linking dei prodotti**
   * [ ] Tutti i prodotti hanno TISSL Product ID
   * [ ] Tutti i modificatori hanno Product ID
   * [ ] I gruppi di modificatori hanno Group Name

4. **Flusso ordine**
   * [ ] Effettua un ordine di test
   * [ ] Verifica che gli articoli compaiano correttamente in TISSL
   * [ ] Controlla che i modificatori siano visualizzati correttamente
   * [ ] Conferma che i prezzi corrispondano

5. **Pay at table** (se in uso)
   * [ ] Tavoli sincronizzati
   * [ ] Apri un conto in TISSL
   * [ ] Visualizza il conto tramite storekit
   * [ ] Completa un pagamento di test

## Troubleshooting

### Connessione fallita

* Verifica che l'API Key sia corretta e attiva
* Controlla che l'Organisation ID corrisponda al tuo account
* Conferma che il sistema TISSL sia online (controllo dello stato live)

### Gli ordini non compaiono

* Verifica che l'integrazione sia abilitata
* Controlla che il Site ID sia corretto
* Rivedi l'ordine nella dashboard per eventuali messaggi di errore
* Conferma che Order Type e Payment Type esistano in TISSL

### Articoli mancanti

* Controlla che i Product ID siano inseriti correttamente
* Verifica che i prodotti esistano in TISSL
* Gli articoli senza Product ID vengono saltati con un avviso

### Problemi con i modificatori

* Assicurati che i gruppi di modificatori abbiano Group Name/ID
* Verifica che i Product ID dei modificatori esistano in TISSL
* Controlla l'associazione al gruppo di modificatori

### Prezzi sbagliati

* I prezzi sono calcolati inclusi i modificatori
* Verifica che le impostazioni fiscali corrispondano (storekit invia lordo e netto)
* Controlla la configurazione del service charge

### Errori Pay at Table

* **"no\_open\_bills"**: nessun conto attivo su quel tavolo in TISSL
* **"already\_exists"**: conto già elaborato/chiuso
* Controlla che il POS ID del tavolo corrisponda al table ID TISSL

## Limitazioni

Con l'integrazione TISSL:

* **Nessuna sync automatica del menu**: costruisci il menu in storekit e collegalo agli ID TISSL
* **Nessuna sync di stock in tempo reale**: la disponibilità è gestita in storekit
* **Mapping manuale dei prodotti**: mantieni i mapping degli ID per tutti gli articoli

Per ulteriore assistenza, [contatta il supporto](/docs/it/getting-started/contact-support).

## Funzionalità supportate

<AccordionGroup>
  <Accordion title="Sincronizzazione del menu">
    | Funzionalità                         | Supportata |
    | ------------------------------------ | :--------: |
    | Sincronizzazione automatica del menu |      ✗     |
    | Linking manuale dei prodotti         |      ✓     |

    TISSL utilizza il linking manuale dei prodotti. Crea il tuo menu in storekit e inserisci il TISSL Product ID per ogni articolo.
  </Accordion>

  <Accordion title="Ordini">
    | Funzionalità                  | Supportata |
    | ----------------------------- | :--------: |
    | Iniezione ordini              |      ✓     |
    | Pre-ordini                    |      ✓     |
    | Buffering ordini              |      ✓     |
    | Validazione carrello          |      ✗     |
    | Auto-snooze articoli esauriti |      ✗     |
    | Sconti                        |      ✗     |
    | Mance                         |      ✗     |
    | Service charge                |      ✗     |
    | Note d'ordine personalizzate  |      ✗     |
    | Dettagli consegna             |      ✓     |
  </Accordion>

  <Accordion title="Pay at Table">
    | Funzionalità                            | Supportata |
    | --------------------------------------- | :--------: |
    | Sync conto in tempo reale               |      ✓     |
    | Applicare pagamenti al conto            |      ✓     |
    | Pagamenti divisi                        |      ✓     |
    | Tracciamento pagamenti da terminale POS |      ✓     |
    | Aggiungere a conto esistente            |      ✓     |
  </Accordion>

  <Accordion title="Configurazione locale">
    | Funzionalità                       | Supportata |
    | ---------------------------------- | :--------: |
    | Sync della planimetria             |      ✓     |
    | Aggiornamenti stock in tempo reale |      ✗     |
    | Supporto multi-sede                |      ✓     |
  </Accordion>
</AccordionGroup>


## Related topics

- [Assegnazione delle portate](/docs/it/guides/menu/course-assignments.md)
- [Sincronizzazione del menu POS](/docs/it/guides/menu/pos-menu-sync.md)
- [Iniezione degli ordini](/docs/it/guides/integrations/pos/order-injection.md)
- [Panoramica sulle integrazioni](/docs/it/guides/integrations/overview.md)
- [Gestire gli ordini live](/docs/it/guides/orders/managing-live-orders.md)