Ordini e instradamento Lightspeed

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

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.

​

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.
• 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.

Sugli ordini in-store, storekit invia anche il numero di portata 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.

​

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.

​

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à.

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.

​

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 #<order number> for store: <store name> 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. 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), “…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) 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).

​

Prossimi passi