Cloud-TSE implementieren

Rufen Sie das fiskaly Dashboard auf. Sie können sich mit Ihrem Google, LinkedIn, Microsoft Konto sowie mit Ihrer E‑Mail Adresse bei fiskaly anmelden. Im Anschluss an die Registrierung erhalten Sie eine E‑Mail, um Ihr Konto zu aktivieren. 

Beim ersten Login werden Sie aufgefordert, eine (Test-)Organisation anzulegen. Füllen Sie dazu den Namen der Organisation (Schritt 1) sowie die Adressfelder aus (Schritt 2). Im letzten Schritt wird standardmäßig die Adresse der Organisation hinterlegt. Zum Testen können Sie auch ohne die Rechnungsadresse anzugeben die Organisation erstellen.

Klicken Sie zum Abschluss auf ‘Erstellen’. Nun können Sie das fiskaly System kostenlos testen. Das fiskaly Dashboard Benutzerhandbuch finden Sie auf developer.fiskaly.com.

Postman ist ein beliebtes Werkzeug zum Testen von APIs. Eine intuitive, grafische Benutzeroberfläche sowie geringe Programmier-Vorkenntnisse sind Vorteile vom Testen mit Postman. Zudem werden durchgeführte Tests abgespeichert und sind wiederholbar.

So haben Sie die Möglichkeit unsere APIs im Detail zu testen und bekommen einen guten Überblick über die Zusammenhänge und Abläufe. Deswegen stellt auch fiskaly Postman Environment und Postman Collection zum Testen der fiskaly API zur Verfügung. Stellen Sie sicher, dass Sie immer mit der aktuellen Environment und Collection testen. So wird gewährleistet, dass die letzten Updates abgebildet werden.

Die Gestaltung des Organisationsmanagements im fiskaly System ist ein wichtiger Baustein bei der Integration der fiskaly Cloud-TSE. Überlegen Sie in einem ersten Schritt, wie Sie Ihre Organisationsstruktur am Besten bei uns abbilden können. Beachten Sie, dass Sie in dieser Phase den zukünftigen Managementaufwand im Betrieb bestimmen.

Da die Organisations- und Kundenstrukturen unserer Kunden sehr vielfältig sind, haben wir für Sie ein sehr flexibles und intuitives System entwickelt, das es Ihnen ermöglicht eine saubere Trennung von Kunden, Standorten und Hierarchien abzubilden.

Auf der Seite fiskademy Seite Organisationen im fiskaly System stellen wir auch Best Practice Beispiele zur Verfügung.

Oberstes Gebot bei der Implementierung ist, dass das POS-System am Laufen bleibt! fiskaly stellt umfassende Informationen und Ressourcen, die Sie bei der Implementierung unterstützen zur Verfügung. Die fiskaly online Ressourcen stellen wir Ihnen auf der fiskademy Seite ‘Ressourcen’ ausführlich vor. Darüber hinaus ist es wichtig zu verstehen, dass neben den technischen Anforderungen vor allem die rechtlichen Rahmenbedingungen eine übergeordnete Rolle spielen.

Im optimalen Fall wird unsere API so implementiert, dass der reibungslose Betrieb der Kasse jederzeit gewährleistet werden kann. Dabei gilt es einige Dinge zu beachten. Im Allgemeinen hängt dies stark von der Kassenarchitektur, der Frequentierung und dem Einsatzgebiet der Kasse ab. Ein weiterer Punkt ist, eine fehlende Signatur am Beleg bedeutet keineswegs, dass der Beleg nicht rechstkonform ist (siehe Punkt 7 AEAO zu § 146a). Die fiskaly API muss jedoch so implementiert sein, dass jede Transaktion eine Signatur abfragt. In der Infobox Tipps aus der Praxis haben wir wichtige Informationen für Sie kurz zusammengefasst.

Im fiskaly System ist die Standardeinstellung der Test-Modus und die initiale Aktivierung der Hauptorganisationen in den Live-Modus erfolgt manuell. Folgen Sie hierfür den Schritten im Dashboard oder wenden Sie sich an sales@fiskaly.com. Unterorganisationen können selbstständig livegeschalten werden. Die Ressourcen des Test- und des Live-Systems sind nicht miteinander verbunden. Änderungen im Test-System werden somit nicht in das Live-System übernommen und Sie können das Test-System weiterhin als Sandbox verwenden.

Bei der Umstellung von V1 auf V2 müssen Sie keine neuen Organisationen anlegen. Jedoch sollten Sie in jedem Fall die V1 Ressourcen deaktivieren, um eine mehrfache Verrechnung zu vermeiden. Selbstverständlich können Sie weiterhin auf die Daten der V1 Ressourcen zugreifen. Unter diese Link finden Sie mehr Informationen zum Umstieg auf V2.

Folgende Tipps aus der Praxis haben wir für Sie zusammengestellt:

Timeouts setzen

Diese hängen stark von der Frequentierung der Kasse ab. Sie sollten als Hersteller selbst entscheiden welche Timeout-Länge Sie für vernünftig erachten. Ein Request sollte in keinem Fall so lange geöffnet sein, dass der reibungslose Betrieb der Kasse gefährdet ist.

Bitte beachten Sie, dass im Falle der Unerreichbarkeit der TSE, der Kassiervorgang nicht gestört wird.

Autorisierung
Die Autorisierung erfolgt initial über API Key und API Secret. Sie erhalten einen “access token” und einen “refresh token” über die Sie sich laufend neu autorisieren können. Sollten Sie in eine “401” Antwort laufen, autorisieren Sie sich über API Key und Secret einfach erneut.

Oberstes Gebot bei der Implementierung ist, dass das POS-System am Laufen bleibt! fiskaly stellt umfassende Informationen und Ressourcen, die Sie bei der Implementierung unterstützen zur Verfügung. Die fiskaly online Ressourcen stellen wir Ihnen auf der Seite fiskademy Ressourcen ausführlich vor. Darüber hinaus ist es wichtig zu verstehen, dass neben den technischen Anforderungen vor allem die rechtlichen Rahmenbedingungen eine übergeordnete Rolle spielen.

Im optimalen Fall wird unsere API so implementiert, dass der reibungslose Betrieb der Kasse jederzeit gewährleistet werden kann. Dabei gilt es einige Dinge zu beachten. Im Allgemeinen hängt dies stark von der Kassenarchitektur, der Frequentierung und dem Einsatzgebiet der Kasse ab. Ein weiterer Punkt ist, eine fehlende Signatur am Beleg bedeutet keineswegs, dass der Beleg nicht rechstkonform ist (siehe Punkt 7 AEAO zu § 146a). Die fiskaly API muss jedoch so implementiert sein, dass jede Transaktion eine Signatur abfragt. In der Infobox Tipps aus der Praxis haben wir wichtige Informationen für Sie kurz zusammengefasst.

Die fiskaly SIGN DE - API ist eine RESTful API, die ein cloudbasiertes, virtuelles TSE (Technische Sicherheitseinrichtung) im Sinne der deutschen KassenSichV (Kassensicherungsverordnung) implementiert.

fiskaly Management API