Note: Validation against real data only occurs in the LIVE environment.
- An initial validation of the credentials is already performed when the Taxpayer's state is updated from
ACQUIREDtoCOMMISSIONEDin the LIVE environment. If the credentials are valid, the Taxpayer mode will change toOPERATIVE.
- Additionally, you can manually trigger a validation by changing the Taxpayer mode from
OPERATIVE→SUSPENDED→OPERATIVEin the LIVE environment using theupdateTaxpayerendpoint (formerly, updateEntity).
If the credentials are valid, the Taxpayer mode will switch toOPERATIVE. If invalid, it will remainSUSPENDEDand you will need to update the FISCONLINE credentials.
-
Later, when you create a
TRANSACTIONrecord 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 toFINISHEDmode /FAILEDstate, and an Authentication Error message will appear in thelogsindicating the exact root cause.
In that case, the Taxpayer's mode will automatically transition toDEGRADED, blocking further record submissions until the Fisconline credentials are fixed and the Taxpayer is manually restored toOPERATIVE.Note: The
DEGRADEDmode is only available in LIVE starting with version 2026-06-01.
For more information, see: What is DEGRADED mode and how to recover