Salta ai contenuti

Stai visualizzando la documentazione per la versione API 2026-05-04. La versione più recente è 2026-06-01.

Questa sezione fornisce una panoramica degli state e dei 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.

Stato e modalità della risorsa entità
  • 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.
  • 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

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.