Lightspeed K-Series

Lightspeed K-Series (ex iKentoo) è un’integrazione POS completa che offre sincronizzazione bidirezionale del menu, iniezione automatica degli ordini, aggiornamenti di stock in tempo reale, sincronizzazione della planimetria e supporto pay-at-table.

​

Prerequisiti

Prima di connettere Lightspeed K-Series, assicurati di avere:

• Un abbonamento attivo a Lightspeed K-Series con accesso API
• Accesso admin alla tua dashboard storekit
• Le tue credenziali del back office Lightspeed

​

Configurazione della connessione

​

Passo 1: autorizzare storekit

La connessione utilizza OAuth, quindi autorizzerai storekit ad accedere al tuo account Lightspeed:

1. Vai su Store Settings > Integrations nella tua dashboard storekit
2. Trova Lightspeed K-Series e clicca su Connect
3. Verrai reindirizzato su Lightspeed per accedere e autorizzare l’accesso
4. Dopo l’autorizzazione tornerai su storekit

​

Passo 2: selezionare la tua business location

Dopo l’autorizzazione, seleziona quale business location Lightspeed collegare:

1. storekit mostrerà i tuoi business Lightspeed disponibili
2. Seleziona la business location che corrisponde a questo locale
3. Clicca su Connect per collegare la location

​

Passo 3: sincronizzare il menu

Una volta connesso, importa il tuo menu da Lightspeed:

1. Vai su Menu nella tua dashboard
2. Clicca su Sync Menu
3. Seleziona quale menu Lightspeed importare
4. Attendi il completamento della sincronizzazione

La sync importa:

• Categorie (comprese facoltativamente le subscreen)
• Prodotti con nomi, descrizioni e prezzi
• Menu deal e articoli combo
• Gruppi di modificatori e istruzioni di produzione
• Informazioni sugli allergeni
• Immagini dei prodotti (dal rich content di Lightspeed)

​

Passo 4: configurare le impostazioni di integrazione

Ottimizza il comportamento dell’integrazione:

​

Codici sconto nativi

Quando Native Discounts è abilitato, storekit invia i codici sconto direttamente a Lightspeed invece di aggiungere una voce di riga con SKU di sconto. Questo richiede:

1. I codici sconto in storekit devono avere il campo POS ID compilato con l’ID codice sconto Lightspeed corrispondente
2. Il codice sconto Lightspeed deve essere configurato e attivo
3. Lo sconto verrà applicato a tutti gli articoli dell’ordine a livello di POS

Se un codice sconto non ha un POS ID o il codice sconto Lightspeed non viene trovato, storekit ripiega sulla voce di riga con SKU di sconto.

​

Sincronizzazione del menu

​

Cosa viene sincronizzato

​

Opzioni di sincronizzazione

Preserva i contenuti esistenti:

• Don’t update images — mantieni le immagini aggiunte manualmente durante la sync
• Don’t update descriptions — mantieni le descrizioni modificate manualmente

Subscreen come categorie: Abilita questa opzione per trattare le subscreen Lightspeed come categorie separate in storekit. Account profile per il caricamento del menu: Specifica un account profile per caricare prezzi del menu specifici per l’ordinazione online. Lingua preferita: Seleziona quale lingua usare per i nomi dei prodotti quando esistono più traduzioni.

​

Sync manuale vs pianificata

Sync manuale: attiva in qualsiasi momento dalla pagina Menu dopo aver apportato modifiche in Lightspeed. Sync pianificata: imposta la sync automatica a orari specifici:

1. Vai su Store Settings > Integrations > Lightspeed K-Series
2. Configura il tuo programma di sync
3. Consigliato: pianifica durante le ore tranquille (es. le 5 del mattino)

​

Iniezione degli ordini

Quando un cliente effettua un ordine, viene automaticamente inviato a Lightspeed.

​

Tipi di ordine

​

Cosa riceve Lightspeed

Ogni ordine include:

• Tutti gli articoli con SKU e prezzi
• Modificatori (come sotto-articoli o ID modificatore)
• Nome, email e telefono del cliente
• Codice di ritiro (8 caratteri)
• Ora di fulfillment nelle note dell’ordine
• Indirizzo di consegna (per ordini delivery)
• Numero di tavolo (per ordini dine-in)
• Mance e service charge

​

Buffering dei pre-ordini

Per gli ordini programmati, puoi controllare quando vengono iniettati:

• Iniezione immediata: ordine inviato al POS subito dopo il pagamento
• Iniezione bufferizzata: ordine inviato X minuti prima dell’orario richiesto

Questo evita che i pre-ordini intasino la coda della cucina con ore di anticipo.

​

Retry logic

Se Lightspeed è temporaneamente irraggiungibile:

• storekit riprova con backoff esponenziale (fino a 6 retry)
• La tempistica dei retry si adatta in base a quanto è lontano l’ordine programmato
• Gli ordini falliti attivano notifiche email al tuo indirizzo email del locale

​

Aggiornamenti di stock in tempo reale

Lightspeed K-Series supporta gli aggiornamenti di inventario in tempo reale via webhook:

1. Quando marchi un articolo come limitato o aggiorni lo stock in Lightspeed
2. Lightspeed invia un webhook a storekit
3. storekit aggiorna immediatamente la disponibilità
4. La cache del menu viene svuotata così che i clienti vedano la disponibilità corrente

​

Auto-snooze in caso di fallimento ordine

Se un ordine fallisce a causa di una restrizione di vendita (articolo non disponibile), storekit automaticamente:

1. Mette in snooze gli articoli interessati fino alle 8 del mattino successivo
2. Registra l’evento di snooze con source lightspeed
3. Svuota la cache del menu
4. Impedisce ulteriori ordini di articoli non disponibili

Tutti gli eventi di auto-snooze vengono tracciati nello snooze report per dare visibilità sui problemi di stock.

​

Sincronizzazione della planimetria

Sincronizza il layout dei tavoli da Lightspeed per dine-in e pay-at-table:

1. Vai su Stores → il tuo store → Settings → Integrations → Lightspeed K-Series
2. Sotto Fetch Lightspeed Floorplan, clicca su Sync floorplan e conferma
3. Aree e tavoli vengono importati con i loro ID Lightspeed

Le modifiche si sincronizzano automaticamente:

• Nuove aree e tavoli vengono creati
• I tavoli rinominati vengono aggiornati
• I tavoli rimossi vengono archiviati

​

Pay at Table

Lightspeed K-Series 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 Lightspeed
3. Il cliente visualizza gli articoli e seleziona cosa pagare
4. Il pagamento viene elaborato e applicato al conto Lightspeed
5. Lo stato del conto si sincronizza in tempo reale

​

Configurazione

​

Sincronizzazione dei conti

storekit mantiene i conti sincronizzati con Lightspeed:

• Gli articoli aggiunti/rimossi in Lightspeed si aggiornano automaticamente
• I pagamenti effettuati sul POS vengono riflessi
• I conti spostati tra tavoli vengono tracciati
• Service charge e sconti si sincronizzano correttamente

​

Testare l’integrazione

​

Checklist pre-lancio

1. Sincronizzazione del menu
   • Tutte le categorie importate correttamente
   • I prodotti hanno nomi e prezzi corretti
   • I modificatori compaiono sui prodotti giusti
   • Le immagini vengono visualizzate (se usi immagini Lightspeed)
2. Flusso ordine
   • Effettua un ordine di test pickup
   • Verifica che l’ordine compaia in Lightspeed
   • Controlla che articoli, modificatori e note siano corretti
   • Conferma che compaia il codice di ritiro
3. Aggiornamenti di stock
   • Marca un articolo come limitato in Lightspeed
   • Verifica che venga nascosto dal menu storekit entro pochi minuti
4. Pay at table (se in uso)
   • Apri un conto in Lightspeed
   • Scansiona il QR code per visualizzare il conto
   • Completa un pagamento di test
   • Verifica che il pagamento compaia in Lightspeed

​

Troubleshooting

​

Connessione scaduta

Se vedi errori di autorizzazione:

• Il refresh token potrebbe essere scaduto
• Vai su Store Settings > Integrations e ri-autorizza

​

Il menu non si sincronizza

• Assicurati che il menu sia pubblicato in Lightspeed
• Controlla che i prodotti siano attivi e assegnati alle categorie
• Verifica che il menu corretto sia selezionato in storekit
• Controlla eventuali errori di sync nella dashboard

​

Gli ordini non compaiono

• Verifica che l’integrazione sia abilitata (non solo connessa)
• Controlla che gli account profile esistano in Lightspeed
• Assicurati che gli SKU richiesti esistano (STOREKIT_DELIVERY, STOREKIT_DISCOUNT, ecc.)
• Rivedi l’ordine nella dashboard storekit per eventuali messaggi di errore

​

Articoli sbagliati negli ordini

• Controlla che gli SKU corrispondano tra i sistemi
• Verifica che i gruppi di modificatori siano sincronizzati correttamente
• Per i menu deal, assicurati che la struttura del deal corrisponda

​

Lo stock non si aggiorna

• Verifica che i webhook siano configurati correttamente
• Controlla che la business location sia aggiunta al webhook
• Conferma che gli SKU degli articoli corrispondano tra i sistemi

Per ulteriore assistenza, contatta il supporto.

​

Funzionalità supportate