Stati e modalità di Taxpayer, Location e System

⚠️ Stai visualizzando la documentazione per la versione API 2026-02-03. La versione più recente è 2026-05-04. La nuova versione API non apporta modifiche all’integrazione italiana. Tuttavia, aggiunge il supporto SIGN PT, consentendo ai team che pianificano di espandersi in Portogallo di riutilizzare la stessa integrazione già in uso per l’Italia.

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

La comprensione di 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 al momento della creazione. In questo stato non è possibile eseguire operazioni.
• Commissioned: La risorsa è pronta e completamente operativa (purché la modalità sia operativa).
• 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 è completamente funzionale e opera come previsto.
• Suspended: Temporaneamente in pausa, che può essere avviata tramite una chiamata API, ad es. quando è necessario aggiornare le credenziali.
• Degraded (non ancora implementato): La risorsa è operativa ma temporaneamente non disponibile, ad es. a causa di credenziali non valide o errori.

📘Nota

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 entrambi i sensi.

Transizioni di stato

• Acquired → Commissioned: Richiede una chiamata API (PATCH) per aggiornare la risorsa.
• Commissioned → Decommissioned: Gestita tramite una chiamata API (PATCH) per contrassegnare la risorsa come non più in uso. Questa modifica dello stato è irreversibile.

Transizioni di modalità

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