Technische Beta: Für eine erste kontrollierte Validierung mit einer realen Open POS NG Installation steht ein schreibgeschützter ODBC-Konnektor bereit. Er darf erst nach Abschluss der Testmatrix für echte Bargeldvorgänge aktiviert werden.
Voraussetzungen
ImaCash muss unter Windows ausgeführt werden und den lokalen Open POS NG Server erreichen. Erstellen Sie einen 32-Bit-ODBC-System-DSN mit dem von der Installation verwendeten Datenbanktreiber und einem schreibgeschützten Konto mit SELECT-Berechtigung auf eine von Avalon oder dem POS-Betreuer bereitgestellte Transaktionstabelle oder -ansicht.
Konfiguration in ImaCash
- Öffne im Hauptfenster Konfiguration > Integration > POS und wähle Open POS NG (Avalon) - Beta. Verwende die von ImaCash verlangte autorisierte Anmeldung.
- Trage unter ODBC name den genauen Namen des vom Verantwortlichen vorbereiteten 32-Bit-System-DSN ein. Er muss unter dem Windows-Konto funktionieren, das ImaCash ausführt, ohne einen weiteren Anmeldedialog. Benutzer und Passwort sind private Angaben; fülle sie nur aus, wenn die DSN-Konfiguration sie verlangt.
- Geben Sie unter Verkaufstabelle oder -ansicht die exakt freigegebene Quelle mit einer Zeile je Vorgang oder Zahlungsart an; niemals eine Artikeltabelle, die den Beleggesamtbetrag wiederholt. Verwenden Sie bei Bedarf schema.tabelle. ImaCash sucht oder wählt keine anderen Quellen aus.
Explizite, verbindliche Spaltenzuordnung
Trage den vom Verantwortlichen bestätigten Vertrag unter Spaltenzuordnung ein. Namen und Werte im folgenden Beispiel veranschaulichen die Syntax; sie beschreiben nicht das Schema jeder Open-POS-NG-Installation. Füge hier keine Verbindungszeichenfolge, Passwörter oder Verkaufsdaten ein.
Definieren Sie die Spaltenzuordnung immer mit durch Semikolon getrennten Paaren; ImaCash behandelt sie als verbindlichen Vertrag und errät keine Spalten. Sie muss dateonly=true|false enthalten: true bedeutet, dass date eine DATE-Spalte ohne Uhrzeit ist, und erlaubt time zusammen mit dateonly=true; false bedeutet, dass date bereits Datum und Uhrzeit enthält. Zum Beispiel: id=ID;date=DATUM;dateonly=true;time=ZEIT;cash=BARGELDBETRAG;operator=BEDIENER;terminal=KASSE. Der cash-Vertrag akzeptiert genau einen konsistenten Betrag pro ID und schlägt sicher fehl, wenn dieselbe ID mit unterschiedlichen Werten wiederholt wird. Für Zahlungszeilen verwenden Sie amount=ZAHLUNGSBETRAG;payment=ZAHLUNGSART;cashvalue=BAR|CASH. Falls Bezeichner Begrenzungszeichen benötigen, ergänzen Sie quote=none|double|bracket|backtick; none ist die Voreinstellung.
Verbindliche Abschlussbedingung
Konfigurieren Sie eine dieser beiden Optionen: eine Ansicht, die ausschließlich endgültige Verkäufe enthält, zusammen mit finalonly=true; oder status=STATUS;closedvalue=GESCHLOSSEN|BEZAHLT;modified=GEAENDERT_AM, um geschlossene Zustände zu filtern und verspätete Abschlüsse abzurufen. Beim Vertrag amount+payment mit status+modified kennzeichnet modified die Änderung des Verkaufs: ImaCash ermittelt zuerst die geänderten IDs und ruft danach alle zugehörigen Zeilen ab, bevor das Bargeld summiert wird. Dadurch wird die teilweise Erfassung einer gemischten Zahlung vermieden. Ohne einen dieser Verträge schlägt die Integration sicher fehl.
Umfang dieser Beta
Die Integration liest aktuelle Vorgänge und übergibt ausschließlich Bargeld an ImaCash, darunter nur den Bargeldanteil gemischter Zahlungen und Erstattungen mit negativem Vorzeichen. Sie arbeitet strikt schreibgeschützt: Sie ändert Open POS NG nie und schreibt keine Bestätigungen, Zustände, Zahlungen oder Stornierungen nach Avalon.
Konfiguration speichern und prüfen
Beim Schließen der Konfiguration mit Änderungen kannst du speichern, weiterbearbeiten oder ohne Speichern der ausstehenden Änderungen beenden. Das Speichern erfolgt in Phasen: Ein späterer Fehler macht bereits gespeicherte Phasen nicht rückgängig. Das Öffnen des DSN und die Prüfung von Quelle und Zuordnung belegen nur diesen Lesezugriff; sie bestätigen keine vollständige Erfassung, Zahlung oder Gerätefunktion.
Filter, Verlauf und Erstprüfung
Die Filter für Kasse und Bediener benötigen die Zuordnungsspalten terminal beziehungsweise operator. Prüfe Auswahl und Aktivierung unter Einstellungen > Filter. Die Abfrage verwendet ein aktuelles Zeitfenster von höchstens zwei Stunden; eine Neusynchronisierung garantiert keine Wiederherstellung des gesamten Verlaufs. Diese Beta importiert weder Artikel, Bestände und Schichten noch eine gesonderte Kartensumme.
Vor dem gewerblichen Einsatz muss der Verantwortliche in einer realen Installation einen Barverkauf, eine gemischte Zahlung, eine Erstattung, einen verspäteten Abschluss und die Fortsetzung nach einem Neustart einschließlich der Vermeidung von Duplikaten prüfen. Ein Test mit fiktiven Daten oder eine erfolgreiche Verbindung schließt diese Prüfung nicht ab. Prüfe bei einem ungewissen Ergebnis Beleg und tatsächliches Bargeld, bevor du wiederholst, neu synchronisierst oder neu startest.
Konfiguration, Speichern und Beenden im ImaCash-Handbuch nachlesen