Skip to main content Skip to main content

Search

Deutsch Español Français Italiano

SIGN IT - How to check if FISCONLINE credentials are valid

  • Updated
Note: Validation against real data only occurs in the LIVE environment.
  1. An initial validation of the credentials is already performed when the Taxpayer's state is updated from ACQUIRED to COMMISSIONED in the LIVE environment. If the credentials are valid, the Taxpayer mode will change to OPERATIVE.
     
  2. Additionally, you can manually trigger a validation by changing the Taxpayer mode from OPERATIVE → SUSPENDED → OPERATIVE in the LIVE environment using the updateTaxpayer endpoint (formerly, updateEntity). 
    If the credentials are valid, the Taxpayer mode will switch to OPERATIVE. If invalid, it will remain SUSPENDED and you will need to update the FISCONLINE credentials.

    Stato e modalità della risorsa entità
     

  3. Later, when you create a TRANSACTION record in the LIVE environment, we perform another credential check. If authentication to the AdE portal fails due to expired, invalid, or locked credentials, the record will be set to FINISHED mode /  FAILED state, and an Authentication Error message will appear in the logs indicating the exact root cause. 
    Record Resource State and Mode
    In that case, the Taxpayer's mode will automatically transition to DEGRADED, blocking further record submissions until the Fisconline credentials are fixed and the Taxpayer is manually restored to OPERATIVE. 

    Note: The DEGRADED mode is being introduced in version 2026-06-01 on June 19, and will roll out to all legacy versions over the next 3 months. 
    If you decide to stay on your current version, you can already simulate this behavior well before it lands on your version by sending a record with the X-Taxpayer-Credentials-Expired: true header. For more details: What is DEGRADED mode and how to recover