Integration Guide SAFE

Integration Guide — fiskaly SAFE

fiskaly SAFE provides automated archiving of fiscal data from connected fiskaly services (SIGN DE, SIGN AT, DSFinV-K, etc.) without requiring manual uploads or direct API calls. Archiving is configured and managed through the fiskaly HUB.

📘SAFE vs SAFE flex

This guide covers SAFE (automated, HUB-managed archiving). If you need full API control over what is archived and when, see the SAFE flex Integration Guide instead. For a comparison, see SAFE vs SAFE flex.

Prerequisites

Before you begin, ensure you have:

• An active fiskaly organization with at least one connected service (e.g., SIGN DE, DSFinV-K)
• Access to the fiskaly HUB with admin permissions
• A LIVE or TEST environment with active TSS or fiscal data

How SAFE Works

SAFE automatically archives exports from your connected fiskaly services based on a schedule you configure in the HUB. The process is fully managed:

1. fiskaly generates exports from your connected services (TSE exports, DSFinV-K closings, etc.)
2. SAFE archives the data in certified cloud storage in the legally required jurisdiction
3. Data remains searchable and exportable for audits (Z1, Z2, Z3 access levels)

No code changes are needed in your POS integration — SAFE hooks into your existing fiskaly services.

Setup via fiskaly HUB

1. Log in to the HUB

   Navigate to hub.fiskaly.com and log in with your organization credentials. Select the organization you want to configure SAFE for.

2. Activate SAFE

   Go to Services > SAFE in the HUB navigation. Click Activate SAFE to enable automated archiving for your organization. You will be prompted to select your storage location (country) based on your legal requirements.

3. Configure archiving schedule

   Choose the export frequency for automated archiving:

   Frequency	Best for
   Daily	High-volume operations needing near-real-time archives
   Weekly	Standard retail operations
   Monthly	Low-volume operations or seasonal businesses

   The schedule determines how often SAFE pulls new exports from your connected services and archives them.

4. Select connected services

   Choose which fiskaly services should feed into SAFE:

   • SIGN DE — Archives TSE transaction exports
   • SIGN AT — Archives RKSV/DEP exports
   • DSFinV-K — Archives cash point closing exports
   • Additional services as they become available

   Each service is toggled independently. You can add or remove services at any time.

5. Verify the first archive

   After the first scheduled run, check the SAFE > Archives section in the HUB. You should see:

   • Archive entries with timestamps and source service
   • File counts and total storage used
   • Status indicators (Processed, Pending, Failed)

   If the first archive completes successfully, SAFE is fully operational.

💡Test environment first

Configure and test SAFE in your TEST environment before enabling it in LIVE. The behavior is identical, but you can verify the archive flow without affecting production data.

Accessing Archived Data

Via the HUB

1. Navigate to SAFE > Archives in the HUB
2. Use filters to narrow by date range, service, or archive status
3. Click on any archive entry to view details and download files
4. Use the Export button to download archives in bulk (ZIP format)

Via the API

Archived data is also accessible through the SAFE API for programmatic access:

# List archives for your organization
curl -X GET "https://safe.fiskaly.com/api/v0/archives" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

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

For full API documentation, see the SAFE API Reference.

Audit Support

SAFE supports three levels of audit access as defined by German fiscal authorities (and analogous requirements in other countries):

Access Level	Description	How SAFE Helps
Z1 — Direct access	Auditor accesses the system directly	Provide auditor read-only access via HUB
Z2 — Indirect access	Taxpayer provides data on auditor’s request	Export from SAFE and deliver to auditor
Z3 — Data carrier	Machine-readable export on storage medium	Download SAFE archives in standard formats

Retention and Compliance

• Archived data is stored for the legally required retention period (typically 10 years in Germany, 7 years in Austria)
• Storage location is determined by the country configured during activation
• Data is stored unalterably in certified Google Cloud data centers
• Full audit trail of all archive operations is maintained

⚠️Retention responsibility

While SAFE handles the technical archiving, you remain responsible for ensuring that your archiving schedule captures all legally required data. Consult your tax advisor for retention requirements specific to your jurisdiction.

Troubleshooting

Issue	Cause	Resolution
No archives appearing	Schedule not yet triggered	Wait for the next scheduled run, or trigger a manual archive from the HUB
Archive status “Failed”	Source service has no new data, or export generation failed	Check the connected service status in the HUB; verify TSS is active
Missing data in archive	Export scope does not include the expected date range	Verify the archive schedule covers the period; check for gaps in source data

Next Steps

SAFE flex Guide

Full API control for custom archiving workflows

Compliance Details

Per-country legal requirements for archiving

HUB SAFE Setup

Detailed HUB configuration for SAFE