fiskaly SAFE fornisce un’archiviazione sicura e conforme e un comodo recupero dei dati fiscali archiviati dai prodotti fiskaly. Per utilizzarlo, SAFE deve essere incluso nel tuo contratto e devi impostare un calendario di archiviazione per l’Account, i Group o le Unit. Per SIGN FR ed E-INVOICE Italia, l’archiviazione avviene automaticamente.
Si consiglia di testare prima la configurazione e l’archiviazione dei dati nell’ambiente TEST. Questo permette di verificare che tutto funzioni come previsto prima di passare in modalità LIVE.
Ruoli
Chi può configurare e accedere a SAFE
Disponibilità e configurazione
Verificare la disponibilità e impostare il calendario di archiviazione
Configurazione dell'archiviazione automatica
Servizi supportati, formati di file e annotazioni
Ricerca ed esportazione dei dati
Cercare, filtrare e scaricare dati archiviati
Risoluzione dei problemi
Risolvere i problemi di archiviazione più comuni
SAFE e SAFE flex
Quando utilizzare SAFE vs SAFE flex
SAFE API
Cercare, filtrare ed esportare dati archiviati in modo programmatico
Verifica il tuo ruolo prima di iniziare.
| Ruolo | Descrizione |
|---|---|
| Owner | Hai tutti i diritti Admin per la configurazione di SAFE e l’accesso ai dati. |
| Admin | Puoi impostare e modificare il calendario di archiviazione per un Group e una Unit, e cercare e visualizzare i dati fiscali archiviati. |
| Utente normale | Puoi cercare e visualizzare i dati fiscali archiviati in SAFE. |
Configurazione dell’archiviazione automatica
Sezione intitolata “Configurazione dell’archiviazione automatica”Disponibilità e configurazione
Sezione intitolata “Disponibilità e configurazione”Per SIGN DE, SIGN AT e DSFinV-K, SAFE deve essere incluso nel tuo contratto. HUB verifica il tuo contratto, quindi non devi attivare nulla. Da quel momento puoi impostare i calendari di archiviazione per l’Account, i suoi Group e le sue Unit. Se SAFE non è incluso nel tuo contratto, l’Owner dell’Account o un Admin può fare clic su “Contact sales” nella pagina di archiviazione in HUB.
Per SIGN FR ed E-INVOICE Italia, non devi attivare nulla. L’archiviazione è inclusa automaticamente.
Impostare il calendario di archiviazione
Accedere a HUB
Accedi al tuo account su hub.fiskaly.com e seleziona l’Account, il Group o la Unit da configurare.
Aprire la configurazione di SAFE
Fai clic su Archiving nel pannello di navigazione, poi apri la scheda Configuration. Se non è ancora stato impostato alcun calendario, puoi anche iniziare dalla scheda SAFE facendo clic su Configure Organizations. A livello di Account, puoi raggiungere SAFE anche tramite Explore Archiving in Quick Actions nella pagina iniziale.

Selezionare l'ambito
Sull’Account, fai clic su Configure All Organizations per configurare l’intero Account, oppure su Configure accanto a un Group o a una Unit. In un Group o in una Unit, fai clic su Auto archiving settings.

Impostare il calendario di archiviazione
Scegli Daily e seleziona i giorni, oppure scegli Monthly. Poi imposta l’orario (UTC). Per un Account o un Group, attiva Apply to all organizations per applicare il calendario a tutti i livelli sottostanti. Fai clic su Save.

Dopo il salvataggio, la scheda Configuration mostra CONFIGURED e il tuo calendario, ad esempio Weekly: Mon at 00:00. Per modificare il calendario, segui gli stessi passaggi.
Sebbene SAFE gestisca l’archiviazione tecnica, l’utente rimane responsabile di garantire che la pianificazione dell’archiviazione acquisisca tutti i dati legalmente richiesti. Consultare il proprio consulente fiscale per i requisiti di conservazione specifici della propria giurisdizione.
Dopo aver configurato fiskaly SAFE, esso analizzerà i prodotti connessi secondo il calendario configurato e archivierà le esportazioni risultanti. L’automazione viene eseguita continuamente finché non si modifica la configurazione.
Attualmente, SAFE supporta i seguenti prodotti.
Con un calendario di archiviazione, che imposti come descritto sopra:
- SIGN DE — esportazioni TSS
- SIGN AT — esportazioni DEP7
- DSFinV-K — esportazioni di chiusura cassa
Automaticamente, senza calendario. L’archiviazione per questi prodotti non può essere disattivata:
- SIGN FR — esportazioni di log eventi XML (tramite UAPI)
- E-INVOICE Italia — ogni fattura inviata e ricevuta
Quando fiskaly SAFE archivia i tuoi dati, memorizza le esportazioni risultanti insieme ad annotazioni chiave. Questo consente di identificare, filtrare e recuperare rapidamente i dati necessari in HUB.
L’archiviazione automatica viene continuamente estesa ad altri prodotti fiskaly dove l’archiviazione è un requisito legale.
🇩🇪 SIGN DE
Sezione intitolata “🇩🇪 SIGN DE”SAFE archivia le esportazioni TSS secondo il calendario configurato.
Proprietà tipiche:
- Data di creazione del documento
- Periodo di conservazione legale
- Data di inizio/fine dei dati esportati
- ID TSS
- ID client (opzionali)
🇦🇹 SIGN AT
Sezione intitolata “🇦🇹 SIGN AT”SAFE archivia le esportazioni DEP7 secondo il calendario configurato.
Proprietà tipiche:
- Data di creazione del documento
- Periodo di conservazione legale
- Data di inizio/fine dei dati esportati
- ID ricevuta
- ID registratore di cassa
- Tipo di ricevuta (normale, annullamento, formazione)
- Contatore firme
- ID entità giuridica
🇫🇷 SIGN FR
Sezione intitolata “🇫🇷 SIGN FR”SAFE archivia tutti i record del log eventi tracciati da SIGN FR tramite UAPI, insieme a un file di integrità per record. L’archiviazione viene attivata automaticamente dopo ogni chiusura giornaliera. Non è necessario impostare un calendario.
Proprietà tipiche:
- Data di creazione del documento
- Periodo di conservazione legale
- Data di inizio/fine dei dati esportati
- ID POS
- Periodo
- Attività commerciale
🇩🇪 DSFinV-K
Sezione intitolata “🇩🇪 DSFinV-K”SAFE archivia le chiusure di cassa per Unit secondo un calendario configurabile (predefinito: settimanale, ogni lunedì).
Proprietà tipiche:
- Data di creazione del documento
- Periodo di conservazione legale
- Data di inizio/fine dei dati esportati
- ID client
- Date di business
- ID chiusura cassa
- Numero di revisione
🇮🇹 E-INVOICE Italia
Sezione intitolata “🇮🇹 E-INVOICE Italia”SAFE archivia automaticamente ogni fattura che invii e ricevi. Non è necessario impostare un calendario.
Ricerca ed esportazione dei dati
Sezione intitolata “Ricerca ed esportazione dei dati”Puoi cercare i dati archiviati per le Unit a cui sei autorizzato ad accedere, e la ricerca può estendersi su più Group e Unit quando i permessi lo consentono. I risultati vengono visualizzati in una vista elenco dalla quale puoi selezionare e scaricare le voci desiderate. Per accedere ai dati, fai clic su Archiving nel pannello di navigazione.
Le esportazioni sono disponibili in formati come TSS-Export, DSFinV-K Export e DEP7. Sono supportati XML, JSON, PDF, ZIP, TAR e HTML. L’accesso opzionale per i revisori fornisce viste standardizzate Z1–Z3 direttamente in HUB.
Scheda “Esportazioni”
Sezione intitolata “Scheda “Esportazioni””La scheda Esportazioni nella sezione SAFE mostra le esportazioni create negli ultimi 7 giorni, dalla più recente, per l’organizzazione in cui ti trovi. Le esportazioni dei Group e delle Unit sottostanti non sono incluse.
Ogni riga indica l’ora di creazione, lo stato e il formato dell’archivio (ZIP o TAR): quanto basta per individuare un’esportazione recente e scaricarla di nuovo senza fare una nuova ricerca.
Il pulsante di download si attiva appena l’esportazione è completata. Mentre è ancora in elaborazione, o se non è riuscita, resta disattivato. Per le esportazioni più vecchie di 7 giorni, cerca di nuovo nei file archiviati.
Oltre all’interfaccia HUB, fiskaly fornisce l’API SAFE, che consente di cercare, filtrare ed esportare dati archiviati in modo programmatico. I dettagli tecnici sono disponibili nella documentazione dell’API SAFE.
Ricerca dei file archiviati
Sezione intitolata “Ricerca dei file archiviati”Il nostro sistema di ricerca dei file archiviati si basa sull’uso di annotazioni, proprietà e valori. Ecco una descrizione dettagliata di ciascun componente e di come utilizzarli in modo efficace:
- Le annotazioni sono raccolte di proprietà che forniscono parametri di ricerca per i file. Aiutano a categorizzare e identificare dettagli specifici all’interno dei tuoi documenti.
- Una proprietà è un singolo parametro all’interno di un’annotazione, collegato a un file e contenente un valore specifico.
- I valori di ricerca sono i criteri specifici che stai cercando all’interno delle proprietà.

Esempio di un’annotazione, delle sue proprietà e dei relativi valori
Come posso cercare un file?
Sezione intitolata “Come posso cercare un file?”Selezionare un'annotazione
Inizia scegliendo un’annotazione appropriata nel generatore di richieste di ricerca.
Scegliere una proprietà
Una volta selezionata l’annotazione, scegli una proprietà rilevante per la tua ricerca.
Specificare un valore
Definisci il valore esatto che stai cercando all’interno della proprietà scelta.

Esempio di una richiesta di ricerca per trovare tutte le ricevute di rimborso in contanti emesse in euro
La ricerca individuerà i file che corrispondono esattamente all’annotazione, alla proprietà e al valore specificati. Se un’annotazione o una proprietà non è stata associata a un file al momento del caricamento, tale file non verrà incluso nei risultati della ricerca.
Suggerimenti aggiuntivi
Sezione intitolata “Suggerimenti aggiuntivi”- Puoi combinare fino a cinque parametri di ricerca diversi.
- Più parametri di ricerca vengono combinati tramite un AND logico, il che significa che la ricerca restituirà solo i file che soddisfano tutti i criteri specificati.
- Sii preciso con i valori di ricerca per non perdere documenti rilevanti.
Risoluzione dei problemi
Sezione intitolata “Risoluzione dei problemi”| Problema | Cosa fare |
|---|---|
| Nessun file archiviato dopo aver salvato il calendario | SAFE archivia per la prima volta al giorno e all’orario programmati successivi (UTC). Fino ad allora, la scheda Archived Files non mostra alcun file. |
| Vuoi verificare che il calendario sia salvato | Apri la scheda Configuration. Ogni Account, Group o Unit con un calendario mostra CONFIGURED e il calendario, ad esempio Weekly: Mon at 00:00. |
| Non riesci a vedere o salvare il calendario | Solo gli Owner dell’Account e gli Admin possono configurare SAFE. Se hai uno di questi ruoli e la scheda Configuration non mostra CONFIGURED dopo il salvataggio, oppure il salvataggio non riesce con un messaggio di errore, contatta il supporto fiskaly. |
| Mancano esportazioni meno recenti | SAFE archivia solo le esportazioni create dopo il salvataggio del calendario. Per archiviare esportazioni meno recenti, contatta il supporto fiskaly. |
| Vuoi archiviare subito | Non puoi avviare un’archiviazione manualmente. SAFE archivia secondo il tuo calendario. SIGN FR ed E-INVOICE Italia vengono archiviati automaticamente. Per caricare file quando serve, usa SAFE flex. |
SAFE e SAFE flex in sintesi
Sezione intitolata “SAFE e SAFE flex in sintesi”In HUB, fiskaly SAFE automatizza l’archiviazione dai prodotti fiskaly connessi secondo un calendario senza caricamenti manuali. SAFE flex è un’API separata e indipendente — già disponibile per tutte le soluzioni fiskaly — che offre pieno controllo su cosa caricare, quando caricare e quali annotazioni applicare, indipendentemente dai prodotti utilizzati. Entrambi possono essere utilizzati separatamente o insieme, a seconda del flusso di lavoro. Per i dettagli sulle differenze, visita la nostra guida SAFE.