TSE - Fiskaltrust
Installation/Einrichtung einer TSE mit Fiskaltrust
- Fiskaltrust einrichten
- Fiskaltrust-Account registrieren
- Fiskaltrust mit hope verknüpfen
- Fiskaltrust API-Key auslesen
- Swissbit USB-TSE auf Laufwerk T: einstellen
- Vorabinstallation der TSE
- ftInstaller - Fiskaltrust lokal konfigurieren
Fiskaltrust einrichten
Einrichtung des Fiskaltrust-Accounts
Fiskaltrust-Account registrieren
Um hope mit einer TSE verknüpfen zu können, wird als Middleware Fiskaltrust eingesetzt. Dies ermöglicht uns, unterschiedliche TSE-Module anbinden und somit flexibel auf Veränderungen im Markt reagieren zu können. Um Fiskaltrust nutzen zu können, wird ein Fiskaltrustaccount zwingen benötigt, da die Kommunikation über diesen abgewickelt wird. Der Basisaccount ist kostenfrei und für alle benötigten Grundfunktionen ausreichend. Weitergehende kostenpflichtige Optionen wie z.B. automatische Meldungen an das Finanzamt etc. sind optional.
Sollten Sie z.B. durch Ihre Kassenlösung bereits einen Account bei Fiskaltrust besitzen, können Sie diesen natürlich auch für hope verwenden. Dieser muss dann lediglich noch mit hope als Kassenhersteller verbunden werden. Hilfe zum Verknüpfen der Accounts finden Sie hier: Fiskaltrust mit hope verknüpfen.
Für die Registrierung Ihres Accounts wird Ihre Steuernummer, Ihre Umsatzsteuer-ID sowie eine gültige Email-Adresse benötigt. Bitte halten Sie dies bereit.
Die Registrierung erfolgt über das Fiskaltrust-Portal. Dies erreichen Sie hier über diesen Link oder direkt unter https://portal.fiskaltrust.de.
Zum Starten der Registrierung unten auf den Button "Registrierung" klicken.
Im nächsten Schritt die Registrierung mit "Unternehmensdaten manuell erfassen" fortsetzen. Eventuell erfolgt über "reCaptcha" noch eine Abfrage um sicherzustellen, dass Sie kein Roboter sind.
Als nächstes müssen Sie hier dann Ihre Stammdaten Ihres Betriebes erfassen. Bitte geben Sie hier auch Ihre Steuernummer/Umsatzsteuer-ID an. Diese wird für zwingend für die Meldungen an das Finanzamt benötigt.
Wichtig!!! - Bitte geben Sie hier Ihre Adressdaten sorgsam ein und überprüfen diese dann nochmals. Falls Sie einen Swissbit-USB-Stick als TSE bestellt haben, wird dieser an die hier angegebene Adresse versendet.
Danach muss noch der Benutzer und eine entsprechende Kontaktemail erfasst werden, um die Registrierung abzuschließen
Als letzter Schritt der Registrierung müssen noch die AGBs und die Datenschutzerklärung akzeptiert werden. Nach dieser Bestätigung ist die Registrierung abgeschlossen und es wird eine entsprechende Mail mit einem Bestätigungslink an die angegebene Email versendet.
In der erhaltenen Email klicken Sie dann auf "Link zur Bestätigung der E-Mail-Adresse". Dadurch werden Sie wieder zum Fiskaltrust-Portal zurück geleitet.
Dort können Sie nun Ihr Passwort erfassen. Bitte wählen Sie unbedingt ein sicheres Passwort, da mit dem Zugang eine Einsicht/Änderung Ihrer kompletten Finanzdaten möglich ist.
Nach dem Login werden Sie direkt auf die Übersichtseite Ihres Hotels weitergeleitet. Hier müssen Sie als erstes die Rolle Ihres Accounts als "KassenBetreiber" festlegen. Damit wird diese von der Funktionalität so eingerichtet, wie Sie es zum TSE-Betrieb mit einer Kasse benötigen.
Nachdem Sie den Schalter bei der Rolle "Kassenbetreiber" aktiviert haben, wird Ihnen der entsprechende Nutzungsvertrag angezeigt.
Bitte lesen Sie den Vertrag durch und akzeptieren diesen digital mit Ihrem Namen.
Nach der Unterzeichnung ist Ihre Rolle als Kassenbetreiber definiert und Ihr Account entsprechend eingerichtet.
Damit ist die Registrierung abgeschlossen und Ihr Account bei Fiskaltrust erstellt. Nun können Sie Ihren Account mit hope verbinden, damit wir Zugriff auf Ihre Einstellungen und Ihre Konfiguration erhalten. Dazu fahren Sie mit der Einrichtung wie auf der nächsten Seite beschrieben fort: Fiskaltrust mit hope verknüpfen.
Fiskaltrust mit hope verknüpfen
Damit hope auf Ihre Konfiguration zugreifen kann und wir alle benötigten Einstellungen ohne Ihr Zutun vornehmen können, muss Ihr Fiskaltrust-Account mit hope als Kassenhersteller verknüpft werden. Wenn Sie noch keinen Account bei Fiskaltrust haben, müssen Sie sich erst dort registrieren. Hilfe dazu finden Sie unter Fiskaltrust-Account registrieren.
Dazu bitte im Menü links auf PosOperator und dann in dem Untermenü auf "Händler/Berater suchen" gehen. In dem nun folgenden Suchfenster geben Sie bitte "hope" ein und klicken auf "Suche"
Es wird Ihnen dann unser Herstelleraccount "hope-Software GmbH" angezeigt. Bitte achten Sie ebenfalls auf die Email-Adresse. Diese muss "info@hope-Software.com" oder "Steffen.Diemer@hope-Software.com" lauten. Als Zugriffsrechte benötigen wir Lese- und Schreibrechte. Daher wählen Sie bitte das voreingestellte "Schreiben/Lesen" aus und fordern die Verbindung mit "Zuordnung anfordern - Händler" bei uns an.
Bis Ihre Anfrage bei uns bearbeitet und Ihrer Anforderung zugestimmt wurde, ist Ihr Status bei der Anfrage rot.
Sobald die Anfrage von uns genehmigt wurde, ist der Status dann ein blaues Häkchen. Nun sind ist Ihr Account mit hope verbunden und Sie können mit der Einrichtung Ihrer Cashbox fortfahren.
Sollte es einmal gewünscht sein, können Sie die Verbindung hier auch jederzeit wieder aufheben.
Fiskaltrust API-Key auslesen
Ihre Cashbox für hope können Sie mit Hilfe unseres Tools ftInstaller einfach und schnell erstellen. Das Tool benötigt dafür Zugang zu Ihrem Account über die Fiskaltrust API. Diesen Gewähren Sie mit Ihrem API-Key und Ihrem API-Token.
Diese Schlüssel finden Sie im Hauptmenu unter Ihrem Hotel im ersten Menüpunkt "Übersicht". Beide Werte können Sie hier einfach in die Zwischenablage kopieren und danach in das hope-Tool ftInstaller bei den entsprechenden Feldern einfügen.
Um Mißbrauch auszuschließen, können Sie diese Keys jederzeit zurücksetzen und neu generieren lassen.
Swissbit USB-TSE auf Laufwerk T: einstellen
Die Laufwerksbezeichnung T: hat sich als Standard für die TSE-Sticks entwickelt. Dies ist keine zwingende Voraussetzung, jedoch vereinfacht eine einheitliche Umgebung das Handling und die Fehlersuche im Supportfall. Daher empfehlen wir Ihnen, Ihren TSE-Stick auf dieses Laufwerk einzustellen. Dies ist mit wenigen Mausklicks zu bewerkstelligen.
Klicken Sie mit der rechten Maustaste auf das Windows-Startmenü und wählen aus der Liste das Tool "Datenträgerverwaltung".
Hier werden alle verfügbaren Laufwerke aufgelistet. Suchen Sie hier Ihren Swissbit-TSE-Stick und klicken mit der rechten Maustaste auf den Namen und wählen "Laufwerksbuchstabe und -pfade ändern"
Hier sehen Sie den zugeordneten Laufwerksbuchstaben. Über "Ändern" können Sie diesen anpassen.
Wählen Sie hier "T" aus der Liste und bestätigen mit "OK". Danach kann die Datenträgerverwaltung wieder geschlossen werden.
Vorabinstallation der TSE
Ab der Version 5.6.3.0 kann die TSE vorbereitete und der Fiskaltrustdienst installiert werden.
Folgende Vorbereitungen benötigen Sie für diese Installation:
- Sie müssen einen Account bei Fiskaltrust anlegen. Hier finden Sie eine Anleitung, wie Sie sich schnell und einfach bei Fiskaltrust registrieren und einen Account Anlegen können:
Fiskaltrust-Account registrieren - Ihr Fiskaltrust-Account muss mit unserem Account bei Fiskaltrust verbunden werden, damit wir Ihre TSE anlegen und konfigurieren können
- Ihre Steuernummer (nicht Ihre Umsatzsteuer-ID muss bei diesem Account in den Stammdaten hinterlegt sein. Ohne diese Nummer können wir keine TSE für Sie erstellen und konfigurieren
- Sie müssen uns mitgeteilt haben, welche TSE (SwissBit-USB-Stick oder Deutsche Fiskal Cloud-TSE) Sie nutzen möchten
Nach dem Start von hope erscheint die Installationsauswahl für Ihre TSE.
Als erstes müssen Sie sich bei Fiskaltrust registrieren bzw. die Registrierung bestätigen. Sobald Ihr Account erstellt und mit unserem Account verbunden ist, werden wir entsprechend von Fiskaltrust benachrichtigt. Danach bereitet unser Support alle notwendigen Schritte für Ihre individuelle TSE vor und stellt diese zum Download bereit.
Bei jedem Neustart von hope wird überprüft, ob diese Daten zur Verfügung stehen. Sobald diese bereit stehen, wird der Button grün und sie können mit dem nächsten Schritt fortfahren.
Die Konfiguration unterscheidet automatisch zwischen einem TSE-Stick und einer TSE-Cloud und führt die entsprechend notwendigen Schritte im Hintergrund aus.
Bei einem Swissbit-TSE-Stick müssen Sie das entsprechende Laufwerk angeben. hope versucht, dieses Laufwerk selbst zu ermitteln. Um eine einheitliche Umgebung zu gewährleisten wird empfohlen, den Laufwerksbuchstaben auf T: festzulegen. Dies kann mit wenigen Mausklicks durchgeführt werden. Eine Anleitung dazu erhalten Sie hier; Swissbit USB-TSE auf Laufwerk T: einstellen.
Nach Abschluss der Konfiguration wird dieser Button grün und Sie können mit dem nächsten Schritt, der Installation des Fiskaltrust-Dienstes weiter fortfahren.
Wichtig!!! - für die Installation des Dienstes benötigen Sie zwingend Adminstratorenberechtigung. Sollten Sie nicht als Administrator eingeloggt sein oder über diese Rechte verfügen, führen Sie bitte diesen Schritt erst dann durch, wenn Sie entsprechende Zugangsdaten vorliegen haben!
Danach müssen Sie festlegen, wie der Dienst benannt werden soll und in welches Verzeichnis die Dateien installiert werden. Die Standardbezeichnung ist "hopeFiskaltrustService", das Standard-Verzeichnis das Verzeichnis "HOPE-IFC\hopeFiskaltrustService" auf dem Laufwerk und der Ebene das HOPE-Verzeichnisses. Wenn nichts Zwingendes dagegen spricht (Installation mehrerer TSEs auf einem Rechner" sollten Sie dies nicht ändern.
Nach dem Bestätigen werden die Dateien für den Dienst in das gewählte Laufwerk entpackt.
Danach müssen Sie festlegen, ob es sich bei dem PC um einen Einzelplatzrechner mit einem hope-Arbeitsplatz oder um ein Mehrplatzsystem handelt. Dies ist wichtig, um die Erreichbarkeit der TSE von allen Arbeitsstationen sicherzustellen. Bei einem Einzelplatz wird der Dienst immer mit "localhost" angesprochen und ist damit unabhängig von der IP-Adresse erreichbar. Bei einem Mehrplatz-System muss der Dienst unter einer festen IP erreichbar sein, die sich nicht ändert. Dies können Sie in den Netzwerkeinstellungen von Windows oder in Ihrem Router festlegen. Bei einer dynamischen IP ist der Dienst und somit die TSE nicht zuverlässig für die anderen Arbeitsstationen erreichbar. Klären Sie diese eventuell mit Ihrem IT-Beauftragten ab.
Nachdem die Konfiguration dann abgeschlossen ist, kann der Dienst installiert werden. Dazu wird ein externes Installationstool gestartet.
Dieses Tool benötigt wie oben erwähnt Administrationsrechte.
Zuerst wird der Dienst im Test-/Debugmodus gestartet. Dieser erste Start kann mehrere Minuten benötigen, da hier alle benötigten Programmmodule individuell nachgeladen werden. Parallel wird geprüft, ob eine Verbindung zu dem Dienst möglich ist.
Wenn die Verbindung im Testmodus hergestellt werden konnte, wird der Dienst installiert und anschließend wird versucht, den Dienst zu starten.
Konnte nach dem Start eine Verbindung zu dem Dienst hergestellt werden, ist die Installation abgeschlossen.
Danach können Sie die Verbindung jederzeit mit der Erstellung eines Nullbeleges testen. Gehen Sie dazu im Menü unter Finanzen auf Fiskaltrust - Deutschland - TSE-Belege.
Dort wählen Sie dann den Nullbeleg aus.
Der Nullbeleg enthält keinerlei Summen oder Daten und kann somit jederzeit verwendet werden, um die TSE zu prüfen und Daten von der TSE abzufragen. Sobald die TSE aktiviert ist, werden mit diesem Beleg auch alle Infos der TSE abgefragt und auf dem Nullbeleg mit ausgegeben.
Solange die TSE noch nicht mit einem Startbeleg (hope Version 6.0) aktiviert wurde, können noch keine Signaturen durchgeführt werden.
Ob die Verbindung zu Fiskaltrust problemlos funktioniert sehen Sie an der Vergabe einer fortlaufenden Belegnummer.
ftInstaller - Fiskaltrust lokal konfigurieren
Erstellen eine Cashbox in Fiskaltrust für Swissbit-TSE oder Fiskaly-TSE und den Fiskaltrust-Dienst installieren und aktivieren
Cashbox mit ftInstaller anlegen
Alle lokalen Schritte können mit dem Installationstool ftInstaller erheblich vereinfacht werden.
Die Startdatei ftInstaller.exe befindet sich normalerweise innerhalb des hope-Verzeichnisses in dem Verzeichnis ftInstaller. Diese können Sie hier manuell starten. Alternativ werden Sie normalerweise nach dem Update von hope aufgefordert, Ihre Fiskaltrust-Konfiguration mit Hilfe des Tools zu erstellen. Danach wird das Tool automatisiert aufgerufen.
Das Tool muss auf dem PC, auf dem hope installiert ist, ausgeführt werden. Dies ist normalerweise der Hauptrechner, auf den die anderen Stationen zugreifen oder ein separater Server, auf dem hope installiert ist. Bei Zweifeln fragen Sie bitte Ihren IT-Verantwortlichen. Bei einem Einzelplatz spielt dies natürlich keine Rolle - dies ist automatisch der Haupt-PC.
Bei Verwendung einer lokalen Hardware TSE (z.B. Swissbit USB-Stick) muss diese ebenfalls zwingend direkt an diesem PC angeschlossen sein.
Nach dem Start des Tools können Sie alle benötigten Daten erfassen. Die Cashbox wird dann im Hintergrund automatisch bei Fiskaltrust angelegt und der Dienst lokal installiert und konfiguriert.
Als erstes müssen Sie die API-Daten von Ihrem Fiskaltrust-Account eingeben, damit das Tool Zugriffsberechtigung hat und Ihre Cashbox dort anlegen und konfigurieren kann. Sollten Sie noch keinen Fiskaltrust-Account haben, müssen Sie diesen vor Benutzung des Tools erst anlegen und aktivieren. Die notwendigen Schritte dazu sind hier beschrieben:
Fiskaltrust-Account registrieren.
Die benötigten API-Daten finden Sie in Ihrem Fiskaltrust-Account unter dem Menüpunkt "Übersicht" bei Ihren Hotel-Daten.
Als nächstes wählen Sie Ihre gewünschte TSE aus. Bei der Auswahl eines Swissbit-TSE-USB-Sticks müssen Sie lediglich das entsprechende Laufwerk auswählen, das der USB-Stick benutzt. Wir empfehlen das Laufwerk T: zu wählen, da einheitliche Umgebungsbedingungen die Fehlersuche im Supportfall erheblich erleichtern. Wie Sie den Laufwerksbuchstaben des Sticks ändern können, ist hier beschrieben:
Bei der Auswahl einer Fiskaly-CloudTSE müssen Sie lediglich die erhaltenen Zugangsdaten in die entsprechenden Felder eintragen. Die Zugangsdaten werden Ihnen nach Beauftragung und Freischaltung Ihrer Fiskaly-TSE zur Verfügung gestellt.
Die Bezeichnung der Cashbox können Sie frei wählen. Diese muss innerhalb Ihres Accounts nur eindeutig sein, falls Sie mehrere Cashboxen benötigen. Bitte wählen Sie den Namen so, dass Sie die Cashbox später einfach zuordnen können.
Bei mehreren Standorten (Outlets) können Sie dies hier angeben. Beachten Sie bitte, dass das Outlet bereits in Ihrem Fiskaltrust-Account angelegt sein sollte, bevor Sie hier eine Cashbox darauf konfigurieren. Wenn Sie keine Standorte benutzen, wählen Sie hier Outlet 1.
Diese Option ist nur für Test-/Supportzwecke und daher deaktiviert.
Nun wurden alle benötigten Angaben getätigt und die Cashbox kann angelegt werden.
Nach erfolgreicher Anlage der Cashbox bei Fiskaltrust erscheint die ID der Cashbox sowie das zugehörige API-Token in den entsprechenden Feldern.
Nun sehen Sie die eben angelegt Cashbox auch in Ihrem Fiskaltrust-Account unter Konfiguration-CashBox und können diese dort ebenfalls nochmals überprüfen.
Als nächstes müssen Sie das Verzeichnis eingeben, in dem der Dienst installiert werden soll. Dies ist standardmäßig das Verzeichnis HOPE-IFC/hopeFiskalTrustService auf dem Laufwerk, auf dem auch hope installiert ist. Falls in Ihrem Fall ein anderer Installationsort geeigneter ist, können Sie dies hier anpassen.
Nun können Sie über "Fiskaltrust-Service installieren" den benötigten Dienst auf Ihrem System einrichten.
Dazu öffnet sich ein neues Fenster mit den entsprechenden Optionen.
Als erstes müssen die benötigten Dateien des Dienstes in das gewünschte Verzeichnis entpackt werden.
Das Entpacken benötigt einen kurzen Moment.
Wurden die Dateien fehlerfrei entpackt, wird sowohl die Zahl 1 vorne grün angezeigt als auch die Option durch einen grünen Haken am Ende als erfolgreich gekennzeichnet.
Nun ist auch der zweite Button aktiv, mit dem der Dienst auf die soeben angelegte Cashbox konfiguriert werden kann.
Die erfolgreiche Konfiguration wird ebenso auch optisch bestätigt und der dritte Button ist aktiv. Hier kann der dienst im Testmodus aufgerufen werden. Hier ist dann zu erkennen, ob der Dienst einwandfrei funktioniert und die entsprechende TSE gefunden und richtig angesprochen werden kann.
Nach dem Start des Testmodus werden die benötigten Dateien nachgeladen und aktualisiert. Dieser Vorgang dauert ein Moment. Bitte warten Sie unbedingt, bis der Vorgang beendet und die TSE aktiviert wurde.
Sie erkennen dies, wenn die Daten der TSE erfolgreich abgefragt werden konnten und von dem Dienst angezeigt werden. Der Dienst wartet nun mit "Press a button to stop" auf die Kommunikationsbefehle.
Wechseln Sie nun wieder zu dem Tool und bestätigen die Abfrage.
Danach wird versucht, eine Verbindung zu dem Dienst aufzubauen. Wenn dies erfolgreich durchgeführt werden kann, sehen Sie die Meldung "{Message":"hope Test Fiskaltrust"} in dem Testfenster.
Damit wurde der Dienst erfolgreich konfiguriert und ist erreichbar und kann nun installiert werden.
Zur Installation klicken Sie den entsprechenden Button. Es wird nun versucht, den Dienst in Ihrem System einzurichten und zu starten. Wird die Ziffer 4 grün hinterlegt, konnte der Dienst installiert werden.
Dazu müssen Sie unterscheiden, ob es sich bei Ihrem PC um einen Einzelplatz oder Mehrplatz- bzw. Serverumgebung handelt. Entsprechend wird der Dienst unabhängig von der IP des PCs über localhost oder direkt über die IP-Adresse angesprochen. Bei einer Serverumgebung ist es wichtig, dass es sich hierbei um eine feste IP handelt, die sich nicht ändert. Nur so ist gewährleistet, dass alle PC den Dienst sicher erreichen könne. Ebenso muss die Firewall entsprechend konfiguriert werden, dass die benutzten Ports nicht blockiert werden. Bitte stellen Sie Ihren Router bzw. Ihre Firewall entsprechend ein oder wenden sich dafür an Ihre IT.
Wenn die Verbindung hergestellt werden konnte, ist der Dienst korrekt eingerichtet und erreichbar.
Bei einer Serverumgebung erfolgt nochmals die Abfrage um sicher zu stellen, dass es sich um eine feste, von allen Arbeitsstationen erreichbare IP-Adresse handelt.
Herzlichen Glückwunsch!
Wenn Sie dieses Bild sehen, haben Sie den Dienst erfolgreich eingerichtet und die Konfiguration Ihrer TSE kann in hope fortgesetzt und mit der Erstellung des Startbeleges angeschlossen und die TSE aktiviert werden.