Quick-Start TSE fiskaltrust.Middleware
←
→
Transkription von Seiteninhalten
Wenn Ihr Browser die Seite nicht korrekt rendert, bitte, lesen Sie den Inhalt der Seite unten
Quick-Start TSE
fiskaltrust.Middleware
TSE Einrichtung leicht gemacht
fiskaltrust.Middleware bietet flexible Integration von TSEs in Registrierkassen
und einfache Übersetzung von Geschäftsvorfällen in die DSFinV-K-Logik
info@fiskaltrust.de
fiskaltrust GmbH Deutschland
Einleitung
Inhaltsverzeichnis
Einleitung.................................................................................................................................... 3
Begrifflichkeiten...................................................................................................................... 3
Dokument Status .................................................................................................................... 3
Swissbit ....................................................................................................................................... 4
Einrichten Queue .................................................................................................................... 8
Zusammenstellen CashBox ..................................................................................................... 9
Cryptovision Bundesdruckerei ................................................................................................. 14
1. Einrichten TSE ................................................................................................................ 14
2. Einrichten Queue........................................................................................................... 16
3. Zusammenstellen Cashbox............................................................................................ 17
Epson ........................................................................................................................................ 22
1. Einrichten TSE ................................................................................................................ 22
EPS TSE Server 3 + Usb TSE .................................................................................................. 22
EPS Printer + MicroSD .......................................................................................................... 24
EPS USB TSE an der Hardware angeschlossen .................................................................... 25
Fussnoten .......................................................................................................................... 27
2. Einrichten Queue........................................................................................................... 28
3. Zusammenstellen Cashbox............................................................................................ 29
Fiskaly Online TSE ..................................................................................................................... 34
1. Einrichten TSE ................................................................................................................ 34
2. Einrichten Queue........................................................................................................... 35
3. Zusammenstellen Cashbox............................................................................................ 37
Installation und Start der Middleware ..................................................................................... 42
Funktionstest der Middleware und TSE ................................................................................... 44
Endpunkte für Aufrufe .......................................................................................................... 44
Zusätzliche Dokumentationen & Support ................................................................................ 46
Wichtige Dokumente ............................................................................................................ 46
FAQ ....................................................................................................................................... 46
JSON Beispiel Dokumentation .............................................................................................. 46
Interface Dokumentation ..................................................................................................... 46
Support ................................................................................................................................. 46
1
Einleitung
2
Einleitung
Einleitung
Im Rahmen der Kassensicherungsverordnung (KassenSichV) müssen Registrierkassen Belege
manipulationsgeschützt abspeichern.
Hierzu werden Technische Sicherheitseinrichtungen (TSE) eingesetzt.
fiskaltrust.Middleware bietet die bequeme Einbindung von TSE aller Hersteller an Ihre Re-
gistrierkasse, sowie eine vereinfachte Umsetzung der Anforderungen der Digitalen Schnitt-
stelle der Finanzverwaltung für Kassensysteme (DSFinV-K).
Neben der kostenlosen fiskaltrust.Middleware bieten wir AddOn-Produkte an, die den Kas-
senalltag sehr erleichtern, beispielsweise durch automatisiertes Speichern der Kassendaten
mit Konformitätserklärung und DATEV-Schnittstelle, auch im Rahmen attraktiver Sorglos-Pa-
kete.
Dieses Dokument bietet einen Schnelleinstieg, wie Sie die von Ihnen genutzte TSE im Portal
einrichten müssen. Alle hierzu benötigten und gelisteten TSEs können Sie online erwerben
unter http://portal.fiskaltrust.de .
Begrifflichkeiten
CashBox Konfigurationscontainer (Auswahl TSE, Betriebssystem u.a.)
Launcher App zum Installieren der Middleware auf Kassenrechner
Middleware Dienstprogramm (Service/Daemon; läuft auf Kassenrechner)
TSE Technische Sicherheitseinrichtung (zur Verschlüsselung)
Dokument Status
Rev Änderung geändert von Änderungsdatum
00 Dokumenterstellung, Swissbit Kaya Cürünay, Lars Mach 09.03.2020
01 Version 1.0 Kaya Cürünay 13.03.2020
02 Erweiterung Cryptovision, Installa- K. Daniel 17.03.2020
tion, Test der Middleware
03 Erweiterung Fiskaly K. Daniel 18.03.2020
04 Erweiterung Epson K. Daniel 20.04.2020
3
Swissbit
Swissbit
1. Einrichten TSE
2. Wählen Sie im Portal den Punkt TSE / Signatur-Erstellungs-Einheit
2.
1.
3. Klicken Sie auf „+Anlegen“
4. Tragen Sie unter „Beschreibung“ Ihrer TSE einen Namen
5. Wählen Sie als „Package Name“ die „fiskaltrust.Middleware.SCU.DE.Swissbit“ aus
6. Wählen Sie die „Package Version“ 1.3.0-rc2 aus (alternativ die neueste)
7. Klicken Sie auf „Speichern“
4
Swissbit
3.
4.
5.
5
Swissbit
8. Stecken Sie die Swissbit TSE in einen USB Anschluss Ihrer Kasse;
prüfen Sie, welchen Laufwerksbuchstaben Ihr Betriebssystem der TSE zugewiesen hat
9. Fügen Sie einen Schlüssel „devicePath“ hinzu und nennen den Laufwerksbuchstaben als
Wert (im Beispiel „D:“ ohne Schrägstrich).
10. Tragen Sie grpc://localhost:10104 ein
8. Schlüssel „devicePath“
D: (oder Laufwerk Ihres USB-Sticks)
9.
6
Swissbit
11. Klicken Sie auf „Speichern und schließen“ Sie gelangen dann zur Übersicht
7
Swissbit
Einrichten Queue
12. Klicken Sie auf der linken Seite auf Queue und legen anschließend wie im „QuickStart
Guide“ beschrieben (siehe Seite 7) eine neue Queue mit folgenden Werten an:
http://localhost:1200/fiskaltrust
grpc://localhost:10103
13. Im zweiten Queue-Eingabefenster ist „CashBoxIdenficiation“ zu nennen;
hier können Sie bei Verwendung einer Swissbit-TSE eine beliebige Bezeichnung wählen,
achten Sie aber darauf, nicht mehr als 20 Zeichen zu verwenden!
8
Swissbit
20 Zeichen max!
14. Klicken Sie auf „Speichern“
Zusammenstellen CashBox
Um die Casbox Konfiguration abzuschließen, klicken Sie unter dem Menüpunkt Konfigura-
tion|CashBox den Button „+Hinzufügen“.
Vergeben Sie unter Beschreibung einen treffenden Namen für Ihre Cashbox und klicken Spei-
chern.
In der Übersicht der Konfigurationscontainer im Menü „CashBox“ finden Sie Ihre CashBox
mit dem von Ihnen vergebenen Beschreibungsnamen, hier beispielsweise „swissbit_Test1“.
9Swissbit
Klicken Sie auf den „Bearbeiten per DragNDrop“-Button ( ), um Ihrer CashBox die von
Ihnen zuvor angelegte TSE und die Queue hinzuzufügen. In der sich öffnenden Ansicht zie-
hen Sie mit der Maus aus dem rechten Bereich „Queues“ Ihre angelegte Queue (hier „Swiss-
bit_Test1“) in den linken leeren Bereich Ihrer Cashbox unterhalb der CahBox-Beschreibung.
Ebenso verfahren Sie mit der TSE aus dem rechten Bereich „Signaturerstellungseinheiten“;
ziehen Sie die TSE (hier „swissbit_Test1“) ebenfalls nach links in den Platzhalter Ihrer Cash-
Box.
10Swissbit
Speichern Sie die CashBox-Konfiguration durch Klick auf den Speichern Button im unteren
Bereich des Formulars.
Sie gelangen zurück in die Übersichtsliste der Cashboxen:
11Swissbit
Klicken Sie auf das „Rechteck mit Pfeil“ und bestätigen die Zuordnung der TSE zu Ihrer
CashBox durch Setzen eines Hackens vor die TSE:
Mit „Speichern und schließen“ beenden Sie das Formular.
Schließen Sie die Cashbox Konfiguration ab, indem Sie auf den „Rebuild Configuration“ But-
ton klicken:
12Swissbit
Sie haben die Einrichtung einer TSE und einer CashBox abgeschlossen. Um Ihre Konfiguration
zu testen lesen Sie bitte Kapitel „Installation und Start der Middleware“.
13Cryptovision Bundesdruckerei
Cryptovision Bundesdruckerei
Im folgenden werden die einzelnen Konfigurationsschritte beschrieben, um eine CryptoVi-
sion TSE mit der fiskaltrust Middleware zu nutzen.
Logen Sie sich dazu auf unser Portal ein (für Test: https://portal-sandbox.fiskaltrust.de/Ac-
count/Login für Produktion unter https://portal.fiskaltrust.de/Account/Login).
1. Einrichten TSE
Unter Konfiguration|TSE Signatur-Erstellungseinheit klicken sie den Button „+Anlegen“, um
eine neue TSE zu konfigurieren:
Vergeben Sie einen Namen in der Beschreibung.
Wählen Sie ein Package, das im Namen „CryptoVision“ enthält.
Es wird in der Package Version die aktuelle Version vorgeblendet, übernehmen Sie diese.
Klicken Sie auf Speichern. Es erscheint folgende Ansicht um weitere Angaben einzutragen:
14Cryptovision Bundesdruckerei
Geben Sie unter „Gerätepfad“ den Laufwerksbuchstaben ein, unter dem sich die TSE beim
Einstecken am Betriebsystem der Kasse anmeldet (hier z.B. „D:/“).
Tragen Sie zusätzlich den Schlüssel „cliendId“ mit einem eindeutigen Wert ein, der noch kei-
ner anderen TSE Konfiguration vergeben wurde, hier beispielsweise „Client1“. Dazu klicken
Sie anschließend auf den Plus-Button .
Im Unteren Bereich geben sie „grpc://localhost:10104“ als Endpunkt für die Kommunikation
unserer Middleware mit der TSE ein und klicken anschließend auf den Plus-Button .
Speichern Sie die Einstellungen zur TSE durch Klick auf „Speichern und Schließen“.
15Cryptovision Bundesdruckerei
2. Einrichten Queue
Unter dem Menüpunkt Konfiguration|Queue klicken Sie den Button „+Neu anlegen“ um
eine für die Cashbox benötigte „Queue“ anzulegen.
Vergeben Sie bei der Beschreibung einen Namen für die Queue, hier z.B. „Cryptovi-
sion_Test1“.
Als Standard werden Ihnen hier weitere Werte voreingestellt, die Sie i.d.R. nur übernehmen:
• Package Name (fiskaltrust.Middleware.Queue.SQLite)
• Package Version (1.3.0…)
• Timeout (1500)
• Länderkürzel (Deutschland (DE))
In dem Feld „CashBox Identification“ vergeben Sie bitte einen eindeutigen Namen, hier z.B.
„CashBox1“.
Drücken Sie auf Speichern, um Ihre Einstellungen zur Queue zu sichern. Es erscheint eine
weitere Konfigurationsseite zur Queue, in der Sie die Kommunikationsendpunkte eintragen,
mit welchem Protokoll Sie als Kassenhersteller (Entwickler) mit unserer Middleware kommu-
nizieren:
16Cryptovision Bundesdruckerei
Beschreibung, Package Name und Version wurden aus der vorhergehenden Seite übernom-
men.
Wir haben hier beispielhaft alle Endpunktmöglichkeiten eingetragen. Mindestens einer ist
notwendig:
Klick auf „http“: http://localhost:1200/...
Manuell eingetragen: grpc://localhost:10103 und „+“-Button drücken
Klick auf „net.pipe“: net.pipe://localhost/…
Klicken Sie „Speichern und Schließen“ um die Einstellungen zur Queue abzuschließen.
3. Zusammenstellen Cashbox
Um die Konfiguration abzuschließen, klicken Sie unter dem Menüpunkt Konfiguration|Cash-
Box den Button „+Hinzufügen“.
17Cryptovision Bundesdruckerei
Vergeben Sie unter Beschreibung einen treffenden Namen für Ihre Cashbox und klicken Spei-
chern.
In der Übersicht der Konfigurationscontainer im Menü „CashBox“ finden Sie Ihre CashBox
mit dem von Ihnen vergebenen Beschreibungsnamen, hier beispielsweise „Cryptovi-
sion_Test1“.
Klicken Sie auf den „Bearbeiten per DragNDrop“-Button ( ), um Ihrer CashBox die von
Ihnen zuvor angelegte TSE und die Queue hinzuzufügen. In der sich öffnenden Ansicht zie-
hen Sie mit der Maus aus dem rechten Bereich „Queues“ Ihre angelegte Queue (hier „Cryp-
tovision_Test1“) in den linken leeren Bereich Ihrer Cashbox unterhalb der CahBox-Beschrei-
bung.
Ebenso verfahren Sie mit der TSE aus dem rechten Bereich „Signaturerstellungseinheiten“;
ziehen Sie die TSE (hier „Cryptovision_Test1“) ebenfalls nach links in den Platzhalter Ihrer
CashBox.
18Cryptovision Bundesdruckerei
Speichern Sie die CashBox-Konfiguration durch Klick auf den Speichern Button im unteren
Bereich des Formulars.
Sie gelangen zurück in die Übersichtsliste der Cashboxen:
19Cryptovision Bundesdruckerei
Klicken Sie auf das „Rechteck mit Pfeil“ und bestätigen die Zuordnung der TSE zu Ihrer
CashBox durch Setzen eines Hackens vor die TSE:
Mit „Speichern und schließen“ beenden Sie das Formular.
Schließen Sie die Cashbox Konfiguration ab, indem Sie auf den „Rebuild Configuration“ But-
ton klicken:
20Cryptovision Bundesdruckerei
Sie haben die Einrichtung einer TSE und einer CashBox abgeschlossen. Um Ihre Konfiguration
zu testen lesen Sie bitte Kapitel „Installation und Start der Middleware“.
21Epson
Epson
Im Folgenden werden die einzelnen Konfigurationsschritte beschrieben, um eine Epson TSE
mit der fiskaltrust Middleware zu nutzen.
Logen Sie sich dazu auf unser Portal ein (für Test: https://portal-sandbox.fiskaltrust.de/Ac-
count/Login für Produktion unter https://portal.fiskaltrust.de/Account/Login).
1. Einrichten TSE
Mit dem Epson-basierten SCU-Paket unterstützen wir die folgenden drei Setup-Szenarien
und alle verwenden intern die XML-Schnittstelle für die Kommunikation mit der TSE.
EPS TSE Server 3 + Usb TSE
Wenn Sie dieses Szenario verwenden, muss der Epson TSE-Server zunächst mit einigen
Schritten für die Verwendung vorbereitet werden.
Hardware-Installation
1. Stecken Sie ein TSE-Modul in den USB-Anschluss des Fiskalservers.
2. Wiederholen Sie Schritt 1 für jedes anzuschließende TSE Modul.
3. Verbinden Sie das Netzwerkkabel (RJ-45) zu Fiskalserver.
4. Schließen Sie das Strom-Netzkabel an den Fiskalserver an. Der Fiskalserver wird gestartet
und ist dann betriebsbereit.
Software-Installation and IP address allocation
1. Nach Abschluss der Hardwareinstallation prüft der Fiskalserver, ob er mithilfe des DHCP-
Protokolls dynamisch eine IPv4-Netzwerkkonfiguration empfängt. Ist dies nicht der Fall,
gibt sich der Fiskalserver selbst eine IP-Adresse von Zeroconf aus dem für Zeroconf reser-
vierten Adressbereich (169.254.0.0/16).
2. Die zugewiesene IPV4 Adresse des Fiskalservers kann mit Hilfe des folgenden Tools be-
stimmt werden
o SEH Product Manager (Win)
o SEH Product Manager (macOS)
3. Greifen Sie unter Verwendung der von SEH Product Manager ermittelten IP-Adresse über
die Anmeldeseite mit den folgenden Anmeldeinformationen auf die Benutzeroberfläche
von EPS TSE Server 3 zu, um eine detaillierte Liste der TSE-Geräte zu erhalten:
• User name: admin
22Epson
• Password: admin
4. Um die Epson-SCU einzurichten, befolgen Sie die üblichen Schritte über das fiskaltrust
portal unter Verwendung des neuesten Epson-Release-Kandidaten (RC) und stellen Sie
die folgenden Schlüsselwertpaare bereit
• tseurl - xxx.xx.xx.xx (die IP-Adresse des EPS TSE Server oder externe IP-Adresse mit
Port Weiterleitung)
• tseport - xxxx (Standard TCP 8009 für unverschlüsselte Gerätekommunikation o-
der TCP 8143 für verschlüsselte Gerätekommunikation
• deviceid -
TSE_0BA3507F5D11679B4892E104F75B262D6B2E2EA36B5E345C9B16CD5F9D7EF
CA2 (Geräte-Id des TSE Modules, welches durch den EPS TSE Server vergeben
wurde)
23Epson
Für eine detailliertere Beschreibung nutzen Sie bitte die offizielle EPS TSE Server 3 Seite
und das installation and user manual des Herstellers.
EPS Printer + MicroSD
1. Laden Sie den aktuellsten Treiber von Epson printer driver
2. Installieren des Epson Treibers
3. Navigieren Sie nach erfolgreicher Einrichtung mit der angegebenen IP-Adresse während
der Installation zu Ihrer Druckerschnittstelle, z. B. https://10.1.1.1/webconfig/
4. Um die Epson-SCU einzurichten, befolgen Sie die üblichen Schritte über das fiskaltrust
portal unter Verwendung des neuesten Epson-Release-Kandidaten (RC) und stellen Sie
die folgenden Schlüsselwertpaare bereit
• tseurl - xxx.xx.xx.xx (IP-Adresse vom EPS TSE Server oder externe IP-Adresse mit
Portweiterleitung)
• tseport - xxxx (Standard TCP 8009 für unverschlüsselte Gerätekommunikation o-
der TCP 8143 für verschlüsselte Gerätes
24Epson
Für eine genauere Beschreibung prüfen Sie bitte die offizielle Seite EPS TSE Server 3 und
das installation and user manual https://support.vendhq.com/hc/en-us/artic-
les/201378420-How-do-I-set-up-my-Epson-TM-T88V-Printer-to-work-on-a-wireless-net-
work
EPS USB TSE an der Hardware angeschlossen
Dieses Szenario wird mit einigen Voraussetzungen für die Einrichtung unterstützt.
Bitte beachten Sie, dass nur USB-Stick-TSEs von Epson verwendbar sind. Micro-SD-Karten
(z.B. aus einem Epson Drucker) über einen USB-Adapter funktionieren nicht.
1. Um die Verwendung des direkt an die Hardware angeschlossenen USB-TSE zu aktivieren,
installieren Sie den Windows-Treiber auf dem PC. Anschließend ist derselbe XML-Dienst
auf localhost (127.0.0.1) über den Standardport 8009 verfügbar. Der EpsonTSE-
WinDrv_1.0.0.2.zip -Treiber ist auf dem fiskal-community portal verfügbar
2. Stecken Sie den Stick ein und stellen Sie sicher, dass der USB-Stick vom Betriebssystem
erkannt wurde. Dies können Sie mit Hilfe des mitinstallieren TSE-Monitors prüfen. Starten
Sie es über den Startbutton:
25Epson
In der Statusbar erscheint ein grünes Schloss:
26Epson
3. Um die Epson-SCU einzurichten, befolgen Sie die üblichen Schritte über das fiskaltrust
portal unter Verwendung des neuesten Epson-Release-Kandidaten (RC) und stellen Sie
die folgenden Schlüsselwertpaare bereit
• tseurl - 127.0.0.1 (IP-Adresse (localhost), die vom EPS TSE-Windows-Treiber be-
reitgestellt wird)
• tseport - xxxx (Standard TCP 8009 für unverschlüsselte Gerätekommunikation o-
der TCP 8143 für everschlüsselte Gerätes
Fussnoten
Verschlüsselte Geräte
1. Die folgenden Produkte unterstützen TCP (verschlüsselt)
• TM-DT Series
• TM-T88VI-iHUB
• TM-m30
• TM-H6000V
27Epson
2. Einrichten Queue
Unter dem Menüpunkt Konfiguration|Queue klicken Sie den Button „+Neu anlegen“ um
eine für die Cashbox benötigte „Queue“ anzulegen.
Vergeben Sie bei der Beschreibung einen Namen für die Queue, hier z.B. „EpsonQueue“.
Als Standard werden Ihnen hier weitere Werte voreingestellt, die Sie i.d.R. nur übernehmen:
• Package Name (fiskaltrust.Middleware.Queue.SQLite)
• Package Version (1.3.0…)
• Timeout (1500)
• Länderkürzel (Deutschland (DE))
In dem Feld „CashBox Identification“ vergeben Sie bitte einen eindeutigen Namen, hier z.B.
„Epson“. Hierbei sind keine Sonderzeichen erlaubt, lediglich A-Za-z0-9'()+,-./:=? und das
Leerzeichen.
Drücken Sie auf Speichern, um Ihre Einstellungen zur Queue zu sichern. Es erscheint eine
weitere Konfigurationsseite zur Queue, in der Sie die Kommunikationsendpunkte eintragen,
mit welchem Protokoll Sie als Kassenhersteller (Entwickler) mit unserer Middleware kommu-
nizieren:
28Epson
Beschreibung, Package Name und Version wurden aus der vorhergehenden Seite übernom-
men.
Wir haben hier beispielhaft alle Endpunktmöglichkeiten eingetragen. Mindestens einer ist
notwendig:
Klick auf „http“ und tragen Sie: rest://localhost:1200/...
Manuell eingetragen: grpc://localhost:10103 und „+“-Button drücken
Klicken Sie „Speichern und Schließen“ um die Einstellungen zur Queue abzuschließen.
3. Zusammenstellen Cashbox
Um die Konfiguration abzuschließen, klicken Sie unter dem Menüpunkt Konfiguration|Cash-
Box den Button „+Hinzufügen“.
Vergeben Sie unter Beschreibung einen treffenden Namen für Ihre Cashbox und klicken Spei-
chern.
29Epson
In der Übersicht der Konfigurationscontainer im Menü „CashBox“ finden Sie Ihre CashBox
mit dem von Ihnen vergebenen Beschreibungsnamen, hier beispielsweise „EpsonCashbox“.
Klicken Sie auf den „Bearbeiten per DragNDrop“-Button ( ), um Ihrer CashBox die von
Ihnen zuvor angelegte TSE und die Queue hinzuzufügen. In der sich öffnenden Ansicht zie-
hen Sie mit der Maus aus dem rechten Bereich „Queues“ Ihre angelegte Queue (hier „Ep-
sonQueue“) in den linken leeren Bereich Ihrer Cashbox unterhalb der CahBox-Beschreibung.
Ebenso verfahren Sie mit der TSE aus dem rechten Bereich „Signaturerstellungseinheiten“;
ziehen Sie die TSE (hier „EpsonTSE“) ebenfalls nach links in den Platzhalter Ihrer CashBox.
30Epson
Speichern Sie die CashBox-Konfiguration durch Klick auf den Speichern Button im unteren
Bereich des Formulars.
Sie gelangen zurück in die Übersichtsliste der Cashboxen:
31Epson
Klicken Sie auf das „Rechteck mit Pfeil“ und bestätigen die Zuordnung der TSE zu Ihrer
CashBox durch Setzen eines Hackens vor die TSE:
Mit „Speichern und schließen“ beenden Sie das Formular.
Schließen Sie die Cashbox Konfiguration ab, indem Sie auf den „Rebuild Configuration“ But-
ton klicken:
32Epson
Sie haben die Einrichtung einer TSE und einer CashBox abgeschlossen. Um Ihre Konfiguration
zu testen lesen Sie bitte Kapitel „Installation und Start der Middleware“.
33Fiskaly Online TSE
Fiskaly Online TSE
Zur Einrichtung einer Fiskaly Online TSE werden Ihnen von fiskaltrust oder Fiskaly folgende
Zugangsschlüssel bereitgestellt: ApiKey, ApiSecret, TssId, ClientId.
Also beispielsweise:
ApiKey: test_1iwrxfk97b9qx6ufn9q9yw8ce_klausdaniel
ApiSercret: THBtRTuNOFo9sjw4iir1HysVbPsHjpGz2OQH8GyPvNM
TSSID: 3ee521cf-bd8d-470e-9e56-3aa928265f80
ClientId: 3b97103e-ade5-402a-9651-e35c0ca847d8
1. Einrichten TSE
Unter Konfiguration|TSE Signatur-Erstellungseinheit klicken sie den Button „+Anlegen“, um
eine neue TSE zu konfigurieren:
Vergeben Sie einen Namen in der Beschreibung, z.B. „fiskaly_Test1“.
Wählen Sie ein Package, das im Namen „Fiskaly“ enthält.
Es wird in der Package Version die aktuelle Version vorgeblendet, übernehmen Sie diese.
Klicken Sie auf Speichern. Es erscheint folgende Ansicht um weitere Angaben einzutragen.
Tragen Sie die Werte für TSS-ID, API-Schlüssel und Geheimer API-Schlüssel ein:
34Fiskaly Online TSE
Im Unteren Bereich geben sie „grpc://localhost:10104“ als Endpunkt für die Kommunikation
unserer Middleware mit der TSE ein und klicken anschließend auf den Plus-Button .
Speichern Sie die Einstellungen zur TSE durch Klick auf „Speichern und Schließen“.
2. Einrichten Queue
Unter dem Menüpunkt Konfiguration|Queue klicken Sie den Button „+Neu anlegen“ um
eine für die Cashbox benötigte „Queue“ anzulegen.
35Fiskaly Online TSE
Vergeben Sie bei der Beschreibung einen Namen für die Queue, hier z.B. „fiskaly_Test1“.
Als Standard werden Ihnen hier weitere Werte voreingestellt, die Sie i.d.R. nur übernehmen:
• Package Name (fiskaltrust.Middleware.Queue.SQLite)
• Package Version (1.3.0…)
• Timeout (1500)
• Länderkürzel (Deutschland (DE))
In dem Feld „CashBox Identification“ tragen Sie die ClientId ein, hier z.B. „3b97103e-ade5-
402a-9651-e35c0ca847d8“.
Drücken Sie auf Speichern, um Ihre Einstellungen zur Queue zu sichern.
Es erscheint eine weitere Konfigurationsseite zur Queue, in der Sie die Kommunikationsend-
punkte eintragen. Damit legen Sie fest, mit welchem Protokoll Sie als Kassenhersteller (Ent-
wickler) mit unserer Middleware kommunizieren:
36Fiskaly Online TSE
Beschreibung, Package Name und Version wurden aus der vorhergehenden Seite übernom-
men.
Wir haben hier beispielhaft alle Endpunktmöglichkeiten eingetragen. Mindestens einer ist
notwendig:
Klick auf „http“: http://localhost:1200/...
Manuell eingetragen: grpc://localhost:10103 und „+“-Button drücken
Klick auf „net.pipe“: net.pipe://localhost/…
Klicken Sie „Speichern und Schließen“ um die Einstellungen zur Queue abzuschließen.
3. Zusammenstellen Cashbox
Um die Konfiguration abzuschließen, klicken Sie unter dem Menüpunkt Konfiguration|Cash-
Box den Button „+Hinzufügen“.
37Fiskaly Online TSE
Vergeben Sie unter Beschrei-
bung einen treffenden Namen für Ihre Cashbox und klicken Speichern.
In der Übersicht der Konfigurationscontainer im Menü „CashBox“ finden Sie Ihre CashBox
mit dem von Ihnen vergebenen Beschreibungsnamen, hier beispielsweise „Fiskaly_Test1“.
Klicken Sie auf den „Bearbeiten per DragNDrop“-Button ( ), um Ihrer CashBox die von
Ihnen zuvor angelegte TSE und die Queue hinzuzufügen. In der sich öffnenden Ansicht zie-
hen Sie mit der Maus aus dem rechten Bereich „Queues“ Ihre angelegte Queue (hier „Fis-
kaly_Test1“) in den linken leeren Bereich Ihrer Cashbox unterhalb der CahBox-Beschreibung.
Ebenso verfahren Sie mit der TSE aus dem rechten Bereich „Signaturerstellungseinheiten“;
ziehen Sie die TSE (hier „Fiskaly_Test1“) ebenfalls nach links in den Platzhalter Ihrer Cash-
Box.
38Fiskaly Online TSE
Speichern Sie die CashBox-Konfiguration durch Klick auf den Speichern Button im unteren
Bereich des Formulars.
Sie gelangen zurück in die Übersichtsliste der Cashboxen:
39Fiskaly Online TSE
Klicken Sie auf das „Rechteck mit Pfeil“ und bestätigen die Zuordnung der TSE zu Ihrer
CashBox durch Setzen eines Hackens vor die TSE:
Mit „Speichern und schließen“ beenden Sie das Formular.
Schließen Sie die Cashbox Konfiguration ab, indem Sie auf den „Rebuild Configuration“ But-
ton klicken:
40Fiskaly Online TSE
Sie haben die Einrichtung einer TSE und einer CashBox abgeschlossen. Um Ihre Konfiguration
zu testen lesen Sie bitte Kapitel „Installation und Start der Middleware“.
Um die hier gelisteten und benötigten TSEs zu bestellen, gehen Sie bitte auf http://portal.fis-
kaltrust.de .
41Installation und Start der Middleware
Installation und Start der Middleware
Über den Menüpunkt Konfiguration|CashBox gehen Sie in die Übersichtsliste Ihrer Cashbo-
xen. Laden Sie den „Launcher“ zur passenden CashBox als Zip-Datei auf Ihren Rechner
(Kasse) herunter, indem Sie den -Button klicken.
Entpacken Sie die Zip-Datei.
Stecken Sie Ihre TSE (USB-Stick oder MicroSD-Karte) an Ihren Rechner und stellen Sie sicher,
dass der verwendete Laufwerksbuchstabe, dem der Cashbox-Konfiguration entspricht (z.B.
„D:“) .
Starten Sie die Middleware zu Testzwecken mit dem Kommandozeilenbefehl „Test.cmd“ mit
Administratorrechten.
Alternativ installieren Sie unsere Middleware dauerhaft als Windows-Dienst auf die Kasse,
indem Sie den Kommandozeilenbefehl „install-service.cmd“ mit Administratorrechten einge-
ben.
Der mit Test.cmd gestartete Launcher sucht zunächst nach Updates und startet dann unsere
Middleware. Hierbei wird u.a. angezeigt, welche Cashbox-Id genutzt wird und welche End-
punkte zur möglichen Nutzung konfiguriert sind.
42Installation und Start der Middleware
Mit der Zeile „fiskaltrust.Service started. Press a button to stop...“ ist unsere Middleware be-
reit Anfragen seitens der Kassensoftware oder eines Test-Clients entgegen zu nehmen.
43Funktionstest der Middleware und TSE
Funktionstest der Middleware und TSE
Nachdem unsere Middleware wie in den zuvor durchgeführten Schritten konfiguriert und
mit „test.cmd“ mit Administratorrechten gestartet ist, können verschiedene Programme
zum Test genutzt werden:
• Unsere Middleware Demo in der verschiedenste Kommunikationsprotokolle genutzt
werden und auch viele JSON Business Case Beispiele zum Test beiliegen:
https://github.com/fiskaltrust/middleware-de-demo-dotnet
• Mit dem frei erhältlichen Programm „Postman“
• Mit dem frei erhältlichen Programm „SoapUI“
• Mit der eigenen Kassensoftware
So können Anfragen an den gestarteten Dienst gesendet werden (Belege signieren, Journal-
daten abrufen oder ein einfaches „echo“ zum Testen der Aufrufschnittstellen).
Endpunkte für Aufrufe
Grundsätzliches zur Endpunktkonfiguration:
die scheme http, https, net.tcp, net.pipe hosten einen wcf-endpunkt,
das scheme rest hostet einen rest-endpunkt,
das scheme grpc hostet einen grpc-endpunkt.
Die Rest Endpunkte der fiskaltrust.Middleware für Client Aufrufe sind
baseUrl (lt.Portal)/v0/journal
baseUrl (lt.Portal)/v1/sign
baseUrl (lt.Portal)/v1/echo
Für JSON-Aufrufe baseUrl (lt.Portal)/json/v0/journal
baseUrl (lt.Portal)/json/v1/sign
baseUrl (lt.Portal)/json/v1/echo
Für XML-Aufrufe baseUrl (lt.Portal)/xml/v0/journal
baseUrl (lt.Portal)/xml/v1/sign
baseUrl (lt.Portal)/xml/v1/echo
Beispiel: http://localhost:1200/bbe97288-3b95-414d-953a-e2de95174729/json/v1/sign
Beispiel Postman:
Zum Testen senden wir ein Start-Receipt zum einmaligen Initialisieren einer neuen Kasse:
44Funktionstest der Middleware und TSE
45Zusätzliche Dokumentationen & Support
Zusätzliche Dokumentationen & Support
Wichtige Dokumente
Unseren Quick Guide finden Sie unter
https://fiskaltrust.de/dokumente/
FAQ
Das Benutzerhandbuch sowie eine Dokumentation der fiskaltrust.Middleware nebst Code-
Sammlungen für Aufrufe liegen unter https://fiskaltrust.de/faq.
JSON Beispiel Dokumentation
Weitere Dokumentation und Beispiele in JSON finden Sie in unseren Dokumenten
Deutsch: „fiskaltrust Geschäftsvorfälle in JSON“.
Englisch: „fiskaltrust Business Cases“
Interface Dokumentation
Darüber hinaus finden Sie weitere Hinweise und den gesamten Befehlssatz der Middleware
in unseren Schnittstellen-Dokumentation:
„fiskaltrust-Interface-Doc“
Support
Bei Fragen steht Ihnen der fiskaltrust-Support unter info@fiskaltrust.de zur Verfügung.
46Sie können auch lesen
