Technische Beta: Anleitung anhand der veröffentlichten ImaCash-Beta 4.4.3.1528 geprüft. Der Konnektor erfordert eine kontrollierte Prüfung Ihrer Installation vor der Bargeldverwaltung. Diese Version wird nicht als neueste stabile Ausgabe dargestellt.
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
- Bestätigen Sie mit dem Anbieter die Retail X-Series-Ausgabe, den API-Zugang und das private Präfix oder die URL des Geschäfts. Verwenden Sie weder eine Restaurant K-Series-Adresse noch den Handelsnamen des Geschäfts.
- Eine vom Geschäftsadministrator genehmigte Private App mit sales:read, users:read und payment_types:read. Lightspeed nennt Private Apps als Bestandteil der Plus-Tarife; prüfen Sie Ihr Konto. Persönliche Tokens sind eine ältere Option für Konten, die sie noch unterstützen.
- 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. Retail beschreibt den Bereich; ein weiterer gleichnamiger Auswahlschritt ist nicht erforderlich. Ihr ImaCash-Konto muss die Konfiguration aufrufen und ändern dürfen.
- Geben Sie unter API-URL das Geschäftspräfix oder die HTTPS-URL mit der Endung retail.lightspeed.app ein. Eine ältere vendhq.com-URL wird an die aktuelle Domain angepasst. Geben Sie keinen Datenbankpfad und keine URL eines anderen Produkts ein.
- Geben Sie unter API-Schlüssel das private Token der genehmigten Anwendung ein. Es ist weder das ImaCash-Passwort noch eine Kassenkennung. Veröffentlichen Sie den Wert nicht und versenden Sie keine entsprechenden Screenshots. Lassen Sie die Gültigkeit vom Geschäftsverantwortlichen bestätigen.
- Bei der Prüfung neuer oder geänderter Einstellungen liest ImaCash Zahlungsarten und Benutzer über die API. Mindestens eine Bargeldart muss erkannt werden. Unverändertes Speichern kann die vorherige Prüfung wiederverwenden. Erfolg belegt weder vollständige Abfragen noch Filter oder echtes Bargeld. Das allgemeine Speichern hat mehrere Phasen. Späteres Verlassen oder Abbrechen macht gespeicherte Änderungen nicht rückgängig; öffnen und prüfen Sie die Einstellungen erneut. Verkaufsberechtigung und Abfrage werden erst bei der ersten Synchronisierung geprüft, nicht beim Laden der Benutzer. Nutzen Sie einen Neustart nur, wenn die Konfigurationsübersicht ihn anbietet.
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 seitenweise Abfrage umfasst höchstens die letzten zwei Stunden mit zwei Minuten Überlappung und mindestens fünfzehn Sekunden zwischen Anfragen. Fehler oder unvollständige Stapel verschieben die Synchronisierung nicht. Bei einer Begrenzung durch Lightspeed gilt die angegebene Wartezeit. Eine lange Unterbrechung kann Verkäufe außerhalb des Fensters lassen und erfordert eine Prüfung.
Umfang von Geschäften und Benutzern
Benutzerfilter betreffen die lokale ImaCash-Ansicht. Sie schränken den Zugriff der Private App nicht ein und werden nicht an die API gesendet. Das Verkäuferverzeichnis wird geladen, Geschäfts- und Kassenlisten jedoch nicht. Verkaufsreferenzen belegen keine Trennung zwischen Geschäften. Prüfen Sie Konto- und Arbeitsplatzumfang bei der beaufsichtigten Validierung.
Bestätigungen und ungewisse Ergebnisse
Eine Bestätigung in ImaCash schreibt keine Zahlung, keinen Abschluss und keine Stornierung in Lightspeed. Ein abgeschlossener Verkauf enthält bereits im POS erfasste Zahlungen. Seine Anzeige in ImaCash belegt keine Bargeldübergabe und erlaubt keine erneute Berechnung. Prüfen Sie Referenzen, Status und tatsächliches Bargeld vor Wiederholung, erneuter Synchronisierung oder Neustart.
Was dieser Konnektor nicht umfasst
Er synchronisiert weder Artikel, Bestand oder Schichten noch Belegsuche per EAN. Reine Kartenverkäufe und eine unabhängige Banksumme werden nicht importiert. Das Token wird privat bereitgestellt; ein Assistent zur automatischen OAuth-Erneuerung fehlt. Die iKentoo-Anleitung gehört zu Restaurant K-Series und bleibt getrennt. Nur lesend bezieht sich auf die Lightspeed-API: Der normale ImaCash-Ablauf kann eine Bargeldmaschine betätigen.
Verpflichtender Test vor dem Produktiveinsatz
Vereinbaren Sie vor dem kommerziellen Einsatz einen beaufsichtigten Test mit Bargeld, Karte, gemischter Zahlung, Erstattung und Wiederherstellung der Verbindung. Prüfen Sie Referenzen und tatsächliche Ergebnisse in beiden Systemen. Anleitung, Code und eine erfolgreiche Verbindung belegen diese Validierung nicht.