Glossar

⚠️ Sie sehen die Dokumentation für API-Version 2026-02-03. Die neueste Version ist 2026-05-04. Die neue API-Version bringt keine Änderungen an der italienischen Integration. Sie fügt jedoch die SIGN PT-Unterstützung hinzu und ermöglicht es Teams, die eine Expansion nach Portugal planen, dieselbe Integration, die bereits für Italien vorhanden ist, wiederzuverwenden.

Folgendes werden Sie konfigurieren:

🏢

Organisation

AccountHUB-generiert
Übergeordnete Einheit im fiskaly HUB. Kann nicht in einen anderen Account eingebettet werden.
GroupHUB-generiert
Zwischenebene, die Units in logische Cluster organisiert (z. B. eines pro Land).
UnitAPI-generiert
Händler / Steuerpflichtiger, der der Group untergeordnet ist.

🔑

API Key & Secret

Group-EbeneHUB-generiert
Im HUB für die Organisation GROUP generiert. Wird zur Authentifizierung in der SIGN IT API verwendet, um Organization Units und deren API Key zu erstellen.
Unit-EbeneAPI-generiert
Über API (Endpunkt createSubject) für die Organization UNIT generiert. Wird zur Authentifizierung für alle operativen Aufrufe auf Unit-Ebene verwendet.

🧾

Steuerpflichtiger

Informationen der bei der italienischen Steuerbehörde (AdE) registrierten Einheit, die den Steuervorschriften in Italien unterliegt.

COMPANY
Juristische Person (“Società”)
INDIVIDUAL
Natürliche Person (“Persona fisica”)

📍

Standort

HEAD_OFFICE
Wird automatisch bei der Erstellung des Steuerpflichtigen angelegt und teilt dieselbe UUID. Stimmt mit der rechtlichen Adresse überein.
BRANCH
Jedes Geschäft, jede Filiale oder jeder andere betriebliche Standort, an dem steuerliche Vorgänge stattfinden.

💻

System

FISCAL_DEVICE
Abstraktion einer Registrierkasse zur Erfassung von Transaktionsdaten gemäß den italienischen Steuervorschriften.

📄

Datensatz

Jeder im System durchgeführte Geschäftsvorgang. Erfordert zwei aufeinanderfolgende Aufrufe:

INTENTION
Kennzeichnet die Absicht, eine Transaktion im System zu erfassen.
TRANSACTION
Kennzeichnet einen vom System ausgestellten Fiskalbeleg.

Glossar

Name	Beschreibung
Handelsdokument	Italienischer Fiskalbeleg. Wird seit 2020 zur Zertifizierung von B2C-Transaktionen verwendet und ersetzt den traditionellen Fiskalbon. Transaktionsdaten können elektronisch an die AdE übermittelt werden über: Eine telematische Registrierkasse (RT-Gerät) Das Webverfahren „Documento Commerciale Online” im Portal „Fatture e Corrispettivi” der Steuerbehörde SIGN IT lite Zugelassene Softwarelösungen, die den technischen Spezifikationen vom 7. März 2025 entsprechen SIGN IT
Lotterie-Code	Achtstelliger alphanumerischer Code, der eindeutig mit der Steueridentifikationsnummer des Käufers verknüpft ist und für die Teilnahme an der Belegslotterie („Lotteria degli Scontrini”) erforderlich ist. Wird auf dem offiziellen Portal generiert und dem Händler zum Zeitpunkt der elektronischen Zahlung vorgezeigt, um den Kauf mit der Lotterie zu verknüpfen.
AdE	Agenzia delle Entrate — Italienische Steuerbehörde.
Fortlaufende Nummer	Eindeutige Nummer, die von der AdE jedem erfolgreich übermittelten TRANSACTION-Datensatz zugewiesen wird. In der im Response zurückgegebenen `compliance.data` enthalten.

Was this page helpful?