Beta tecnica: L’integrazione è implementata e disponibile per test controllati prima dell’uso con incassi reali.
Questo connettore è esclusivamente per Lightspeed Retail X-Series, in precedenza Vend. Non è compatibile con Lightspeed Restaurant K-Series o Ikentoo.
Prerequisiti
- Un account Retail X-Series e il prefisso o URL attuale del negozio, per esempio https://mio-negozio.retail.lightspeed.app.
- Una Private App approvata con sales:read, users:read e payment_types:read. Un token personale è accettato solo per account legacy compatibili.
- 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
- Apri Configurazione > Integrazione > POS e seleziona Lightspeed Retail X-Series nella categoria Retail.
- In URL API inserisci il prefisso del negozio o il suo URL completo *.retail.lightspeed.app.
- Incolla il token della Private App in Chiave API. Non inviarlo tramite e-mail, screenshot o log di supporto.
- Salva la configurazione. ImaCash convalida negozio, token, utenti e tipi di pagamento sull’API reale prima di accettarla.
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 sincronizzazione è incrementale, paginata e limitata; dopo un limite 429 conserva il cursore e rispetta Retry-After.
Test obbligatorio prima della produzione
Verifica una vendita in contanti, una solo con carta, una mista, un rimborso e il ripristino dopo un’interruzione di rete o un 429. Controlla che una nuova sincronizzazione non crei duplicati.
