Zur LIVE-Umgebung wechseln

Alle fiskaly-Organisationen starten standardmäßig in der TEST-Umgebung. Die TEST-Umgebung bietet volle API-Funktionalität mit Sandbox-Daten, sodass Sie Ihre Integration aufbauen und validieren können, bevor Sie in den Produktionsbetrieb gehen.

Wenn Sie bereit sind, echte Transaktionen zu verarbeiten, müssen Sie die LIVE-Umgebung aktivieren.

TEST vs. LIVE

Merkmal	TEST	LIVE
API-Endpunkte	Sandbox-URLs (Middleware)	Produktions-URLs
TSS-Zertifikate	Testzertifikate	Rechtsgültige Zertifikate
Transaktionen	Nicht rechtsverbindlich	Rechtskonform und signiert
Datenspeicherung	Temporär	Vollständige gesetzliche Aufbewahrungsfrist
Ratenlimits	Wie in der Produktion	Produktionslimits
Kosten	Kostenlos während der Entwicklung	Gemäß Ihren Vertragsbedingungen

⚠️TEST und LIVE sind getrennt

Daten werden nicht zwischen Umgebungen übertragen. TSS-Instanzen, Clients und Transaktionen, die in TEST erstellt wurden, existieren nicht in LIVE. Sie müssen neue Ressourcen in der LIVE-Umgebung erstellen.

LIVE-Zugang aktivieren

1. Integrationsbereitschaft prüfen

   Bevor Sie LIVE-Zugang anfordern, stellen Sie sicher, dass Ihre Integration:

   • Erfolgreich eine TSS in TEST erstellt und initialisiert
   • Transaktionen vollständig und fehlerfrei signiert
   • Timeouts und Fehler elegant behandelt
   • Korrekte Belegdaten mit QR-Codes generiert (für SIGN DE)
   • Gültige DSFinV-K-Exporte produziert (falls zutreffend)
2. LIVE-Aktivierung anfordern

   In der fiskaly HUB wird ein Testmodus-Banner angezeigt, während Sie sich in der TEST-Umgebung befinden. Klicken Sie als Account-Owner auf die Schaltfläche “Go Live” in diesem Banner, um Ihre Aktivierungsanfrage zu starten. Ein kurzes Formular wird Sie auffordern, Ihre Unternehmensdaten und Kontaktinformationen vor dem Absenden zu bestätigen.

3. Vertrag abschließen

   Nach Ihrer Anfrage wird das fiskaly-Vertriebsteam Sie kontaktieren, um einen Vertrag über Ihre Produktionsnutzung abzuschließen. Dieser umfasst typischerweise:

   • Auswahl des Volumentarifs
   • Aktivierung des Ländermoduls
   • Einrichtung der Abrechnung und Zahlung
4. LIVE-Zugang erhalten

   Während Ihre Anfrage bearbeitet wird, zeigt das Banner ein “LIVE-Zugang ausstehend”-Badge an. Sobald Ihr Account genehmigt und aktiviert wurde, erhalten Sie Zugang zur LIVE-Umgebung.

5. LIVE-Ressourcen erstellen

   Wechseln Sie zur LIVE-Umgebung und erstellen Sie Ihre Produktionsressourcen:

   1. Erstellen Sie eine neue LIVE-Organisation, die Ihre Produktionsstruktur widerspiegelt
   2. Generieren Sie einen neuen LIVE-API Key — TEST-Schlüssel funktionieren nicht in LIVE
   3. Erstellen und initialisieren Sie Ihre Produktions-TSS-Instanzen
   4. Registrieren Sie Clients für die LIVE-TSS

📘Neuer API Key erforderlich

Sie müssen einen neuen API Key in der LIVE-Umgebung erstellen. Ihr TEST-API Key wird sich nicht gegenüber Produktionsendpunkten authentifizieren.

Zwischen Umgebungen wechseln

Sobald LIVE aktiviert ist, können Sie jederzeit zwischen TEST und LIVE wechseln. Jede Umgebung ist über ihre eigene URL zugänglich, sodass Sie beide gleichzeitig geöffnet haben können. Dies ist nützlich für:

• Weitere Entwicklung und Tests in TEST, während die Produktion in LIVE läuft
• Fehlersuche durch Reproduktion in TEST
• Schulung neuer Teammitglieder ohne Beeinträchtigung der Produktionsdaten

💡Separate Anmeldedaten pro Umgebung

Speichern Sie Ihre TEST- und LIVE-API Key separat. Verwenden Sie Umgebungsvariablen in Ihrer Anwendung, um zwischen ihnen zu wechseln — niemals Produktionsanmeldedaten hardcoden.

Häufige Probleme

Problem	Ursache	Lösung
Schaltfläche “Go Live” nicht sichtbar	Nur der Account-Owner kann LIVE anfordern	Als Account-Owner anmelden und alle Onboarding-Schritte abschließen
401-Fehler in LIVE	TEST-API Key werden verwendet	Neue API Key in der LIVE-Umgebung generieren
TSS in LIVE nicht gefunden	TSS existiert nur in TEST	Neue TSS-Instanzen in der LIVE-Umgebung erstellen
Fehlende Daten nach dem Wechsel	Umgebungen sind isoliert	Ressourcen müssen in jeder Umgebung neu erstellt werden

Nächste Schritte

HUB-Navigation

Die HUB-Benutzeroberfläche und Menüstruktur kennenlernen

Erste Schritte

Organisationseinrichtung abschließen

Leitfaden für Neukunden

Vollständige Integrationsanleitung für SIGN DE