SIGN IT - Come verificare se le credenziali FISCONLINE sono valide – fiskaly-support (IT)

Nota: La validazione con dati reali avviene esclusivamente nell'ambiente LIVE.

Una prima validazione delle credenziali viene eseguita quando lo state del Taxpayer viene aggiornato da ACQUIRED a COMMISSIONED nell'ambiente LIVE. Se le credenziali sono valide, il mode del Taxpayer cambierà a OPERATIVE.
Inoltre, è possibile avviare manualmente una validazione cambiando il mode del Taxpayer da OPERATIVE → SUSPENDED → OPERATIVE nell'ambiente LIVE tramite l’endpoint updateTaxpayer (in precedenza, updateEntity).
Se le credenziali sono ancora valide, il mode del Taxpayer cambierà a OPERATIVE; in caso contrario, resterà in SUSPENDED e sarà necessario aggiornare le credenziali FISCONLINE.
Successivamente, quando viene creato un Record TRANSACTION nell'ambiente LIVE, viene eseguita un'ulteriore verifica delle credenziali. Se l'autenticazione al portale AdE non va a buon fine a causa di credenziali scadute, non valide o di un account bloccato, il Record restituirà modalità FINISHED / stato FAILED, e un messaggio Authentication Error apparirà nei logs indicando la causa esatta.

In tal caso, la modalità del Taxpayer passerà automaticamente a DEGRADED, bloccando ulteriori trasmissioni di record fino a quando le credenziali Fisconline non vengono corrette e il Taxpayer viene ripristinato manualmente in modalità OPERATIVE.

Nota: La modalità DEGRADED viene introdotta nella versione 2026-06-01 in data 19 giugno, e sarà disponibile per tutte le versioni precedenti nei prossimi 3 mesi.
Se si decide di rimanere sulla propria versione, è già possibile simularne il comportamento inviando un record con l'header X-Taxpayer-Credentials-Expired: true nell'ambiente di TEST. Per maggiori dettagli: Cos'è la modalità DEGRADED e come intervenire