Glossario

⚠️ Stai visualizzando la documentazione per la versione API 2026-02-03. La versione più recente è 2026-05-04. La nuova versione API non apporta modifiche all’integrazione italiana. Tuttavia, aggiunge il supporto SIGN PT, consentendo ai team che pianificano di espandersi in Portogallo di riutilizzare la stessa integrazione già in uso per l’Italia.

Ecco cosa configurerai:

🏢

Organization

---

• AccountGenerato da HUB

  Entità di livello superiore in fiskaly HUB. Non può essere annidata all’interno di un altro Account.

• GroupGenerato da HUB

  Livello intermedio che organizza le Unit in cluster logici (ad es. uno per paese).

• UnitGenerato da API

  Commerciante / contribuente che opera all’interno del Group.

🔑

API Key & Secret

---

• Livello GroupGenerato da HUB

  Generato in HUB per l’Organization GROUP. Utilizzato per autenticarsi nell’API SIGN IT al fine di creare Organization Unit e le relative chiavi API.

• Livello UnitGenerato da API

  Generato tramite API (endpoint createSubject) per l’Organization UNIT. Utilizzato per autenticarsi per tutte le chiamate operative a livello di unit.

🧾

Taxpayer

---

Informazioni dell’entità registrata presso l’Agenzia delle Entrate italiana (AdE) e soggetta alle normative fiscali in Italia.

• COMPANY

  Persona giuridica (“Società”)

• INDIVIDUAL

  Persona fisica (“Persona fisica”)

📍

Location

---

• HEAD_OFFICE

  Creata automaticamente alla creazione del Contribuente, condivide lo stesso UUID. Coincide con l’indirizzo legale.

• BRANCH

  Ogni negozio, punto vendita o altra sede operativa aziendale in cui si svolgono operazioni fiscali.

💻

System

---

• FISCAL_DEVICE

  Astrazione di un registratore di cassa utilizzato per registrare i dati delle transazioni in conformità con le normative fiscali italiane.

📄

Record

---

Ogni operazione commerciale effettuata nel System. Richiede due chiamate successive:

• INTENTION

  Identifica l’intenzione di registrare una transazione nel System.

• TRANSACTION

  Identifica una ricevuta fiscale emessa dal System.

Glossario

Nome	Descrizione
Documento commerciale	Ricevuta fiscale italiana. Dal 2020, viene utilizzata per certificare le transazioni B2C, sostituendo la tradizionale ricevuta fiscale. I dati delle transazioni possono essere trasmessi elettronicamente all’AdE tramite: Un registratore telematico (dispositivo RT) La procedura web “Documento Commerciale Online” sul portale “Fatture e Corrispettivi” dell’Agenzia delle Entrate SIGN IT lite Soluzioni software approvate conformi alle specifiche tecniche del 7 marzo 2025 SIGN IT
Codice lotteria	Codice alfanumerico di 8 caratteri, univocamente collegato al codice fiscale dell’acquirente, necessario per partecipare alla lotteria degli scontrini (“Lotteria degli Scontrini”). Generato sul portale ufficiale e presentato al commerciante al momento del pagamento elettronico per collegare l’acquisto alla lotteria.
AdE	Agenzia delle Entrate — Autorità fiscale italiana.
Numero progressivo	Numero univoco assegnato dall’AdE a ogni registrazione TRANSACTION trasmessa con successo. Incluso nel campo compliance.data restituito nella risposta.