Zertifikate

Um den gesetzlichen Anforderungen zu entsprechen müssen Sie auf V2 migrieren. Für die Übergangsfrist hat die V1 unserer API bereits einen sehr hohen Schutz vor Manipulation gewährleistet, ist aber nicht zertifiziert und entspricht somit nicht den gesetzlichen Anforderungen an eine Technische Sicherheitseinrichtung. Die zertifizierte V2 ist weiterhin softwarebasiert und die Zertifizierung ist ohne Einschränkung bis 2029 gültig.

Warum auf V2 migrieren?

Video Migration zu V2

Im Video erfahren Sie in Kürze das Wichtigste zur Migration / Integration der fiskaly Cloud-TSE V2.

Anschließend haben Sie einen guten Überblick über die relevanten Thematiken der Migration / Integration der fiskaly Cloud-TSE V2.

Migration zu V2

Neben zusätzlich erforderlichen Schritten in der Authentifizierung (PIN und PUK), werden der fiskaly Client und Service nicht mehr angeboten. Wir möchten die Implementierung so einfach wie möglich halten. Es ist ein HTTP-Client Ihrer Wahl für die Kommunikation mit unserer API ausreichend. Mit der Migration zu V2 erwartet Sie ein überarbeitetes System, das besser und stabiler funktioniert als V1.

Was hat sich geändert?

Um es kurz zu machen — der Rest: Wir sind dem Prinzip unserer Lösung treu geblieben und Sie können wie gewohnt auf bewährte Methoden und Abläufe der fiskaly Cloud-TSE vertrauen.

Was ist gleich geblieben?

fiskaly Cloud-TSE Migration V1 zu V2. Warum die Migration auf die fiskaly Cloud-TSE V2 wichtig ist und Sie diese unbedingt jetzt umsetzten sollten, erfahren Sie in diesem Artikel.

[Weiter zum Blogbeitrag](/articles/cloud-tse-migration-zu-v2)

[](/articles/cloud-tse-migration-zu-v2/)

Blogbeitrag zum Thema

Neuigkeiten V2

Für Fragen zur Migration V1 zu V2

Verschwenden Sie keine Zeit und setzen die KassenSichV jetzt um!


## Nur die fiskaly Cloud-TSE V2 ist die zertifizierte TSE!

Die zertifizierte fiskaly Cloud-TSE ist stabil und kann nun integriert werden. Dazu migrieren Sie das System auf V2.

## Jetzt auf die Cloud-TSE V2 migrieren!

Starten Sie jetzt mit der zertifizierten Cloud-TSE von fiskaly durch. Dazu migrieren Sie das System von V1 zu V2. Mit V2 haben wir das System überarbeitet, verbessert und Ihr Feedback eingearbeitet. Somit ist V2 unser bestes und stabilstes System. 

Wichtig! V2 ist die einzige zertifizierte Cloud-TSE von fiskaly

## Warum ist die Migration zu V2 wichtig?

Um den gesetzlichen Anforderungen zu entsprechen müssen Sie auf V2 migrieren. Mit der Migration zu V2 erwartet Sie ein überarbeitetes System, das besser und stabiler funktioniert als V1.

## Die Vorteile im Überblick 

* V2 ist DIE zeritifizierte Cloud-TSE von fiskaly 
* Noch besseres System 
* Noch stabileres System 
* Kundenfeedback wurde berücksichtigt 
* Höhere Kundenzufriedenheit

Für Fragen steht Ihnen unser Sales Team unter [sales@fiskaly.com](mailto:sales@fiskaly.com) zur Verfügung.

Warum die Migration auf die fiskaly Cloud-TSE V2 wichtig ist und Sie diese unbedingt jetzt umsetzten sollten, erfahren Sie in diesem Artikel.

fiskaly Cloud-TSE Migration V1 zu V2

## fiskaly Cloud-TSE als einzige Cloud-TSE mit Zertifikatslaufzeit bis 2029

fiskaly erreicht mit dem Abschluss des Zertifizierungsverfahrens als einzige Cloud-TSE die volle Zertifikatslaufzeit und ist **bis 2029 zertifiziert**. Die fiskaly Cloud-TSE ist 100% softwarebasiert und kann in alle Systeme und Kassenarchitekturen eingebunden werden.

> Mehr als zwei Jahre Planung, Verschiebungen, Hürden und Veränderungen, wie auch Verbesserungen der Anforderungen liegen hinter uns. Nun ist es endlich soweit! Die zertifizierte fiskaly Cloud-TSE ist als erste Cloud-TSE über den vollen Zeitraum zertifiziert! Ich bin sehr stolz auf fiskaly und die unglaubliche Teamleistung der letzten Monate. 

Johannes Ferner, CEO fiskaly GmbH

## Hard Facts fiskaly Cloud-TSE

* Einzige Cloud-TSE mit der maximalen **Zertifikatslaufzeit bis 2029**!
* **Echte Cloud-TSE** ohne zusätzliche Hardware-Anforderungen wie ein TPM-Modul!
* Skalierbarer Betrieb & Roll-Out!
* Offen für innovative Handels-Konzepte!

## Download der Zertifikate

Selbstverständlich wollen wir Ihnen die Zertifikate auch hiermit überreichen:

### CSP‑L Zertifikat

### [![CSP‑L Zertifikat](/img/scpl.png "CSP‑L Zertifikat")](/img/cspl-zertifikat-fiskaly_-bsi-dsz-cc-1130-2021-ou-1-.pdf)

### SMAERS Zertifikat

### [![SMAERS Zertifikat](/img/smaers-zertifikat.png "SMAERS Zertifikat")](/img/SMAERS-Zertifikat-fiskaly_BSI-DSZ-CC-1130-2021.pdf)

### **TR-Zertifikat**

### [![TR-Zertifikat](/img/tr-zertifikat.png "TR-Zertifikat")](/img/tr-zertifikat_fiskaly_bsi-k-tr-0403-2021.pdf)

### ![](/img/logo-igztk.png) IGZTK — Mitglied werden

An dieser Stelle verweisen wir gerne auf die IGZTK — Interessensgemeinschaft Zukunftsweisender Technologiehersteller für Kassensysteme- und möchten Ihnen eine Mitgliedschaft nahe legen: [www.igztk.com](http://www.igztk.com)

Die fiskaly Cloud-TSE ist nun vollständig vom Bundesamt für Sicherheit in der Informationstechnik (BSI) zertifiziert worden! 🚀

fiskaly Cloud-TSE zertifiziert 🚀

Mit dem fiskaly Dashboard haben Sie Einsicht über Ihre bei fiskaly gebuchten Produkte. Über das Dashboard können Sie Organisationen und deren Nutzer anlegen und verwalten, einsehen, welche Transaktionen gestartet werden sowie welche Clients und technischen Sicherheitseinrichtungen (TSE) angelegt wurden. Es visualisiert Ihre Daten und Sie sehen mit einem Blick, was im fiskaly System passiert.

## Kostenlose Anmeldung beim fiskaly Dashboard
![Anmeldung-Dashboard_deutsch_fiskaly-Dashboard-und-Management-API](/img/anmeldung-dashboard_deutsch_fiskaly-dashboard-und-management-api-268x300.png)
Um das fiskaly Dashboard verwenden zu können, benötigen Sie einen eigenen Account. Diesen können Sie kostenlos anlegen. Alle Firmen, die Sie im Test anlegen, können nach Vertragsabschluss auch in den Live Modus geschalten werden.

[Hier geht es zum Dashboard.](https://dashboard.fiskaly.com/)

Info: Beim ersten Anmelden muss eine Hauptorganisation erstellt werden. Danach haben Sie die Möglichkeit Ihre Haupt- und Unterorganisationen über das Dashboard oder über die Management API anzulegen.

### fiskaly Dashboard Handbuch
Das ausführliche [Handbuch zum Dashboard gibt es auf der fiskaly Entwickler Website](https://developer.fiskaly.com/de/docs/guides/dashboard).

## Management API
Über die Management API können Sie auch alle Funktionen des Dashboards programmatisch lösen. Lediglich die erste Hauptorganisation muss über das Dashboard angelegt werden. Die detaillierte Dokumentation der Schnittstellen-Funktionen mit ihren Parametern finden sie auf der [fiskaly Entwickler Website](https://developer.fiskaly.com/api/management/v0/). 
**In der Management API werden die Begriffe *Organization* für Hauptorganisation und *Managed Organization* für Unterorganisation verwendet.**

### Organisationen und Benutzerrechte
Im fiskaly System wird zwischen Hauptorganisationen und Unterorganisationen unterschieden. Worin der Unterschied liegt und welche Auswirkungen das auf die Benutzerrechte hat, wird im Folgenden beschrieben.
Auf der fiskaly Entwickler Website sind alle [Informationen zu den Organisationen](https://developer.fiskaly.com/api/management/v0/#tag/Organizations) zu finden oder im [Dashboard Benutzerhandbuch](https://developer.fiskaly.com/de/docs/guides/dashboard#%20organisationsverwaltung).
### Was ist eine Hauptorganisation?
Eine Hauptorganisation ist eine maßgebliche Einheit im fiskaly System. Sie bildet in der Regel eine Holding, Geschäfts- oder Zweigstelle ab. Hauptorganisationen können kostenlos über das Dashboard angelegt werden. An sie können Unterorganisationen (im fiskaly System: *managed organizations*) angehängt werden. Unterorganisationen können auch über die Hauptorganisation verwaltet werden.
Im Organisationsmanagement können weitere Organisationen erstellt, Informationen eingesehen, zum Live Modus geschalten, ein Organisationslogo hinterlegt, User organisiert, API Keys für die Hauptorganisation erstellt und API Keys für die Unterorganisationen erzeugt werden. 

**Wichtig: eine Hauptorganisation kann keine Unterorganisation einer weiteren Hauptorganisation sein.**

### Benutzerrechte in der Hauptorganisation
Nutzer der Hauptorganisation, sowie Personen, die in die Hauptorganisation eingeladen werden, haben Zugriff auf alle Informationen, die im Dashboard der der Hauptorganisation angezeigt werden **sowie zu den Informationen der anhängenden Unterorganisation(en)** dieser Haupt- organisation. D.h. Übersicht Dashboard, TSE-Nummer(n), Client(s), Transaktionen, Exporte, Integrationen etc. werden den Nutzern angezeigt.
![Benutzerrechte in der Hauptorganisation](/img/nutzerrechte_deutsch_fiskaly-dashboard-und-management-api-243x300.png "Benutzerrechte in der Hauptorganisation")

### Was ist eine Unterorganisation?
Die Unterorganisation ist von der ihr übergeordneten Hauptorganisation abhängig und kann niemals alleine stehen. Sie muss immer einer Hauptorganisation untergeordnet sein. Unterorganisationen werden mit dem Badge **“managed”** versehen. Sie können ebenfalls über das Dashboard angelegt werden.
![Organisation erstellen](/img/screenshot_1_fiskaly-dashboard-und-management-api-261x300.png "Organisation erstellen")

### Benutzerrechte in der Unterorganisation
Nutzer, die für die Unterorganisation freigeschalten sind, haben ausschließlich Zugriff auf die Informationen der jeweiligen Unterorganisation. Die Nutzer haben keinen Einblick in die Informationen der übergeordneten Hauptorganisation. Innerhalb der Unterorganisation haben Nutzer Zugriff auf das Dashboard und alle dort hinterlegten Informationen.

### Wie erstelle ich eine Unterorganisation (*managed organization*)
Im **Dashboard** im Menüpunkt *Einstellungen* > *Organisationsverwaltung* auf den Button *Neue Organisation erstellen* klicken und das Kästchen *Verwaltete Organisation* *erstellen* auswählen. Anschließend angeben, unter welcher Hauptorganisation diese Unterorganisation angelegt werden soll.

Unter diesem Link finden Sie wie die [Unterorganisation über die Management API](https://developer.fiskaly.com/api/management/v0/#operation/createOrganization) erstellt wird.
Dabei darauf achten, dass der Button *ManagedOrganization* ausgewählt ist.
![Create organization](/img/screenshot_2_fiskaly-dashboard-und-management-api-300x160.png "Create organization")

### Unterschied einer Haupt- von einer Unterorganisation
Im fiskaly System wird zwischen Hauptorganisationen und Unterorganisationen unterschieden. Unterorganisationen sind von der Hauptorganisation abhängig. Sie können selbst keine weiteren Unterorganisationen beinhalten. Ebenso kann eine Hauptorganisation keine Unterorganisation einer weiteren Hauptorganisation sein. Wichtig zu wissen ist, dass sich die Benutzerrechte von Haupt- und Unterorganisation unterscheiden.

### Unterschied Benutzerrechte in Haupt- und Unterorganisation
Nutzer von Haupt- oder Unterorganisationen haben Zugriff auf die im Dashboard angezeigten Informationen der jeweiligen Organisation. Die Benutzerrechte innerhalb der Haupt- und der Unterorganisation unterscheiden sich darin, dass Nutzer der Hauptorganisation auch Zugriff zu den Informationen der jeweilige verknüpften Unterorganisationen haben. Nutzer der Unterorganisationen haben jedoch keinen Zugriff auf die Informationen der übergeordneten Hauptorganisation.

### API Keys
Auf Organisationsebene muss mindestens ein API Key angelegt werden. 

Über das Dashboard im Menüpunkt *Entwickler* > *API Schlüssel* auf den Button *API Schlüssel erstellen* klicken und einen Namen für den neuen API Schlüssel wählen. Anschließend *Erstellen* auswählen. 
![Neuer API Schüssel](/img/screenshot_3_fiskaly-dashboard-und-management-api-e1600269690310-300x144.png "Neuer API Schüssel")
**Achtung: das API Secret wird nur unmittelbar nach der Erstellung eines neuen API Schlüssels angezeigt!**
![Neuer API Schüssel 2](/img/screenshot_4_fiskaly-dashboard-und-management-api-e1600269732594-300x153.png "Neuer API Schüssel 2")
[API Keys können auch über die Management API](https://developer.fiskaly.com/api/management/v0/#operation/createApiKey) erzeugt werden.

Mit dem dem API Key der Hauptorganisation können die Unterorganisationen verwaltet werden. Für jede Unterorganisation muss ein eigener API Key erzeugt werden, um eine TSE für diese zu erstellen und die weiteren Funktionalitäten der fiskaly SIGN API zu verwenden.
API Keys für Hauptorganisationen müssen über das Dashboard oder die Management API erzeugt werden. Für Unterorganisationen können API Keys automatisiert erzeugt werden.

Ein API Key ist an eine Organisation sowie an den gewählten Modus (Test/Live) gebunden. Das bedeutet, dass jeder API Key auch nur für die eigene Organisation verwendet werden kann. Ausnahme: API Keys einer Hauptorganisation können die jeweils dazugehörenden Unterorganisationen verwendet werden.

Wurde der API Key im Test Modus erstellt, können mit diesem **nur(!)** Entitäten zu Testzwecken erzeugt werden. Mit einem im Live Modus erstellten Schlüssel, können somit auch **nur(!)** Live Entitäten produziert werden. Dh. in einer Live geschaltenen Organisation können mit dem Live API Key weitere Unterorganisationen erzeugt werden, so muss nicht jede Unterorganisation einzeln in den Live Modus geschalten werden.

Auf der fiskaly Entwickler Seite sind alle[ Informationen zu den API Keys](https://developer.fiskaly.com/api/management/v0/#tag/API-Keys) hier zu finden.
![](/img/info-zu-api-keys.png)

### Verrechnungsoptionen
Es gibt zwei Möglichkeiten die Verrechnung zu steuern:

##### Bill_to_Organization
Mit der Option *Bill_to_Organization* wird die Rechnung an die Hauptorganisation gestellt und kann auch über das Dashboard eingesehen werden.

##### Withhold Billing
Bei der Option *Withhold Billing* wird die Rechnung nicht an diese Unterorganisation gestellt und kann auch nicht über das Dashboard eingesehen werden. So kann die fiskaly TSE beispielsweise als ein Bestandteil eines Kassenpackets verkauft werden, ohne dass bei Ihrem Kunden der Preis der fiskaly TSE aufscheint.

Auf der fiskaly Entwickler Seite sind alle [Informationen zur Verrechnung](https://developer.fiskaly.com/api/management/v0/#operation/createBillingAddress) hier zu finden.
![fiskaly Information zur Verrechnung](/img/info-zur-verrechnung.png "fiskaly Information zur Verrechnung")

### Organisationsstruktur
#### Kassenhersteller bietet fiskaly Cloud TSE in seinem Portfolio an
Ein Kassenhersteller verwendet für seine Kassensoftware die fiskaly Cloud TSE. Er bietet drei Lösungen seinen Kunden an. Typischerweise ist Punkt 1. Best Practice bei großen Kassenanbietern. Punkt 2. und 3. sind für komplexere Modelle konzipiert.

Kontaktieren Sie hierfür unser Sales Team: [sales@fiskaly.com](mailto:sales@fiskaly.com).
![Organisationsstruktur](/img/organisationsstruktur.jpg "Organisationsstruktur")

**1. Einzelkunden – Best Practice**
Unter der Hauptorganisation des Kassenherstellers werden Einzelkunden als Unterorganisationen angelegt und verwaltet. Über die Hauptorganisation wird der jeweilige API Key der Unterorganisation erstellt. Die Verrechnungsoption wurde auf *Withhold Billing* gesetzt, da der Preis der fiskaly Cloud TSE in der Gesamtrechnung des Kassenherstellers an den Kunden beinhaltet ist.

**2. Enterprise Kunden**
Der Kassenhersteller legt die Holding des Enterprise Kunden als Hauptorganisation an. Die Filialen des Enterprise Kunden werden als Unterorganisationen angelegt. Die Hauptorganisation des Enterprise Kunden wird mit dem API Key der Hauptorganisation des Kassenherstellers erzeugt. Es ist dem Kassenhersteller überlassen, ob der Enterprise Kunde seine Organisationen selbst verwaltet oder durch den Kassenanbieter verwaltet wird. Die Billing Optionen sind bei den Organisationen des Enterprise Kunden auf *Withhold Billing* gesetzt.

**3. White Label Partner**
Der Kassenhersteller legt die Firma des White Label Partners als Hauptorganisation an. Die Kunden des White Label Partners werden als Unterorganisationen angelegt. Die Hauptorganisation des White Label Partner wird mit dem API Key der Hauptorganisation des Kassenherstellers erzeugt. Der White Label Partner verwaltet seine Kunden (Unterorganisationen) selbst. Die Billing Optionen sind bei den Organisationen der Kunden des White Label Partner auf *Withhold Billing* gesetzt.

Für andere Modelle oder Sonderfälle setzen Sie sich mit unserem Sales Team in Verbindung: [sales@fiskaly.com](mailto:sales@fiskaly.com).

### Download
Hier steht der Artikel 'fiskaly Dashboard und Management API als PDF zum Download' zur Verfügung. [![fiskaly-Dashboard-und-Management-API_2020.pdf](/img/fiskaly-dashboard-management-api.png "fiskaly-Dashboard-und-Management-API_2020.pdf")](/img/fiskaly-Dashboard-und-Management-API_2020.pdf)

Das fiskaly Dashboard gibt Ihnen Einsicht über Ihre bei fiskay gebuchten Produkte und Sie sehen auf einen Blick, was im fiskaly System passiert.

fiskaly Dashboard und Management API

Beiträge zum Thema

Um den gesetzlichen Anforderungen zu entsprechen müssen Sie auf V2 migrieren.Die zertifizierte V2 ist weiterhin softwarebasiert und die Zertifizierung ist ohne Einschränkung bis 2029 gültig.

Migration Cloud-TSE V2.