Stati e modalità del contribuente, della sede e del sistema

Questa sezione fornisce una panoramica dello state e della mode che definiscono il ciclo di vita e il comportamento operativo delle risorse Taxpayer, Location e System. Il diagramma seguente illustra le transizioni tra stati e modalità, descrivendo come la risorsa evolve dalla creazione alla disattivazione 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.

📘Note

Ogni transizione è attivata da una chiamata API esterna o avviene automaticamente in base alla logica interna del sistema:

• PATCH indica che è richiesta una chiamata API esterna per avviare la transizione.
• INTERNAL indica che la transizione è attivata automaticamente all’interno del sistema.

Le frecce bidirezionali indicano che la transizione può avvenire in entrambe le direzioni.

Stati

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

Modalità

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

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. Questo cambio di stato è irreversibile.

📘Nota sulla fatturazione

Per la maggior parte dei contratti, i System sono le unità utilizzate per la fatturazione con fiskaly. Un System diventa rilevante ai fini della fatturazione non appena il suo stato passa da ACQUIRED a COMMISSIONED nell’ambiente LIVE. Le risorse nell’ambiente TEST non vengono fatturate. Per le condizioni di fatturazione esatte, fare riferimento al proprio contratto con fiskaly.

Transizioni di modalità

• Inactive → Operative: Si verifica automaticamente se lo stato viene aggiornato a Commissioned tramite una 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): Si verifica 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 la risoluzione dei problemi, ad es. dopo l’aggiornamento delle credenziali.
• Degraded → Operative (non ancora implementato): Può avvenire automaticamente quando i problemi con la risorsa vengono risolti internamente.