Technische Beta: Die Integration ist implementiert und für kontrollierte Tests verfügbar, bevor sie für reale Barzahlungen eingesetzt wird.
Dieser Connector ist ausschließlich für Lightspeed Retail X-Series, früher Vend, vorgesehen. Er ist nicht mit Lightspeed Restaurant K-Series oder Ikentoo kompatibel.
Voraussetzungen
- Ein Retail X-Series-Konto und das aktuelle Präfix oder die URL des Shops, zum Beispiel https://mein-shop.retail.lightspeed.app.
- Eine genehmigte Private App mit sales:read, users:read und payment_types:read. Ein persönlicher Token wird nur für kompatible ältere Konten akzeptiert.
- Ausgehendes HTTPS über Port 443 zu *.retail.lightspeed.app. Eingehende Ports oder Zugriff auf eine lokale Datenbank sind nicht erforderlich.
- Eine aktive Barzahlungsart. ImaCash importiert nur Verkäufe, die in Lightspeed bereits abgeschlossen sind.
Konfiguration in ImaCash
- Öffnen Sie Konfiguration > Integration > POS und wählen Sie Lightspeed Retail X-Series in der Kategorie Einzelhandel.
- Geben Sie unter API-URL das Shop-Präfix oder die vollständige URL *.retail.lightspeed.app ein.
- Fügen Sie den Private-App-Token unter API-Schlüssel ein. Senden Sie ihn nicht per E-Mail, Screenshot oder Supportprotokoll.
- Speichern Sie die Konfiguration. ImaCash prüft Shop, Token, Benutzer und Zahlungsarten gegen die echte API, bevor die Konfiguration akzeptiert wird.
Verhalten und Umfang
- Barverkäufe werden mit ihrem Baranteil importiert; reine Kartenzahlungen werden ignoriert.
- Bei gemischten Zahlungen wird nur der Baranteil importiert. Negative Barbeträge werden als Rückerstattungen behandelt.
- Die Beta ist schreibgeschützt: Sie bestätigt keine Zahlungen und ändert keine Verkäufe in Lightspeed.
- Die Synchronisierung ist inkrementell, paginiert und begrenzt; nach einem 429-Limit behält sie den Cursor und beachtet Retry-After.
Verpflichtender Test vor dem Produktiveinsatz
Prüfen Sie einen Barverkauf, einen reinen Kartenverkauf, eine gemischte Zahlung, eine Rückerstattung und die Wiederaufnahme nach Netzwerkausfall oder 429. Stellen Sie sicher, dass eine wiederholte Synchronisierung keine Duplikate erzeugt.
