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. Un ordine che fallisce perché un articolo “has a Disconnected status in Lightspeed” è un problema diverso — vedi sotto. 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.
Connessione
”Lightspeed K-Series” non è nel mio elenco Integrations
L’integrazione non è abilitata per il tuo account. Contatta il supporto 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 suen 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 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 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 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.
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 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.
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 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.
- 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.
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:- 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.
- 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.
- La cartella spam e il mittente. L’email arriva dall’indirizzo di invio del tuo partner storekit con oggetto
Lightspeed Issue: Order #<order number> for store: <store name>.
- 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.
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. 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.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.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.