Dashboard Benutzerhandbuch
Version 0.1
Mit dem fiskaly Dashboard haben Sie die volle Einsicht über Ihre gebuchten Produkte bei fiskaly. Es bietet die Möglichkeit Organisationen und deren Nutzer zu verwalten.
Ihr Benutzerkonto
Um das fiskaly Dashboard verwenden zu können, benötigen Sie einen eigenen Account. Diesen können Sie kostenlos unter obenstehender Adresse anlegen.
Registrierung und erster Login
- Sie haben die Möglichkeit mit Ihrem bereits bestehendem Google, LinkedIn Microsoft Konto ein fiskaly Konto zu erstellen. Alternativ können Sie auch mit dem Klick auf "Register" ein klassisches Konto mit Ihrer E-Mail Adresse eröffnen.
- Nach Abschluss der Registrierung erhalten Sie eine E-Mail um diese zu aktivieren. Der Aktivierungslink ist hierbei lediglich 5 Minuten gültig!
- Sofern Sie nicht bereits in eine Organisation eingeladen worden sind, erscheint nun die Aufforderung eine solche anzulegen. Das Anlegen einer Organisation ist kostenfrei. Sollten Sie unser System lediglich testen wollen, können Sie hier einfach eine Testorganisation ohne weitere Kosten anlegen. Füllen Sie dazu unter Schritt 2 den Namen der Organisation sowie die Felder für Ihre Adresse aus.
- (Optional) Im letzten Schritt können Sie eine Rechnungsadresse definieren. Standardmäßig wird die Adresse der Organisation hierfür hinterlegt. Sollten Sie dies nicht wünschen, können Sie auf "Rechnungsadresse leer lassen" klicken. In jedem Fall bleibt Ihr Benutzerkonto kostenlos. Wir verrechnen lediglich LIVE Instanzen, welche Sie in einem späteren Schritt erstellen können.
- Klicken Sie zum Abschluss auf "Erstellen".
Herzlichen Glückwunsch! Sie haben Erfolgreich Ihre erste Organisation angelegt.
Regulärer Login
Sollten Sie bereits mehrere Organisationen erstellt oder in bereits existierende Organisationen eingeladen worden sein, erscheint nach dem Login eine Auswahlliste all Ihrer Organisationen in denen Sie berechtigt sind. Andernfalls wird automatisch Ihre Organisation ausgewählt.
Navigierung im Dashboard
Das Dashboard ist in mehrere Kategorien aufgebaut. Einerseits beinhaltet es alle wichtigen Menüpunkte für die SIGN DE API (KassenSichV), andererseits stellt Sie auch Bereiche für Benutzer- und Organisationsverwaltung sowie Nachschlagewerk und Hilfsquellen für Entwickler zur Verfügung.
Hier sei nun einmal die Menüführung für die SIGN DE API (KassenSichV) kurz erklärt.
Dashboard Übersicht
Übersicht und Einblicke der bei uns gebuchten Produkte sowie Statistiken zu Ihrer Verwendung.
Technische Sicherheitseinrichtung
Unter diesem Menüpunkt finden Sie eine Auflistung der bei fiskaly gebuchten TSEs und deren Status. Mit einem Klick auf die ID der TSE erhalten Sie weitere Informationen. Außerdem können Sie hier einen Export auslösen indem Sie am Ende der Tabelle auf den dafür zuständigen Button klicken.
Die Detailseite der TSE bietet weitere Informationen wie:
- TSE ID
- Beschreibung
Der von Ihnen gewählte Beschreibungstext - Status
Der derzeitige Zustand der TSE - Transaktionszähler
- Signaturzähler
- Seriennummer des Zertifikats
- Erstellungsdatum
- Initiierungsdatum
- Auflistung der Clients dieser TSE
- Auflistung der Transaktionen dieser TSE
- Auflistung der Exporte dieser TSE
Clients
Dieser Menüpunkt bietet eine Auflistung aller Clients, unabhängig ihrer TSE. Mit Klick auf deren ID werden weitere Informationen sowie eine Auflistung der Transaktionen angezeigt.
Auf der Detailseite des Clients erhalten Sie außerdem noch folgende Informationen:
- Client ID
- TSE ID
- Seriennummer
- Erstellungsdatum
- Auflistung der Transaktionen
Transaktionen
Unter diesem Menüpunkt finden Sie eine Auflistung aller Transaktionen, unabhängig, der TSE und der Clients. Mit Klick auf die Transaktions-ID gelangen Sie zur Detailseite der Transaktion.
Auf der Detailseite finden Sie weitere Informationen, wie:
- Revisionen
Bei mehreren Revisionen kann zwischen diesen gewechselt werden. - Typ
- Schema
- Status
- Startdatum
- Transaktionsnummer
- Transaktionszähler
- TSE ID
- Client ID
- Transaktions ID
- Signaturwert
- Seriennummer des Zertifikats
- Signierte Daten
- Payload
Exporte
Hier finden Sie eine Übersicht der Exporte die derzeit in Erstellung sind oder bereit zum Download stehen. In der Download-Spalte können Sie die exportierten Daten herunterladen.
Integration
Es besteht die Möglichkeit fiskaly mit weiteren Services von Drittanbietern zu integrieren. Dies erweitert in der Regel die Bedienoberfläche des Dashboards oder startet bestimmte Automatisierungen im Hintergrund.
Unter diesem Menüpunkt sehen Sie den aktuellen Status Ihrer Integrationen mit Drittservices. Sie haben die Möglichkeit diese Verbindung einerseits herzustellen, andererseits auch wieder zu trennen.
Organisationsverwaltung
Dieser Menüpunkt befindet sich unter "Einstellungen" > "Organisationsverwaltung".
Die Organisation ist eine maßgebliche Einheit und bildet in der Regel eine Geschäfts- oder Zweigstelle ab. Natürlich ist es Ihnen überlassen, wie Sie Ihre Geschäftsstruktur abbilden möchten.
Wir unterscheiden zwischen Hauptorganisationen und Managed Organisationen. Letztere werden mit einem managed Badge markiert. Letztere ist von der Hauptorganisation abhängig und kann selbst keine weiteren managed Organisationen beinhalten. Eine Hauptorganisation kann keine Unterorganisation einer weiteren Organisation sein.
Organisation erstellen
Organisationen können kostenlos erstellt werden. Über das Dashboard können derzeit nur Hauptorganisationen angelegt werden. Managed Organisationen sollen aber auch in Zukunft über die Weboberfläche angelegt werden können.
Um eine Hauptorganisation anzulegen gehen Sie bitte wie folgt vor:
- Klicken Sie im linken, oberen Bereich auf Ihre derzeitige Organisation.
Es erscheint ein Dropdown (oder Dialogfenster) mit einem Link am unteren Rand, um eine weitere Organisation zu erstellen ("Neue Organisation erstellen") - Füllen Sie zumindest die erforderlichen Felder im 1. und 2. Dialogfenster aus.
- Klicken Sie auf "Erstellen" oder auf "Rechnungsadresse leer lassen".
- Die neu erstellte Organisation wird automatisch für Sie ausgewählt.
Organisation wechseln
- Klicken Sie im linken, oberen Bereich auf Ihre derzeitig ausgewählte Organisation.
Es erscheint ein Dropdown (oder Dialogfenster). - Sollten Sie für mehr als fünf Organisationen berechtigt sein, erscheint ein Suchfeld, welches Ihnen erlaubt gezielt nach der gewünschenten Organisation zu suchen.
- Klicken Sie auf die Organisation, die Sie auswählen möchten.
Informationen anzeigen
In manchen Situationen, wie zbsp. für Support-Zwecke, kann es hilfreich sein, weitere Information zu Ihrer Organisation anzuzeigen, Hierfür klicken Sie auf das i-Symbol rechts neben der ausgewählten Organisation im linken, oberen Bereich.
Sie erhalten neben der Organisations-ID und -Namen die angegebene Adresse.
Organisation LIVE schalten
Standardmäßig sind alle Einheiten die auf fiskaly erstellt werden im TEST-Modus, sofern nicht bereits der LIVE Modus aktiviert wurde. Die initiale Aktivierung der LIVE-Umgebung passiert derzeit noch manuell. Hierfür wenden Sie sich bitte an unser Sales-Team unter sales@fiskaly.com und teilen Sie Ihre Organisations ID mit (siehe Informationen anzeigen oben).
Sobald der LIVE Modus für Ihre Organisation freigeschaltet wurde, wird anstelle des "LIVE-Modus aktivieren"-Buttons ein Umschaltknopf eingeblendet mit welchem der Modus gewechselt werden kann. Es werden nur Einheiten für den jeweiligen Modus dargestellt. Um neue Einheiten im LIVE-Modus erstellen zu können muss ein neuer API Schlüssel im LIVE-Modus erzeugt werden.
Organisations-Logo hinterlegen
Für die bessere Unterscheidung der einzelnen Organisationen ist es möglich, ein Firmen-/Organisations-Logo zu hinterlegen. Klicken Sie dazu auf das Firmen-Platzhalter-Logo im linken Bereich und wählen Sie das von Ihnen gewünschte Logo für Ihre Organisation aus.
Benutzerverwaltung
Unter "Einstellungen" > "Benutzerverwaltung" können Sie weitere Benutzer zu Ihrer Organisation einladen.
Benutzer zur Organisation einladen
Klicken Sie auf den Button "Zur Organisation einladen" und tragen Sie anschließend die E-Mail Adresse im Feld ein.
Sollte die angegebene E-Mail Adresse bereits in unserem System hinterlegt sein, wird der Benutzer lediglich informiert, dass dieser zu Ihrer Organisation hinzugefügt wurde.
Falls es sich um einen neuen Benutzer handelt, wird ein Account erstellt, welcher vom Inhaber der E-Mail Adresse innerhalb von 48 Stunden aktiviert werden muss.
API Schlüssel
Dieser Menüpunkt befindet sich unter "Einstellungen" > "API Schlüssel".
Ein API Schlüssel ist an eine Organisation sowie an den gewählten Modus gebunden. Das bedeutet, dass dieser auch nur für eine Organisation funktioniert. Sollte der API Schlüssel im TEST-Modus erstellt worden sein, können mit diesem auch lediglich Entitäten zu Testzwecken erzeugt werden. Mit einem Schlüssel, der im LIVE-Modus erstellt wurde können auch nur LIVE Entitäten produziert werden.
Hier können Sie Ihre API Schlüssel verwalten, neue erstellen und bei Bedarf auch wieder löschen.
Entwickler
Dokumentationen und der Changelog sind hier zu finden.
Weiterführende Links
Sie finden unter der Kategorie "Entwickler" weitere Links zu Dokumentationen rund um unsere Systeme und Guides.