Skip to main content Skip to main content

Search

Deutsch Español Français Italiano

SIGN IT - What is DEGRADED mode and how to recover

  • Updated

What is DEGRADED mode

When a record submission fails due to a persistent Fisconline credential error in the LIVE environment, the Taxpayer's mode automatically switches from OPERATIVE to DEGRADED. 

All further record submissions are immediately blocked until the Fisconline credentials are fixed and the Taxpayer is manually restored to OPERATIVE.

Note: For now, this change only affects SIGN IT version 2026-06-01, effective June 19. 
It will be rolled out to all previous API versions over the next 3 months. To help you prepare, starting June 19 you can simulate the expired credentials scenario in the TEST environment across all API versions — including those prior to 2026-06-01. Learn how at the end of this article. 


What triggers it

The first record submission in the LIVE environment that fails with one of the following 3 authentication errors:

Error  Cause
Authentication error: Fisconline credentials expired Password has exceeded the 90-day lifecycle
Authentication error: Invalid credentials Wrong username, PIN, or password
Authentication error: authentication failed due to multiple failed intents with wrong credentials - please reset and update them Account locked after repeated failed login attempts

When triggered:

  • The triggering record returns FAILED, with the specific authentication error indicating the root cause captured in the record's logs.
  • The Taxpayer mode automatically switches from OPERATIVE to DEGRADED
  • All subsequent record submissions immediately return a 405 Method not allowed error — "record operation invalid: cannot create new record of '<TYPE>::<OPERATION>', legal entity is not in mode 'OPERATIVE'". 


How to recover

The recovery flow is as follows:

  1. PATCH the Taxpayer to SUSPENDED mode
  2. Update or reset credentials in the AdE portal, according to the scenario
  3. PATCH the Taxpayer to provide valid credentials
  4. PATCH the Taxpayer back to OPERATIVE mode

Stato e modalità della risorsa entità

How to simulate DEGRADED mode in the TEST environment 

To simulate the expired credentials scenario in the TEST environment, send the record with the header: X-Taxpayer-Credentials-Expired: true

This header causes the record to act as the triggering record, forcing the credential-expiration path so you can observe the full DEGRADED mode behavior described above and test your integration's response before it goes live on your version. 

Learn more about the key changes in SIGN IT 2026-06-01.