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
- Öffnen Sie Konfiguration > Integration und wählen Sie Open POS NG (Avalon) - Beta.
- Geben Sie unter ODBC-Name den exakten Namen des x86-System-DSN ein. Benutzername und Kennwort sind nur erforderlich, wenn sie nicht vom DSN verwaltet werden.
- 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
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.