SIGN IT - Cos'è la modalità DEGRADED e come intervenire – fiskaly-support (IT)

Cos'è la modalità DEGRADED?

Quando la trasmissione di un record fallisce a causa di un errore persistente nelle credenziali Fisconline nell'ambiente LIVE, la modalità del Taxpayer passa automaticamente da OPERATIVE a DEGRADED.

Tutte le trasmissioni successive vengono immediatamente bloccate fino a quando le credenziali Fisconline non vengono corrette e il Taxpayer viene ripristinato manualmente in modalità OPERATIVE.

Nota: per ora, questa modifica si applica esclusivamente a SIGN IT 2026-06-01, con effetto dal 19 giugno.

Verrà estesa a tutte le versioni API precedenti nel corso dei prossimi 3 mesi. Per aiutarti a prepararti, a partire dal 19 giugno sarà possibile simulare lo scenario di credenziali scadute nell'ambiente TEST per tutte le versioni API — incluse quelle precedenti alla 2026-06-01. Scopri come alla fine di questo articolo.

Cosa la innesca?

La prima trasmissione di record che fallisce nell'ambiente LIVE con uno dei seguenti 3 errori di autenticazione:

Errore	Causa
`Authentication error: Fisconline credentials expired`	La password ha superato il ciclo di vita di 90 giorni
`Authentication error: Invalid credentials`	Username, PIN o password errati
`Authentication error: authentication failed due to multiple failed intents with wrong credentials - please reset and update them`	Account bloccato dopo ripetuti tentativi di accesso falliti

Il record che innesca l'errore restituisce lo stato FAILED, con l'errore di autenticazione scatenante nei logs.
La modalità del Taxpayer passa automaticamente da OPERATIVE a DEGRADED
Tutte le trasmissioni successive restituiscono immediatamente un errore 405 Method not allowed error — "record operation invalid: cannot create new record of '<TYPE>::<OPERATION>', legal entity is not in mode 'OPERATIVE'".

Come ripristinare

Il flusso di ripristino è il seguente:

PATCH Taxpayer → Aggiornare la modalità del Taxpayer a SUSPENDED
Aggiornare o ripristinare le credenziali nel portale AdE, in base allo scenario
PATCH Taxpayer → Fornire credenziali valide
PATCH Taxpayer → Aggiornare la modalità del Taxpayer a OPERATIVE

Stato e modalità della risorsa entità

Come simulare la modalità DEGRADED nell'ambiente TEST

Per simulare lo scenario di credenziali scadute nell'ambiente TEST, invia il record con l'header: X-Taxpayer-Credentials-Expired: true

Questo header fa sì che il record si comporti come quello che innesca l'errore, forzando il percorso di scadenza delle credenziali, così da poter osservare il comportamento completo della modalità DEGRADED descritto sopra — utile per testare la propria integrazione prima che la funzionalità sia disponibile nella propria versione.

Scopri tutte le novità di SIGN IT 2026-06-01.