Beta tecnica: Guida verificata con la beta pubblicata di ImaCash 4.4.3.1528. Il connettore richiede una convalida controllata dell’installazione prima di gestire contanti; questa versione non è presentata come l’ultima stabile.
Questo connettore è esclusivamente per Lightspeed Retail X-Series, in precedenza Vend. Non è compatibile con Lightspeed Restaurant K-Series o Ikentoo.
Prerequisiti
- Confermare con il fornitore l’edizione Retail X-Series, l’accesso API e il prefisso o URL privato del negozio. Non usare un indirizzo Restaurant K-Series né il nome commerciale del negozio.
- Una Private App approvata dall’amministratore del negozio, con sales:read, users:read e payment_types:read. Lightspeed indica che le Private Apps sono disponibili nei piani Plus; verificare il proprio account. I token personali restano un’opzione precedente per gli account che li accettano ancora.
- Uscita HTTPS sulla porta 443 verso *.retail.lightspeed.app. Non sono richieste porte in ingresso né accesso a un database locale.
- Un tipo di pagamento in contanti attivo. ImaCash importa solo le vendite già chiuse in Lightspeed.
Configurazione in ImaCash
- Aprire Configurazione > Integrazione > POS e scegliere Lightspeed Retail X-Series. Retail ne descrive il settore; non occorre un altro selettore con questo nome. L’account ImaCash deve consentire di consultare e modificare la configurazione.
- In URL API inserire il prefisso o URL HTTPS del negozio che termina con retail.lightspeed.app. Un vecchio URL vendhq.com viene adattato al dominio attuale. Non inserire percorsi di database né URL di altri prodotti.
- In Chiave API inserire il token privato dell’applicazione approvata. Non è la password di ImaCash né un identificativo di cassa. Non pubblicarlo e non inviare schermate contenenti il valore; verificarne la validità con il responsabile del negozio.
- Durante la convalida di impostazioni nuove o modificate, ImaCash legge tipi di pagamento e utenti tramite API; deve riconoscere almeno un tipo di contanti. Salvare senza modifiche può riutilizzare la convalida precedente. Un esito positivo non prova letture complete, filtri o contanti reali. Il salvataggio generale ha più fasi: uscire o annullare dopo non ripristina quanto già salvato; riaprire e verificare. Il permesso e la lettura delle vendite vengono verificati alla prima sincronizzazione, non caricando gli utenti. Usare il riavvio solo quando proposto dal riepilogo della configurazione.
Funzionamento e ambito
- Le vendite in contanti vengono importate per il loro importo in contanti; le vendite solo con carta vengono ignorate.
- Per un pagamento misto viene importata solo la parte in contanti. Gli importi negativi in contanti sono trattati come rimborsi.
- La beta è di sola lettura: non conferma pagamenti e non modifica vendite in Lightspeed.
- La lettura a pagine copre al massimo le ultime due ore, con due minuti di sovrapposizione e almeno quindici secondi tra richieste. Un errore o lotto incompleto non fa avanzare la sincronizzazione. Se Lightspeed limita le richieste, rispettare il tempo indicato. Un’interruzione lunga può lasciare vendite fuori dalla finestra e richiede verifica.
Ambito di negozi e utenti
I filtri utente agiscono sulla vista locale di ImaCash; non limitano l’accesso della Private App e non vengono inviati all’API. Viene caricato il catalogo dei venditori, ma non elenchi di negozi o casse. I riferimenti della vendita non provano l’isolamento tra negozi. Verificare l’ambito dell’account e di ogni postazione durante la convalida supervisionata.
Conferme ed esiti incerti
Confermare in ImaCash non scrive un pagamento, una chiusura o un annullamento in Lightspeed. Una vendita chiusa contiene già pagamenti registrati nel POS. La sua comparsa in ImaCash non prova la consegna di contanti e non autorizza un secondo addebito. Verificare riferimenti, stato e contanti reali prima di ripetere, risincronizzare o riavviare.
Cosa non comprende questo connettore
Non sincronizza articoli, scorte, turni né ricerche di scontrini tramite EAN. Non importa vendite solo con carta né un totale bancario indipendente. Il token è fornito in privato; non è disponibile un rinnovo OAuth automatico guidato. La guida iKentoo riguarda Restaurant K-Series e resta separata. Sola lettura si riferisce all’API Lightspeed: il normale circuito di ImaCash può azionare una macchina per la gestione dei contanti.
Test obbligatorio prima della produzione
Prima dell’uso commerciale, concordare con il fornitore una prova supervisionata di contanti, carta, pagamento misto, rimborso e ripristino della connessione. Verificare riferimenti ed esiti reali nei due sistemi. Guida, codice e connessione riuscita non dimostrano tale convalida.