Bêta technique: L’intégration est implémentée et disponible pour des essais contrôlés avant toute utilisation avec des encaissements réels.
Ce connecteur est exclusivement destiné à Lightspeed Retail X-Series, anciennement Vend. Il n’est pas compatible avec Lightspeed Restaurant K-Series ni avec Ikentoo.
Prérequis
- Un compte Retail X-Series et le préfixe ou l’URL actuelle de la boutique, par exemple https://ma-boutique.retail.lightspeed.app.
- Une Private App approuvée avec les droits sales:read, users:read et payment_types:read. Un jeton personnel n’est accepté que pour les anciens comptes compatibles.
- Une sortie HTTPS sur le port 443 vers *.retail.lightspeed.app. Aucun port entrant ni accès à une base locale n’est requis.
- Un mode de paiement en espèces actif. ImaCash importe uniquement les ventes déjà clôturées dans Lightspeed.
Configuration dans ImaCash
- Ouvrez Configuration > Intégration > POS et sélectionnez Lightspeed Retail X-Series dans la catégorie Commerce de détail.
- Dans URL de l’API, saisissez le préfixe de la boutique ou son URL complète *.retail.lightspeed.app.
- Collez le jeton de la Private App dans Clé API. Ne l’envoyez jamais par e-mail, capture d’écran ou journal de support.
- Enregistrez la configuration. ImaCash valide la boutique, le jeton, les utilisateurs et les modes de paiement auprès de l’API réelle avant de l’accepter.
Fonctionnement et périmètre
- Les ventes en espèces sont importées pour leur montant en espèces ; les ventes uniquement par carte sont ignorées.
- Pour un paiement mixte, seule la part en espèces est importée. Les montants négatifs en espèces sont traités comme des remboursements.
- La bêta est en lecture seule : elle ne confirme aucun paiement et ne modifie aucune vente dans Lightspeed.
- La synchronisation est incrémentale, paginée et bornée ; après une limite 429, elle conserve le curseur et respecte Retry-After.
Test obligatoire avant la production
Validez une vente en espèces, une vente uniquement par carte, une vente mixte, un remboursement et la reprise après une coupure réseau ou une erreur 429. Vérifiez qu’une nouvelle synchronisation ne crée aucun doublon.
