Salta ai contenuti

Stai visualizzando la documentazione per la versione API 2024-10-31. La versione più recente è 2026-06-01. 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 Entities e Systems. Il diagramma seguente illustra le transizioni tra questi stati e modi, descrivendo in dettaglio come la risorsa si evolve dalla creazione alla dismissione e come i suoi modi operativi 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.

  • Acquired: Stato iniziale della risorsa al momento della creazione. Non è possibile eseguire operazioni in questo stato.
  • Commissioned: La risorsa è pronta e completamente operativa (a condizione che il modo sia operativo).
  • Decommissioned: La risorsa non è più operativa e non può eseguire alcun compito.
  • Inactive: Modalità iniziale della risorsa al momento della creazione. In questa modalità non è possibile eseguire operazioni.
  • Operative: La risorsa è completamente funzionale e opera come previsto.
  • Suspended: La risorsa è temporaneamente in pausa tramite una chiamata API (PATCH) — ad es. per aggiornare le credenziali Fisconline o altre informazioni della risorsa. Una volta completato l’aggiornamento, la risorsa può essere riportata a Operative.
  • Degraded (non disponibile in LIVE in questa versione): La risorsa è operativa ma temporaneamente non disponibile — ad es. a causa di errori delle credenziali Fisconline. In TEST, questa modalità può essere attivata manualmente inviando il record TRANSACTION con l’header X-Taxpayer-Credentials-Expired: true. In LIVE, è disponibile solo a partire dalla versione API 2026-06-01. Per saperne di più, consulta l’articolo dedicato: Cos’è la modalità DEGRADED e come intervenire
Entity Resource State and Mode

Tutte le transizioni di state sono irreversibili.

  • Acquired → Commissioned: Richiede una chiamata API (PATCH) per attivare la risorsa. Se l’operazione ha esito positivo, la modalità corrispondente passa automaticamente da Inactive a Operative.
  • Commissioned → Decommissioned: Richiede una chiamata API (PATCH) per contrassegnare la risorsa come non più in uso. Se l’operazione ha esito positivo, la modalità corrispondente passa da Operative a Inactive, segnando la fine del ciclo di vita della risorsa.
  • Acquired → Decommissioned: Richiede una chiamata API (PATCH) per terminare il ciclo di vita della risorsa senza mai attivarla. Questo è utile, ad esempio, quando una risorsa è stata creata per errore e non deve mai diventare operativa. Poiché la risorsa non è mai stata attivata, la modalità corrispondente resta Inactive per tutta la durata.
  • Inactive → Operative: Avviene automaticamente quando lo stato viene aggiornato con successo a Commissioned tramite una chiamata API (PATCH).
  • Operative → Suspended: Attivata tramite una chiamata API (PATCH) — ad es. per sospendere temporaneamente le operazioni durante l’aggiornamento delle credenziali Fisconline o di altre informazioni della risorsa.
  • Operative → Degraded (non disponibile in LIVE in questa versione): Avviene automaticamente — ad es. a causa di errori persistenti delle credenziali Fisconline. In TEST, questa transizione può essere attivata manualmente inviando il record TRANSACTION con l’header X-Taxpayer-Credentials-Expired: true. In LIVE, è disponibile solo a partire dalla versione API 2026-06-01. Per saperne di più, consulta l’articolo dedicato: Cos’è la modalità DEGRADED e come intervenire
  • Degraded → Suspended (non disponibile in LIVE in questa versione): Deve essere attivata manualmente tramite una chiamata API (PATCH) per affrontare errori persistenti delle credenziali Fisconline prima di ripristinare il Taxpayer alla modalità Operative. In LIVE, è disponibile solo a partire dalla versione API 2026-06-01. Per saperne di più, consulta l’articolo dedicato: Cos’è la modalità DEGRADED e come intervenire
  • Suspended → Operative: Attivata tramite una chiamata API (PATCH) una volta completati gli aggiornamenti necessari — ad es. le credenziali Fisconline o altre informazioni della risorsa.