ZVT-Schnittstelle: Unterschied zwischen den Versionen

Version vom 17. November 2023, 07:47 Uhr

(Hauptseite → Optionen → Schnittstellen → Sie sind auf der Seite: ZVT-Schnittstelle)

Auf dieser Seite erhalten Sie Informationen, wie Sie die ZVT-Schnittstelle einrichten und verwenden können.

Über diese Schnittstelle kann der Zahlbetrag an ein ZVT-fähiges Kartenterminal gesendet werden. Das Terminal informiert die Kasse über den Abschluss des Kartenzahlvorgangs.

Eine Übersicht über alle verfügbaren Schnittstellen erhalten Sie hier.

Freischaltung

Schnittstellen müssen beim Hersteller aktiviert werden. Sie werden durch einen Dialog zur Aktivierung aufgefordert, wenn Sie die Freischalttaste

rechts neben der roten Statusanzeige

einer bisher nicht aktivierten Schnittstelle anklicken^[1].

Aufrufen der Schnittstellenkonfiguration

Um die ZVT-Schnittstelle zu konfigurieren, muss zunächst die Schnittstellenkonfiguration aufgerufen werden:

Klicken Sie im Hauptmenü auf Optionen → Schnittstellen oder drücken Sie die Tastenkombination ⇑ + F12.
Der Dialog Schnittstellenverwaltung öffnet sich.
Klicken Sie auf ZVT.

Nun können Sie die ZVT-Schnittstelle konfigurieren.

Schnittstellenverwaltung, hier mit dem Register ZVT-Schnittstelle

Konfiguration

Um die Schnittstelle zu konfigurieren, müssen einige Informationen zusammengestellt werden.

Checkliste für das Kartenterminal

Für die Konfiguration werden Informationen benötigt, die der Kundendienst des Terminalherstellers bereitstellen muss:

====IP Adresse und Kommunikation

Wie lautet die IP-Adresse des Kartenterminals?
Wurde die IP-Adresse des Kartenterminals fest (also nicht DHCP) zugewiesen?

IP-Adresse muss fest eingestellt werden. Die IP-Adresse muss zwischen 192.168.xxx.101 und 192.168.xxx.149 eingestellt werden. Die IP-Adresse darf keinesfalls 192.168.xxx.1, 192.168.xxx.100, 192.168.xxx.200 oder 192.168.xxx.255 lauten

Auf welchen Kommunikationsport ist das Kartenterminal eingestellt?

Wenn der Port nicht bekannt gegeben wird, ist keine Verbindung zum Gerät möglich. Laut ZVT-Spezifikation soll der Port 20.007 (nicht 2.0007) verwendet werden.

Verbindungsparameter

Wie viele Millisekunden dauert es, bis das Terminal auf eine Verbindungsanfrage antwortet?
Wie viele Millisekunden dauert es, bis das Terminal auf eine Übertragung antwortet?
Wie viele Millisekunden dauert es, bis das Terminal eine Kartenzahlung abbricht?

Eine zu kurze Zeitvorgabe führt zu Problemen bei der Nutzung des Kartenterminals. Eine zu lange Zeitvorgabe zu langen Wartezeiten bei Störungen.

Authentifizierung

Ist ein Händlerpasswort notwendig?
Wenn ja: Wie lautet das Händlerpasswort?
Wenn nein: welcher Wert kann eingegeben werden, ohne dass es zu Fehlern kommt?

Das Standard-Passwort wird bei Auswahl eines Presets automatisch vergeben, ansonsten muss mindestens "0" eingegeben werden

Belegdruck

Ist der Händlerbelegdruck abschaltbar?
Ist der Kundenbelegdruck abschaltbar?

Die Auswahloptionen werden bei Auswahl eines Presets automatisch angepasst. Die Kasse kann die Zahlungsinformationen in den Kassenbon integrieren, ein separater Druck durch das Terminal ist dann nicht mehr notwendig. Der Abschluss kann ebenfalls ohne Händlerbeleg durchgeführt werden, da die Kasse alle Kartenzahlungen aufzeichnet und bei der Tagesabrechnung die Summe ausgibt.

Presets

Derzeit sind für die Schnittstellenparameter folgender Kartenterminals fertige Presets verfügbar:

Geräte von REA

Wenn Sie neue Kartenterminals oder einen neuen Zahlungsdienstleister suchen, empfehlen wir REA Card. Sprechen Sie uns an, um bei REA Card vergünstigte Konditionen zu erhalten!

Geräte von CCV
Geräte von Verifone
Geräte von Ingenico (Deutschland)

Akkreditierung in Arbeit:

Geräte von Telecash/Clover (Hinweis: Der Hersteller hat trotz anforderung keine Informationen übermittelt)
Geräte von Ingenico (für Schweiz)

Sollte kein passendes Preset verfügbar sein, kann die Eingabe der Schnittstellenparameter manuell erfolgen. Es kann jedoch keine Gewähr für eine einwandfreie Kommunikation zwscihen terminal und Kasse übernommen werden.

Schnittstellenparameter

Kommunikation

IP Adresse des Terminals
Kommunikationsport (Default: 20007)
Timeout Verbindung: Die Zeit, in der die Verbindung zum Gerät aufgebaut werden muss. (Default: 5.000ms)
Timeout Antwort: Die Zeit, in der das Gerät die Anfrage der Kasse beantwortet. (Default: 30.000ms)
Timeout Registration: Die Zeit, in der ein Zahlungsvorgang abgeschlossen werden muss. (Default: 60.000ms)

Belegdruck Die Kasse kann den Belegdruck des Terminals übernehmen, so dass Papier gespart wird. Die Angaben zur Zahlung werden dann auf dem Kassenbon gedruckt. Der Händlerbeleg kann ebenfalls ausgeschaltet werden.

Weiter zu VMP-Schnittstelle