> ## 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.
# Lightspeed K-Series
> Collega Lightspeed K-Series (ex iKentoo) a storekit per una sincronizzazione completa del menu, iniezione ordini, aggiornamenti di stock in tempo reale, sync della planimetria e pay at table.
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
Ogni locale storekit si connette a una business location Lightspeed. Per configurazioni multi-sede, connetti ogni locale separatamente.
### 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:
| Impostazione | Descrizione |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Delivery Fee SKU** | SKU per le commissioni di consegna (default: `STOREKIT_DELIVERY`) |
| **Discount SKU** | SKU per gli sconti (default: `STOREKIT_DISCOUNT`) |
| **Service Charge SKU** | SKU per il service charge (default: `STOREKIT_SERVICE_CHARGE`) |
| **Payment Method** | Codice metodo di pagamento per gli ordini online (default: `STOREKIT`) |
| **Buffer Orders** | Ritarda l'iniezione dei pre-ordini fino ad avvicinarsi all'orario di fulfillment |
| **Buffer Time** | Minuti prima dell'orario del pre-ordine per iniettare l'ordine |
| **Native Discounts** | Usa i codici sconto Lightspeed invece delle voci di riga con SKU di sconto |
| **Send cash payments as paid** | Invia gli ordini in contanti a Lightspeed con il pagamento già applicato. Lascia disattivato se lo staff deve vedere un saldo aperto e chiuderlo quando il cliente paga — vedi [ordini in contanti e pay-on-collection](/docs/it/guides/payments/cash-payments) |
Gli SKU devono esistere nel tuo menu Lightspeed. Crea articoli con questi SKU in Lightspeed prima di abilitare l'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.
Gli sconti nativi offrono una reportistica migliore in Lightspeed e assicurano che gli sconti vengano applicati in modo coerente con le regole di sconto del tuo POS.
## Sincronizzazione del menu
### Cosa viene sincronizzato
| Dato | Sincronizzato |
| ------------------------ | -------------------------------- |
| Categorie | Sì |
| Prodotti | Sì |
| Prezzi | Sì |
| Descrizioni | Sì (disattivabile) |
| Immagini | Sì (disattivabile) |
| Modificatori | Sì |
| Istruzioni di produzione | Sì (come gruppi di modificatori) |
| Menu Deal | Sì |
| Allergeni | Sì |
| Contenuti multilingua | Sì |
### 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
| Tipo di ordine | Endpoint Lightspeed | Account Profile |
| -------------- | ------------------- | ----------------------------------- |
| Pickup | To-Go Order | Configurabile (default: `storekit`) |
| Delivery | To-Go Order | Configurabile (default: `storekit`) |
| Dine-in | Local Order | Configurabile (default: `storekit`) |
### 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.
Per i locali con volumi elevati, bufferizza i pre-ordini per iniettarli 15-30 minuti prima dell'orario richiesto.
### 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
Le notifiche email includono il motivo specifico dell'errore, i dettagli dell'ordine e un link diretto per visualizzare l'ordine nella tua dashboard. Questo assicura che tu non perda mai un ordine che richiede attenzione manuale.
## 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
| Impostazione | Descrizione |
| ---------------------------- | ----------------------------------------------------------------------- |
| **PAT Payment Method** | Codice metodo di pagamento per i pagamenti al tavolo (default: `APM`) |
| **Gift Card Payment Method** | Metodo di pagamento separato per pagamenti con gift card/loyalty |
| **Ignore Free Items** | Non mostrare gli articoli a prezzo zero sul conto |
| **Auto-close Bills Delay** | Tempo di attesa prima di controllare se il conto è completamente pagato |
### 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](/docs/it/getting-started/contact-support).
## Funzionalità supportate
| Funzionalità | Supportata |
| --------------------------------------- | :--------: |
| Sincronizzazione automatica del menu | ✓ |
| Sync leggera (solo prezzi) | ✗ |
| Immagini prodotto | ✓ |
| Allergeni | ✓ |
| Calorie | ✓ |
| Modificatori nidificati | ✓ |
| Sottocategorie | ✓ |
| Fasce orarie di disponibilità categoria | ✗ |
| Porzioni / taglie | ✗ |
| Portate | ✗ |
| Istruzioni di produzione | ✓ |
| Menu deal | ✓ |
| Contenuti multilingua | ✓ |
| Stato di stock | ✓ |
| Funzionalità | Supportata |
| ----------------------------- | :--------: |
| Iniezione ordini | ✓ |
| Pre-ordini | ✓ |
| Buffering ordini | ✓ |
| Validazione carrello | ✗ |
| Auto-snooze articoli esauriti | ✗ |
| Sconti | ✓ |
| Mance | ✓ |
| Service charge | ✓ |
| Note d'ordine personalizzate | ✗ |
| Dettagli consegna | ✓ |
| Funzionalità | Supportata |
| --------------------------------------- | :--------: |
| Sync conto in tempo reale | ✓ |
| Applicare pagamenti al conto | ✓ |
| Pagamenti divisi | ✓ |
| Tracciamento pagamenti da terminale POS | ✓ |
| Aggiungere a conto esistente | ✗ |
| Pagamenti con gift card | ✓ |
| Funzionalità | Supportata |
| ---------------------------------- | :--------: |
| Sync della planimetria | ✓ |
| Aggiornamenti stock in tempo reale | ✓ |
| Supporto multi-sede | ✓ |
## Related topics
- [Iniezione degli ordini](/docs/it/guides/integrations/pos/order-injection.md)
- [Assegnazione delle portate](/docs/it/guides/menu/course-assignments.md)
- [Panoramica sulle integrazioni](/docs/it/guides/integrations/overview.md)
- [Gestire gli ordini live](/docs/it/guides/orders/managing-live-orders.md)
- [Stampa i modificatori come prodotti](/docs/it/guides/menu/print-modifiers-as-products.md)