Stati e Modalità di Entità e Sistema

⚠️ Stai visualizzando la documentazione per la versione API 2025-08-12. La versione più recente è 2026-05-04. Le modifiche principali includono una terminologia aggiornata (Asset → Organization, Entity → Taxpayer/Location).

Questa sezione fornisce una panoramica dello state e del mode che definiscono il ciclo di vita e il comportamento operativo delle risorse Entità e Sistemi. Il diagramma seguente illustra le transizioni tra questi stati e modalità, descrivendo in dettaglio come la risorsa evolve dalla creazione al decomissionamento e come le sue modalità operative si adattano in base a eventi interni o chiamate API esterne.

Comprendere queste transizioni è essenziale per gestire le risorse in modo efficace, garantire operazioni fluide e risolvere problemi come credenziali non valide o pause temporanee.

Stati

• Acquired: Stato iniziale della risorsa alla creazione. In questo stato non è possibile eseguire operazioni.
• Commissioned: La risorsa è pronta e pienamente operativa (a condizione che la modalità sia operative).
• Decommissioned: La risorsa non è più operativa e non può eseguire alcun compito. Questo stato è irreversibile.

Modalità

• Inactive: La risorsa è inattiva e non operativa.
• Operative: La risorsa è pienamente funzionale e opera come previsto.
• Suspended: Temporaneamente in pausa, che può essere avviata tramite una chiamata API, ad esempio quando è necessario aggiornare le credenziali.
• Degraded (non ancora implementato): La risorsa è operativa ma temporaneamente non disponibile, ad esempio a causa di credenziali non valide o errori.

📘Note

Ogni transizione è attivata da una chiamata API esterna o avviene automaticamente in base alla logica interna del sistema. PATCH indica che è necessaria una chiamata API esterna per avviare la transizione. INTERNAL indica che la transizione viene attivata automaticamente all’interno del sistema. Le frecce bidirezionali indicano che la transizione può avvenire in entrambe le direzioni.

Transizioni di Stato

• Acquired → Commissioned: Richiede una chiamata API (PATCH) per aggiornare la risorsa.
• Commissioned → Decommissioned: Gestito tramite una chiamata API (PATCH) per contrassegnare la risorsa come non più in uso. Questo cambiamento di stato è irreversibile.

Transizioni di Modalità

• Inactive → Operative: Transisce automaticamente se lo stato viene aggiornato a Commissioned tramite chiamata API.
• Operative → Suspended: Può essere eseguita attivamente tramite l’API, ad esempio per sospendere temporaneamente le operazioni durante l’aggiornamento delle credenziali.
• Operative → Degraded (non ancora implementato): Transisce automaticamente se le credenziali non sono valide o si verifica un errore.
• Degraded → Suspended (non ancora implementato): Deve essere aggiornata attivamente tramite l’API per risolvere problemi come credenziali non valide.
• Suspended → Operative: Può essere aggiornata tramite l’API dopo aver risolto i problemi, ad esempio aggiornando le credenziali.
• Degraded → Operative (non ancora implementato): Può transitare automaticamente quando i problemi con la risorsa vengono risolti internamente.