Zustände und Modi von Taxpayer, Location und System

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

Das Verständnis dieser Übergänge ist wesentlich für ein effektives Ressourcenmanagement, reibungslose Abläufe und die Behebung von Problemen wie ungültigen Zugangsdaten.

📘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.

Zustände

• Acquired: Anfangszustand der Ressource bei der Erstellung. In diesem Zustand können keine Operationen durchgeführt werden.
• Commissioned: Die Ressource ist bereit und vollständig betriebsbereit (sofern der Modus operativ ist).
• Decommissioned: Die Ressource ist nicht mehr betriebsbereit und kann keine Aufgaben mehr ausführen.

Modi

• Inactive: Initialer Modus der Ressource bei der Erstellung. In diesem Modus können keine Operationen durchgeführt werden.
• Operative: Die Ressource ist voll funktionsfähig und arbeitet wie vorgesehen.
• Suspended: Die Ressource ist vorübergehend über einen API-Aufruf (PATCH) pausiert — z. B. um Fisconline-Zugangsdaten oder andere Ressourceninformationen zu aktualisieren. Nach Abschluss der Aktualisierung kann die Ressource wieder auf Operative gesetzt werden.
• Degraded: Die Ressource hat einen dauerhaften Fisconline-Zugangsdatenfehler gegen AdE festgestellt. Datensatzübermittlungen sind blockiert, bis die Fisconline-Zugangsdaten behoben und der Taxpayer manuell in den Modus Operative zurückversetzt wurden.
  Mehr dazu im entsprechenden Artikel: Was ist der DEGRADED-Modus und wie kann man ihn beheben?

Zustandsü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.

⚠️Abrechnungshinweis

Die Inbetriebnahme eines Systems in der LIVE-Umgebung markiert den Beginn der Abrechnung und löst die Übermittlung offizieller Rechnungen an die Finanzbehörden aus. In der TEST-Umgebung finden weder Abrechnungen noch echte Übermittlungen statt.

Modusübergänge

• Inactive → Operative: Wechselt automatisch, wenn der Zustand erfolgreich über einen API-Aufruf (PATCH) 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: Wechselt automatisch — z. B. aufgrund von dauerhaften Fisconline-Zugangsdatenfehlern. Mehr dazu im entsprechenden Artikel: Was ist der DEGRADED-Modus und wie kann man ihn beheben?
• Degraded → Suspended: 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.