Basis-URLs & Umgebungen

Alle fiskaly-Produkte bieten separate TEST- und LIVE-Umgebungen. API Keys, die in einer Umgebung generiert wurden, funktionieren nur mit den Ressourcen dieser Umgebung.

SIGN-Produkte

Produkt	Test-Basis-URL	Live-Basis-URL	API-Pfad
SIGN DE	https://kassensichv-middleware.fiskaly.com/api/v2	https://kassensichv.fiskaly.com/api/v2	/api/v2
SIGN AT	https://rksv.fiskaly.com/api/v1	https://rksv.fiskaly.com/api/v1	/api/v1
SIGN ES	https://test.es.sign.fiskaly.com/api/v1	https://live.es.sign.fiskaly.com/api/v1	/api/v1
SIGN IT	https://test.api.fiskaly.com	https://live.api.fiskaly.com	Versionierte Pfade
SIGN FR	https://test.api.fiskaly.com	https://live.api.fiskaly.com	Versionierte Pfade

Weitere Produkte

Produkt	Test-Basis-URL	Live-Basis-URL	API-Pfad
DSFINVK DE	https://dsfinvk.fiskaly.com/api/v1	https://dsfinvk.fiskaly.com/api/v1	/api/v1
RECEIPT	https://receipt.fiskaly.com/api/v1	https://receipt.fiskaly.com/api/v1	/api/v1
E-INVOICE	https://test.api.fiskaly.com	https://live.api.fiskaly.com	Versionierte Pfade
HUB	https://hub.fiskaly.com/api/v0	https://hub.fiskaly.com/api/v0	/api/v0

Erforderliche Header

Alle Produkte

Header	Wert	Erforderlich
Authorization	Bearer <access_token>	Alle authentifizierten Anfragen
Content-Type	application/json	Alle Anfragen mit einem Body

Neuere APIs (SIGN IT, SIGN FR, E-INVOICE)

Diese APIs teilen eine gemeinsame Plattform und erfordern zusätzliche Header:

Header	Wert	Erforderlich
X-Api-Version	2026-02-03 (aktuell)	Alle Anfragen
X-Idempotency-Key	UUIDv4	Alle POST- und PATCH-Anfragen
X-Scope-Identifier	Organisations-UUID	Bei Scoping auf eine bestimmte UNIT

SIGN ES

Header	Wert	Erforderlich
Content-Type	application/json	Alle Anfragen

📘Note

SIGN ES umhüllt alle Anfrage-Bodies in einen content-Envelope: {"content": {...}}. Dies gilt für die Authentifizierung und alle API-Aufrufe.

Umgebungsverhalten

⚠️LIVE ist dauerhaft

In der LIVE-Umgebung erstellte Datensätze sind rechtlich bindend. Transaktionen in SIGN DE werden vom BSI-zertifizierten TSS signiert. Datensätze in SIGN IT und SIGN FR werden an die jeweilige Steuerbehörde übermittelt. Entwickeln und testen Sie stets zuerst in TEST.

Verhalten	TEST	LIVE
Steuerbehörden-Einreichung	Nein	Ja
Zertifizierungsvalidierung	Simuliert	Real
Datenspeicherung	Standard	Gemäß gesetzlicher Anforderungen
Rate Limits	Standard	Standard

💡Umgebungen wechseln

Wenn Sie bereit sind, live zu gehen, generieren Sie neue API Keys in der LIVE-Umgebung über das HUB. Weitere Informationen finden Sie im Guide Zu LIVE wechseln.

Service-Status

Überwachen Sie alle fiskaly-Dienst-Endpunkte unter status.fiskaly.com.