> ## 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. # Ordini e instradamento Lightspeed > Come storekit invia gli ordini a Lightspeed K-Series: instradamento per account profile, pagamenti, sconti, service charge e buffering dei pre-ordini. storekit mette in coda per Lightspeed ogni ordine online non appena viene effettuato — non devi accettarlo prima. I pre-ordini possono essere trattenuti con **Buffer Orders**. ## Come un ordine raggiunge Lightspeed | Tipo di ordine | Ordine Lightspeed | Dettagli extra inviati | | - | - | - | | Pickup | To-go order | Codice di ritiro, orario di ritiro nella nota dell'ordine | | Delivery | To-go order | Indirizzo di consegna, line item della delivery fee, codice di ritiro, orario di consegna nella nota dell'ordine | | In store | Local order | Numero di tavolo (il POS ID Lightspeed del tavolo) | | Add to bill | Bill Lightspeed esistente | L'identificatore dell'account della bill invece di un nuovo ordine | Ogni ordine porta con sé anche nome, email e numero di telefono del cliente, gli articoli con i loro SKU e modificatori, la mancia e la nota d'ordine generata. > [!NOTE] > > Il codice di ritiro che Lightspeed mostra è il codice ordine di storekit — Lightspeed lo limita a 8 caratteri. ## Instradamento per account profile Sotto **Account Profile Codes** su **Stores** → il tuo locale → **Settings** → **Integrations** → **Lightspeed K-Series** mappi ogni tipo di consegna a un account profile Lightspeed. Le quattro righe sono fisse: **Pickup**, **Delivery**, **In Store** e **Add to Bill**. Ogni menu a discesa elenca gli account profile della tua business location Lightspeed. Se una riga non è impostata, storekit invia il codice account profile `storekit`, che deve esistere in Lightspeed. Quando un ordine finisce su una bill esistente, il profile **Add to Bill** ha la precedenza sul profile del tipo di consegna. ## Pagamento, sconti e charge * **Payment Method** — il metodo di pagamento Lightspeed su cui viene registrato il pagamento dell'ordine. Di default è `STOREKIT` quando non è selezionato nulla. * **Send cash payments as paid** — disattivato di default: gli ordini in contanti vengono inviati senza pagamento applicato, così lo staff vede un saldo aperto e lo salda quando il cliente paga. Attivalo per inviare gli ordini in contanti come già pagati. Gli ordini con carta e altri prepagati vengono sempre inviati come pagati. Vedi [ordini in contanti e pay-on-collection](/docs/it/guides/payments/cash-payments). * **Discount Product Code (SKU)** — usato per un line item di sconto negativo. Se il codice sconto storekit ha un **POS ID** che corrisponde a un codice sconto Lightspeed, storekit applica quello sconto nativo Lightspeed agli articoli dell'ordine invece di aggiungere il line item. Gli sconti di consegna gratuita non aggiungono alcuna riga di sconto, perché la riga di delivery a £0 riflette già la fee annullata. * **Service Charge Product Code (SKU)** — line item usato per il service charge dell'ordine. * **Delivery Product Code (SKU)** — line item usato per la delivery fee sugli ordini di consegna. * **Don't send customer email address to Lightspeed** — invia un indirizzo email vuoto, per i locali che non vogliono le email dei clienti nel POS. Nome e numero di telefono vengono comunque inviati. > [!WARNING] > > Questi product code devono esistere nel tuo menu Lightspeed. Uno SKU mancante fa rifiutare a Lightspeed l'intero ordine. Sugli ordini in-store, storekit invia anche il [numero di portata](/docs/it/guides/menu/course-assignments) di ogni articolo, così Lightspeed può inviare l'ordine per portata. ## Note dell'ordine **Order Note Template** nella pagina delle impostazioni Lightspeed controlla la nota inviata con ogni ordine (fino a 250 caratteri). Clicca su **Insert Variable** per vedere le variabili disponibili e su **Preview** per verificare il risultato con dati di esempio. storekit aggiunge automaticamente alla nota l'orario di ritiro o di consegna. ## Buffering dei pre-ordini Di default un pre-ordine viene inviato a Lightspeed subito, il che può intasare la cucina con ore d'anticipo. Per ritardarlo: 1. Attiva **Buffer Orders**. 2. Facoltativamente imposta **Buffer (in minutes)** (0–720) — l'ordine viene iniettato quel numero di minuti prima dell'orario di consegna richiesto. Con **Buffer Orders** attivo e **Buffer (in minutes)** vuoto, storekit usa il calcolo normale del tempo di preparazione del locale per decidere quando iniettare. Gli ordini senza orario richiesto non vengono mai bufferizzati. > [!TIP] > > 15–30 minuti è un buon punto di partenza per una cucina impegnata. ## Add to Bill Per gli ordini in-store sui tavoli di un'area che accetta pay-at-table, **Add to bill batching for all orders** invia ogni ordine sulla bill Lightspeed aperta del tavolo invece di creare un ordine separato. Viene usato l'account profile **Add to Bill** e il pagamento viene lasciato fuori dall'ordine perché viene saldato contro la bill. Vedi [Pay at Table](/docs/it/guides/integrations/pos/lightspeed/pay-at-table). ## Quando un ordine fallisce Lightspeed segnala l'esito di ogni ordine tramite webhook: * **Success** — l'ordine viene marcato **Accepted** in storekit e viene memorizzato il riferimento della ricevuta Lightspeed. * **Failure** — storekit rimette l'ordine in coda e riprova. Un ordine immediato viene marcato **Failed** dopo 5 tentativi; un pre-ordine continua a riprovare finché l'orario richiesto non è vicino, poi viene marcato **Failed**. Una volta che l'ordine è **Failed**, il motivo del fallimento viene memorizzato, viene inviata un'email al locale e viene stampato un ticket di ordine fallito se il locale ha stampanti. Gli ordini che vengono aggiunti a una bill esistente e i fallimenti il cui motivo è che l'articolo non è stato aggiungibile non vengono ritentati — vengono marcati **Failed** al primo fallimento. * Se il motivo del fallimento è una sales restriction, storekit mette anche in snooze gli articoli interessati — vedi [Stock e disponibilità](/docs/it/guides/integrations/pos/lightspeed/stock-and-availability). storekit dà anche a Lightspeed una deadline per accettare l'ordine che scala in base a quanto è distante il pre-ordine: un minuto per gli ordini immediati, fino a sei ore per gli ordini a più di una settimana di distanza. Se Lightspeed rifiuta l'accesso di storekit (un 403), l'ordine fallisce con *"Our access to your Lightspeed account has been disabled, please re-enable the integration user or speak to support"* — vedi [Risoluzione dei problemi](/docs/it/guides/integrations/pos/lightspeed/troubleshooting). ### L'email di ordine fallito L'email viene inviata una sola volta, quando l'ordine viene definitivamente marcato **Failed** — non a ogni retry. Ha come oggetto `Lightspeed Issue: Order # for store: ` e il motivo del fallimento nel corpo. Va alla lista **Email address** del locale su **Stores** → il tuo locale → **Settings** → **General** (il primo indirizzo come destinatario, gli altri in copia nascosta) e a nessun altro: l'email con cui accedi alla dashboard non riceve nulla a meno che non sia in quella lista. Se la lista è vuota, non viene inviata alcuna email. Vedi [Non ricevo le email di ordine fallito](/docs/it/guides/integrations/pos/lightspeed/troubleshooting#non-ricevo-le-email-di-ordine-fallito). Qualsiasi altro motivo di fallimento è il messaggio di Lightspeed stesso, memorizzato parola per parola. I tre che è più probabile che tu veda sono *"Not processed before validity ended"* (l'Active Device era offline — vedi [Ordini falliti: cassa offline](/docs/it/guides/integrations/pos/lightspeed/till-offline)), *"…one of the items in the order has a Disconnected status in Lightspeed"* (Lightspeed non tratta un articolo dell'ordine come attivo sulla location — vedi [Risoluzione dei problemi](/docs/it/guides/integrations/pos/lightspeed/troubleshooting#un-ordine-e-fallito-perche-un-articolo-ha-lo-stato-disconnected-in-lightspeed)) e *"Failed to sync order Validation failed for method … placeToGoOrder …"* nella timeline dell'ordine (Lightspeed ha rifiutato il contenuto dell'ordine prima di accettarlo, quindi le regole di riprova e di email descritte sopra non partono mai — vedi [Risoluzione dei problemi](/docs/it/guides/integrations/pos/lightspeed/troubleshooting#un-ordine-e-fallito-con-validation-failed-for-method--placetogoorder)). ## Prossimi passi > **[Stock e disponibilità](/docs/it/guides/integrations/pos/lightspeed/stock-and-availability)** > > Tieni gli articoli esauriti fuori dal menu > **[Pay at Table](/docs/it/guides/integrations/pos/lightspeed/pay-at-table)** > > Bill, pagamenti e add-to-bill ## Related topics - [Stock e disponibilità Lightspeed](/docs/it/guides/integrations/pos/lightspeed/stock-and-availability.md) - [Ordini Toast e instradamento](/docs/it/guides/integrations/pos/toast/orders.md) - [Lightspeed K-Series](/docs/it/guides/integrations/pos/lightspeed/overview.md) - [Ordini falliti: cassa offline](/docs/it/guides/integrations/pos/lightspeed/till-offline.md) - [Collegare Lightspeed](/docs/it/guides/integrations/pos/lightspeed/connect.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.