ZVT-Schnittstelle: Unterschied zwischen den Versionen

Aus FAKTURA-X Wiki
Zur Navigation springen Zur Suche springen
(Die Seite wurde neu angelegt: „{{WL|Hauptseite|Optionen|Schnittstellen}} Auf dieser Seite erhalten Sie Informationen, wie Sie die ZVT-Schnittstelle einrichten und verwenden können. Über…“)
 
 
(25 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 13: Zeile 13:
==Aufrufen der Schnittstellenkonfiguration==
==Aufrufen der Schnittstellenkonfiguration==
Um die ZVT-Schnittstelle zu konfigurieren, muss zunächst die Schnittstellenkonfiguration aufgerufen werden:
Um die ZVT-Schnittstelle zu konfigurieren, muss zunächst die Schnittstellenkonfiguration aufgerufen werden:
#Klicken Sie im Hauptmenü auf {{Menü|Optionen}} &rarr; {{Menü|Schnittstellen}} oder drücken Sie die Tastenkombination <kbd class="light">&uArr;</kbd> + <kbd class="light">F12</kbd>.
#Klicken Sie im Hauptmenü auf {{Menü|Optionen}} &rarr; {{Menü|Schnittstellen}} oder drücken Sie die Tastenkombination <kbd class="light">&uArr;</kbd> + <kbd class="light">F12</kbd>.
#Der Dialog ''Schnittstellenverwaltung'' öffnet sich.
#Der Dialog ''Schnittstellenverwaltung'' öffnet sich.
#Klicken Sie auf ''ZVT''.
#Klicken Sie auf ''ZVT''.
Nun können Sie die ZVT-Schnittstelle konfigurieren.
Nun können Sie die ZVT-Schnittstelle konfigurieren.


<div class="imageMapHighlighter">
<div class="imageMapHighlighter">
<imagemap>
<imagemap>
File:zvt.schnitts.png|gerahmt|ohne|'''Schnittstellenverwaltung''', hier mit dem Register '''ZVT-Schnittstelle'''
File:OptionenSchnittstelleZVT.PNG|gerahmt|ohne|'''Schnittstellenverwaltung''', hier mit dem Register '''ZVT-Schnittstelle'''
rect 1 69 55 89 [[DATEV-Schnittstelle]]
rect 1 65 62 90 [[DATEV-Schnittstelle]]
rect 55 69 114 89 [[Elster-Schnittstelle]]
rect 62 65 136 90 [[Elster-Schnittstelle]]
rect 114 69 170 89 [[Banking-Schnittstelle]]
rect 136 65 200 90 [[Banking-Schnittstelle]]
rect 170 69 245 89 [[ZUGFeRD-Schnittstelle]]
rect 200 65 283 90 [[ZUGFeRD-Schnittstelle]]
rect 245 69 330 89 [[xRechnung-Schnittstelle]]
rect 283 65 373 90 [[xRechnung-Schnittstelle]]
rect 330 69 385 89 [[TAPI-Schnittstelle]]
rect 373 65 436 90 [[TAPI-Schnittstelle]]
rect 385 69 452 89 [[GoogleCalendar-Schnittstelle]]
rect 436 65 511 90 [[GoogleCalendar-Schnittstelle]]
rect 452 69 508 89 [[DHL-Schnittstelle]]
rect 511 65 574 90 [[DHL-Schnittstelle]]
rect 508 69 563 89 [[EDI-Schnittstelle]]
rect 574 65 638 90 [[EDI-Schnittstelle]]
rect 563 69 610 89 [[ZVT-Schnittstelle]]
rect 638 65 700 90 [[ZVT-Schnittstelle]]


rect 1 89 55 111 [[EPAP-Schnittstelle]]
rect 1 90 55 114 [[EPAP-Schnittstelle]]
rect 55 89 114 111 [[VMP-Schnittstelle]]
rect 55 90 114 114 [[VMP-Schnittstelle]]
rect 114 89 205 111 [[WEBDRINK-Schnittstelle]]
rect 114 90 207 114 [[WEBDRINK-Schnittstelle]]
rect 205 89 310 111 [[GEDAT-Schnittstelle]]
rect 207 90 319 114 [[GEDAT-Schnittstelle]]
rect 310 89 412 111 [[GEVA-Schnittstelle]]
rect 319 90 396 114 [[Streckenabrechnung]]
rect 412 89 482 111 [[Octopus-Schnittstelle]]
rect 396 90 473 114 [[Octopus-Schnittstelle]]
rect 482 89 542 111 [[Kollex-Schnittstelle]]
rect 473 90 549 114 [[Gastivo-Schnittstelle]]
rect 542 89 610 111 [[Im/Export-Schnittstelle]]
rect 549 90 618 114 [[Kollex-Schnittstelle]]
rect 618 90 700 114 [[Im/Export-Schnittstelle]]




Zeile 46: Zeile 48:
</imagemap>
</imagemap>
</div>
</div>
<!--####################################################################################################################-->
<!--####################################################################################################################-->
==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:
{{Achtung|Die Informationen in diesem Abschnitt müssen exakt beachtet werden, damit das Kartenterminal zuverlässig mit der Kasse betrieben werden kann.}}
====Betriebsart====
Das Kartenterminal muss im ZVT-Modus betrieben werden.
{{Achtung|'''Andere Betriebsarten werden nicht unterstützt.''' Für die Schweiz ist eine gesonderte Schnittstelle verfügbar}}
====IP Adresse und Kommunikation====
* Wie lautet die IP-Adresse des Kartenterminals?
* Wurde die IP-Adresse des Kartenterminals fest (also '''nicht DHCP''') zugewiesen?
{{Achtung|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?
{{Achtung|Wenn der Port nicht bekannt gegeben wird, ist keine Verbindung zum Gerät möglich. Laut ZVT-Spezifikation soll der '''Port 20007''' ('''nicht 2007''') verwendet werden.}}
====Verbindungsparameter====
* '''Connection:''' Wie viele Millisekunden dauert es, bis das Terminal auf eine Verbindungsanfrage antwortet? (Default: 5.000 ms)
* '''Registration''': Wie viele Millisekunden dauert es, bis das Terminal auf eine Übertragung antwortet? (Default: 60.000 ms)
* '''Response''': Wie viele Millisekunden dauert es, bis das Terminal eine Kartenzahlung abbricht? (Default: 10.000-60.000 ms)
{{Achtung|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?
{{Achtung|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?
{{Achtung|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.}}
===Kompatible Geräte mit Preset===
Konfiguration folgender Kartenterminals sind als Presets verfügbar:
* Geräte von REA
{{Tipp1|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 (DE/CH)
===Kompatible Geräte===
Sollte kein passendes Preset für Ihr Gerät verfügbar sein, kann die Eingabe der Schnittstellenparameter manuell erfolgen.
{{Hinweis|Es kann dann jedoch keine Gewähr für eine einwandfreie Kommunikation zwischen Terminal und Kasse übernommen werden.}}
Konfigurationen folgender Kartenterminals sind prinzipiell kompatibel, jedoch nicht empfehlenswert:
* Geräte von Telecash
* Geräte von Clover
===Inkompatible Geräte===
Konfigurationen folgender Kartenterminals sind '''prinzipiell nicht kompatibel''':
* Wise POS (kein ZVT, einige Geräte sind zudem in Deutschland nicht zugelassen)
* SumUp (kein ZVT, nur manuelle Nutzung)
{{Achtung|Diese Geräte können nicht mit der Kasse verbunden werden.}}
===Nicht empfehlenswerte Anbieter===
Die folgenden Terminalanbieter sind explizit nicht empfehlenswert:
* Concardis/NEXI (schlechter Kundendienst)
* Telecash (Fehlerhafte Firmware-Implementation)
{{Achtung|Geräte dieser Anbieter können mit der Kasse verbunden werden, es kann aber zu Einschränkungen kommen.}}
===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.
===Weitere Optionen der ZVT-Schnittstelle===
Mit "Weitere Optionen" können Sie die Methoden zur Fehlerbehandlung und Problemlösung in der Gerätekommunikation aktivieren.
* Mit der Option '''Protokoll''' kann eine Protokollführung der IP-Verbindung aktiviert werden.
{{Achtung|Diese Funktion kann zu Verzögerungen im Programmablauf führen und sollte nur bei Problemen aktiviert werden, um weitere Diagnosemöglichkeiten zu bieten}}
* Mit der Option '''Timeout Gerät''' wird ein Timeout für das Kartenterminal aktiviert, der die Zeit bis zur Bestätigung der Zahlung durch das Gerät begrenzt.
{{Achtung|Diese Einstellungen müssen zuvor mit dem Terminalhersteller abgeklärt werden. Die Funktion sollte nur bei Problemen aktiviert werden}}


----
----

Aktuelle Version vom 17. Juni 2024, 12:56 Uhr

(HauptseiteOptionenSchnittstellenSie 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 Schluessel.png rechts neben der roten Statusanzeige Schnitt freischaltung.png einer bisher nicht aktivierten Schnittstelle anklicken[1].

Aufrufen der Schnittstellenkonfiguration

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

  1. Klicken Sie im Hauptmenü auf OptionenSchnittstellen oder drücken Sie die Tastenkombination + F12.
  2. Der Dialog Schnittstellenverwaltung öffnet sich.
  3. Klicken Sie auf ZVT.

Nun können Sie die ZVT-Schnittstelle konfigurieren.

DATEV-SchnittstelleElster-SchnittstelleBanking-SchnittstelleZUGFeRD-SchnittstelleXRechnung-SchnittstelleTAPI-SchnittstelleGoogleCalendar-SchnittstelleDHL-SchnittstelleEDI-SchnittstelleZVT-SchnittstelleEPAP-SchnittstelleVMP-SchnittstelleWEBDRINK-SchnittstelleGEDAT-SchnittstelleStreckenabrechnungOctopus-SchnittstelleGastivo-SchnittstelleKollex-SchnittstelleIm/Export-Schnittstelle
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:

Die Informationen in diesem Abschnitt müssen exakt beachtet werden, damit das Kartenterminal zuverlässig mit der Kasse betrieben werden kann.

Betriebsart

Das Kartenterminal muss im ZVT-Modus betrieben werden.

Andere Betriebsarten werden nicht unterstützt. Für die Schweiz ist eine gesonderte Schnittstelle verfügbar

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 20007 (nicht 2007) verwendet werden.

Verbindungsparameter

  • Connection: Wie viele Millisekunden dauert es, bis das Terminal auf eine Verbindungsanfrage antwortet? (Default: 5.000 ms)
  • Registration: Wie viele Millisekunden dauert es, bis das Terminal auf eine Übertragung antwortet? (Default: 60.000 ms)
  • Response: Wie viele Millisekunden dauert es, bis das Terminal eine Kartenzahlung abbricht? (Default: 10.000-60.000 ms)
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.

Kompatible Geräte mit Preset

Konfiguration folgender Kartenterminals sind als 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 (DE/CH)

Kompatible Geräte

Sollte kein passendes Preset für Ihr Gerät verfügbar sein, kann die Eingabe der Schnittstellenparameter manuell erfolgen.

Es kann dann jedoch keine Gewähr für eine einwandfreie Kommunikation zwischen Terminal und Kasse übernommen werden.

Konfigurationen folgender Kartenterminals sind prinzipiell kompatibel, jedoch nicht empfehlenswert:

  • Geräte von Telecash
  • Geräte von Clover

Inkompatible Geräte

Konfigurationen folgender Kartenterminals sind prinzipiell nicht kompatibel:

  • Wise POS (kein ZVT, einige Geräte sind zudem in Deutschland nicht zugelassen)
  • SumUp (kein ZVT, nur manuelle Nutzung)
Diese Geräte können nicht mit der Kasse verbunden werden.

Nicht empfehlenswerte Anbieter

Die folgenden Terminalanbieter sind explizit nicht empfehlenswert:

  • Concardis/NEXI (schlechter Kundendienst)
  • Telecash (Fehlerhafte Firmware-Implementation)
Geräte dieser Anbieter können mit der Kasse verbunden werden, es kann aber zu Einschränkungen kommen.

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.

Weitere Optionen der ZVT-Schnittstelle

Mit "Weitere Optionen" können Sie die Methoden zur Fehlerbehandlung und Problemlösung in der Gerätekommunikation aktivieren.

  • Mit der Option Protokoll kann eine Protokollführung der IP-Verbindung aktiviert werden.
Diese Funktion kann zu Verzögerungen im Programmablauf führen und sollte nur bei Problemen aktiviert werden, um weitere Diagnosemöglichkeiten zu bieten
  • Mit der Option Timeout Gerät wird ein Timeout für das Kartenterminal aktiviert, der die Zeit bis zur Bestätigung der Zahlung durch das Gerät begrenzt.
Diese Einstellungen müssen zuvor mit dem Terminalhersteller abgeklärt werden. Die Funktion sollte nur bei Problemen aktiviert werden

Weiter zu VMP-Schnittstelle


(HauptseiteOptionenSchnittstellenSie sind auf der Seite: ZVT-Schnittstelle)

Fußnoten:

  1. Schnittstellenfreischaltungen sind teilweise kostenpflichtig. Weitere Informationen erhalten Sie beim Hersteller.