Bêta technique: Guide vérifié avec la bêta publiée d’ImaCash 4.4.3.1528. Le connecteur exige une validation contrôlée de votre installation avant de gérer des espèces ; cette version n’est pas présentée comme la dernière stable.
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
- Confirmez avec le fournisseur l’édition Retail X-Series, l’accès API et le préfixe ou l’URL privée du magasin. N’utilisez ni une adresse Restaurant K-Series ni le nom commercial du magasin.
- Une Private App approuvée par l’administrateur du magasin, avec sales:read, users:read et payment_types:read. Lightspeed indique que les Private Apps sont disponibles avec les offres Plus ; confirmez votre compte. Les jetons personnels restent une option historique pour les comptes qui les acceptent encore.
- 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. Retail décrit son secteur ; aucun sélecteur supplémentaire de ce nom n’est nécessaire. Votre compte ImaCash doit pouvoir consulter et modifier la configuration.
- Dans URL de l’API, saisissez le préfixe ou l’URL HTTPS du magasin se terminant par retail.lightspeed.app. Une ancienne URL vendhq.com est adaptée au domaine actuel. Ne saisissez ni chemin de base de données ni URL d’un autre produit.
- Dans Clé API, saisissez le jeton privé de l’application approuvée. Ce n’est ni le mot de passe ImaCash ni un identifiant de caisse. Ne le publiez pas et ne l’envoyez pas dans une capture ; faites confirmer sa validité par le responsable du magasin.
- Lors de la validation de paramètres nouveaux ou modifiés, ImaCash lit les modes de paiement et les utilisateurs via l’API ; au moins un mode espèces doit être reconnu. Enregistrer sans changement peut réutiliser la validation précédente. Un succès ne prouve ni lecture complète, ni filtrage, ni espèces réelles. L’enregistrement général comporte plusieurs étapes : quitter ou annuler ensuite ne rétablit pas ce qui a été enregistré ; rouvrez et vérifiez. Le droit et la lecture des ventes sont vérifiés à la première synchronisation, pas lors du chargement des utilisateurs. Utilisez le redémarrage uniquement si le récapitulatif de configuration le propose.
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 lecture paginée couvre au maximum les deux dernières heures, avec deux minutes de recouvrement et au moins quinze secondes entre requêtes. Un échec ou un lot incomplet ne fait pas avancer la synchronisation. Si Lightspeed limite les requêtes, respectez le délai indiqué. Une longue interruption peut laisser des ventes hors de la fenêtre et demande une vérification.
Périmètre des magasins et utilisateurs
Les filtres utilisateur agissent sur la vue locale d’ImaCash ; ils ne restreignent pas l’accès de la Private App et ne sont pas envoyés à l’API. Le catalogue des vendeurs est chargé, mais pas de listes de magasins ou de caisses. Les références des ventes ne prouvent pas l’isolation des magasins. Vérifiez le périmètre du compte et de chaque poste lors de la validation supervisée.
Confirmations et résultats incertains
Confirmer dans ImaCash n’écrit aucun paiement, clôture ou annulation dans Lightspeed. Une vente clôturée contient déjà des paiements enregistrés dans le POS. Son apparition dans ImaCash ne prouve pas la remise d’espèces et n’autorise pas à la facturer à nouveau. Vérifiez références, état et espèces réelles avant de répéter, resynchroniser ou redémarrer.
Ce que ce connecteur ne comprend pas
Il ne synchronise ni articles, ni stock, ni sessions de caisse, ni recherche de tickets par EAN. Il n’importe pas les ventes uniquement par carte ni un total bancaire indépendant. Le jeton est fourni en privé ; aucun assistant ne renouvelle automatiquement OAuth. Le guide iKentoo concerne Restaurant K-Series et reste distinct. La lecture seule concerne l’API Lightspeed : le circuit normal d’ImaCash peut actionner une machine de gestion des espèces.
Test obligatoire avant la production
Avant l’usage commercial, convenez avec le fournisseur d’un essai supervisé : espèces, carte, paiement mixte, remboursement et reprise de connexion. Vérifiez les références et les résultats réels dans les deux systèmes. Le guide, le code et une connexion réussie ne prouvent pas cette validation.