Skip to main content

Software Development Kit

info

this section will be revised and adapted for the certified version 2 of the the fiskaly Cloud-TSS!

├ťberblick {#├╝berblick}ÔÇő

Das Software Development Kit (SDK) wird von fiskaly bereitgestellt. Es besteht aus:

  • Schnittstelle zur Integration (siehe auch kassensichv.io, fiskaly TSS / TSE API)
  • CC-zertifizierte SMA-Komponente in bin├Ąrer, ausf├╝hrbarer Form
  • Optionale Komponenten: Kompensationsmechanismen f├╝r Ausfallszenarien & Loging der Ausfallszenarien

Das SDK wird f├╝r verschiedene Plattformen und Betriebssysteme bereitgestellt, darunter Linux, Windows, macOS, Android und iOS; f├╝r 32-Bit- und 64-Bit-Architekturen.

Referenzimplementierungen sind f├╝r die g├Ąngigsten Sprachen und Laufzeitumgebungen verf├╝gbar:

Diese sind alle Open Source und k├Ânnen auf github.com/fiskaly gefunden werden. Aufgrund der freiz├╝gigen MIT-Lizenz k├Ânnen die SDKs beliebig modifiziert, erweitert und verbreitet werden.

Auf Anfrage erstellen wir auch gerne Implementierungen f├╝r andere Plattformen oder Sprachen.

FunktionsweiseÔÇő

Konzeptionell stellt das SDK einen HTTP-Client dar, der explizit f├╝r die Kommunikation mit unserer REST-API optimiert ist (SIGN DE API).

Das SDK bietet die folgende Funktionalit├Ąt:

  • Die Authentifizierung mit unserer REST-API - Empfang und Erneuerung des JWT-Authentifizierungstokens - ist vollst├Ąndig abstrahiert. Das bedeutet, dass der Integrator nur einen API key und das entsprechende API secret angeben muss.
  • Die Serialisierung und Deserialisierung von JSON-Anfragen und -Antworten geschieht automatisch.
  • Konformit├Ąt mit den Anforderungen des vom BSI spezifizierten Schutzprofils (BSI CC-PP-0105-2019). Dies erfordert, dass eine lokale SMA-Komponente, die in der Betriebsumgebung des Kassensystems ausgef├╝hrt wird, die Inkrementierung des Transaktionsz├Ąhlers und den Aufbau des vertrauensw├╝rdigen Kanals zur entfernt angeschlossenen ZDA-Komponente ├╝bernimmt. Die Aufgabe des SDKs ist es, die SMA-Komponente, die in bin├Ąrer oder ausf├╝hrbarer Form vorliegt, anzusprechen und die Nutzung der ben├Âtigten Funktionalit├Ąt f├╝r den Anwender des SDKs (d.h. den Entwickler) m├Âglichst vollst├Ąndig zu abstrahieren.

Github overview

Dev-Newsletter

stay up-to-date