Integrationsleitfaden SAFE

Integrationsleitfaden — fiskaly SAFE

fiskaly SAFE bietet automatische Archivierung von Steuerdaten aus verbundenen fiskaly-Diensten (SIGN DE, SIGN AT, DSFinV-K usw.), ohne manuelle Uploads oder direkte API-Aufrufe. Die Archivierung wird über den fiskaly HUB konfiguriert und verwaltet.

📘SAFE vs SAFE flex

Dieser Leitfaden behandelt SAFE (automatische, HUB-verwaltete Archivierung). Wenn Sie vollständige API-Kontrolle darüber benötigen, was wann archiviert wird, lesen Sie stattdessen den SAFE flex Integrationsleitfaden. Für einen Vergleich siehe SAFE vs SAFE flex.

Voraussetzungen

Stellen Sie vor dem Start sicher, dass Sie Folgendes haben:

• Eine aktive fiskaly-Organisation mit mindestens einem verbundenen Dienst (z. B. SIGN DE, DSFinV-K)
• Zugang zum fiskaly HUB mit Administratorrechten
• Eine LIVE- oder TEST-Umgebung mit aktivem TSS oder Steuerdaten

Wie SAFE funktioniert

SAFE archiviert automatisch Exporte aus Ihren verbundenen fiskaly-Diensten auf Basis eines im HUB konfigurierten Zeitplans. Der Prozess ist vollständig verwaltet:

1. fiskaly generiert Exporte aus Ihren verbundenen Diensten (TSE-Exporte, DSFinV-K-Kassenschnitte usw.)
2. SAFE archiviert die Daten in zertifizierten Cloud-Speichern in der rechtlich vorgeschriebenen Jurisdiktion
3. Daten bleiben durchsuchbar und exportierbar für Prüfungen (Zugriffsebenen Z1, Z2, Z3)

An Ihrer Kassensystem-Integration sind keine Code-Änderungen erforderlich — SAFE klinkt sich in Ihre bestehenden fiskaly-Dienste ein.

Einrichtung über den fiskaly HUB

1. Im HUB anmelden

   Navigieren Sie zu hub.fiskaly.com und melden Sie sich mit Ihren Organisationsdaten an. Wählen Sie die Organisation aus, für die Sie SAFE konfigurieren möchten.

2. SAFE aktivieren

   Gehen Sie im HUB-Menü zu Services > SAFE. Klicken Sie auf SAFE aktivieren, um die automatische Archivierung für Ihre Organisation zu aktivieren. Sie werden aufgefordert, Ihren Speicherort (Land) entsprechend Ihren gesetzlichen Anforderungen auszuwählen.

3. Archivierungsplan konfigurieren

   Wählen Sie die Exportfrequenz für die automatische Archivierung:

   Frequenz	Am besten geeignet für
   Täglich	Hochvolumige Betriebe mit Bedarf an nahezu echtzeit Archiven
   Wöchentlich	Standard-Einzelhandelsbetriebe
   Monatlich	Betriebe mit geringem Volumen oder Saisonbetriebe

   Der Plan bestimmt, wie oft SAFE neue Exporte aus Ihren verbundenen Diensten abruft und archiviert.

4. Verbundene Dienste auswählen

   Wählen Sie, welche fiskaly-Dienste in SAFE einfließen sollen:

   • SIGN DE — Archiviert TSE-Transaktionsexporte
   • SIGN AT — Archiviert RKSV/DEP-Exporte
   • DSFinV-K — Archiviert Kassenschnitt-Exporte
   • Weitere Dienste werden laufend hinzugefügt

   Jeder Dienst wird unabhängig aktiviert. Sie können Dienste jederzeit hinzufügen oder entfernen.

5. Erstes Archiv überprüfen

   Überprüfen Sie nach dem ersten geplanten Durchlauf den Bereich SAFE > Archive im HUB. Sie sollten folgendes sehen:

   • Archiveinträge mit Zeitstempeln und Quelldienst
   • Dateianzahl und gesamter genutzter Speicher
   • Statusanzeigen (Verarbeitet, Ausstehend, Fehlgeschlagen)

   Wenn das erste Archiv erfolgreich abgeschlossen wird, ist SAFE vollständig betriebsbereit.

💡Zuerst in der Testumgebung testen

Konfigurieren und testen Sie SAFE in Ihrer TEST-Umgebung, bevor Sie es in LIVE aktivieren. Das Verhalten ist identisch, aber Sie können den Archivierungsablauf überprüfen, ohne Produktionsdaten zu beeinflussen.

Zugriff auf archivierte Daten

Über den HUB

1. Navigieren Sie im HUB zu SAFE > Archive
2. Verwenden Sie Filter, um nach Zeitraum, Dienst oder Archivstatus einzugrenzen
3. Klicken Sie auf einen Archiveintrag, um Details anzuzeigen und Dateien herunterzuladen
4. Verwenden Sie die Schaltfläche Export, um Archive in großen Mengen herunterzuladen (ZIP-Format)

Über die API

Archivierte Daten sind auch über die SAFE API für programmatischen Zugriff verfügbar:

# Archive für Ihre Organisation auflisten
curl -X GET "https://safe.fiskaly.com/api/v0/archives" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# Ein bestimmtes Archiv herunterladen
curl -X GET "https://safe.fiskaly.com/api/v0/archives/{archive_id}/download" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o archive.zip

Die vollständige API-Dokumentation finden Sie in der SAFE API-Referenz.

Unterstützung bei Betriebsprüfungen

SAFE unterstützt drei Zugriffsebenen für Betriebsprüfungen, wie sie von deutschen Finanzbehörden definiert wurden (und analoge Anforderungen in anderen Ländern):

Zugriffsebene	Beschreibung	Wie SAFE hilft
Z1 — Direktzugriff	Prüfer greift direkt auf das System zu	Prüfer erhalten Lesezugriff über den HUB
Z2 — Indirekter Zugriff	Steuerpflichtiger stellt Daten auf Anfrage bereit	Export aus SAFE und Übergabe an den Prüfer
Z3 — Datenträger	Maschinenlesbarer Export auf Speichermedium	SAFE-Archive in Standardformaten herunterladen

Aufbewahrung und Compliance

• Archivierte Daten werden für die gesetzlich vorgeschriebene Aufbewahrungsfrist gespeichert (in der Regel 10 Jahre in Deutschland, 7 Jahre in Österreich)
• Der Speicherort wird durch das während der Aktivierung konfigurierte Land bestimmt
• Daten werden unveränderlich in zertifizierten Google Cloud-Rechenzentren gespeichert
• Ein vollständiges Prüfprotokoll aller Archivierungsvorgänge wird geführt

⚠️Aufbewahrungsverantwortung

Obwohl SAFE die technische Archivierung übernimmt, bleiben Sie dafür verantwortlich, sicherzustellen, dass Ihr Archivierungsplan alle gesetzlich erforderlichen Daten erfasst. Konsultieren Sie Ihren Steuerberater bezüglich der für Ihre Jurisdiktion geltenden Aufbewahrungsfristen.

Fehlerbehebung

Problem	Ursache	Lösung
Keine Archive erscheinen	Zeitplan wurde noch nicht ausgelöst	Auf den nächsten geplanten Durchlauf warten oder eine manuelle Archivierung im HUB auslösen
Archivstatus „Fehlgeschlagen”	Quelldienst hat keine neuen Daten oder Export-Generierung fehlgeschlagen	Verbundenen Dienststatus im HUB prüfen; sicherstellen, dass TSS aktiv ist
Fehlende Daten im Archiv	Exportbereich schließt den erwarteten Datumsbereich nicht ein	Archivierungsplan überprüfen, ob er den Zeitraum abdeckt; Lücken in den Quelldaten prüfen

Nächste Schritte

SAFE flex-Leitfaden

Vollständige API-Kontrolle für individuelle Archivierungsabläufe

Compliance-Details

Länderspezifische gesetzliche Anforderungen für die Archivierung

HUB SAFE-Einrichtung

Detaillierte HUB-Konfiguration für SAFE