Glossario

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.