Skip to content

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.

Check your role before starting.

RoleDescription
OwnerYou have all Admin rights for SAFE configuration and data access.
AdminYou can set and modify the archiving schedule for a Group and Unit, and search and view archived fiscal data.
Regular userYou can search and view archived fiscal data in SAFE.

Set the archiving schedule

  1. Log in to HUB

    Log into your account at hub.fiskaly.com and select the Account, Group, or Unit you want to configure.

  2. 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.

    Configure Organizations screen in fiskaly SAFE
  3. 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.

    Organization selection in fiskaly SAFE
  4. 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.

    Auto-archiving frequency and time settings in fiskaly SAFE

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.

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.

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)

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

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

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

SAFE automatically archives every invoice you send and receive. You don’t need to set a schedule.

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.

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.

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.
Receipt Germany

Example of an annotation, its properties and their values

  1. Select an Annotation

    Begin by choosing an appropriate annotation from the search request builder.

  2. Choose a Property

    Once the annotation is selected, pick a property that is relevant to your search.

  3. Specify a Value

    Define the exact value you are searching for within the chosen property.

Search Receipt Annotations

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.

  • 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.
ProblemWhat to do
No archived files after saving the scheduleSAFE 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 savedOpen 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 scheduleOnly 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 missingSAFE only archives exports created after you saved your schedule. To archive older exports, contact fiskaly support.
You want to archive right awayYou 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.

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.