Einführung in fiskaly

fiskaly bietet cloudbasierte Fiskalkonformitäts-APIs für europäische POS-Systeme. Wenn Ihre Software in einem Land mit Fiskalisierungsgesetzen Bar- oder Kartenzahlungen verarbeitet, übernimmt fiskaly die regulatorische Komplexität — damit Ihr Team das nicht muss.

Diese Seite beantwortet die drei Fragen, die jeder neue Kunde stellt: Was macht fiskaly, welche Produkte benötige ich und wie viel Aufwand erfordert die Integrierung.

💡Möchten Sie direkt loslegen?

Springen Sie zum Quick Start — Sandbox-Zugang und Ihre erste signierte Transaktion in unter 5 Minuten.

Was fiskaly leistet

Europäische Länder verpflichten elektronische Kassensysteme dazu, Transaktionen kryptografisch zu signieren, prüfungsfertige Exporte zu generieren und in einigen Fällen Daten in Echtzeit an die Steuerbehörden zu übermitteln. Die Regulierungen, Formate und Zertifizierungsanforderungen unterscheiden sich je nach Land.

fiskaly ersetzt all das durch eine einzige REST-API:

1. Sie senden Transaktionsdaten (Beträge, Mehrwertsteuersätze, Zahlungsart)
2. fiskaly signiert diese mit einem zertifizierten kryptografischen Modul (TSS, SCU usw.)
3. Sie erhalten eine Signatur zum Drucken auf dem Beleg (oft als QR-Code)
4. fiskaly speichert die Prüfspur und generiert auf Abruf konforme Exporte

Keine Hardware. Keine lokalen Kryptomodule. Keine manuelle Einreichung. Die Signier-Infrastruktur läuft in zertifizierten Cloud-Rechenzentren und ist stets auf dem neuesten Stand der Regulierungsänderungen.

Welche Produkte benötigen Sie?

Dies hängt davon ab, in welchen Ländern Sie tätig sind und welchen Verpflichtungen Sie unterliegen. Hier ist der Entscheidungsrahmen:

Frage	Produkt	Erforderlich?
Verarbeiten Sie POS-Transaktionen in DE, AT, FR, ES, IT oder SE?	Sign DE / AT / FR / ES / IT / SE (digitale Signierung, je Land)	Ja — gesetzlich vorgeschrieben
Sind Sie in Deutschland tätig?	DSFinV-K (Fiskalexport)	Ja — für Prüfungen vorgeschrieben
Sind Sie in Deutschland tätig?	SUBMIT DE (ELSTER-Einreichung)	Ja — seit 2025 vorgeschrieben
Sind Sie in Deutschland tätig?	Management API (Organisationsverwaltung)	Optional
Müssen Sie Fiskaldaten 10–30 Jahre archivieren?	SAFE	Empfohlen
Stellen Sie B2B-Rechnungen in Belgien aus (oder bald DE/FR/IT/PL)?	E-Invoice	Ja (BE), für andere folgt es
Möchten Sie Papierbelege ersetzen?	eReceipt	Optional

Häufigster Einstieg: SIGN DE + DSFINVK DE + SUBMIT DE für eine rein deutsche POS-Integrierung. Dies deckt die vollständige gesetzliche Verpflichtung ab.

📘Für Produktmanager

Siehe den Integrierungsplanungs-Guide für Aufwandsschätzungen, Teamanforderungen, Abhängigkeits-Maps und eine Rollout-Zeitplan-Vorlage, die Sie für Ihre Roadmap anpassen können.

Wie die API funktioniert (alle Produkte)

Jedes fiskaly-Produkt folgt demselben Integrierungsmuster:

1. Authentifizieren

   POST /auth mit Ihrem API Key und Secret. Sie erhalten einen Bearer-Token, der 24 Stunden gültig ist, und einen Refresh-Token, der 48 Stunden gültig ist.

2. Ressourcen bereitstellen (einmalig)

   Erstellen Sie die Signing-Ressource für Ihr Land: ein TSS in Deutschland, eine SCU in Österreich, eine Signing-Unit in Frankreich/Italien/Spanien. Jede Ressource entspricht einem physischen Standort oder POS-Terminal.

3. Transaktionen signieren

   Für jede Transaktion PUT-en Sie die Transaktionsdaten (Status, Beträge, Mehrwertsteuersätze) gegen die Signing-Ressource. Die Antwort enthält eine kryptografische Signatur.

4. Exporte generieren

   Auf Abruf oder nach Zeitplan werden konforme Datenexporte (DSFINVK DE, TSS-Export, Archiv) über die API ausgelöst.

Zwei API-Architekturen

fiskaly bietet zwei API-Architekturen, die beide aktiv unterstützt werden:

Spezialisierte APIs (SIGN DE, SIGN AT, SIGN ES) — speziell für die Regulierungen eines einzelnen Landes entwickelt. Tiefgreifende, optimierte, länderspezifische Endpunkte und Ressourcenmodelle.

Unified API (SIGN FR, SIGN IT, SIGN SE folgt) — ein gemeinsames Ressourcenmodell über Länder hinweg. Einmal integrieren, ein weiteres Land durch Änderung des Payload-Schemas hinzufügen.

	Spezialisierte APIs	Unified API
Länder	Deutschland, Österreich, Spanien	Frankreich, Italien, Schweden (folgt)
Organisationsverwaltung	Separate Management API	In die Produkt-API integriert
Land hinzufügen	Separate API integrieren	Payload-Schema ändern
Am besten für	Einzelland-Tiefe	Multi-Country-Expansion

Siehe Die Unified API für den vollständigen Vergleich, das Ressourcenmodell und die Integrierungs-Komplettanleitung.

Multi-Country-Expansion

Der Erweiterungspfad hängt davon ab, welche Länder Sie hinzufügen:

• Ein weiteres Unified-API-Land hinzufügen (z. B. FR + IT): ~1 Woche. Gleiche Basis-URLs, gleiche Header, gleiches Ressourcenmodell — nur der Abschnitt fiscalization des Steuerpflichtigen und das Record-Payload-Schema ändern sich.
• Eine weitere Spezialisierte API hinzufügen (z. B. DE + AT): 1–3 Wochen. Ähnliche Muster, aber unterschiedliche API-Oberflächen und Endpunkte.
• Architekturen mischen (z. B. DE + FR): Sie integrieren beide. Sie teilen dasselbe Bearer-Token-Authentifizierungsmuster, haben aber unterschiedliche Ressourcenmodelle und Basis-URLs.

Umgebungen

fiskaly bietet für jedes Produkt zwei Umgebungen:

Umgebung	Zweck	Daten	Abrechnung
TEST (Sandbox)	Entwicklung und Integrierungstests	Flüchtig — kann zurückgesetzt werden	Kostenlos
LIVE (Produktion)	Echte Transaktionen mit echten Signaturen	Permanent — prüfungsrelevant	Per Vertrag abgerechnet

Alle neuen Organisationen starten in TEST. Sie wechseln über das HUB zu LIVE, nachdem Sie Ihre Integrierung abgeschlossen haben.

⚠️TEST und LIVE sind getrennt

Ressourcen, die in TEST erstellt wurden, existieren in LIVE nicht. Planen Sie einen Bereitstellungsschritt in Ihrer Go-Live-Checkliste ein.

Unsere Produkte

SIGN DE (Deutschland)

KassenSichV — BSI-zertifiziertes Cloud-TSS, gültig bis 2033

SIGN AT (Österreich)

RKSV — cloudbasierte Signierung mit FinanzOnline-Integrierung

SIGN FR (Frankreich)

NF525 — zertifizierte Signierung mit Offline-Replay-Modus

SIGN ES (Spanien)

TicketBAI & Verifactu — XML-Echtzeiteinreichung

SIGN IT (Italien)

Corrispettivi telematici — Cloud-RT mit Belegslotterie

SIGN SE (Schweden)

InfraSec TCS — X.509-zertifikatsbasierte Signierung

Nächste Schritte

Quick Start (Entwickler)

Erster API-Aufruf in unter 5 Minuten. Sandbox, cURL und mehrsprachige Beispiele.

Integrierungsplanung (PMs)

Aufwandsschätzungen, Teamanforderungen, Abhängigkeits-Maps und Rollout-Vorlagen.

API-Referenz

Alle Produkt-Endpunkte, Basis-URLs, Authentifizierung und Rate Limits.

KI- und Agent-Integrierung

MCP-Server, maschinenlesbare Endpunkte und Best Practices für KI-gestützte Integrierungen.