Glossar

Kurzfassung

Kurze Erklärungen zu den Begriffen, die in diesem Handbuch und in der Live-Anzeige vorkommen, alphabetisch. Die Werte, die du in deiner Kasse einträgst, stehen nicht hier, sondern im Kapitel Kasse anbinden.

Ausführlich

ACK (Quittung). Die kurze Bestätigung „angekommen und verstanden" (80 00 00). Fast jedes Telegramm wird damit quittiert, bevor das eigentliche Ergebnis folgt.

NAK (negative Quittung). Die Gegenantwort zum ACK: 84 <Fehlercode> 00. Die Instanz sendet 84 9A für ein Kommando, das sie nicht kennt, und für ein falsches Registrierungs-Passwort – die ZVT-Spezifikation kennt für beides keinen eigenen Code.

API. Eine Schnittstelle, über die ein Programm ein anderes steuert. Hier: die Steuer-API, mit der deine Pipeline die Instanz bedient.

API-Schlüssel. Ein langes Geheimwort, mit dem sich eine Pipeline gegenüber der Schnittstelle ausweist. Beginnt mit zvtsim_. Erzeugt und widerrufen wird er auf der verlinkten Seite; der Klartext erscheint genau einmal.

APDU. Die Dateneinheit des ZVT-Protokolls: Steuerfeld, Länge, Daten. In diesem Handbuch sagen wir meistens „Telegramm".

Autorisierung. Die Anfrage der Kasse an das Terminal, eine Zahlung durchzuführen (Befehl 06 01).

Abbruch. Die Kasse bricht einen laufenden Vorgang ab (Befehl 06 B0). Nicht zu verwechseln mit 06 1E: Das ist die Gegenrichtung, mit der das Terminal einen Vorgang als gescheitert abschließt. Der Modus abort simuliert, dass das Terminal abbricht (siehe Fehlerszenarien).

Bearer. Die Art, einen Schlüssel im Kopf einer Anfrage mitzuschicken: Authorization: Bearer <Schlüssel>.

CI/CD. Automatisierte Tests und Auslieferung bei jeder Codeänderung (zum Beispiel mit GitHub Actions).

Instanz. Dein eigener Terminalsimulator, der für dich gestartet wurde. Höchstens einer je Konto. IP-Adresse und Port dazu zeigt die Seite Simulator an.

Kasse (ECR). Die Kassensoftware, der Teil, der das Terminal steuert. In ZVT-Texten „ECR" (electronic cash register).

Kassenschnitt. Der Tagesabschluss (Befehl 06 50): Das Terminal meldet die Umsätze seit dem letzten Schnitt und setzt sie zurück. Als Teilabrechnung 06 52; 06 10 meldet dieselben Summen, ohne abzurechnen.

Live-Anzeige. Die Darstellung des Verkehrs zwischen Kasse und Instanz im Browser, in Echtzeit.

Maskieren. Schützenswerte Stellen (zum Beispiel Kartennummern) unkenntlich machen.

Maskierungswerkzeug (Mask-Tool). Das kleine Programm, das einen Mitschnitt maskiert. Es läuft ohne Installation; heruntergeladen wird es auf der verlinkten Seite.

Mitschnitt. Eine Aufzeichnung des ZVT-Verkehrs, meist als .dif-Datei. Siehe auch „Sniffer / Mitschnitt".

Mitschnitt-Analyse. Die Auswertung eines hochgeladenen Mitschnitts im Portal, in derselben Darstellung wie die Live-Anzeige. Die Anleitung dazu steht im Kapitel Mitschnitte auswerten.

Modus. Das Verhalten, das du für die nächste Zahlung einstellst (success, decline, timeout, …).

OpenAPI / Swagger. Standardformat und Weboberfläche, mit denen eine Schnittstelle beschrieben und ausprobiert wird. Unter /api/docs und /api/openapi/v1.json, beides nur angemeldet.

oneShot. „Nur einmal": Der Modus gilt für die nächste Zahlung und fällt dann zurück auf Erfolg.

Pipeline. Der automatische Ablauf, der bei jeder Änderung Tests ausführt.

Port. Die „Tür" auf dem Server, an der deine Instanz lauscht. Welche Nummer es bei dir ist, sagt dir die Simulator-Seite; in diesem Handbuch steht dafür <PORT>.

IP-Adresse (Host). Die IP-Adresse, auf die deine Kasse ihre ZVT-Verbindung aufbaut. Im Feld „Host“ oder „Adresse“ deiner Kassenkonfiguration trägst du sie ein. Sie ist nicht dieselbe wie der Name, unter dem du das Portal im Browser aufhast. Welche es bei dir ist, sagt dir die Simulator-Seite; in diesem Handbuch steht dafür <IP>.

Registrierung. Die Anmeldung der Kasse beim Terminal (Befehl 06 00) mit Passwort und Einstellungen. Nicht zu verwechseln mit der Registrierung eines Kontos im Portal.

Reservierung. Die Zusage, dass dein Port dir gehört, auch wenn die Instanz gerade nicht läuft (Pro-Abo 7 Tage rollierend, Pro-Abo Plus unbegrenzt, Tages-Pass für die Laufzeit des Passes). Siehe Tarife und Freischaltung.

Rückvergütung. Die Rückzahlung an den Kunden (Befehl 06 31).

Sitzung (Session). Die Kennung deiner laufenden Instanz. Die Schnittstelle braucht sie in der Adresse.

Sniffer / Mitschnitt. „Sniffer" ist der übliche Werkzeugname für ein Programm, das den Datenverkehr zwischen Kasse und Terminal mitliest; was dabei herauskommt, ist ein Mitschnitt (auch „ZVT-Trace", meist eine .dif-Datei). In diesem Portal heißt die Auswertung solcher Dateien deshalb Mitschnitt-Analyse – früher „Sniffer-Analyse". Die alte Adresse leitet auf die neue weiter.

Status-Telegramm. Das Ergebnis eines Vorgangs, das das Terminal der Kasse meldet (04 0F), samt Ergebniscode. Ein Vorgang kann mehrere davon enthalten; abgeschlossen ist er erst mit 06 0F (Erfolg) oder 06 1E (Fehlschlag).

Stripe. Der Zahlungsdienst, über den du deinen Tarif bezahlst. Die Kartenerfassung findet dort statt, nicht im Portal.

Storno. Die Rücknahme einer Zahlung (Befehl 06 30).

Telegramm. Eine einzelne Nachricht zwischen Kasse und Terminal.

Terminal-ID. Die Nummer des Terminals, die die Instanz in der Antwort auf die Registrierung meldet und auf die Belege druckt. Der Testwert steht in Kasse anbinden.

Timeout. Die Zeitüberschreitung: Eine Antwort bleibt aus. Der Modus timeout erzwingt das.

ZVT. Das Protokoll, mit dem Kassen deutsche Zahlungsterminals ansprechen.

Zwischenstatus. Meldungen während eines Vorgangs („Karte einführen", „PIN eingeben"), Befehl 04 FF.