fiskaly HUB è la nuova interfaccia web che sostituisce il precedente fiskaly Dashboard ed è ora il punto centrale per la gestione della tua integrazione SIGN IT.
Questo articolo spiega cosa viene gestito in HUB e cosa rimane invece gestito tramite API, dal punto di vista di SIGN IT. Per HUB stesso, manteniamo una guida HUB completa: ogni sezione qui sotto rimanda all'argomento corrispondente, dove troverai tutti i dettagli e gli screenshot.
Per comprendere l'intero flusso di integrazione e quando eseguire ciascun passaggio, ti consigliamo di consultare la guida all'integrazione di SIGN IT.
Nota: se in precedenza utilizzavi il fiskaly Dashboard, HUB ne è il successore. Offre una struttura unificata per Account, Group e Unit, insieme a una navigazione migliorata, alla gestione dell'Organization, alla gestione delle API Key e all'accesso ai servizi fiskaly sia in ambiente TEST che LIVE. Questo articolo spiega le principali differenze tra la terminologia utilizzata su Dashboard e quella utilizzata su HUB: SIGN IT - Nuova terminologia delle risorse
Dove trovare cosa
| Configurazione dell'Account, gestione utenti, API Key | HUB |
| Monitoraggio di Taxpayer, Location, System e Record | HUB (sezione SIGN IT) |
| Passaggio all'ambiente LIVE | HUB (Go LIVE) |
| Creazione e gestione delle Unit (Taxpayer) | SIGN IT API |
Nota: tutti i corrispettivi trasmessi con successo restano inoltre accessibili e tracciabili dal Taxpayer tramite il portale dell'Agenzia delle Entrate, dove ogni contribuente può consultare autonomamente i propri dati fiscali.
Cosa puoi fare in HUB per SIGN IT
Account e accesso
Registrati su hub.fiskaly.com per ricevere l'email di attivazione: il link è valido per 5 minuti. Se disponi già di un account su Dashboard, ti basta accedere a HUB con le stesse credenziali. Una volta effettuato l'accesso, potrai creare il tuo Account, invitare utenti, assegnare ruoli e generare API Key.
→ Primi passi · Glossario
Selezione dell'ambito (Pannello di navigazione → Organizations → Select)
Tutto ciò che vedi in HUB dipende dall'organizzazione che stai visualizzando in quel momento. La scheda dell'organizzazione nella parte superiore della barra laterale mostra sempre dove ti trovi; puoi cliccarci sopra per aprire la pagina di dettaglio di quell'organizzazione, oppure utilizzare Organizations nel pannello di navigazione per aprire il selettore delle organizzazioni e cambiarla.
Ciò che è disponibile dipende dal livello selezionato:
- Account — i dati aziendali e la sezione "What's New" con avvisi di manutenzione e aggiornamenti sulle release. In arrivo: informazioni su piani e fatturazione.
- Group — gestione delle Unit sottostanti, invito degli utenti e generazione delle API Key
- Unit — i dati SIGN IT relativi a quel Taxpayer, oltre alle relative API Key, agli utenti e alla panoramica dei prodotti disponibili.
→ Menu HUB · Cambio organizzazione
Gestione degli utenti (Pannello di navigazione → Users)
Invita o rimuovi utenti a livello di Account, Group o Unit, a seconda di dove l'utente deve avere accesso. A livello di Account puoi anche assegnare i ruoli — Owner, Admin, Billing e Regular user — tramite policy, opzionalmente con una data di scadenza per l'accesso temporaneo.
→ Gestione utenti · Ruoli e assegnazione dei ruoli
API Key (Pannello di navigazione → API Keys)
Vengono create a livello di Group o Unit a seconda della tua integrazione, e sono necessarie per generare access token all'interno della SIGN IT API (endpoint createToken). Le API Key sono specifiche per ambiente: una Key di TEST crea solo risorse di test; una Key di LIVE crea solo risorse di produzione.
Gestione dell'Organization (Pannello di navigazione → Organizations)
Una pagina dedicata mostra l'intera gerarchia di Group e Unit appartenenti al tuo Account. Se utilizzi i Group, le Unit vengono mostrate all'interno della struttura del Group.
Ogni Group e Unit dispone inoltre di una pagina di dettaglio in cui puoi visualizzare e modificare nome, indirizzo e logo dell'organizzazione.
→ Dettagli dell'organizzazione
Monitoraggio di SIGN IT
Una volta creata e configurata tramite API, un'Organization UNIT compare nella sezione SIGN IT di HUB, che segue la stessa gerarchia di un drill-down a partire dal Taxpayer:
- La Overview ti offre una lettura immediata dello stato operativo del Taxpayer: il suo stato e la modalità correnti e quanti System sono commissioned al suo interno. Da qui,
- Locations ti permette di vedere dove quei System sono fisicamente installati e verificare che ogni Location funzioni come previsto. Cliccando su una Location, la vista si restringe ai relativi
- Systems, dove puoi monitorare l'attività di ciascun System, incluso il numero di Record emessi e i relativi dettagli software.
- I Records si trovano al livello più granulare e forniscono un registro di stato di ogni transazione fiscale in tutte le Location e i System appartenenti all'Organization UNIT.
→ Panoramica del servizio SIGN IT
Le tue risorse SIGN IT vengono sempre mostrate a livello di Unit, poiché ogni Unit corrisponde a un Taxpayer. Se stai cercando Location, System o Record e la sezione SIGN IT appare vuota, verifica di aver selezionato la Unit corretta e non l'Account o un Group.
Per il recupero tramite API, puoi comunque elencare tutti gli Asset tramite l'endpoint SIGN IT ListAssets. Per recuperare le Unit appartenenti a un Group specifico, includi l'header:
X-Scope-Identifier: {GROUP_ID}
Passaggio a LIVE
Quando sei pronto a elaborare transazioni reali, l'Account Owner clicca su "Go Live" nel banner Test Mode nella parte superiore di HUB. Dopo aver confermato i dati della tua azienda, il nostro team Sales ti contatterà per completare l'iter contrattuale. Una volta attivato LIVE, potrai passare dall'ambiente TEST all'ambiente LIVE direttamente in HUB.
→ Passaggio all'ambiente LIVE & SIGN IT - Ambienti TEST e LIVE
Guida e stato
La barra di navigazione superiore include un menu Help con accesso diretto alla nostra documentazione per sviluppatori, al centro assistenza e al contatto con il supporto. Da lì puoi anche cambiare la lingua dell'interfaccia di HUB — HUB è disponibile in inglese, tedesco, spagnolo, italiano e francese.
Riepilogo
- HUB sostituisce il vecchio Dashboard e supporta tutte le funzioni di configurazione relative a SIGN IT.
- Struttura organizzativa, accesso degli utenti e API Key sono oggi interamente gestiti all'interno di HUB.
- Taxpayer, Location, System e Record vengono monitorati in HUB; il contenuto fiscale dei record viene consultato sul portale dell'AdE.
- Le Unit (Taxpayer) continuano a essere create e gestite tramite la SIGN IT API.