Quelltext der Seite OBS/Kasse/OBS-Kasse mit EC-Terminal

{{Vorlage:Kasse}}


=OBS-Kasse mit EC-Terminal=
Sie können an der OBS-Kasse ein EC-Terminal verwenden. 

==Voraussetzungen==
Damit die Verbindung zwischen OBS-Kasse und dem EC-Terminal funktioniert muss dieses mit der [[http://www.easyzvt.de/ EasyZVT Schnittstelle]] kompatibel sein. Im folgenden sehen Sie die bisher mit dieser Schnittstelle getesteten EC-Terminals:<br/>
[[IMAGE:ZVTTerminals.jpg|500px|© Groetzner Unternehmensberatung]]

==Einstellungen am EC-Gerät==
{{Hinweis|'''IP-Anschluss:''' Das EC-Terminal sollte im IP Modus betrieben werden (nicht Seriell). Dies muss im EC-Gerät selbst eingestellt werden.}} <br>
{{Achtung|'''Serieller Anschluss:''' Die EasyZVT-Schnittstelle bietet mittlerweile auch die Möglichkeit das EC-Gerät seriell anzuschließen (z.B. per USB).<br>
Wir übernehmen keine Garantie für die Funktionaltität der Schnittstelle per seriellem Anschluss. Anfallender Support wird kostenpflichtig behandelt.<br>
Wir empfehlen ganz klar die Nutzung im IP-Modus. ''Stand 02.02.2022''}}

Im Folgenden erhalten Sie Anleitungen zu einzelnen Geräten. Wir können keine Garantie für die Vollständigkeit an diesen Anleitungen nehmen, da diese je nach Version vom Gerät auch abweichen können. Wenden Sie sich bei Problemen bitte an Ihre Bank. 

<div class="mw-collapsible mw-collapsed" style="width:100%">
<div class="mw-collapsible-toggle" style="float:none; cursor:pointer;
     background:#eee; padding:4px 8px; border-radius:4px; display:inline-block">
▶ Ingenico Move 5000</div>
<div class="mw-collapsible-content">
===Ingenico Move 5000===
Ingenico Move 5000 mit OBS-Kassensystem verbinden
====Schritt 1 - WLAN====
WLAN-Verbindung prüfen
Schauen Sie auf das WLAN-Symbol oben links am Terminal-Display. Wird dieses grün dargestellt ist das Gerät mit dem WLAN verbunden. 

Ist das Gerät mit dem WLAN verbunden können Sie nun mit Schritt 2 fortfahren. Anderfalls können Sie wie folgt das Gerät in Ihr WLAN integrieren: 
#F-Taste drücken → Hauptmenü öffnet sich
#Einstellungen wählen
#Kassierer-PIN eingeben (Werkseinstellung: 1 2 3 4 5)
#Verbindungen wählen
#Runterscrollen zu DFÜ-Assistent
#WLAN wählen und die weiteren Schritte zur WLAN-Verbindung durchführen


====Schritt 2 - IP Adresse ermitteln====
Ermitteln Sie wie folgt Ihre IP-Adresse: 

#F-Taste drücken → Einstellungen → Kassierer-PIN eingeben (1 2 3 4 5)
#Verwaltung wählen
#Runterscrollen zu System Info anzeigen
#In der Systeminfo scrollen bis zum Abschnitt „IP Network" → Unterpunkt „Wifi Interface"
#Die IP-Adresse steht unter „IP-Adr." Notieren Sie sich diese bitte.


====Schritt 3 - Verbindungsart einstellen====
#F-Taste → Einstellungen → Kassierer-PIN eingeben
#Verbindungen wählen
#Verbindungsart → Kasse
#Modus → TCP/IP
#Netzwerk → Ethernet/WLAN
#Host/IP-Adresse prüfen, diese sollte auf 127.0.0.1 stehen.
#TCP-Port auf ''5577'' setzen und diesen notieren

====Schritt 4 - ZVT Modus und Initialisierung====
Falls das Terminal nicht für ZVT konfiguriert ist (ist es in der Regel bei Ersteinrichtung nicht):
#Die Technikernummer beim Netzbetreiber-Hotline erfragen und Support Hotline anrufen. Techniker-Passwort erfragen und bei der Gelegenheit ein mal nachfragen, ob das Gerät initialisiert worden ist. 
#F-Taste → Einstellungen → Kassierer-PIN eingeben
#Terminal wählen
#Betriebsart wählen
#Betriebsart auf ''ZVT 700'' einstellen

</div>
</div>

==Kassen Programmparameter konfigurieren==
Diese Parameter können nur durch den OBS - Support eingestellt werden!

*074  auf J
*076  auf J (Wenn Ausdruck auf OBS Kassen-Bon)
*077 Token Trenner für Beleg Kunde / Händler

==ZVT INI Einstellung==
Über die [[OBS/Stammdaten/Programmparameter|Programmparameter]] gelangen Sie zu den [[OBS/Stammdaten/Programmparameter/INI Definition|INI Definitionen]]. Sollte noch kein Eintrag mit dem Namen '''ZVT''' vorhanden sein, muss dieser angelegt werden. Hier müssen folgende Parameter pro EC-Terminal eingetragen werden. 
Jede PC Nummer aus der [[OBS/Weitere Stammdaten/Weitere Stammdaten: PC Verwaltung | PC Verwaltung]] der Kasse kann andere Einstellungen bekommen

<syntaxhighlight lang="ini">
-----------------------------------------------------
[001]

IOMODE=IP

IP=192.168.0.1
TermID=12345678
Lizenz=XXXXXX-XXXXXXXX
Port=22000
PASS=12345

DEBUG=False
DEBUGCMD=False
DEBUGFILE=False
-----------------------------------------------------
</syntaxhighlight> 

{| class="wikitable"
|-
! INI Parameter !! Beschreibung
|-
| [XXX] || PC Nummer der Kasse (siehe:[[OBS/Weitere Stammdaten/Weitere Stammdaten: PC Verwaltung | PC Verwaltung]])
|-
| IOMODE || Muss immer '''IP''' sein
|-
| IP || IP Adresse des EC-Terminals
|-
| TermID || TermID steht auf dem EC-Terminal
|-
| Lizenz || Lizen wird von Bergau vergeben (Passwortverwaltung)
|-
| Port || Port des EC-Terminals 
|-
| PASS || Passwort des EC-Terminals 
|-
| DEBUG|| Nur für den Support (Standard = '''False''') 
|-
| DEBUGCMD||Nur für den Support (Standard = '''False''')
|-
| DEBUGFILE|| Nur für den Support (Standard = '''False''')
|}

==Protokolle==
===ZVT Protokolle===
Beim Verwenden des EC-Terminals in OBS-Kasse wird ein Protokoll angelegt. Dieses befindet sich in folgendem Ordner: 
 ..\OBS\DATA\ZVT\'''TermID'''\

===ZVT Debug Modus===
Ist dieser aktiviert wird ein ausführliches Debug Protokoll im folgenden Ordner angelegt:
 ..\OBS\DATA\DEBUG\ZVT_Debug.txt 

===Bon Protokoll des Terminals===
'''. \obs\DATA\debug\ZVTDruck.txt'''

 * *  Händlerbeleg  * *
 Ernst Bergau GmbH
 Am Steinkamp 17
 21684 Stade
 Tel.: 0 41 41 / 88 81 8
 www.bergau.de
  
 Datum 11.06.15 02:52 Uhr
 Beleg-Nr.           0034
 Trace-Nr.         000101
  
 Kartenzahlung
 girocard
 Nr.
 67252403000000xxxxx 0008
 gültig bis         12/15
 VU-Nr.        800020xxxx
 Terminal-ID     5204xxxx
 Pos-Info       00 053 00
 Weitere Daten 0000000000
 /E800////440xxx
 Betrag EUR          0,01
  
 Autorisierung erfolgt
  
  
 Bitte Beleg aufbewahren
  
 * *  Kundenbeleg  * *
 Ernst Bergau GmbH
 Am Steinkamp 17
 21684 Stade
 Tel.: 0 41 41 / 88 81 8
 www.bergau.de
  
 Datum 11.06.15 02:52 Uhr
 Beleg-Nr.           0034
 Trace-Nr.         000101
  
 Kartenzahlung
 girocard
 Nr.
 ###############6523 0008
 VU-Nr.        800020xxxx
 Terminal-ID     5204xxxx
 Pos-Info       00 053 00
 Weitere Daten 0000000000
 /E800////440xxx
 Betrag EUR          0,01
  
 Autorisierung erfolgt
  
  
 Bitte Beleg aufbewahren
==Test-Modus==
Über den Menüpunkt [Support → ZVT-Admin] kann ein Test-Modus für EC-Module aktiviert werden. Hierbei kann über ''Diagnose'' geprüft werden, ob eine Verbindung aufgebaut werden kann. 

[[Datei:ZVT Admin.png|rahmenlos|421x421px]] 
==Mögliche Fehler im ZVT Log==
===Timeout nach Anmeldung mit Passwort===
Ein Timeout nach der Anmeldung mit Passwort deutet auf ein falsches Passwort hin. 
 01.01.20 15:56:51.248 Anmeldung mit Passwort xxxxxx
 01.01.20 15:56:51.264 Timeout 20 s
===Socketfehler beim Verbinden===
Ein Socketfehler deutet daraufhin, dass die Verbindung von einer Firewall geblockt wird.
 01.01.20 11:17:17.051 Prüfe LAN auf 192.168.0.1
 01.01.20 11:17:17.082 Timeout 20 s
 01.01.20 11:17:18.207 Socketfehler beim Verbinden: Es konnte keine Verbindung hergestellt werden, da der Zielcomputer die Verbindung verweigerte 192.168.0.1:22000
 01.01.20 11:17:18.410 Application Exit
===Fehler Lizenzupdate: Timeout für Vorgang überschritten===
Es ist eine Online-Aktivierung der EasyZVT-Lizenz per Internet erforderlich. Diese Meldung deutet darauf hin, dass am entsprechenden PC die Verbindung zu http://www.easyzvt.de durch eine Firewall blockiert wird. Es muss ein Zugriff auf die Website direkt per http ohne Proxy möglich sein. Auch wenn die Seite über den Webbrowser aufrufbar ist, kann es sein, dass der Virenscanner den Aufruf im Livebetrieb blockt, da der Aufruf durch die EasyZVT.exe im Hintergrund läuft. Im Zweifelsfall sollte der Virenscanner also temporär ausgeschaltet werden. Wenn die Lizenzaktivierung dann läuft, muss im Virenscanner eine entsprechende Ausnahme hinzugefügt werden.

 09.08.21 14:27:31.434 Prüfe Lizenzschlüssel XXXXXX-XXXXXXXX
 09.08.21 14:27:31.434 Aktiviere Terminal
 09.08.21 14:27:32.651 Fehler Lizenzupdate: Timeout für Vorgang überschritten
 09.08.21 14:27:33.468 Aktivierung ist fehlgeschlagen, bitte Internetverbindung prüfen
 09.08.21 14:27:34.490 Fehler Lizenzupdate: Timeout für Vorgang überschritten
 09.08.21 14:27:34.553 Application Exit
 09.08.21 14:27:34.568 Disconnect

===TCP Receive Exception===
Wenn ein TCP Receive Exception Fehler kommt, wurde die Erstinitialisierung des Gerätes nicht durchgeführt. In diesem Fall muss der Support des EC-Gerätes angerufen werden. 

 28.08.26 12:50:19.965 ------- Anmeldung async -------
 28.08.26 12:50:19.997 Receive TCP Timeout 20 s
 28.08.26 12:50:40.062 TCP Receive Exception. Von der Übertragungsverbindung können keine Daten gelesen werden: Ein Verbindungsversuch ist fehlgeschlagen, da die Gegenstelle nach einer bestimmten Zeitspanne nicht richtig reagiert hat, oder die hergestellte Verbindung war fehlerhaft, da der verbundene Host nicht reagiert hat.
 28.08.26 12:50:40.078 Disconnect
 28.08.26 12:50:40.099 Fehler beim Senden des Befehls
 28.08.26 12:50:40.110 Resultat der Anmeldung: VERBINDUNGSFEHLER
 28.08.26 12:50:40.204 Application Exit
 28.08.26 13:11:48.230 ------------------------------------------------------------------------------------

==Weitere Einstellungen==
Weitere Informationen gibt es hier: [[https://wiki.bergau.de/OBS/Adminhilfe/Diverses#ZVT|ZVT Admin Hilfe]]