> ## 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. # Risoluzione dei problemi Lightspeed > Risolvi i problemi comuni di Lightspeed K-Series in storekit: errori di autorizzazione, sync fallite, ordini rifiutati, product code e stock. Problemi comuni con Lightspeed K-Series e come risolverli. Se sei ancora bloccato, [contatta il supporto storekit](/docs/it/getting-started/contact-support). > [!NOTE] > > Gli ordini che falliscono con **"Not processed before validity ended"**, **"K-Series iPad App is off"** o **"All active devices are offline"** significano tutti la stessa cosa — l'Active Device Lightspeed non era online. Ha una pagina dedicata: [Ordini falliti: cassa offline](/docs/it/guides/integrations/pos/lightspeed/till-offline). Un ordine che fallisce perché un articolo *"has a Disconnected status in Lightspeed"* è un problema diverso — vedi [sotto](#un-ordine-e-fallito-perche-un-articolo-ha-lo-stato-disconnected-in-lightspeed). Una voce della timeline che riporta *"Failed to sync order Validation failed for method … placeToGoOrder …"* è ancora un altro caso — Lightspeed ha rifiutato il contenuto dell'ordine — vedi [sotto](#un-ordine-e-fallito-con-validation-failed-for-method--placetogoorder). ## Connessione ### "Lightspeed K-Series" non è nel mio elenco Integrations L'integrazione non è abilitata per il tuo account. [Contatta il supporto](/docs/it/getting-started/contact-support) per farla attivare. ### Gli ordini falliscono con "Our access to your Lightspeed account has been disabled" Lightspeed sta rifiutando l'accesso di storekit. L'utente integration in Lightspeed di solito è stato disabilitato o ha subito modifiche ai permessi — riabilitalo nel back office di Lightspeed, poi clicca su **Disconnect Auth** e di nuovo su **Connect to Lightspeed** su **Stores** → il tuo locale → **Settings** → **Integrations** → **Lightspeed K-Series**. ### Ho collegato la location Lightspeed sbagliata Clicca su **Disconnect Auth**, poi su **Connect to Lightspeed** e scegli la location giusta sulla schermata **Select your Lightspeed location:**. ## Sync del menu ### Non c'è il pulsante Sync sul menu La barra **Connected to Lightspeed** (con **View in POS** e **Sync**) appare solo quando il provider POS del locale è Lightspeed e il menu è collegato a un menu Lightspeed. Scegli il menu in **Lightspeed Menu** nella pagina delle impostazioni Lightspeed e clicca su **Save**. ### La sync fallisce a metà La barra di progresso mostra la fase in cui è fallita. Cause comuni: * Il menu non esiste più in Lightspeed, o non è più disponibile sulla business location collegata — riselezionalo in **Lightspeed Menu**. * L'autorizzazione è scaduta o è stata revocata — ricollega (sopra). * L'account profile in **Specify account profile when syncing menu** non esiste più in Lightspeed — rimettilo su **No profile** o scegli uno attuale. ### Alcuni articoli non sono stati importati * Gli articoli la cui pricing strategy Lightspeed rende il prezzo positivo, negativo o una percentuale del totale vengono saltati di proposito — non hanno un prezzo fisso da importare. * Gli articoli dentro le sub-screen finiscono nella categoria padre a meno che **Import Sub-screens as categories** non sia attivo. * I prodotti nel menu entry group `integration` (i prodotti storekit per delivery, sconto e service charge) vengono saltati di proposito. ### Nomi o descrizioni sono nella lingua sbagliata Imposta **Language** sulla locale Lightspeed che vuoi. storekit ripiega su `en` per gli articoli senza testo in quella locale. ### Le mie immagini o descrizioni storekit sono state sovrascritte Attiva **Don't update menu images** e **Don't update menu description**. Tutto il resto del menu viene riscritto da Lightspeed a ogni sync. ## Ordini ### Gli ordini falliscono con "Not processed before validity ended" L'Active Device Lightspeed — il tuo iPad master — non era online per raccogliere l'ordine. Vedi [Ordini falliti: cassa offline](/docs/it/guides/integrations/pos/lightspeed/till-offline) per la checklist completa e per come reinviare l'ordine. Se il reinvio viene rifiutato con *"This order has already been sent to the POS"*, Lightspeed ha accettato l'ordine ma la cassa non l'ha mai stampato — vedi [cosa fare](/docs/it/guides/integrations/pos/lightspeed/till-offline#questo-ordine-e-gia-stato-inviato-al-pos) invece di cliccare di nuovo su **Resend order to POS**. ### Gli ordini non arrivano proprio a Lightspeed * Controlla che **Integration Status** sia attivo — l'etichetta dovrebbe riportare *Enabled - sending orders to Lightspeed*. * Controlla che il locale sia collegato alla business location giusta. * Apri l'ordine in storekit e leggi il motivo del fallimento registrato. ### Gli ordini vengono rifiutati subito quando vengono inviati * Il codice account profile deve esistere in Lightspeed. Se una riga sotto **Account Profile Codes** è vuota, storekit invia `storekit` — crea quel profile in Lightspeed oppure selezionane uno reale per **Pickup**, **Delivery**, **In Store** e **Add to Bill**. * I prodotti di delivery, sconto e service charge devono esistere in Lightspeed con gli SKU impostati in **Delivery Product Code (SKU)**, **Discount Product Code (SKU)** e **Service Charge Product Code (SKU)** (default: `STOREKIT_DELIVERY`, `STOREKIT_DISCOUNT`, `STOREKIT_SERVICE_CHARGE`). Uno SKU mancante fa fallire l'intero ordine. * Gli SKU degli articoli devono ancora corrispondere. Ri-sincronizza il menu dopo aver cambiato SKU in Lightspeed. ### Un ordine è fallito perché un articolo ha lo stato Disconnected in Lightspeed Il motivo del fallimento riporta *"…one of the items in the order has a Disconnected status in Lightspeed"*. Questo è il messaggio di Lightspeed stesso, memorizzato parola per parola sull'ordine: Lightspeed ha rifiutato l'ordine perché non tratta uno degli articoli come un articolo attivo e ordinabile sulla business location collegata. Il caso che il supporto storekit ha visto riguardava un articolo appena creato in Lightspeed e importato dalla sync del menu del giorno precedente. Non è il fallimento da cassa offline. Non c'è niente da fare sull'iPad — vedi [Ordini falliti: cassa offline](/docs/it/guides/integrations/pos/lightspeed/till-offline) solo se il motivo è *"Not processed before validity ended"*. **1. Ri-sincronizza il menu** Apri il menu sotto **Menus** e clicca su **Sync** nella barra **Connected to Lightspeed** così storekit prende l'articolo Lightspeed corrente. Vedi [Sync del menu](/docs/it/guides/integrations/pos/lightspeed/menu-sync). **2. Controlla l'articolo in Lightspeed** Clicca su **View in POS** e conferma che l'articolo esista ancora nel menu a cui storekit è collegato e sia attivo su questa business location. Se è stato eliminato e ricreato, il nuovo articolo deve essere in quel menu. **3. Reinvia l'ordine** Apri l'ordine e clicca su **More actions** → **Resend order to POS**. L'ordine viene reinviato con l'articolo appena sincronizzato. **4. Ancora fallito? Contatta il supporto** Se il reinvio fallisce con lo stesso motivo, [contatta il supporto storekit](/docs/it/getting-started/contact-support) e cita il numero dell'ordine e il nome dell'articolo. Il collegamento tra l'articolo storekit e l'articolo Lightspeed potrebbe dover essere ricostruito dalla nostra parte — una sync eseguita dal supporto ha risolto casi in cui una sync eseguita dal merchant non ci era riuscita. > [!WARNING] > > L'ordine è già stato confermato al cliente, e se ha pagato online il denaro è già stato prelevato. Se l'ordine non può essere reinviato con successo, digitalo a mano in Lightspeed dai dettagli dell'ordine in storekit così la cucina lo riceve comunque, e incassa il pagamento alla consegna solo se l'ordine storekit mostra che è stato effettuato come ordine in contanti. ### Un ordine è fallito con "Validation failed for method … placeToGoOrder" La timeline dell'ordine mostra *"Failed to sync order Validation failed for method='public com.ikentoo.ape.dto.SubmissionResponseDto com.ikentoo.ape.controllers.OrderSubmissionController.placeToGoOrder(com.lightspeedhq.ape.dto.rest.ToGoOrder)'. Error count: N"*. Questa è la risposta di Lightspeed stesso, memorizzata parola per parola: Lightspeed ha rifiutato di accettare l'ordine perché qualcosa in ciò che storekit ha inviato — i dettagli del cliente, un codice di articolo o modifier, la business location o la linea di pagamento — non ha superato i suoi controlli. *Error count* è il numero di campi a cui ha obiettato. **Non** è il fallimento della cassa offline. L'ordine non ha mai raggiunto l'iPad, quindi riavviare l'app Lightspeed o ricaricare l'iPad non cambia nulla, e cliccare **More actions** → **Resend order to POS** senza modificare nulla invia lo stesso contenuto e fallisce nello stesso modo. Poiché Lightspeed non ha mai preso l'ordine, le regole di riprova e di email di ordine fallito descritte in [Quando un ordine fallisce](/docs/it/guides/integrations/pos/lightspeed/orders#quando-un-ordine-fallisce) non partono — il rifiuto viene registrato nella timeline dell'ordine e l'ordine non viene stampato sulla cassa. Controlla queste cose prima di reinviare: * *Un articolo nell'ordine esiste solo in storekit.* Un articolo o modifier aggiunto a mano in storekit non ha un codice Lightspeed, quindi Lightspeed rifiuta l'ordine. Crea prima l'articolo nel menu Lightspeed a cui il locale è collegato, poi apri il menu sotto **Menus** e clicca **Sync** nella barra **Connected to Lightspeed** in modo che storekit ne prenda il codice, poi reinvia l'ordine. Una sync da sola rimuove gli articoli presenti solo in storekit invece di crearli in Lightspeed — vedi [Sync del menu](/docs/it/guides/integrations/pos/lightspeed/menu-sync#limitazioni). * *Un codice di modifier o articolo non esiste più in Lightspeed.* Se è stato eliminato, ricreato o ha avuto la sua SKU modificata in Lightspeed dall'ultima sync, sincronizza di nuovo il menu così storekit invia il codice corrente. Le SKU di delivery, sconto e service charge sotto **Delivery Product Code (SKU)**, **Discount Product Code (SKU)** e **Service Charge Product Code (SKU)** devono anch'esse esistere ancora in Lightspeed. * *Il numero di telefono del cliente.* storekit passa il numero di telefono del cliente a Lightspeed nel campo che Lightspeed riserva ai numeri in formato internazionale (E.164). Se il rifiuto riguarda un campo dei dati cliente, chiedi al supporto di verificare se il numero sull'ordine è ciò a cui Lightspeed ha obiettato. Se il reinvio fallisce con lo stesso motivo dopo che il menu è stato risincronizzato, [contatta il supporto storekit](/docs/it/getting-started/contact-support) e cita il numero dell'ordine. storekit memorizza solo la riga di riepilogo di Lightspeed insieme all'ordine; il dettaglio campo per campo di ciò che Lightspeed ha rifiutato è conservato nei nostri log, e il supporto può leggerlo e dirti quale articolo o campo correggere. > [!WARNING] > > L'ordine è già stato confermato al cliente, e se ha pagato online il denaro è già stato prelevato. Se non può essere reinviato con successo, digitalo a mano in Lightspeed dai dettagli dell'ordine in storekit così la cucina lo riceve comunque. ### Un ordine è fallito perché un articolo è restretto Lightspeed ha rifiutato l'ordine per una sales restriction. storekit mette in snooze gli articoli interessati fino alle 8:00 del giorno successivo e invia un'email al locale; controlla lo stock o la restriction dell'articolo in Lightspeed, poi togli lo snooze in storekit. ### Gli ordini falliscono e poi smettono di riprovare storekit invia un ordine immediato fino a 5 tentativi in totale (l'invio originale più quattro retry) prima di marcarlo come **Failed**. Un pre-ordine viene ritentato finché il suo orario richiesto è ancora lontano, quindi un pre-ordine per più tardi nella giornata può fallire, riprovare e fallire di nuovo ogni pochi minuti fino a essere finalmente marcato **Failed** poco prima dell'orario previsto. Gli ordini che vengono aggiunti a una bill esistente e i fallimenti riportati come "articolo non aggiungibile" non vengono ritentati affatto. Una volta risolta la causa, reinvia l'ordine con **More actions** → **Resend order to POS**. ### Non ricevo le email di ordine fallito Gli ordini risultano **Failed** nella dashboard ma non arriva alcuna email. Controlla queste cose in ordine: 1. *Gli indirizzi email del locale.* L'email di ordine fallito va solo agli indirizzi in **Email address** su **Stores** → il tuo locale → **Settings** → **General** — il primo indirizzo è il destinatario e gli altri sono in copia nascosta. Non viene inviato nulla all'email con cui accedi alla dashboard, al proprietario dell'account o ad altri membri dello staff a meno che il loro indirizzo non sia in quella lista. Se la lista è vuota, non viene inviata alcuna email. Aggiungi gli indirizzi che devono essere avvisati e clicca su **Save**. Nella dashboard non c'è un'impostazione separata per stabilire chi riceve le email di ordine fallito. 2. *L'ordine non è ancora definitivamente fallito.* L'email viene inviata una sola volta, quando storekit smette di riprovare e marca l'ordine **Failed**. Non viene inviata a ogni tentativo fallito. Un ordine immediato viene notificato via email dopo il 5° fallimento; un pre-ordine viene ritentato fino a poco prima dell'orario richiesto, quindi un ordine che risulta in retry, o un pre-ordine per più tardi oggi, non è ancora stato notificato via email. Gli ordini aggiunti a una bill esistente e i fallimenti "articolo non aggiungibile" vengono notificati via email al primo fallimento perché non vengono ritentati. 3. *La cartella spam e il mittente.* L'email arriva dall'indirizzo di invio del tuo partner storekit con oggetto `Lightspeed Issue: Order # for store: `. L'email *"Lightspeed Not Ready"* è un messaggio diverso con regole proprie — vedi [Il locale continua a chiudersi da solo](#il-locale-continua-a-chiudersi-da-solo) e [Prontezza degli ordini](/docs/it/guides/integrations/pos/lightspeed/stock-and-availability#prontezza-degli-ordini). È deliberatamente limitata a un'email per locale ogni 30 minuti e non viene inviata mentre i tuoi orari di apertura dicono che il locale è chiuso, così una raffica di fallimenti di prontezza non produce una raffica di email e nessuna arriva di notte. Mentre risolvi il problema delle email, i fallimenti sono sempre visibili nella dashboard: * Apri l'ordine sotto **Orders** — un ordine **Failed** mostra il banner *"Something went wrong sending this order to the POS:"* seguito dal motivo di Lightspeed. * Su **Live Orders**, attiva **Show failed orders only** nei filtri per elencare solo gli ordini falliti. * **Logs** → **POS Errors** (titolo pagina **Integration Errors**) mostra un conteggio giornaliero degli ordini con un errore POS e i loro totali, filtrabile per locale e intervallo di date. Non elenca il motivo per ciascun ordine — per quello apri l'ordine. * Non guardare sotto **Logs** → **Blocked Orders**: quella pagina elenca gli ordini che storekit ha rifiutato di creare in primo luogo (regole e filtri), non gli ordini che Lightspeed ha rifiutato. Se gli indirizzi sono corretti e un ordine definitivamente fallito non ha comunque prodotto alcuna email, [contatta il supporto storekit](/docs/it/getting-started/contact-support) con il numero dell'ordine — dalla nostra parte teniamo una copia di ogni email di ordine fallito. ### I pre-ordini arrivano troppo presto o troppo tardi Questo lo controlla **Buffer Orders**. Con **Buffer (in minutes)** impostato, l'ordine viene iniettato quel numero di minuti prima dell'orario richiesto; con il campo vuoto, storekit usa il calcolo del tempo di preparazione del locale. ### Viene usato il tavolo sbagliato per gli ordini in-store storekit invia il POS ID del tavolo come numero di tavolo Lightspeed. Se sono sbagliati solo pochi tavoli, correggi il loro **POS ID** su **Stores** → il tuo locale → **Settings** → **Tables** — vedi [Modificare i tavoli](/docs/it/guides/fulfillment/dine-in-tables#modificare-i-tavoli). Riesegui **Sync floorplan** solo quando serve riconciliare l'intera planimetria: copre ogni area del locale e sovrascrive i tavoli modificati a mano, come descritto in [Planimetria e tavoli](/docs/it/guides/integrations/pos/lightspeed/dine-in#ri-sincronizzare). ## Stock e disponibilità ### Gli articoli esauriti sono ancora ordinabili * **Stock Webhook** deve essere attivo — l'etichetta dovrebbe riportare *Enabled - stocks updated automatically*. * storekit associa gli aggiornamenti di stock sullo SKU e sulla business location collegata, quindi un articolo il cui SKU differisce tra i due sistemi non si aggiornerà. Ri-sincronizza il menu. ### Il locale continua a chiudersi da solo È **Sync order readiness**: Lightspeed sta riportando la location come non pronta per gli ordini online, quindi storekit chiude il locale e lo riapre quando Lightspeed lo segnala nuovamente pronto. Disattiva l'impostazione se non vuoi che il POS piloti la disponibilità del locale, e disattiva **Order readiness emails** per fermare le notifiche. Quelle email vanno alla lista **Email address** del locale, al massimo una ogni 30 minuti e solo mentre il locale è aperto — vedi [Prontezza degli ordini](/docs/it/guides/integrations/pos/lightspeed/stock-and-availability#prontezza-degli-ordini). ### I clienti non vengono avvisati che il loro ordine è pronto **Ready for pickup notifications** deve essere attivo perché Lightspeed possa pilotare lo stato "pronto per il ritiro". ## Pay at Table ### L'ospite non vede nessuna bill * Il tavolo deve esistere in entrambi i sistemi con lo stesso numero — esegui **Sync floorplan**. * Deve esserci una check aperta su quel tavolo in Lightspeed. ### I pagamenti falliscono * Controlla che **Payment Method PAT** punti a un metodo di pagamento Lightspeed ancora attivo. Con niente selezionato storekit riporta i pagamenti come `APM`, che deve esistere in Lightspeed. * I pagamenti con gift card e loyalty usano **Gift Card Payment Method** — lo stesso vale per lui. * Il motivo del fallimento di Lightspeed viene memorizzato sul pagamento e la bill viene segnalata così lo staff può saldarla sul POS. ### Un round di drink non è finito sulla bill Gli ordini aggiunti a una bill aperta non vengono ritentati. Controlla il motivo del fallimento dell'ordine in storekit e aggiungi gli articoli sul POS se serve. Per qualsiasi altra cosa, [contatta il supporto](/docs/it/getting-started/contact-support). ## Related topics - [Risoluzione dei problemi](/docs/it/guides/integrations/pos/comtrex/troubleshooting.md) - [Risoluzione dei problemi Deliverect](/docs/it/guides/integrations/pos/deliverect/troubleshooting.md) - [Risoluzione dei problemi Syrve](/docs/it/guides/integrations/pos/syrve/troubleshooting.md) - [Risoluzione dei problemi Toast](/docs/it/guides/integrations/pos/toast/troubleshooting.md) - [Risoluzione dei problemi Stream](/docs/it/guides/integrations/pos/stream/troubleshooting.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.