TISSL

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

​

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:

​

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

​

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

​

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

​

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

​

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.

​

Funzionalità supportate