Status und Modi von Steuerpflichtigem, Standort und System

⚠️Warning

Sie sehen die Dokumentation für API-Version 2026-02-03. Die neueste Version ist 2026-06-01. 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.

Dieser Abschnitt bietet eine Übersicht über die state- und mode-Attribute, die den Lebenszyklus und das Betriebsverhalten der Ressourcen Taxpayer, Location und System definieren. Das nachfolgende Diagramm veranschaulicht die Übergänge zwischen diesen Status und Modi und zeigt auf, wie sich die Ressource von der Erstellung bis zur Außerbetriebnahme weiterentwickelt und wie sich ihre Betriebsmodi basierend auf internen Ereignissen oder externen API-Aufrufen anpassen.

Das Verständnis dieser Übergänge ist essenziell für eine effektive Ressourcenverwaltung, einen reibungslosen Betrieb und die Behebung von Problemen wie ungültigen Zugangsdaten oder vorübergehenden Pausen.

Status

• Acquired (Erworben): Anfangsstatus der Ressource bei der Erstellung. In diesem Status können keine Operationen durchgeführt werden.
• Commissioned (In Betrieb): Die Ressource ist bereit und vollständig betriebsbereit (sofern der Modus operativ ist).
• Decommissioned (Außer Betrieb): Die Ressource ist nicht mehr betriebsbereit und kann keine Aufgaben mehr ausführen. Dieser Status ist unumkehrbar.

Modi

• Inactive (Inaktiv): Die Ressource ist inaktiv und nicht betriebsbereit.
• Operative (Betriebsbereit): Die Ressource ist voll funktionsfähig und arbeitet wie vorgesehen.
• Suspended (Ausgesetzt): Vorübergehend pausiert, was über einen API-Aufruf initiiert werden kann, z. B. wenn Zugangsdaten aktualisiert werden müssen.
• Degraded (Beeinträchtigt) (in dieser Version noch nicht in LIVE verfügbar): Die Ressource ist betriebsbereit, aber vorübergehend nicht verfügbar, z. B. aufgrund ungültiger Zugangsdaten oder Fehler. In der TEST-Umgebung kann dieser Modus manuell ausgelöst werden, indem der TRANSACTION-Record mit dem Header X-Taxpayer-Credentials-Expired: true gesendet wird, um Ihre Integration vor der Veröffentlichung in der Produktionsumgebung vorzubereiten. Mehr dazu im entsprechenden Artikel: Was ist der DEGRADED-Modus und wie kann man ihn beheben?

📘Note

Jeder Übergang wird entweder durch einen externen API-Aufruf ausgelöst oder erfolgt automatisch basierend auf interner Systemlogik:

• PATCH gibt an, dass ein externer API-Aufruf erforderlich ist, um den Übergang einzuleiten.
• INTERNAL gibt an, dass der Übergang automatisch innerhalb des Systems ausgelöst wird.

Bidirektionale Pfeile zeigen an, dass der Übergang in beide Richtungen erfolgen kann.

Statusübergänge

Alle state-Übergänge sind irreversibel.

• Acquired → Commissioned: Erfordert einen API-Aufruf (PATCH), um die Ressource zu aktivieren. Bei Erfolg wechselt der entsprechende Modus automatisch von Inactive zu Operative.
• Commissioned → Decommissioned: Erfordert einen API-Aufruf (PATCH), um die Ressource als nicht mehr in Verwendung zu markieren. Bei Erfolg wechselt der entsprechende Modus von Operative zu Inactive, was das Ende des Ressourcenlebenszyklus markiert.

⚠️Hinweis zur Abrechnung

Die Inbetriebnahme eines Systems in der LIVE-Umgebung markiert den Beginn der Abrechnung und löst die Übertragung offizieller Rechnungen an die Finanzbehörden aus. In der TEST-Umgebung finden keine Abrechnungen oder echten Übertragungen statt.

Modusübergänge

• Inactive → Operative: Wechselt automatisch, wenn der Status über einen API-Aufruf auf „Commissioned” aktualisiert wird.
• Operative → Suspended: Wird über einen API-Aufruf (PATCH) ausgelöst — z. B. um den Betrieb vorübergehend zu unterbrechen, während Fisconline-Zugangsdaten oder andere Ressourceninformationen aktualisiert werden.
• Operative → Degraded (in dieser Version noch nicht in LIVE verfügbar): Wechselt automatisch — z. B. aufgrund von dauerhaften Fisconline-Zugangsdatenfehlern. In der TEST-Umgebung kann dieser Übergang manuell ausgelöst werden, indem der TRANSACTION-Record mit dem Header X-Taxpayer-Credentials-Expired: true gesendet wird, um Ihre Integration vor der Veröffentlichung in der Produktionsumgebung vorzubereiten. Mehr dazu im entsprechenden Artikel: Was ist der DEGRADED-Modus und wie kann man ihn beheben?
• Degraded → Suspended (in dieser Version noch nicht in LIVE verfügbar): Muss manuell über einen API-Aufruf (PATCH) ausgelöst werden, um dauerhafte Fisconline-Zugangsdatenfehler zu beheben, bevor der Taxpayer in den Modus Operative zurückversetzt wird. Mehr dazu im entsprechenden Artikel: Was ist der DEGRADED-Modus und wie kann man ihn beheben?
• Suspended → Operative: Wird über einen API-Aufruf (PATCH) ausgelöst, sobald die erforderlichen Aktualisierungen abgeschlossen sind — z. B. Fisconline-Zugangsdaten oder andere Ressourceninformationen.