EasyTSE ist eine 32Bit-Windows DLL für die Kommunikation Ihres Kassenprogramms mit der technischen Sicherheitseinrichtung (TSE) von Epson. Sie stellt alle Kommandos zur Verfügung, die für die Erfüllung der Fiskalisierung nach der Kassensicherungsverordnung benötigt werden. Die als COM-Objekt entwickelte Klasse kommuniziert mit dem Epson USB-Stick, den Druckern TM-m30 und TM-T88iV iHub sowie den 3er und 8er Servern.
Die meisten Entwickler die sich mit der Dokumentation der Epson-TSE auseinandergesetzt haben wissen, weshalb sie heute auf unserer Webseite gelandet sind. Die Beschreibungen sind leider äußerst dürftig und große Unterstützung findet man nicht.
Die TSE verlangt aber von Ihnen Kenntnisse in TCP/IP Sockets, Verschlüsselungen wie SHA256 und Base64 Kodierung. Hat man dies verstanden geht es weiter mit User-Rollen, Authentifizierung, Request und Response, XML und Json, Challenge und einer große Tüte TSE-Kommandos. Ist man auch da mal durch kann man seine TSE mit PUK und PIN initialisieren, Clients registrieren, UTC-Zeiten setzen, Daten signieren und seine Transaktionsdaten abholen. Das alles macht wenig Spaß und die Lern- und Testphase ist enorm. Unser Stundenaufwand liegt im 4-stelligen Bereich.
Lassen Sie es nicht so weit kommen. Die EasyTSE verringert Ihre Entwicklungszeit auf Null. Sie müssen lediglich die Klasse in Ihre Entwicklungsumgebung einbinden, einige wenige Eigenschaften setzen und können sofort mit Ihrer TSE kommunizieren. Erfolgreich eingesetzt wird die Klasse aktuell mit Visual FoxPro, VBA, VB6, xBase++, xHarbour und PHP. Dies sind die mir bekannten Sprachen, evtl. gibt es zwischenzeitlich schon weitere.
EasyTSE kennt alle Kommandos die Epson zur Verfügung stellt. Diese können durch einzelne Funktionsaufrufe gestartet werden. Zusätzlich stehen für umfangreichere Funktionen wie z.B. das Setup, das Registrieren von Clients, das Erstellen von Transaktionsdaten oder für den Export fertige Methoden zur Verfügung, die mit einem einzelnen Funktionsaufruf gestartet werden können. Ergänzend zur wichtigen Signierung und den daraus folgenden Transaktionsdaten, erzeugt EasyTSE nicht nur die QR-Daten sondern auch gleich den QR-Code als Graphik zur Einbindung in Ihre Ausdrucke! Das hier erhältliche Setup enthält neben der DLL alle notwendigen Runtime-Module die automatisch auf Ihrem System installiert und registriert werden.
| METHODE (Auszug) | FUNKTION |
|---|---|
| Stack_Setup() | Initialisiert die TSE mit PUK, PIN und SecretKey |
| Stack_RunTSESelfTest() | Führt den regelmäßig notwendigen Selbsttest aus |
| Stack_RegisterNewClient() | Registriert einen neuen Client |
| Stack_ExportArchiveData() | Startet den Export der TSE-Daten |
| Stack_StartFinishTransaction() | Startet und beendet eine Transaktion |
| Stack_UpdateTime() | Aktualisiert die UTC-Time |
| Stack_StartTransaction() Stack_UpdateTransaction() Stack_FinishTransaction() | Startet eine Transaktion Sendet beliebig viele Updates Beendet eine Transaktion |
| Stack_StartTransaction() SetTransactionObjectStart() Stack_FinishTransaction() | Startet eine Transaktion Aktiviert eine offene Transaktion Beendet eine Transaktion |
| TSEConnectOpenSend() | Alle TSE-Kommandos z.Bsp. GetStorageInfo |
| FEATURES (Auszug) | IHR VORTEIL |
|---|---|
| Fertige Klassenbibliothek | Sofort einsetzbar |
| Unterstützung aller Epson TSE´s | USB / Drucker / Server |
| Umfangreiche Hilfedatei | Leichte Integration in Ihren Code |
| Stapel-Funktionen | Umfangreiche Funktionen mit nur einem Aufruf |
| TSE-Kommandos | Sämtliche Kommandos der TSE |
| TSE-Seriennummer | Ermittlung der Seriennummer für das Finanzamt |
| QR-Code | Erstellt die QR-Daten und eine BMP-Graphik |
| TAR-Export | Erstellt alle Exporte im TAR-Format |
| EasyTSE GUI | Graphische Benutzeroberfläche |
| Beispielcode | Beispielcode (VFP+VBA) für alle Funktionen |
Technische Sicherungs-einrichtung als USB-Stick. Lebensdauer: 20 Mio. Signaturen, Zertifikatslaufzeit:
5 Jahre
Bei uns für 200,- Euro
zzgl. MwSt. erhältlich.
Der TM-T88VI-iHub und der
TM-M30f erstellen Signaturen und Transaktionen per MicroSD Karte bequem für mehrere Clients.
Höchste Flexibilität mit Fiskalservern im Netzwerk und
wahlweise mit 3 oder 8 USB-TSE-Ports. Optional auch mit 19" Rackmount erweiterbar.
Bei uns ab 350,- Euro
zzgl. MwSt. erhältlich.
Company-Lizenz für Software-entwickler für eine unbegrenzte Anzahl von Kasseninstallationen!
Einmalig 1.000,- Euro
zzgl. MwSt. ohne Folgekosten!
Setup mit allen Dateien und Registrierung der Runtime-Bibliotheken.
Die letzte Version ist vom 13.06.2023
VFP Beispielcode für Funktionen wie Setup, Transaktion, usw.
Die letzte Version ist vom 16.11.2020
Umfangreiche Hilfedatei mit Erläuterungen zu sämtlichen Eigenschaften und Methoden
Die letzte Version ist vom 24.01.2023
Aktuellste Version der EasyTSE.dll zum Download.
Die letzte Version ist vom 13.06.2023
Aktuellste Version der EasyTSEGUI zum Download.
Die letzte Version ist vom 15.01.2022
Aktuellste Version des EasyTSETutorials zum Download.
Die letzte Version ist vom 30.03.2021
Für die USB-TSE muss zunächst der Windows-Treiber installiert werden. Die aktuelle Version ist die 1.0.8.0 welche man über die Epson Webseiten oder auf Anfrage über uns herunterladen kann. Drucker und Server benötigen keinen zusätzlichen Treiber.
Bei erfolgreicher Installation befindet sich dann ein Schloßsymbol in der Windows-Taskleiste.
Installieren Sie dann das EasyTSE-Setup. Dieses beinhaltet alle notwendigen Dateien und registriert diese.
Die Developer-TSE kann bis zum Laufzeitende beliebig oft initialisiert werden, während dies bei der Produktiv-TSE nur einmal möglich ist. Die Zugangsdaten können Sie selbst wählen, Sie müssen sich lediglich an die Längenbegrenzungen halten.
Die wichtigste Einstellung ist die PUK. Diese sollten Sie nie vergessen, am besten gar nicht erst an die Anwender weitergeben.
Eine gesperrte TSE kann ohne PUK nicht mehr verwendet werden!
Verwenden Sie unsere graphische Oberfläche EasyTSEGUI um die TSE zu initialisieren, Clients anzulegen, Storage-Informationen abzurufen, Seriennummer und Public-Key zu ermitteln oder um die erste Transaktion zu signieren. Oder starten Sie gleich selbst durch mit eigenem Code. Aktuell haben wir Beispiele für:
- VFP (Umfangreiche Sammlung aller notwendigen Funktionen)
- VB(A) (Vollständiges Beispiel in VBA mit Access)
- C#
- PHP
- Delphi
- Lazarus
- PHP
SoftArt
Inh. Thomas Geißler
Carl-Zeiss-Str. 16
D-74321 Bietigheim-Bissingen
eMail: info@bonstar.de
Tel: +49 (0) 7142 21943 Fax: +49 (0) 7142 21949
