fiskaly SAFE provides secure and compliant archiving and convenient retrieval of archived fiscal data from your fiskaly products. To use it, SAFE must be included in your contract, and you set an archiving schedule for your Account, Groups, or Units. For SIGN FR and E-INVOICE Italy, archiving runs automatically.
We recommend testing your configuration and data archiving in the TEST environment first. This allows you to verify that everything works as expected before going LIVE.
Roles
Who can configure and access SAFE
Availability & Configuration
Check availability and set your archiving schedule
Auto-archiving Setup
Supported services, file formats, and annotations
Search and Export Data
Search, filter, and download archived data
Troubleshooting
Fix common archiving issues
SAFE and SAFE flex
When to use SAFE vs SAFE flex
SAFE API
Programmatically search, filter, and export archived data
Check your role before starting.
| Role | Description |
|---|---|
| Owner | You have all Admin rights for SAFE configuration and data access. |
| Admin | You can set and modify the archiving schedule for a Group and Unit, and search and view archived fiscal data. |
| Regular user | You can search and view archived fiscal data in SAFE. |
Auto-archiving Setup
Section titled “Auto-archiving Setup”Availability and configuration
Section titled “Availability and configuration”For SIGN DE, SIGN AT, and DSFinV-K, SAFE must be included in your contract. HUB checks your contract, so you don’t need to activate anything. You can then set archiving schedules for the Account, its Groups, and its Units. If SAFE isn’t included in your contract, the Account Owner or an Admin can click “Contact sales” on the Archiving page in HUB.
For SIGN FR and E-INVOICE Italy, you don’t need to activate anything. Archiving is included automatically.
Set the archiving schedule
Log in to HUB
Log into your account at hub.fiskaly.com and select the Account, Group, or Unit you want to configure.
Open the SAFE configuration
Click Archiving in the navigation panel, then open the Configuration tab. If no schedule has been set yet, you can also start from the SAFE card by clicking Configure Organizations. At Account level, you can also reach SAFE through Explore Archiving under Quick Actions on the Home page.

Select your scope
On the Account, click Configure All Organizations to configure the whole Account, or Configure next to a Group or Unit. On a Group or Unit, click Auto archiving settings.

Set archiving schedule
Choose Daily and select the days, or choose Monthly. Then set the time (UTC). For an Account or Group, turn on Apply to all organizations to use the schedule for everything below it. Click Save.

After you save, the Configuration tab shows CONFIGURED and your schedule, for example Weekly: Mon at 00:00. To change the schedule, follow the same steps.
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.
After you configure fiskaly SAFE, it scans your connected products according to your schedule and archives the resulting exports. The automation runs continuously until you change the configuration.
Currently, SAFE supports the following products.
With an archiving schedule, which you set as described above:
- SIGN DE — TSS exports
- SIGN AT — DEP7 exports
- DSFinV-K — cash point closing exports
Automatically, with no schedule needed. Archiving for these products can’t be turned off:
- SIGN FR — XML event log exports (via UAPI)
- E-INVOICE Italy — every invoice you send and receive
When fiskaly SAFE archives your data, it stores the resulting exports together with key annotations. This lets you quickly identify, filter, and retrieve the data you need in HUB.
Auto-archiving is continuously extended to additional fiskaly products where archiving is a legal requirement.
🇩🇪 SIGN DE
Section titled “🇩🇪 SIGN DE”SAFE archives TSS exports on your configured schedule.
Typical properties you’ll see:
- Document creation date
- Legal retention period
- Start/end date of exported data
- TSS ID
- Client IDs (optional)
🇦🇹 SIGN AT
Section titled “🇦🇹 SIGN AT”SAFE archives DEP7 exports on your configured schedule.
Typical properties you’ll see:
- Document creation date
- Legal retention period
- Start/end date of exported data
- Receipt ID
- Cash register ID
- Receipt type (normal, cancellation, training)
- Signature counter
- Legal entity ID
🇫🇷 SIGN FR
Section titled “🇫🇷 SIGN FR”SAFE archives all event log records tracked by SIGN FR via UAPI, along with an integrity file per record. Archiving is triggered automatically after each daily closing. You don’t need to set a schedule.
Typical properties you’ll see:
- Document creation date
- Legal retention period
- Start/end date of exported data
- POS ID
- Period
- Business activity
🇩🇪 DSFinV-K
Section titled “🇩🇪 DSFinV-K”SAFE archives cash point closings per Unit on a configurable schedule (default: weekly, every Monday).
Typical properties you’ll see:
- Document creation date
- Legal retention period
- Start/end date of exported data
- Client IDs
- Business dates
- Cash point closing IDs
- Revision number
🇮🇹 E-INVOICE Italy
Section titled “🇮🇹 E-INVOICE Italy”SAFE automatically archives every invoice you send and receive. You don’t need to set a schedule.
Search and Export Data
Section titled “Search and Export Data”You can search archived data for the Units you are allowed to access, spanning across multiple Groups and Units when permissions allow. Results are displayed in a list view from which you can select and download the desired entries. To access the data, click Archiving in the navigation panel.
Exports are available in formats including TSS-Export, DSFinV-K Export, and DEP7. XML, JSON, PDF, ZIP, TAR, and HTML are supported. Optional auditor access provides standardized Z1–Z3 views directly in HUB.
Exports tab
Section titled “Exports tab”The Exports tab in the SAFE section shows the exports created in the last 7 days, newest first, for the organization you’re currently in. Exports of the Groups and Units below it aren’t included.
Each row gives you the creation time, the status, and the archive format (ZIP or TAR) — enough to pick out a recent export and download it again without running a new search.
The download button becomes active as soon as an export is complete. While an export is still processing, or if it failed, the button stays greyed out. For anything older than 7 days, search the archived files again.
Besides the HUB interface, fiskaly provides the SAFE API, which allows you to search, filter, and programmatically export archived data. Technical details are available in the SAFE API documentation.
Searching Archived Files
Section titled “Searching Archived Files”Our search system for archived files relies on the use of Annotations, Properties, and Values. Here’s a detailed breakdown of each component and how to use them effectively:
- Annotations are collections of properties that provide searchable parameters for files. They help categorize and identify specific details within your documents.
- A property is a single parameter within an annotation, connected to a file, and containing a specific value.
- Search values are the specific criteria you are looking for within the properties.

Example of an annotation, its properties and their values
How do I search for a file?
Section titled “How do I search for a file?”Select an Annotation
Begin by choosing an appropriate annotation from the search request builder.
Choose a Property
Once the annotation is selected, pick a property that is relevant to your search.
Specify a Value
Define the exact value you are searching for within the chosen property.

Example of a search request to find all cash refund receipts issued in euro
The search will look for files that match the selected annotation, property, and specified value exactly. If an annotation or property was not attached to a file at the time of upload, that file will not be included in the search results.
Additional Tips
Section titled “Additional Tips”- You can combine up to five different search parameters.
- Multiple search parameters are combined using a logical AND, meaning the search will return only the files that meet all specified criteria.
- Be precise with your search values to avoid missing out on relevant documents.
Troubleshooting
Section titled “Troubleshooting”| Problem | What to do |
|---|---|
| No archived files after saving the schedule | SAFE archives for the first time at the next scheduled day and time (UTC). Until then, the Archived Files tab shows “No files yet archived. Set a configuration to start archiving”. |
| You want to check that your schedule is saved | Open the Configuration tab. Each Account, Group, or Unit with a schedule shows CONFIGURED and the schedule, for example Weekly: Mon at 00:00. |
| You can’t see or save the schedule | Only Account Owners and Admins can configure SAFE. If you have one of these roles and the Configuration tab shows no CONFIGURED badge after saving, or saving fails with “failed to configure auto archival”, contact fiskaly support. |
| Older exports are missing | SAFE only archives exports created after you saved your schedule. To archive older exports, contact fiskaly support. |
| You want to archive right away | You can’t start an archive run manually. SAFE archives on your schedule. SIGN FR and E-INVOICE Italy are archived automatically. To upload files on demand, use SAFE flex. |
SAFE and SAFE flex at a glance
Section titled “SAFE and SAFE flex at a glance”In HUB, fiskaly SAFE automates archiving from connected fiskaly products on a schedule without manual uploads. SAFE flex is a separate, independent API — already available for all fiskaly solutions — that gives you full control over what to upload, when to upload, and which annotations to apply, regardless of which services you use. Both can be used separately or together, depending on your workflow. For details on the differences, visit our SAFE Guide.