Status und Modi von Steuerpflichtigem, Standort und System

⚠️ 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.

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) (noch nicht implementiert): Die Ressource ist betriebsbereit, aber vorübergehend nicht verfügbar, z. B. aufgrund ungültiger Zugangsdaten oder Fehler.

📘Note

Jeder Übergang wird entweder durch einen externen API-Aufruf ausgelöst oder erfolgt automatisch basierend auf der internen Systemlogik. PATCH zeigt an, dass ein externer API-Aufruf erforderlich ist, um den Übergang zu initiieren. INTERNAL zeigt 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

• Acquired → Commissioned: Erfordert einen API-Aufruf (PATCH) zur Aktualisierung der Ressource.
• Commissioned → Decommissioned: Wird durch einen API-Aufruf (PATCH) verwaltet, um die Ressource als nicht mehr in Verwendung zu markieren. Diese Statusänderung ist unumkehrbar.

Modusübergänge

• Inactive → Operative: Wechselt automatisch, wenn der Status über einen API-Aufruf auf „Commissioned” aktualisiert wird.
• Operative → Suspended: Kann aktiv über die API durchgeführt werden, z. B. um den Betrieb vorübergehend auszusetzen, während Zugangsdaten aktualisiert werden.
• Operative → Degraded (noch nicht implementiert): Wechselt automatisch, wenn Zugangsdaten ungültig sind oder ein Fehler auftritt.
• Degraded → Suspended (noch nicht implementiert): Sollte aktiv über die API aktualisiert werden, um Probleme wie ungültige Zugangsdaten zu beheben.
• Suspended → Operative: Kann nach der Behebung von Problemen über die API aktualisiert werden, z. B. nach der Aktualisierung von Zugangsdaten.
• Degraded → Operative (noch nicht implementiert): Kann automatisch wechseln, wenn Probleme mit der Ressource intern behoben werden.